Excel Add-In for Facebook Ads

Build 24.0.9062

AdInsightsActions

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

テーブル固有の情報

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

Select

AdInsightsActions を要求する場合は、Target を含める必要があります。Target は、インサイトを取得するエレメントを指定します。 対象Target は、AdAccount、Campaign、AdSet、またはAd です。 次に例を示します。
SELECT * FROM AdInsightsActions WHERE Target = 'act_123456'
Adinsightsactions に対するSELECT * クエリでデフォルトで常にフェッチされるカラム:

  • Target
  • DateStart
  • DateEnd
  • AdAccountId
  • AdAccountName

指標カラム

Adinsightsactions レポートでSELECT * クエリを実行する場合、すべての指標カラムがFacebook から取得されるわけではありません。これは、カラムメタデータが過去のリクエストで取得された場合、特定のカラムが "0" またはNULL 値を返す可能性があることを意味します。

Adinsightsaction でこの挙動を示す可能性のある指標カラムは、以下のとおりです。

  • ActionType
  • ActionValue
  • Action1dClick
  • Action1dView
  • Action7dClick
  • Action7dView
  • Action28dClick
  • Action28dView
  • ActionDDA

ActionAttributionWindows

アトリビューションウィンドウのカンマ区切りのリストを入力するには、ActionAttributionWindows を使用します。次に例を示します。
SELECT * FROM AdInsightsActions WHERE Target = 'act_123456' AND level = 'ad' AND ActionAttributionWindows = '1d_view,7d_view,28d_click'

ActionCollection

AdInsightsActions から取得する特定のコレクションを指定するには、ActionCollection を使用します。 コレクションが指定されない場合、ドライバーはデフォルトでActions を使用します。 それぞれのインプットは、アクションのコレクションが返されるAdInsights からの使用可能なカラムを表します。

複数のコレクションを指定するには、IN 句でActionCollection を使用します。

次に例を示します。

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

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

ブレークダウンカラム

AdInsights からの有効なセレクションクライテリアと同様に、Adinsightsactions レポートでもブレークダウンが使用可能です。ブレークダウンについて、詳しくはAdInsights を参照してください。

AdInsightsActions で利用可能なその他のブレークダウンは以下のとおりです。

  • ActionType
  • ActionCanvasComponentName
  • ActionCarouselCardId
  • ActionCarouselCardName
  • ActionDestination
  • ActionDevice
  • ActionLinkClickDestination
  • ActionReaction
  • ActionTargetId
  • ActionVideoSound
  • ActionVideoType

Managing Query Size

Sometimes if a query is too large for Facebook to process on its end, you might receive this error: Please reduce the amount of data you're asking for, then retry your request. The error appears to be triggered by individually dense fields, and not the page size.

If the 本製品 encounters this error when first executing certain types of queries, the driver attempts to retry the query at the next lowest level of ad object, down to the level defined in RetryLevel, as long as the query does not include the Level parameter. (If the Level parameter is specified in a query, the driver does not attempt to retry beyond the ad object level specified by Level. For further information, see RetryLevel.) Note that since spreading queries across more granular ad objects increases the number of requests executed for the query, it can decrease query performance.

If you continue to receive this error, try either reducing the date range of the query, or removing 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. If you get the same error, reduce the remaining columns by half and try again. If you do not get an error, add back half of the columns you just removed, and try again.

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。

Copyright (c) 2024 CData Software, Inc. - All rights reserved.
Build 24.0.9062