広告レポートをクエリします。広告レポート情報へのアクセスには、ads_read アクセス許可が必要です。

テーブル固有の情報

Facebook のAdInsights ではレポートから取得できる情報と同等のものが要求できます。

Select

AdInsights を要求する場合は、Target を指定する必要があります。どのエレメントからインサイトを抽出するかを指定します。AdAccount、Campaign、AdSet、またはAd などが考えられます。次に例を示します。

SELECT * FROM AdInsights WHERE Target = 'act_123456'

日付範囲は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'

DatePreset で使用できる値は次のとおりです。

• maximum
• today
• yesterday
• this_week_sun_today
• this_week_mon_today
• last_week_sun_sat
• last_week_mon_sun
• last_3d
• last_7d
• last_14d
• last_28d
• last_30d
• last_90d
• this_month
• last_month

TimeIncrement では各レポート行に何日を含めるかを指定します。次に例を示します。

SELECT DateStart, DateEnd, AdAccountId, Age, Spend, Impressions FROM AdInsights WHERE Target = 'act_123456' AND DatePreset = 'last_90d' AND TimeIncrement = '7'

SELECT DateStart, DateEnd, AdAccountId, Age, Spend, Impressions FROM AdInsights WHERE Target = 'act_123456' AND DatePreset = 'last_90d' AND TimeIncrement = 'monthly'

Level はインサイトがどのレベルで抽出されるかを指定します。AdAccount、Campaign、AdSet、またはAd などに設定できます。次に例を示します。

SELECT DateStart, DateEnd, AdAccountId, Age, Spend, Impressions FROM AdInsights WHERE Target = 'act_123456' AND Level = 'campaign'

ブレークダウンカラムが多く存在します。一般的には、一度に1つのブレークダウンカラムしか選択できません。SELECT * を使うと、ブレークダウンカラムは使われません。利用可能なブレークダウンカラムは次のとおりです。

• Age：Gender と一緒に選択することができます。
• Country
• FrequencyValue
• Gender：Age と一緒に選択することができます。
• HStatsByAdvertiserTZ (Hourly Stats by Advertizer Timezone)
• HStatsByAudienceTZ (Hourly Stats by Audience Timezone)
• ImpressionDevice：PublisherPlatform、またはPublisherPlatform とPlatformPosition の両方と一緒に選択することができます。
• PlatformPosition：PublisherPlatform と一緒に選択される必要があります。ImpressionDevice と一緒に選択することもできます。
• PublisherPlatform：PlatformPosition、ImpressionDevice、またはPlatformPosition とImpressionDevice 両方と一緒に選択できます。
• ProductId
• Region

他の多くのカラムは、標準SQL WHERE clause modifiers と使うことができます。次に例を示します。

SELECT DateStart, DateEnd, AdAccountId, Spend, Impressions FROM AdInsights WHERE Target = 'act_123456' WHERE Impressions > 10000 AND Spend < 1000

DataPreset およびブレークダウンはFacebook によって頻繁に変更されることがあります。Facebook 側の変更により、上のリストは古くなっている可能性があります。最新のブレークダウンおよび、data presets を参照するには、Facebook のドキュメントのパラメータとブレークダウンを参照してください：https://developers.facebook.com/docs/marketing-api/insights/

Facebook Ads では、同時に選択できるブレークダウンに制限を課しているため、デフォルトでは、本製品 に指定されるクエリのブレークダウンにも同様の制限を課していることに注意してください。必要であれば、IgnoreValidationException プロパティによってこの内部強制を無効にすることができます。このプロパティを"True" に設定すると、ブレークダウンに関する内部的な制限が回避され、指定されたブレークダウンの組み合わせがそのままFacebook に渡されます。

Note: The following error message may be encountered when querying from this table: "Please reduce the amount of data you're asking for, then retry your request".

This error typically occurs when the driver requests an amount of data that Facebook cannot handle the calculations for on its end. It appears to be triggered based on individually dense fields, and not the page size.

If the 本製品 encounters this error when first executing certain types of queries, the driver will attempt to retry the query at a lower level of ad object, if possible. To retry, the driver will execute the query at the next lowest level of ad object, down to the level defined in RetryLevel. Note that if the Level parameter is specified in a query, the driver will not attempt to retry beyond the ad object level specified by Level. Please see RetryLevel for more details. Additionally, spreading queries across more granular ad objects can decrease query performance by increasing the number of requests executed for the query.

If this error is still encountered, either reduce the date range of the query or remove expensive columns.

A good method for finding and removing expensive columns is to use a binary search by removing half of the columns you are selecting and retrying the query. Then retry again with half of the remaining columns if you get the same error, or half of the removed columns if you got no error.

Columns