Facebook Ads データの取得
Facebook Ads の広告データは、本製品 によって公開される複数のビューを通じて表示され、アクセスされます。このビューの詳細については、データモデル を参照してください。Facebook Ads の仕組み上、これらのビューのクエリには、以下に示すような基本的なルールがいくつかあります。どのビューについても、データモデル セクションの該当ページで、そのビューのクエリに関連する詳細について説明します。
ターゲットの指定
広告に関連する多くのビューで、データを取得する特定の広告またはアカウントオブジェクトを識別するために、クエリ時にターゲットを指定する必要があります。たとえば、Ads ビューをクエリする場合、特定の広告アカウントを指す条件としてTarget カラムを指定する必要があります。SELECT * FROM Ads WHERE Target = 'act_123456'Target は、クエリで動的に指定することもできます。
SELECT * FROM Ads WHERE Target IN (SELECT ID FROM AdAccounts)クエリでTarget が指定されず、Target 接続プロパティが設定されていない場合、AccountID 接続プロパティを使用して広告クエリのデフォルトターゲットが決定されます。いずれも設定されていない場合は、Facebook Ads から返された最初のアカウントID が使用されます。
インサイトビュー
広告の分析、パフォーマンス、レポートデータは、AdInsights およびAdInsightsActions ビューからアクセスできます。これらのビューへのクエリには、前項で説明したようにTarget が必要ですが、レポーティング機能のためのより詳細なクエリ構文もサポートしています。
時間範囲
広告レポートや分析を取得しようとする場合は、クエリでDateStart とDateEnd、またはDatePreset を使用して、広告データの時間範囲を制御します。SELECT DateStart, DateEnd, AdAccountId, Spend, Impressions FROM AdInsights WHERE Target = 'act_123456' AND DateStart >= '01/01/2015' AND DateEnd <= '03/31/2015'
SELECT DateStart, DateEnd, AdAccountId, Spend, Impressions FROM AdInsights WHERE Target = 'act_123456' AND DatePreset='last_90d' AND TimeIncrement='monthly'広告データの時間範囲を指定する場合は、TimeIncrement を使用して、各結果行に要約される広告データの期間を制御します。たとえば、TimeIncrement が"monthly に設定されている場合、各結果行は広告データの月次ロールアップに対応します。
広告レベル
クエリに指定されたTarget は、どの広告アカウントの広告データを取得するかを制御します。Level を使用して、広告オブジェクトの結果をレポートするレベルを制御します。レベルは、ad、adset、campaign、またはaccount に設定できます。
内訳
Facebook Ads は、広告インサイトデータをクエリするための多くの内訳を提供します。これらの内訳は、AdInsights およびAdInsightsActions ビューを通じて公開され、使用できます。クエリに対して返される各行は、クエリで指定された内訳の1つの組み合わせのレポートデータに対応します。内訳の組み合わせに対して返される集計データは、クエリで指定された広告オブジェクトターゲットと広告オブジェクトレベルによって制限されます。Facebook Ads では、同時に選択できる内訳に制限を課しているため、デフォルトでは、本製品 に指定されるクエリの内訳にも同様の制限を課しています。必要であれば、IgnoreValidationException プロパティによってこの内部強制を無効にすることができます。このプロパティを"True" に設定すると、内訳に関する内部的な制限が回避され、指定された内訳の組み合わせがそのままFacebook に渡されます。
内訳の組み合わせについての詳細はデータモデル を参照してください。
アクションコレクション
AdInsightsActions ビューにはActionCollection カラムもあり、広告に帰属するアクションの種類を指定することができます。
アクション属性
AdInsightsActions ビューには、ActionAttributionWindows カラムもあり、Facebook Ads がレポートを生成する際に、広告オブジェクトにどのようにアクションを関連付けるかを制御することができます。ActionAttributionWindows は、アクションと期間の組み合わせを定義する組み合わせのリストから指定されます。たとえば、ActionAttributionWindows のデフォルト値は「7d_click,1d_view」で、広告オブジェクトをクリックしてから7日以内、または表示してから1日以内に実行された関連アクションが、広告オブジェクトに帰属し、レポートされることを意味します。