AdInsightsActions
広告レポートをクエリします。広告レポート情報へのアクセスには、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
Name | Type | Description |
Target | String | インサイトを取得するアカウント、キャンペーン、広告グループ、広告のID。 |
DatePreset | String | DateStart およびDateEnd を指定する代替手段。日付の範囲は前もって指定された値に基づき自動的に計算されます。
使用できる値は次のとおりです。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 |
DateStart | Date | インサイトの取得開始日。これは、Facebook UI のReport Start フィールドです。これは、Facebook UI のReport Start フィールドです。 |
DateEnd | Date | インサイトの取得終了日。これは、Facebook UI のReport End フィールドです。これは、Facebook UI のReport End フィールドです。 |
TimeIncrement | String | データの集計日数。整数(1-90)、月一回、または毎日(all_days)。この値は範囲またはプリセット日を、より小さなインクリメントに分割します。
デフォルト値は1です。 |
Level | String | 結果を表示するレベル。
使用できる値は次のとおりです。ad, adset, campaign, account |
ActionAttributionWindows | String | アクションのアトリビューションウィンドウが何であるかを決定するカンマ区切りのリスト。例えば、28d_click は、API が誰かが広告をクリックしてから28日後に起こったアクションのすべてを返します。デフォルトオプションは、[1d_view,7d_click] を意味します。使用できる値は、1d_view、7d_view、28d_view、1d_click、7d_click、28d_click、default です。 |
ActionCollection | String | 取得するアクションのコレクション。利用可能な値は次のとおりです。ActionValues, Actions, AdClickActions, AdImpressionActions, CatalogSegmentActions, CatalogSegmentValue, CatalogSegmentValueMobilePurchaseRoas, CatalogSegmentValueOmniPurchaseRoas, CatalogSegmentValueWebsitePurchaseRoas, ConversionValues, Conversions, ConvertedProductQuantity, ConvertedProductValue, CostPer15_secVideoView, CostPer2SecContinuousVideoView, CostPerActionType, CostPerAdClick, CostPerConversion, CostPerOneThousandAdImpression, CostPerOutboundClick, CostPerStoreVisitAction, CostPerThruplay, CostPerUniqueActionType, CostPerUniqueConversion, CostPerUniqueOutboundClick, InteractiveComponentTap, MobileAppPurchaseRoas, OutboundClicks, OutboundClicksCtr, PurchaseRoas, StoreVisitActions, UniqueActions, UniqueConversions, UniqueOutboundClicks, UniqueOutboundClicksCtr, UniqueVideoView15_sec, Video15_secWatchedActions, Video30_secWatchedActions, VideoAvgTimeWatchedActions, VideoContinuous2SecWatchedActions, VideoP100_watchedActions, VideoP25WatchedActions, VideoP50WatchedActions, VideoP75WatchedActions, VideoP95WatchedActions, VideoPlayActions, VideoPlayCurveActions, VideoPlayRetention0To15SActions, VideoPlayRetention20_to60SActions, VideoPlayRetentionGraphActions, VideoTimeWatchedActions, WebsiteCtr, WebsitePurchaseRoas
デフォルト値はActionsです。 |
AdAccountId | String | レポート行と関連のある広告アカウントのID。 |
AdAccountName | String | レポート行と関連のある広告アカウントの名前。 |
CampaignId | String | レポート行と関連のあるキャンペーンのID。 |
CampaignName | String | レポート行と関連のあるキャンペーンの名前。 |
AdSetId | String | レポート行と関連のある広告セットのID。 |
AdSetName | String | レポート行と関連のある広告セットの名前。 |
AdId | String | レポート行と関連のある広告のID。 |
AdName | String | レポート行と関連のある広告の名前。 |
ActionType | String | 広告が表示された後に広告、ページ、アプリ、イベント内で起こったアクションの種類(広告がクリックされなかった場合も含む)。 |
ActionValue | Integer | アトリビューションウィンドウのMetric 値。 |
Action1dClick | String | 広告をクリックした1日後のアトリビューションウィンドウのMetric 値。 |
Action1dView | String | 広告を見た1日後のアトリビューションウィンドウのMetric 値。 |
Action7dClick | String | 広告をクリックした7日後のアトリビューションウィンドウのMetric 値。 |
Action7dView | String | 広告を見た7日後のアトリビューションウィンドウのMetric 値。 |
Action28dClick | String | 広告をクリックした28日後のアトリビューションウィンドウのMetric 値。 |
Action28dView | String | 広告を見た28日後のアトリビューションウィンドウのMetric 値。 |
ActionDDA | String | Metric value of attribution window which is powered by data driven model. |
ActionCanvasComponentName | String | Canvas 広告内のコンポーネント名。 |
ActionCarouselCardId | String | あなたの広告を見た時の人々のカルーセルカードのID。 |
ActionCarouselCardName | String | あなたの広告を見た際の特定のカルーセルカード。カードはヘッドラインから特定されます。 |
ActionConvertedProductId | String | コンバートされた製品ID - 共同広告用 |
ActionDestination | String | あなたの広告をクリックした後の人々の行先。 |
ActionDevice | String | トラッキングしているコンバージョンイベントが起こったデバイス。 |
ActionReaction | String | あなたの広告もしくはブーストされた投稿へのリアクションの数。 |
ActionTargetId | String | あなたの広告をクリックした後の行先のID。 |
ActionVideoSound | String | 動画広告を見た際の音の(on/off) ステータス。 |
ActionVideoType | String | 動画指標のブレークダウン。 |
Age | String | この行の指標の年齢範囲。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
Country | String | この行の指標の国。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
DevicePlatform | String | 広告の表示に使うデバイスまたはプラットフォーム。このブレークダウンカラムは他のブレイクダウンカラムとは同時に選択できない場合があります。 |
DMA | String | 指定されたマーケティング範囲。このブレークダウンカラムは他のブレイクダウンカラムとは同時に選択できない場合があります。 |
FrequencyValue | String | リーチ&フリークエンシーキャンペーンの広告が一人に表示された回数。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
Gender | String | この行の指標の性別。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
HStatsByAdvertiserTZ | String | 広告主にスタッツが記録される期間。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
HStatsByAudienceTZ | String | オーディエンスにスタッツが記録される期間。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
ImpressionDevice | String | 広告の表示に使うデバイス。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
PlacePageId | String | 対応する場合に使われる場所ページ。このブレークダウンカラムは他のブレイクダウンカラムとは同時に選択できない場合があります。 |
PlatformPosition | String | プラットフォーム上の位置。 |
ProductId | String | 広告で宣伝されているプロダクトID。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
PublisherPlatform | String | 広告が掲載されたプラットフォーム。 |
Region | String | 広告が表示された地域。これはブレークダウンカラムです。このカラムを選択すると指標によって結果がさらにブレークダウンされます。 |
AdEffectiveStatus | String | 広告アカウントより低いレベルでインサイトを取得する際にサポートされているステータスの入力専用リスト。有効な値の例については、AdStatus にリストされている値を参照してください。 |
UseAsync | Boolean | インサイトの取得に非同期呼び出しを使用する必要があるかどうかを示すboolean。 |