データコネクターの追加
- 設定＞データコネクターで、データコネクターの追加をクリックし、「Facebook」と入力して選択します。
- Facebookの認証情報を使用してサインインします。Singularに再度移動し、Data Connectorを再度開く必要があるかもしれません。
- 追加したData Connectorを開き、データを引き出すアカウントを有効にして、送信をクリックします。
クイック詳細
| データコネクタテクノロジー | API(Facebook Graph APIおよびMarketing APIv13.0) |
| データの内訳（セグメンテーション） |
Facebookは、以下のすべてによって 分解されたデータを提供します（用語と詳細については、以下のデータマッピングを参照してください）：
さらに、Facebookは以下のブレイクダウンのいずれかを提供します：
デフォルトはCountry です。その他の内訳をご希望の場合は、カスタマーサクセスマネージャーまたはSingularサポートにお問い合わせください。アカウントIDごとに内訳を選択できます。 |
| データの取得期間 |
Singularは毎日7日前のデータを取り込みます。週1回月曜日に、Singularは30日前のデータを取得します。 |
| タイムゾーン | Facebookでアカウントに設定されているタイムゾーンです。 |
| データはクリエイティブ（広告）レベルで利用できますか？ |
はい。 |
| Singularはクリエイティブアセットを表示しますか？ |
はい、ダイナミッククリエイティブ内の複数のアセットを含みます。ただし、SingularはFacebookページの管理者でないユーザーの動画を引き出すことはできません。 |
| 既知の制限/問題 | Facebookアカウントで二要素認証を有効にした場合、SingularでFacebookデータコネクターを再認証する必要があります。 |
データマッピング
用語に関する注意事項
- "Campaign" のSingularはFacebookの"Ad Campaign" に対応しています。
- "Sub-Campaign" Facebookの"Ad Set"。
- "Creative" Facebookの"Ad"。
- "Asset" は、Facebookの"Asset" に対応するCreative の下の階層にある新しいレベルです。 Dynamic Creatives で使用されます（例：Automated App Ads [AAA]キャンペーン）。
すべてのフィールドの説明については、「Singular Metrics and Dimensions Glossary」を参照してください。
Meta でクリエイティブレポートを実行する方法については、 How to run Creative Reports in Meta and 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
|
| Metrics | ||
| Average Frequency |
frequency | frequency |
| 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 |
| Reach |
reach |
reach |
| 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はこのパートナーのキャンペーンプロパティのプルにも対応しています。
よくある質問とトラブルシューティング
Facebookが提供する様々なメトリクスのうち、Singularインテグレーションはモバイルマーケティングに関連するメトリクスの収集を行います：
- インプレッション
- クリック数
- インストール - AEMのインストールに最適化するようにFacebookキャンペーンを設定している場合、このメトリクスはAEMのインストールを反映することに注意してください。
- コスト
さらに、Singularではコンバージョンイベントとして知られている、ユーザーのアクションに関する統計を取得することができます。Facebookからデータを取得するためのSingularの設定については、下記のカスタムイベントの設定をご覧ください。
エンドユーザーのプライバシーを保護するために、Facebookは1000インプレッション未満のユーザーセグメントの測定値を表示することを許可していません。レポートの行にこのメッセージが表示された場合、その行のインプレッション数が少ないことを意味します。お探しのデータを得るには、より粒度の小さいレポートを実行してみてください。つまり、より少ないディメンションを含めるか、より広い日付範囲を選択してください。
ダイナミッククリエイティブは、複数のクリエイティブアセットを含むFacebookの特別なタイプのクリエイティブです。Singularはこれらのクリエイティブアセットをレポートに表示し、アセットレベルの統計も表示できるようになりました。
Facebookはアセットを独立した内訳とみなしており、その他の許可された内訳（国やサブ広告ネットワークなど）ではアセットレベルのデータを提供していません。国ごとのアセットデータ（または他のFacebookレポートで表示されるその他の内訳）を表示するために、Singularはクリエイティブごとにデータを取得し、データを補間して各アセットにメトリクスの一部を比例配分します。
例えば、選択したFacebookの内訳が「国」であったとします：
Facebook APIは国またはサブアドのネットワークまたはプラットフォームしか提供しないため、Singularはキャンペーン、サブキャンペーン、またはクリエイティブのターゲティング設定をチェックすることで、他の2つのディメンションを別の方法で把握しようとします。
例えば、キャンペーンと国別にデータを分解している場合、Facebookから引き出されたデータにはプラットフォームが含まれていません。Singularは各キャンペーンのターゲティング設定を調べ、あるキャンペーンがiPhoneのような特定のプラットフォームをターゲットにしている場合、Singularはターゲティング情報を使用して、そのキャンペーンのプラットフォームフィールドを「iPhone」という値で埋めます。
一方、キャンペーンが複数のプラットフォーム、例えばiOSとAndroidをターゲットにしている場合、Singularはその情報を使ってプラットフォームフィールドを埋めることはできません。
つまり、キャンペーンまたはサブキャンペーン（Facebookでは広告キャンペーンまたは広告セット）を定義し、それぞれが1つの国および/または1つのデバイスをターゲットにするようにすることで、レポートでより豊富なデータを得ることができます。
注:プラットフォームデータがターゲティング設定に由来する場合、レポートではプラットフォームが「iPhone」または「iPad」と表示されることもあれば、「iOS」としか表示されない、またはまったく表示されないこともあります。これは、それぞれのケースにおけるターゲティングのレベルに基づいています。
デフォルトでは、Facebookはクリックに7日間、ビューに1日間のアトリビューションウィンドウを使用します。
Singularのアナリティクスレポートで異なる値を使用したい場合は、Singularサポートに連絡してウィンドウを変更してもらいましょう。
FacebookからSingularにデータを取り込むには：
- Singularプラットフォームで Settings > Data Connectors.
- Add New Connector ボタンにカーソルを合わせ、"Facebook "と入力する。表示されるリストでフェイスブックを選択。
-
Connect with Facebook をクリックし、必要な広告アカウントにアクセスできるFacebookユーザーにログインします。
注意：ボタンをクリックする前に、無関係のアカウント（個人アカウントなど）でFacebookにログインしていないことを確認してください。
代理店Facebook広告アカウントでキャンペーンを実施するには、次のサイトにアクセスします。 Settings > Data Connectorsにアクセスし、代理店のFacebookアカウントを追加してください。SDKインテグレーションまたはパートナーコンフィギュレーションを更新する必要はありません。
その後、当社のレポートツールを使用して、インプレッション、クリック、およびコストのようなキャンペーンデータを取得することができます。レポートを実行する際は、Account ID およびAccount Name ディメンションを使用してください。
キャンペーン費用に代理店手数料などの追加料金が含まれている場合、Singularの設定 > パートナー手数料で、これらの手数料をレポートに表示される費用に追加することができます。パートナーフィーFAQをご覧ください。
代理店としてデータを表示することもできます。Settings > Data Connectors にアクセスし、Facebook設定を開いて、View This Source As ドロップダウンを使用してください。
Singularは、ログインしたユーザーがアクセスできるすべてのアカウントを表示します。Singular に接続したいアカウントを選択してください。例えば、ダミーデータのテスト用アカウントがある場合は、それらを選択しないでください。
注意：選択したアカウントが無効な場合、保存できません。これは、フェイスブックのアカウントがアクティブでなくなった場合や、サインインしたユーザーがアカウントにアクセスできなくなった場合に起こります。
ソース」列では、各アカウントに名前を付けることができます。これはレポートに表示されるデータの名前です.複数のアカウントに同じソース名を使用できます。
たとえば、NanigansのようなPMD（Preferred Marketing Developer）やFMP（Facebook Marketing Partner）が担当する広告キャンペーンのFacebookアカウントが1つ以上ある場合は、それらのアカウントに「Nanigans」を指定します。Singularレポートでは、これらのアカウントのデータを合計し、「Nanigans」というソース名でレポートに表示します。
デフォルトでは、すべてのアカウントに "Facebook "というソース名が与えられています。
Singularのカスタムイベントに関する一般的な情報は、カスタムイベントの設定を参照してください。
Singularは、登録や初回購入など、ユーザーのインストール後のイベントに関するデータを分析できます。通常、これらのイベントに関するデータはアトリビューションプロバイダーから取得するのが望ましいですが、アトリビューションプロバイダーを通してFacebookのアクティビティをトラッキングしていない場合や、モバイル以外のトラフィックをトラッキングしたい場合は、Facebook自体からデータを取り込むことができます。Facebookでは、ユーザーイベントはアクションとして知られています。
Facebookからカスタムイベントのトラッキングを開始するには、カスタムイベントの設定の指示に従って、新しいカスタムイベントを追加します。Facebookキャンペーンが設定されている場合、新規カスタムイベントボックスにはFacebookのドロップダウンリストがあります。リストをクリックして利用可能なすべてのFacebookアクションを表示し、カスタムイベントをマッピングするアクションを選択します。
iOSのレポートにインストール数が表示されない場合、正しいレポートが表示されているか確認してください。SKANレポートにはSKANインストール数が表示されます。レポートにはネットワークとMMPインストールの両方が表示されます。
以下の点に注意してください：
- SKANレポート：SKANレポートは、ネットワークデータとSKANインストールを組み合わせたものであることを理解してください。ネットワークデータは詳細ですが、SKANデータはSKAdNetworkの制限により通常キャンペーンレベルです。
- レポートの内訳：サブキャンペーン別に分類する場合、パートナーがキャンペーンレベルでのデータしか渡さない場合、SKANのインストールは「N/A」になる可能性があります。その他のデータはそれぞれのサブキャンペーンの下に表示されます。