データコネクタを追加
- Settings > Data Connectorsで、 Add Data Connector をクリックし、「Facebook」と入力して選択します。
- Facebook の認証情報でサインインします。Singular に再度移動して、データコネクタを開き直す必要がある場合があります。
- 追加したデータコネクタを開き、データを取得したいアカウントを有効にして、次をクリックします: Submit.
概要情報
| データコネクタテクノロジー | API (Facebook Graph API と Marketing API v19.0) |
| データの内訳（セグメンテーション） |
Facebook はデータを 以下のすべて で分類して提供します（用語と詳細については、以下の データマッピング を参照）:
さらに、Facebook は 次のいずれかの内訳を提供します:
このうちデフォルトは 国です。別の内訳を使用したい場合は、担当の Customer Success Manager または Singular サポートに連絡して連携を設定してもらってください。内訳は Account ID ごとに個別に選択できます。 |
| データの取得期間 | Singular は毎日、7日前までのデータを取得します。週に1回、月曜日には30日前までのデータを取得します。 |
| タイムゾーン | Facebook でアカウントに設定されているタイムゾーン。 |
| データはクリエイティブ（広告）レベルで利用できますか？ | はい。 |
| Singularはクリエイティブアセットを表示しますか？ | はい。Dynamic Creative に含まれる複数のアセットも表示します。ただし、ページの管理者ではないユーザーの場合、Singular は Facebook ページから動画を取得できません。 |
| 既知の制限/問題 | Facebook アカウントで2要素認証を有効にした場合、Singular で Facebook データコネクタを再認証する必要があります。 |
データマッピング
用語に関する注記:
- "Campaign" は Singular における Facebook の "Ad Campaign" に相当します
- "Sub-Campaign" は Facebook の以下に相当します: "Ad Set"
- "Creative" は Facebook の以下に相当します: "Ad"
- "Asset" は、階層構造において Creative の下に位置する新しいレベルで、Facebook の "Asset"に相当します。Dynamic Creative で使用され、たとえば Automated App Ads [AAA] キャンペーンで使用されます）。
すべてのフィールドの説明については、 Singular の指標とディメンションの用語集を参照してください。
Meta でクリエイティブレポートを実行する方法の詳細については、 Meta と Google Ads でクリエイティブレポートを実行するには？
| Field in Singular UI | Field in Singular API | Field in Facebook |
|---|---|---|
| Dimensions | ||
| Account ID | adn_account_id | 'id' from me/adaccounts |
| Account Name | adn_account_name | 'name' from me/adaccounts |
| Asset ID | asset_id | asset_id |
| Campaign URL | adn_campaign_url | Taken from one of the Creative URLs. |
| Country | country_field | Country from Insights URL |
| Date | date_field | Given as a parameter when querying Facebook |
| DMA ID | dma_id_field | targeting[geo_locations][data][key] |
| DMA Name | dma_name_field | dma |
| Network Campaign ID | adn_campaign_id | campaign_id |
| Network Campaign Name | adn_campaign_name | 'Name' from the campaign-level endpoint |
| Network Creative ID | adn_creative_id | ad_id |
| Network Creative Name | adn_creative_name | 'Name' from ad level |
| Network Sub Campaign ID | adn_sub_campaign_id | adset_id |
| Network Sub Campaign Name | adn_sub_campaign_name | 'Name' from the sub-campaign (ad set) level endpoint |
|
Placement |
placement |
Mapped from one of the following fields: device_platforms/ publisher_platforms/ facebook_positions/ instagram_positions/ audience_network_positions/ messenger_positions Possible values: mobile, desktop, facebook, instagram, messenger, audience_network, feed, right_hand_column, instant_article, marketplace, video_feeds, search stream, story, explore, classic, instream_video, rewarded_video, messenger_home, sponsored_messages |
| Platform | platform |
|
| Public Id | site_public_id |
|
|
Region |
region_field |
region |
| Source | source | For Sub Ad Network ("Publisher Platform") breakdown - this field contains the sub ad network, i.e. Facebook Advertising Network, Instagram, Whatsapp, etc. |
| Sub Ad Network | adn_subadnetwork | publisher_platform |
| Sub Campaign ID | sub_campaign_id | adset_id |
| Sub Campaign Name | sub_campaign_name | ‘Name’ from sub campaign level insights |
| Target Countries | target_countries_str | targeting[‘geo_locations’] |
| Text | creative_text |
Get creative(ad) data by id
|
| Timezone | adn_timezone | From Account.timezone_utc_offset |
| UTC Offset | adn_utc_offset | From Account.timezone_utc_offset |
| Age | age | age |
| Gender | gender | gender |
Facebook Attribution Type |
campaign_attribution_type | A field for FB app ads campaign, which directly indicates the chosen attribution type for an app install campaign (e.g., SKAN or AEM) while creating it on FB |
Call to Action Button |
call_to_action_button | A creative field with the call to action message if there is any |
| Metrics | ||
|
Comments |
adn_comments | Post comments |
|
Likes |
adn_likes | Post reactions |
| Network Clicks | adn_clicks | Clicks (default) or inline_link_clicks (if specifically requested by Singular customer) |
| Network Impressions | adn_impressions | impressions |
| Network Installs | adn_installs | Mobile_installs / canvas_installs. Note that if you set up your campaign with Facebook to optimize on AEM installs, this metric will reflect AEM installs. |
| Original Cost | adn_original_cost | spend |
| Original Currency | adn_original_currency | 'currency' from me/adaccounts endpoint |
|
Posts saved |
posts_saved | Post saves |
|
Shares |
adn_shares | Post shares |
| Video Views 25% | video_views_25pct | video_p25_watched_actions |
| Video Views 50% | video_views_50pct | video_p50_watched_actions |
| Video Views 75% | video_views_75pct | video_p75_watched_actions |
| Completed Video Views | completed_video_views | video_p100_watched_actions |
Singular はこのパートナーのキャンペーンプロパティの取得にも対応しています。詳細は こちらをご覧ください。
FAQ とトラブルシューティング
Facebook が提供するさまざまな指標のうち、Singular の連携ではモバイルマーケティングに関連する指標を収集します:
- インプレッション
- クリック
- インストール - Facebook キャンペーンを AEM インストール向けに最適化するよう設定している場合、この指標には AEM インストールが反映されます。
- コスト
さらに、Singular は ユーザーアクションに関する統計を取得できます。これは Singular では コンバージョンイベントと呼ばれます。Facebook からそのデータを取得するための設定については、以下の カスタムイベントの設定 を参照してください。
キャンペーンを AEM 向けに最適化するよう設定している場合、AEM インストールはネットワークインストールのディメンションに取り込まれます
エンドユーザーのプライバシーを保護するため、Facebook はインプレッションが1,000未満のユーザーセグメントについて測定値を表示することを許可していません。レポートの行にこのメッセージが表示される場合、その行のインプレッション数が少ないことを意味します。目的のデータを取得するには、ディメンションを減らす、または期間を広げるなどして、粒度の粗いレポートを実行してみてください。
Dynamic Creative は、複数のクリエイティブアセットを含む Facebook の特殊なクリエイティブタイプです。Singular はこれらのクリエイティブアセットをレポートに表示し、アセットレベルの統計も表示できるようになりました。
Facebook はアセットを別個の内訳とみなしており、他の許可された内訳（国やサブアドネットワークなど）とアセットレベルのデータを組み合わせて提供することはありません。国別（または他の Facebook レポートで使用している任意の内訳）のアセットデータを表示するため、Singular はクリエイティブ単位でデータを取得したうえで、各アセットに指標を比例配分する補間処理を追加で行っています。
たとえば、選択した Facebook の内訳が国の場合:
Facebook API は国、サブアドネットワーク、プラットフォームのいずれか1つしか提供しないため、Singular は残りの2つのディメンションを別の方法で推定します。つまり、キャンペーン、サブキャンペーン、またはクリエイティブの ターゲティング設定 を確認します。
たとえば、データをキャンペーンと国で分類している場合、Facebook から取得したデータにはプラットフォームが含まれません。Singular は各キャンペーンのターゲティング設定を参照し、キャンペーンが iPhone のような特定の単一プラットフォームをターゲットにしている場合、 Singular はそのターゲティング情報を使用して、そのキャンペーンのプラットフォームフィールドを補完します （値は「iPhone」）。
一方、キャンペーンが iOS と Android のように複数のプラットフォームをターゲットにしている場合、Singular はそれを使ってプラットフォームフィールドを補完することはできません。
つまり、キャンペーンやサブキャンペーン（Facebook では ad campaign や ad set）を、それぞれ1つの国および/または1つのデバイスをターゲットにするよう設定すれば、レポートでより豊富なデータを得られます。
注: プラットフォームデータがターゲティング設定から導出された場合、レポートにはプラットフォームが「iPhone」や「iPad」と表示されることもあれば、「iOS」とだけ表示される、あるいはまったく表示されないこともあります。これは、それぞれのケースでのターゲティングの粒度によります。
デフォルトでは、Facebook はクリックに7日間、ビューに1日間のアトリビューションウィンドウを使用します。
Singular のアナリティクスレポートで別の値を使用したい場合は、 Singular サポートにお問い合わせ のうえ、ウィンドウを変更してもらってください。
Facebook から Singular へのデータ取得を開始するには:
- Singular プラットフォームで Settings > Data Connectorsに移動します。
- Add New Connector ボタンにカーソルを合わせ、「Facebook」と入力し始めます。表示されるリストから Facebook を選択します。
-
Connect with Facebook をクリックし、必要な広告アカウントにアクセスできる Facebook ユーザーでログインします。
注: ボタンをクリックする前に、無関係なアカウント（個人アカウントなど）で Facebook にログインしていないことを確認してください。
代理店の Facebook Ads アカウントでキャンペーンを実施するには、 Settings > Data Connectorsに移動し、代理店の Facebook アカウントを追加します。SDK 連携やパートナー設定を変更する必要はありません。
その後、レポートツールを使ってインプレッション、クリック、コストなどのキャンペーンデータを取得できます。レポートを実行する際は、 Account ID と Account Name のディメンションを使用してください。
キャンペーンコストに代理店手数料などの追加費用が含まれる場合、Singular がこれらの費用をレポートに表示されるコストに加算するよう設定できます。設定場所は Settings > Partner Feesです。詳細は パートナー手数料 FAQを参照してください。
データを代理店として表示することもできます。 Settings > Data Connectorsに移動し、Facebook の設定を開いて、 View This Source As ドロップダウンを使用します。
Singular は、ログインしたユーザーがアクセスできるすべてのアカウントを表示します。Singular に接続するアカウントを選択してください。たとえば、ダミーデータを含むテストアカウントは除外するとよいでしょう。
注: 選択したアカウントのいずれかが無効な場合、保存できません。Facebook のアカウントがすでに有効でない場合や、ログイン中のユーザーがそのアカウントにアクセスできなくなった場合に発生することがあります。
Source 列では、各アカウントに名前を付けられます。この名前でデータがレポートに表示されます。複数のアカウントに同じソース名を使用することもできます。
たとえば、Nanigans のような Preferred Marketing Developer（PMD）や Facebook Marketing Partner（FMP）が運用する広告キャンペーン用の Facebook アカウントが1つ以上ある場合、それらのアカウントに「Nanigans」を指定します。Singular のレポートでは、これらのアカウントのデータが合算され、ソース名「Nanigans」で表示されます。
デフォルトでは、すべてのアカウントにソース名「Facebook」が付けられます。
Singular のカスタムイベントに関する一般的な情報は、カスタムイベントの設定を参照してください
Singular は、登録や初回購入など、ユーザーのインストール後イベントに関するデータを分析できます。通常はアトリビューションプロバイダーからこれらのイベントデータを取得するのが望ましいですが、Facebook のアクティビティをアトリビューションプロバイダー経由でトラッキングしていない場合や、モバイル以外のトラフィックをトラッキングしたい場合は、Facebook から直接送られるデータを取り込めます。Facebook では、ユーザーイベントは actionsと呼ばれます。
Facebook のカスタムイベントのトラッキングを開始するには、カスタムイベントの設定の手順に従って新しいカスタムイベントを追加します。Facebook キャンペーンが設定されている場合、New Custom Event ボックスに Facebook のドロップダウンリストが表示されます。リストをクリックして利用可能な Facebook の actions をすべて表示し、カスタムイベントにマッピングするアクションを選択します。
iOS レポートにインストール数が表示されない場合は、正しいレポートを表示しているか確認してください。SKAN レポートには SKAN インストールの値が表示され、Reports にはネットワークインストールと MMP インストールの両方が表示されます。
次の点にご注意ください:
- SKAN レポート: SKAN レポートはネットワークデータと SKAN インストールを組み合わせたものです。ネットワークデータは詳細ですが、SKAN データは SKAdNetwork の制約により通常はキャンペーンレベルです。
- レポートの内訳: サブキャンペーンで分類する場合、パートナーがキャンペーンレベルでしかデータを渡していないと、SKAN インストールは「N/A」になることがあります。その他のデータはそれぞれのサブキャンペーンに表示されます。
Facebook のクリエイティブ権限エラーは通常、ページまたは広告アカウントへのアクセス権がない、アセット（画像/動画）が利用できない、あるいは役割の権限が不足していることを意味します。多くの場合、Business Settings の Accounts > Pages/Ad Accounts を確認する、ページの管理者権限があることを確認する、管理者に広告アカウントの役割（Admin/Advertiser）を割り当ててもらう、リンク時にドメインアクセスを申請する、といった対応で解決します。一般的な解決策としては、Ads Manager で権限を確認する、ページの状態（削除/無効化されていないか）を確認する、あるいは広告/クリエイティブを複製して速やかに再公開する、などがあります。詳しくは Facebook のドキュメントの こちらをご覧ください