Facebookデータコネクタ

 

データコネクターの追加

  1. 設定データコネクターでデータコネクターの追加をクリックし、「Facebook」と入力して選択します。
  2. Facebookの認証情報を使用してサインインします。Singularに再度移動し、Data Connectorを再度開く必要があるかもしれません。
    facebook_edit.png
  3. 追加したData Connectorを開き、データを引き出すアカウントを有効にして、送信をクリックします。
    facebook_account.png

クイック詳細

データコネクタテクノロジー API(Facebook Graph APIおよびMarketing APIv13.0)
データの内訳(セグメンテーション)

Facebookは、以下のすべてによって 分解されたデータを提供します(用語と詳細については、以下のデータマッピングを参照してください):

  • Account
  • Campaign
  • Sub-Campaign
  • Creative

さらに、Facebookは以下のブレイクダウンのいずれかを提供します:

  • Country (デフォルト)
  • Sub Ad Network (パブリッシャープラットフォーム) +Placement (プラットフォームポジション):パブリッシャープラットフォームは、Facebook、Instagram、Messenger、Facebook Audience Networkなど、広告が表示されたFacebookのプロパティです。Platform Positionは、広告が表示された場所(Facebookウェブサイトのニュースフィード、Instagramのモバイルニュースフィードなど)の詳細を提供します。
  • Platform (インプレッションデバイス):iOS、Android、iPhoneなど。
  • Region 地域レベルの情報(国も取得)。
  • DMA DMAレベルの情報(国も取得)。米国でのみ利用可能。

これらのうちデフォルトはCountry です。その他の内訳をご希望の場合は、カスタマーサクセスマネージャーまたはSingularサポートにご連絡の上、統合の設定を行ってください。アカウントIDごとに内訳を選択できます。

データの取得期間

Singularは毎日7日前のデータを取り込みます。週1回月曜日に、Singularは30日前のデータを取得します。

タイムゾーン Facebookでアカウントに設定されているタイムゾーンです。
データはクリエイティブ(広告)レベルで利用できますか?

はい。

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を参照してください。

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
  1. If all the ads are of the same platform (see Creative Platform), Singular gives that platform to the sub-campaign.
  2. Otherwise, estimated based on the ad-set targeting: targeting[‘user_os’], targeting[‘user_device’], targeting[‘device_platforms’]
  3. If that's not possible, estimated based on the campaign objective:
  • LINK_CLICKS, CONVERSIONS → Platform WEB
  • CANVAS_APP_INSTALL, CANVAS_APP_ENGAGEMENT → Platform CANVAS
Public Id site_public_id
  1. Derived from our Campaign URL and Platform dimensions if possible.
  2. Otherwise derived from the Creative URL and Platform.
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
  • ad[‘body’]
  • ad[‘message’] if is story or video
  • ad[‘description’] if is event or page
  • asset_feed_spec[‘title’] & asset_feed_spec[bodies] & asset_feed_spec[‘descriptions’] if asset_feed_spec in ad
Timezone adn_timezone From Account.timezone_utc_offset
UTC Offset adn_utc_offset From Account.timezone_utc_offset
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からどのようなメトリクスを取得しますか?

Facebookが提供する様々なメトリクスのうち、Singularインテグレーションはモバイルマーケティングに関連するメトリクスを収集します:

  • インプレッション
  • クリック数
  • インストール - AEMのインストールに最適化するようにFacebookキャンペーンを設定している場合、このメトリクスはAEMのインストールを反映することに注意してください。
  • コスト

さらに、Singularではコンバージョンイベントとして知られている、ユーザーのアクションに関する統計を取得することができます。Facebookからデータを取得するためのSingularの設定については、下記のカスタムイベントの設定をご覧ください。

AEMのインストールはどこで確認できますか?
AEMに最適化するようにキャンペーンを設定した場合、AEMのインストールをネットワークインストールディメンションに取り込みます。
レポートの一部の行に「データはメタ/Facebookのプライバシー要件により検閲されています」と表示されるのはなぜですか?

Screen_Shot_2022-10-19_at_14.18.04.png

エンドユーザーのプライバシーを保護するため、Facebookはインプレッション数が1000未満のユーザーセグメントの測定値を表示することを許可していません。 レポートの行にこのメッセージが表示された場合、その行のインプレッション数が少ないことを意味します。お探しのデータを得るには、より粒度の小さいレポートを実行してみてください。つまり、より少ないディメンションを含めるか、より広い日付範囲を選択してください。

SingularはDynamic Creativesでアセットごとにどのようなデータを表示しますか?

ダイナミッククリエイティブは、複数のクリエイティブアセットを含むFacebookの特別なタイプのクリエイティブです。Singularはこれらのクリエイティブアセットをレポートに表示し、アセットレベルの統計も表示できるようになりました。

Facebookはアセットを独立した内訳とみなしており、その他の許可された内訳(国やサブ広告ネットワークなど)ではアセットレベルのデータを提供していません。国ごとのアセットデータ(または他のFacebookレポートで表示されるその他の内訳)を表示するために、Singularはクリエイティブごとにデータを取得し、データを補間して各アセットにメトリクスの一部を比例配分します。

例えば、選択したFacebookの内訳が「国」であったとします:

Screen_Shot_2021-02-23_at_16.04.21.png

別の内訳を使用しているにもかかわらず、レポートに国やプラットフォームのデータが表示されることがあるのはなぜですか?

Facebook APIは国またはサブアドネットワークまたはプラットフォームしか提供しないため、Singularはキャンペーン、サブキャンペーン、またはクリエイティブのターゲティング設定をチェックすることで、他の2つのディメンションを別の方法で把握しようとします。

例えば、キャンペーンと国別にデータを分解している場合、Facebookから引き出されたデータにはプラットフォームが含まれていません。Singularは各キャンペーンのターゲティング設定を調べ、あるキャンペーンがiPhoneのような特定のプラットフォームをターゲットにしている場合、Singularはターゲティング情報を使用して、そのキャンペーンのプラットフォームフィールドを「iPhone」という値で埋めます

一方、キャンペーンが複数のプラットフォーム、例えばiOSとAndroidをターゲットにしている場合、Singularはその情報を使ってプラットフォームフィールドを埋めることはできません。

つまり、キャンペーンまたはサブキャンペーン(Facebookでは広告キャンペーンまたは広告セット)を定義して、それぞれが1つの国および/または1つのデバイスをターゲットにするようにすることで、レポートでより豊富なデータを得ることができます。

: プラットフォームデータがターゲティング設定に由来する場合、レポートではプラットフォームが「iPhone」または「iPad」と表示されることもあれば、「iOS」としか表示されない、または何も表示されないこともあります。これは、それぞれのケースにおけるターゲティングのレベルに基づいています。

アトリビューションウィンドウを変更できますか?

デフォルトでは、Facebookはクリックに7日間、ビューに1日間のアトリビューションウィンドウを使用します。

Singularのアナリティクスレポートで異なる値を使用したい場合は、Singularサポートに連絡してウィンドウを変更してもらいましょう。

Facebookデータコネクターの設定方法を教えてください。

FacebookからSingularにデータを取り込むには:

  1. Singularプラットフォームで Settings > Data Connectors.
  2. Add New Connector ボタンにカーソルを合わせ、"Facebook "と入力する。表示されるリストでフェイスブックを選択。
  3. Connect with Facebook をクリックし、必要な広告アカウントにアクセスできるFacebookユーザーにログインします。

    image3.png

    注意:ボタンをクリックする前に、無関係のアカウント(個人アカウントなど)でFacebookにログインしていないことを確認してください。

代理店のFacebook広告アカウントと連携するには?

代理店Facebook広告アカウントでキャンペーンを実施するには、次のサイトにアクセスします。 Settings > Data Connectorsにアクセスし、代理店のFacebookアカウントを追加してください。SDKインテグレーションまたはパートナーコンフィギュレーションを更新する必要はありません。

その後、当社のレポートツールを使用して、インプレッション、クリック、およびコストのようなキャンペーンデータを取得することができます。レポートを実行する際は、Account IDおよびAccount Name ディメンションを使用してください。

キャンペーン費用に代理店手数料などの追加料金が含まれている場合、Singularの設定 > パートナー手数料で、これらの手数料をレポートに表示される費用に追加することができます。パートナーフィーFAQをご覧ください。

代理店としてデータを表示することもできます。Settings > Data Connectorsにアクセスし、Facebook設定を開いて、View This Source As ドロップダウンを使用してください。

facebook_agency.png

新しいコネクタを作成するときに表示されるアカウントのリストは何ですか? どのアカウントを選択すればよいですか?

image1.png

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アクションを表示し、カスタムイベントをマッピングするアクションを選択します。

image2.png

SingularがFacebookダッシュボードと異なるデータを表示するのはなぜですか?