Facebook 広告レポートの変換

このドキュメントでは、Facebook 広告から BigQuery への転送を実行するときに、Facebook 広告レポートがどのように変換されるかについて説明します。

Facebook 広告レポートのテーブル マッピング

Facebook 広告レポートを BigQuery に転送すると、レポートは次の BigQuery のテーブルとビューに変換されます。

AdAccounts レポート

Meta API のフィールド名 マッピングされた BigQuery フィールド名 型 説明
id ID [KEY] String 広告アカウントの ID。
ターゲット String 広告アカウントの取得に使用されるターゲット。この値は null です。すべての広告アカウントを取得します。
account_id AccountId String Facebook で直接表示された広告アカウントの ID。
account_status AccountStatus 整数 アカウントのステータス。1 = 有効、2 = 無効、3 = 未解決、7 = 審査待ち、9 = 猶予期間中、101 = 一時的に利用不可、100 = 閉鎖待ち。
age 年齢 ダブル 広告アカウントの開設から経過した日数。
amount_spent AmountSpent 整数 アカウントで現在までに使用した合計金額。これはリセットできます。
balance Balance 整数 請求額。
business_city BusinessCity String ビジネス拠点の住所の市区町村。
business_country_code BusinessCountryCode String ビジネス拠点の住所の国コード。
business_name BusinessName String アカウントのビジネス名。
business_state BusinessState String ビジネス拠点の住所の都道府県の略称。
business_street BusinessStreet String アカウントのビジネス拠点の番地の 1 行目。
business_street2 BusinessStreet2 String アカウントのビジネス拠点の番地の 2 行目。
business_zip BusinessZip String ビジネス拠点の郵便番号。
capabilities 機能 String この広告アカウントで許可されている機能。
created_time CreatedTime 日時 アカウントが作成された時刻。
currency 通貨 String アカウント設定の対応する値に基づいて、アカウントで使用される通貨。
min_campaign_group_spend_cap MinCampaignGroupSpendCap String キャンペーン グループの最小費用の上限。
name 名前 String アカウントの名前。多くのアカウントには名前がないため、このフィールドは空になることがあります。
offsite_pixels_tos_accepted OffsitePixelsTosAccepted String オフサイト ピクセルの利用規約契約が締結されたかどうかを示します。
owner OwnerId String 広告アカウントのオーナーの Facebook ID。
spend_cap SpendCap 整数 このアカウントで使用できる費用の上限。上限に達すると、キャンペーンは一時停止されます。値 0 は、費用の上限がないことを意味します。
timezone_id TimezoneId String タイムゾーンの ID。
timezone_name TimezoneName String タイムゾーンの名前。
timezone_offset_hours_utc TimezoneOffsetHoursUTC ダブル UTC とのタイムゾーンの差。

AdInsights レポート

Meta API のフィールド名 マッピングされた BigQuery フィールド名 型 説明
ターゲット String 分析情報を取得するアカウントの ID。
date_start DateStart 日付 分析情報を取得する開始日。Facebook の管理画面では、[レポートの開始日] フィールドです。
date_stop DateEnd 日付 分析情報を取得する期間の終了日。Facebook の管理画面では、[レポートの終了日] フィールドです。
TimeIncrement String データの集計期間の日数。この値は 1 に設定されています。
レベル String 結果を表示するレベル。この値は「ad」に設定されています。
account_currency AccountCurrency String 広告アカウントで使用されている通貨。
action_attribution_windows ActionAttributionWindows String アクションのアトリビューション ウィンドウを決定するカンマ区切りのリスト。たとえば、28d_click は、広告がクリックされてから 28 日以内に発生したすべてのアクションが API から返されることを意味します。このオプションは [1d_view,28d_click] に設定されています。
account_id AdAccountId String レポートの行に関連付けられている広告アカウントの ID。
account_name AdAccountName String レポートの行に関連付けられている広告アカウントの名前。
campaign_id CampaignId String レポートの行に関連付けられているキャンペーンの ID。
campaign_name CampaignName String レポートの行に関連付けられているキャンペーンの名前。
adset_id AdSetId String レポートの行に関連付けられている広告セットの ID。
adset_name AdSetName String レポートの行に関連付けられている広告セットの名前。
AdId ad_id String レポートの行に関連付けられている広告の ID。
ad_name AdName String レポートの行に関連付けられている広告の名前。
buying_type BuyingType String キャンペーンでターゲット広告のお支払いを行う方法。
clicks クリック数 長め 広告がクリックされた合計回数。プロモーションの内容に応じて、ページの「いいね」、イベントの応答、アプリのインストールなどが含まれます。Facebook の管理画面では、[クリック数（すべて）] フィールドです。
conversion_rate_ranking ConversionRateRanking String コンバージョン率のランキング。
cost_per_estimated_ad_recallers CostPerEstimatedAdRecallers 小数 2 日以内に広告を見たことを思い出すと推定される追加のユーザー 1 人あたりの平均費用。
cost_per_inline_link_click CostPerInlineLinkClick 小数 広告内のリンクのクリック 1 回あたりの平均費用。
cost_per_inline_post_engagement CostPerInlinePostEngagement 小数 投稿のエンゲージメントあたりの平均費用。
cost_per_unique_click CostPerUniqueClick 小数 これらの広告のユニーク クリックあたりの平均費用。費用をユニーク クリック数で割って算出されます。
cost_per_unique_inline_link_click CostPerUniqueInlineLinkClick 小数 ユニークなインライン リンクのクリック 1 回あたりの平均費用。
cpc CPC 小数 これらの広告の平均クリック単価。費用を獲得したクリック数で割って算出されます。
cpm CPM 小数 広告のインプレッション 1,000 回に対して支払った費用の平均額。
cpp CPP 小数 広告が 1,000 人のユニーク ユーザーに配信された場合に発生した費用の平均額。
ctr クリック率 ダブル クリック数をインプレッション数で割った値。Facebook の管理画面では、[CTR（すべて）%] フィールドです。
estimated_ad_recall_rate EstimatedAdRecallRate ダブル 広告を覚えていると推定されるユーザー数を、広告がリーチしたユーザー数で割った値です。
estimated_ad_recallers EstimatedAdRecallers ダブル 2 日以内に質問された場合に、広告を見たことを覚えていると思われるユーザーの追加数。
frequency Frequency ダブル 各ユーザーに広告が配信された平均回数。
impressions インプレッション 長め 広告が配信された回数。モバイルアプリでは、広告が初めて表示された時点で配信されたとカウントされます。他のすべての Facebook インターフェースでは、広告はユーザーのニュースフィードに初めて配置されたとき、または右側の列に配置されたときに配信されます。
inline_link_clicks InlineLinkClicks 長め 広告内のリンクのクリック数の合計。
inline_link_click_ctr InlineLinkClicksCounter ダブル リンクへのインライン クリックのクリック率。
inline_post_engagement InlinePostEngagement 長め 投稿のエンゲージメントの合計数。
instant_experience_clicks_to_open InstantExperienceClicksToOpen 長め META API の instant_experience_clicks_to_open フィールドに対応します。
instant_experience_clicks_to_start InstantExperienceClicksToStart 長め META API の instant_experience_clicks_to_start フィールドに対応します。
instant_experience_outbound_clicks InstantExperienceOutboundClicks 長め META API の instant_experience_outbound_clicks フィールドに対応します。
objective 目標 String キャンペーンに選択した目標。目標は、広告掲載で達成したい目標を反映します。
quality_ranking QualityRanking String 品質ランキング。
reach リーチ 長め 広告が表示されたユーザー数。
spend 支出 小数 これまでに使用した金額の合計。
UniqueClicks 長め 広告をクリックしたユニーク ユーザーの合計数。たとえば、3 人のユーザーが同じ広告を 5 回クリックした場合、3 回のユニーク クリックとしてカウントされます。
UniqueCTR ダブル 広告をクリックしたユーザー数を、リーチしたユーザー数で割った値です。たとえば、ユニーク クリック数が 20 回で、広告が配信されたユニーク ユーザー数が 1,000 人の場合、ユニーク クリック率は 2% となります。
inline_link_clicks UniqueInlineLinkClicks 長め 広告のインラインリンクがクリックされたユニーク ユーザー数。Facebook の管理画面では、[リンクへのユニーククリック数] フィールドです。
UniqueInlineLinkClickCounter ダブル リンクへのユニークなインライン クリックのクリック率。
UniqueLinkClicksCounter ダブル リンクへのクリックのユニーク クリック率。広告内のリンクをクリックして Facebook の外部に移動したユーザー数を、リーチしたユーザー数で割った値です。たとえば、リンクへのユニーク クリック数が 20 回で、広告がユニーク ユーザー 1,000 人に表示された場合は、ユニーク クリック率は 2% となります。
チェックイン Int 広告に起因するチェックインの数。
EventResponses Int 広告に起因するイベント レスポンス数。
inline_link_clicks LinkClicks Int 広告に起因するリンククリック数。
OfferSaves Int 広告に起因するオファーの受信数。
outbound_clicks OutboundClicks Int 広告に起因する外部リンクのクリック数。
PageEngagements Int 広告に起因するページ エンゲージメントの数。
PageLikes Int 広告に起因するページの高評価の数。
PageMentions Int 広告に起因するページの記述の数。
PagePhotoViews Int 広告に起因する写真の閲覧数。
PostComments Int 広告に起因する投稿コメントの数。
PostEngagements Int 広告に起因する投稿エンゲージメントの数。
PostShares Int 広告に起因する投稿の共有数。
PostReactions Int 広告に起因する投稿のリアクション数。
PageTabViews Int 広告に起因するタブビューの数。
Video3SecondViews Int 広告に起因する動画視聴回数。3 秒以上（3 秒未満の動画の場合は最後まで）再生された場合に視聴回数としてカウントされます。

AdInsightsActions レポート

Meta API のフィールド名 マッピングされた BigQuery フィールド名 型 説明
ターゲット String 分析情報を取得するアカウントの ID。
date_start DateStart 日付 分析情報を取得する開始日。Facebook の管理画面では、[レポートの開始日] フィールドです。
date_stop DateEnd 日付 分析情報を取得する終了日。Facebook の管理画面では、[レポートの終了日] フィールドです。
TimeIncrement String データの集計期間の日数。この値は 1 に設定されています。
レベル String 結果を表示するレベル。値は ad に設定されています。
action_attribution_windows ActionAttributionWindows String アクションのアトリビューション ウィンドウを決定するカンマ区切りのリスト。たとえば、28d_click は、広告がクリックされてから 28 日以内に発生したすべてのアクションが API から返されることを意味します。デフォルトのオプションは [1d_view,7d_click] です。有効な値は、1d_view、7d_view、28d_view、1d_click、7d_click、28d_click、default です。
ActionCollection String 取得するアクション コレクション。値は Actions に設定されています。
account_id AdAccountId String レポートの行に関連付けられている広告アカウントの ID。
account_name AdAccountName String レポートの行に関連付けられている広告アカウントの名前。
campaign_id CampaignId String レポートの行に関連付けられているキャンペーンの ID。
campaign_name CampaignName String レポートの行に関連付けられているキャンペーンの名前。
adset_id AdSetId String レポートの行に関連付けられている広告セットの ID。
adset_name AdSetName String レポートの行に関連付けられている広告セットの名前。
ad_id AdId String レポートの行に関連付けられている広告の ID。
ad_name AdName String レポートの行に関連付けられている広告の名前。
actions.action_type ActionType String ユーザーが広告を表示した後に、広告、ページ、アプリ、イベントで行われたアクション（ユーザーが広告をクリックしなかった場合でも）。
actions.value ActionValue 整数 デフォルトのアトリビューション ウィンドウの指標値。
actions.1d_click Action1dClick String 広告のクリックから 1 日後のアトリビューション期間の指標値。
actions.1d_view Action1dView String 広告の視聴から 1 日後のアトリビューション期間の指標値。
actions.7d_click Action7dClick String 広告のクリックから 7 日間のアトリビューション期間の指標値。
actions.7d_view Action7dView String 広告の視聴から 7 日間のアトリビューション期間の指標値。
actions.28d_click Action28dClick String 広告のクリックから 28 日間のアトリビューション期間の指標値。
actions.28d_view Action28dView String 広告の視聴から 28 日後のアトリビューション期間の指標値。
actions.dda ActionDDA String データドリブン モデルに基づくアトリビューション ウィンドウの指標値。
actions.action_canvas_component_name ActionCanvasComponentName String キャンバス広告内のコンポーネントの名前。
actions.action_carousel_card_id ActionCarouselCardId String 広告を見たユーザーが操作したカルーセル カードの ID。
actions.action_carousel_card_name ActionCarouselCardName String 広告を見たユーザーが操作したカルーセル カード。カードは見出しで識別されます。
actions.action_destination ActionDestination String 広告をクリックしたユーザーに表示されるページの URL です。
actions.action_device ActionDevice String トラッキングしているコンバージョン イベントが発生したデバイス。
actions.action_reaction ActionReaction String 広告またはブーストされた投稿に対するリアクションの数。
actions.action_target_id ActionTargetId String 広告をクリックしたユーザーの移動先の ID。
actions.action_video_sound ActionVideoSound String ユーザーが動画広告を視聴したときのサウンドのステータス（オン/オフ）。