このページの一部またはすべての情報は、S3NS の Trusted Cloud に適用されない場合があります。
このドキュメントでは、Facebook 広告から BigQuery への転送を実行するときに、Facebook 広告レポートがどのように変換されるかについて説明します。
Facebook 広告レポートのテーブル マッピング
Facebook 広告レポートを BigQuery に転送すると、レポートは次の BigQuery のテーブルとビューに変換されます。
AdAccounts
レポート
Meta API のフィールド名 |
マッピングされた BigQuery フィールド名 |
タイプ |
説明 |
id |
ID [KEY] |
文字列 |
広告アカウントの ID。 |
|
ターゲット |
文字列 |
広告アカウントの取得に使用されるターゲット。この値は null です。すべての広告アカウントを取得します。 |
account_id |
AccountId |
文字列 |
Facebook で直接表示された広告アカウントの ID。 |
account_status |
AccountStatus |
整数 |
アカウントのステータス。1 = 有効、2 = 無効、3 = 未決済、7 = 審査待ち、9 = 猶予期間中、101 = 一時的に利用不可、100 = 閉鎖待ち。 |
age |
年齢 |
倍精度 |
広告アカウントの開設から経過した日数。 |
amount_spent |
AmountSpent |
整数 |
アカウントで現在までに使用した合計金額。これはリセットできます。 |
balance |
バランス |
整数 |
請求額。 |
business_city |
BusinessCity |
文字列 |
ビジネス拠点の住所の市区町村。 |
business_country_code |
BusinessCountryCode |
文字列 |
ビジネス拠点の住所の国コード。 |
business_name |
BusinessName |
文字列 |
アカウントのビジネス名。 |
business_state |
BusinessState |
文字列 |
ビジネス拠点の住所の都道府県の略称。 |
business_street |
BusinessStreet |
文字列 |
アカウントのビジネス拠点の番地の 1 行目。 |
business_street2 |
BusinessStreet2 |
文字列 |
アカウントのビジネス拠点の番地の 2 行目。 |
business_zip |
BusinessZip |
文字列 |
ビジネス拠点の郵便番号。 |
capabilities |
機能 |
文字列 |
この広告アカウントで許可されている機能。 |
created_time |
CreatedTime |
日時 |
アカウントが作成された時刻。 |
currency |
通貨 |
文字列 |
アカウント設定の対応する値に基づいて、アカウントで使用される通貨。 |
min_campaign_group_spend_cap |
MinCampaignGroupSpendCap |
文字列 |
キャンペーン グループの最小費用の上限。 |
name |
名前 |
文字列 |
アカウントの名前。多くのアカウントには名前がないため、このフィールドは空になることがあります。 |
offsite_pixels_tos_accepted |
OffsitePixelsTosAccepted |
文字列 |
オフサイトで Google Pixel の利用規約契約が締結されたかどうかを示します。 |
owner |
OwnerId |
文字列 |
広告アカウントのオーナーの Facebook ID。 |
spend_cap |
SpendCap |
整数 |
このアカウントで使用できる費用の上限。上限に達すると、キャンペーンは一時停止されます。値 0 は、費用の上限がないことを意味します。 |
timezone_id |
TimezoneId |
文字列 |
タイムゾーンの ID。 |
timezone_name |
TimezoneName |
文字列 |
タイムゾーンの名前。 |
timezone_offset_hours_utc |
TimezoneOffsetHoursUTC |
倍精度 |
UTC とのタイムゾーンの差。 |
AdInsights
レポート
Meta API のフィールド名 |
マッピングされた BigQuery フィールド名 |
タイプ |
説明 |
|
ターゲット |
文字列 |
分析情報を取得するアカウントの ID。 |
date_start |
DateStart |
日付 |
分析情報を取得する開始日。Facebook の管理画面では、[レポートの開始日] フィールドです。 |
date_stop |
DateEnd |
日付 |
分析情報を取得する期間の終了日。Facebook の管理画面では、[レポートの終了日] フィールドです。 |
|
TimeIncrement |
文字列 |
データの集計期間の日数。この値は 1 に設定されています。 |
|
レベル |
文字列 |
結果を表示するレベル。この値は「ad」に設定されています。 |
account_currency |
AccountCurrency |
文字列 |
広告アカウントで使用されている通貨。 |
action_attribution_windows |
ActionAttributionWindows |
文字列 |
アクションのアトリビューション ウィンドウを決定するカンマ区切りのリスト。たとえば、28d_click は、広告がクリックされてから 28 日以内に発生したすべてのアクションが API から返されることを意味します。このオプションは [1d_view,28d_click] に設定されています。 |
account_id |
AdAccountId |
文字列 |
レポートの行に関連付けられている広告アカウントの ID。 |
account_name |
AdAccountName |
文字列 |
レポートの行に関連付けられている広告アカウントの名前。 |
campaign_id |
CampaignId |
文字列 |
レポートの行に関連付けられているキャンペーンの ID。 |
campaign_name |
CampaignName |
文字列 |
レポートの行に関連付けられているキャンペーンの名前。 |
adset_id |
AdSetId |
文字列 |
レポートの行に関連付けられている広告セットの ID。 |
adset_name |
AdSetName |
文字列 |
レポートの行に関連付けられている広告セットの名前。 |
ad_id |
AdId |
文字列 |
レポートの行に関連付けられている広告の ID。 |
ad_name |
AdName |
文字列 |
レポートの行に関連付けられている広告の名前。 |
buying_type |
BuyingType |
文字列 |
キャンペーンでターゲット広告のお支払いを行う方法。 |
clicks |
クリック数 |
長整数 |
広告がクリックされた合計回数。プロモーションの内容に応じて、ページの「いいね」、イベントの応答、アプリのインストールなどが含まれます。Facebook の管理画面では、[クリック数(すべて)] フィールドです。 |
conversion_rate_ranking |
ConversionRateRanking |
文字列 |
コンバージョン率のランキング。 |
cost_per_estimated_ad_recallers |
CostPerEstimatedAdRecallers |
10 進数 |
2 日以内に広告を見たことを覚えている可能性のある追加のユーザー 1 人あたりの推定平均費用。 |
cost_per_inline_link_click |
CostPerInlineLinkClick |
10 進数 |
広告内のリンクの平均クリック単価。 |
cost_per_inline_post_engagement |
CostPerInlinePostEngagement |
10 進数 |
投稿の平均エンゲージメント単価。 |
cost_per_unique_click |
CostPerUniqueClick |
10 進数 |
これらの広告のユニーク クリックあたりの平均費用。費用を一意のクリック数で割って算出されます。 |
cost_per_unique_inline_link_click |
CostPerUniqueInlineLinkClick |
10 進数 |
各ユニーク インライン リンクのクリック 1 回あたりの平均費用。 |
cpc |
CPC |
10 進数 |
これらの広告の平均クリック単価。費用をクリック数で割って算出されます。 |
cpm |
インプレッション単価 |
10 進数 |
広告のインプレッション 1,000 回に対して支払った費用の平均額。 |
cpp |
CPP |
10 進数 |
広告が 1,000 人のユニーク ユーザーに配信された場合に発生した費用の平均額。 |
ctr |
クリック率 |
倍精度 |
クリック数をインプレッション数で割った値。Facebook の管理画面では、[クリック率(すべて)%] フィールドです。 |
estimated_ad_recall_rate |
EstimatedAdRecallRate |
倍精度 |
広告を覚えていると推定されるユーザー数を、広告がリーチしたユーザー数で割った値です。 |
estimated_ad_recallers |
EstimatedAdRecallers |
倍精度 |
2 日以内に質問された場合に、広告を見たことを覚えていると思われるユーザーの追加数。 |
frequency |
頻度 |
倍精度 |
1 人のユーザーに広告が配信された平均回数。 |
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 |
目標 |
文字列 |
キャンペーンに選択した目標。目標は、広告掲載で達成したい目標を反映します。 |
quality_ranking |
QualityRanking |
文字列 |
品質ランキング。 |
reach |
リーチ |
長整数 |
広告が表示されたユーザー数。 |
spend |
支出 |
10 進数 |
これまでに使用した金額の合計。 |
|
UniqueClicks |
長整数 |
広告をクリックした一意のユーザーの合計数。たとえば、3 人のユーザーが同じ広告を 5 回クリックした場合、3 回のユニーク クリックとしてカウントされます。 |
|
UniqueCTR |
倍精度 |
広告をクリックしたユーザー数を、リーチしたユーザー数で割った値。たとえば、ユニーク クリック数が 20 回で、広告が配信されたユニーク ユーザー数が 1,000 人の場合、ユニーク クリック率は 2% となります。 |
inline_link_clicks |
UniqueInlineLinkClicks |
長整数 |
広告が獲得したユニーク インライン リンクのクリック数。Facebook の管理画面では、[リンクへのユニーク クリック数] フィールドです。 |
|
UniqueInlineLinkClickCounter |
倍精度 |
リンクへのユニーク インライン クリックのクリック率。 |
|
UniqueLinkClicksCounter |
倍精度 |
リンクへのクリックのユニーク クリック率。広告内のリンクをクリックして Facebook の外部に移動したユーザー数を、リーチしたユーザー数で割った値です。たとえば、リンクへのユニーク クリック数が 20 回で、広告がユニーク ユーザー 1,000 人に表示された場合は、ユニーク クリック率は 2% となります。 |
|
Checkins |
整数型 |
広告に起因するチェックインの数。 |
|
EventResponses |
整数型 |
広告に起因するイベント レスポンス数。 |
inline_link_clicks |
LinkClicks |
整数型 |
広告に起因するリンククリック数。 |
|
OfferSaves |
整数型 |
広告に起因するオファーの受信数。 |
outbound_clicks |
OutboundClicks |
整数型 |
広告に起因する離脱クリック数。 |
|
PageEngagements |
整数型 |
広告に起因するページ エンゲージメント数。 |
|
PageLikes |
整数型 |
広告に起因するページ高評価の数。 |
|
PageMentions |
整数型 |
広告に起因するページ言及の数。 |
|
PagePhotoViews |
整数型 |
広告に起因する写真の閲覧数。 |
|
PostComments |
整数型 |
広告に起因する投稿コメント数。 |
|
PostEngagements |
整数型 |
広告に起因する投稿エンゲージメントの数。 |
|
PostShares |
整数型 |
広告に起因する投稿の共有数。 |
|
PostReactions |
整数型 |
広告に起因する投稿のリアクション数。 |
|
PageTabViews |
整数型 |
広告に起因するタブビューの数。 |
|
地域 |
文字列 |
ユーザーが広告を見た地域。これは内訳フィールドです。 |
|
Video3SecondViews |
整数型 |
広告に起因する動画視聴回数。3 秒以上再生された場合、または動画全体が再生された場合(動画が 3 秒未満の場合)に、視聴回数としてカウントされます。 |
AdInsightsActions
レポート
Meta API のフィールド名 |
マッピングされた BigQuery フィールド名 |
タイプ |
説明 |
|
ターゲット |
文字列 |
分析情報を取得するアカウントの ID。 |
date_start |
DateStart |
日付 |
分析情報を取得する開始日。Facebook の管理画面では、[レポートの開始日] フィールドです。 |
date_stop |
DateEnd |
日付 |
分析情報を取得する終了日。Facebook の管理画面では、[レポートの終了日] フィールドです。 |
|
TimeIncrement |
文字列 |
データの集計期間の日数。この値は 1 に設定されています。 |
|
レベル |
文字列 |
結果を表示するレベル。値は ad に設定されています。 |
action_attribution_windows |
ActionAttributionWindows |
文字列 |
アクションのアトリビューション ウィンドウを決定するカンマ区切りのリスト。たとえば、28d_click は、広告がクリックされてから 28 日以内に発生したすべてのアクションが API から返されることを意味します。デフォルトのオプションは [1d_view,7d_click] です。有効な値は、1d_view、7d_view、28d_view、1d_click、7d_click、28d_click、default です。 |
|
ActionCollection |
文字列 |
取得するアクション コレクション。値は Actions に設定されています。 |
account_id |
AdAccountId |
文字列 |
レポートの行に関連付けられている広告アカウントの ID。 |
account_name |
AdAccountName |
文字列 |
レポートの行に関連付けられている広告アカウントの名前。 |
campaign_id |
CampaignId |
文字列 |
レポートの行に関連付けられているキャンペーンの ID。 |
campaign_name |
CampaignName |
文字列 |
レポートの行に関連付けられているキャンペーンの名前。 |
adset_id |
AdSetId |
文字列 |
レポートの行に関連付けられている広告セットの ID。 |
adset_name |
AdSetName |
文字列 |
レポートの行に関連付けられている広告セットの名前。 |
ad_id |
AdId |
文字列 |
レポートの行に関連付けられている広告の ID。 |
ad_name |
AdName |
文字列 |
レポートの行に関連付けられている広告の名前。 |
actions.value |
ActionValue |
整数 |
デフォルトのアトリビューション ウィンドウの指標値。 |
actions.1d_click |
Action1dClick |
文字列 |
広告のクリックから 1 日後のアトリビューション期間の指標値。 |
actions.1d_view |
Action1dView |
文字列 |
広告の視聴から 1 日後のアトリビューション期間の指標値。 |
actions.7d_click |
Action7dClick |
文字列 |
広告のクリックから 7 日間のアトリビューション期間の指標値。 |
actions.7d_view |
Action7dView |
文字列 |
広告の視聴から 7 日間のアトリビューション期間の指標値。 |
actions.28d_click |
Action28dClick |
文字列 |
広告のクリックから 28 日後のアトリビューション期間の指標値。 |
actions.28d_view |
Action28dView |
文字列 |
広告の視聴から 28 日後のアトリビューション期間の指標値。 |
actions.dda |
ActionDDA |
文字列 |
データドリブン モデルに基づくアアトリビューション期間の指標値。 |
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2025-08-21 UTC。
[[["わかりやすい","easyToUnderstand","thumb-up"],["問題の解決に役立った","solvedMyProblem","thumb-up"],["その他","otherUp","thumb-up"]],[["必要な情報がない","missingTheInformationINeed","thumb-down"],["複雑すぎる / 手順が多すぎる","tooComplicatedTooManySteps","thumb-down"],["最新ではない","outOfDate","thumb-down"],["翻訳に関する問題","translationIssue","thumb-down"],["サンプル / コードに問題がある","samplesCodeIssue","thumb-down"],["その他","otherDown","thumb-down"]],["最終更新日 2025-08-21 UTC。"],[],[]]