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

テーブル固有の情報

AdInsightsActions は、AdInsights からのActions カラムのブレークダウンを表します。AdInsights のクエリについての一般的な情報は、AdInsights を参照してください。

Select

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

SELECT * FROM AdInsightsActions WHERE Target = 'act_123456'

AdInsightsActions から取得する特定のコレクションはActionCollection で指定できます。何も指定されなかった場合は、Atcions が使われます。それぞれのインプットは、アクションのコレクションが返されるAdInsights からの使用可能なカラムを表します。さらに、IN 句によって複数のコレクションを指定することができます。次に例を示します。

SELECT * FROM AdInsightsActions WHERE Target = 'act_123456' AND ActionCollection = 'UniqueActions'

SELECT * FROM AdInsightsActions WHERE Target = 'act_123456' AND ActionCollection IN ('Actions', 'UniqueActions')

AdInsights からの有効なセレクションクライテリアのようにブレークダウンが使用可能です。ブレークダウンの詳細については、AdInsights を参照してください。AdInsightsActions の追加でのブレークダウンは以下を含みます：ActionType、ActionCanvasComponentName、ActionCarouselCardId、ActionCarouselCardName、ActionDestination、ActionDevice、ActionLinkClickDestination、ActionReaction、ActionTargetId、ActionVideoSound、およびActionVideoType。

ActionAttributionWindows は、アトリビューションウィンドウのカンマ区切りのリストを入力するために使用できます。次に例を示します。

SELECT * FROM AdInsightsActions WHERE Target = 'act_123456' AND level = 'ad' AND ActionAttributionWindows = '1d_view,7d_view,28d_click'

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