提供意見
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本文說明將 Facebook Ads 資料移轉至 BigQuery 時,Facebook Ads 報表的轉換方式。
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
年齡
Double
廣告帳戶的開通時間 (以天為單位)。
amount_spent
AmountSpent
整數
帳戶目前的支出總金額。這項設定可以重設。
balance
餘額
整數
應付帳單金額。
business_city
BusinessCity
字串
商家地址所在的城市。
business_country_code
BusinessCountryCode
字串
商家地址的國家/地區代碼。
business_name
BusinessName
字串
帳戶的商家名稱。
business_state
BusinessState
字串
公司地址的州別縮寫。
business_street
BusinessStreet
字串
帳戶的商家街道地址第一行。
business_street2
BusinessStreet2
字串
帳戶的商家街道地址第二行。
business_zip
BusinessZip
字串
商家地址的郵遞區號。
capabilities
功能
字串
這個廣告帳戶可使用的功能。
created_time
CreatedTime
日期時間
帳戶建立時間。
currency
幣別
字串
帳戶使用的幣別,以帳戶設定中的相應值為準。
min_campaign_group_spend_cap
MinCampaignGroupSpendCap
字串
廣告活動群組的最低支出限制。
name
名稱
字串
帳戶名稱;請注意,許多帳戶沒有名稱,因此這個欄位可能會空白。
offsite_pixels_tos_accepted
OffsitePixelsTosAccepted
字串
指出是否已簽署站外像素服務條款合約。
owner
OwnerId
字串
廣告帳戶擁有者的 Facebook ID。
spend_cap
SpendCap
整數
這個帳戶可支出的最高金額,超過這個金額後,廣告活動就會暫停。如果值為 0,表示沒有支出上限。
timezone_id
TimezoneId
字串
時區 ID。
timezone_name
TimezoneName
字串
時區名稱。
timezone_offset_hours_utc
TimezoneOffsetHoursUTC
Double
與世界標準時間的時差。
「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 表示 API 會傳回使用者點按廣告後 28 天內的所有動作。這個選項設為 [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
十進位
如果我們估計在 2 天內詢問使用者,他們會回憶起看過您的廣告,則每位額外使用者的平均費用。
cost_per_inline_link_click
CostPerInlineLinkClick
十進位
廣告中連結的平均單次點擊出價。
cost_per_inline_post_engagement
CostPerInlinePostEngagement
十進位
貼文的平均單次參與出價。
cost_per_unique_click
CostPerUniqueClick
十進位
這些廣告的平均單次不重複點擊出價,計算方式為支出金額除以獲得的不重複點擊次數。
cost_per_unique_inline_link_click
CostPerUniqueInlineLinkClick
十進位
您為每次不重複的內嵌連結點擊支付的平均費用。
cpc
單次點擊出價
十進位
這些廣告的平均單次點擊出價,計算方式為支出金額除以獲得的點擊次數。
cpm
千次曝光出價
十進位
您為廣告每獲得 1,000 次曝光所支付的平均費用。
cpp
單次通話成本
十進位
廣告每觸及 1,000 位不重複使用者,您支付的平均費用。
ctr
點閱率
Double
獲得的點擊次數除以曝光次數。在 Facebook 使用者介面中,這是「點閱率 (全部)」% 欄位。
estimated_ad_recall_rate
EstimatedAdRecallRate
Double
預估記得廣告的人數除以廣告觸及人數。
estimated_ad_recallers
EstimatedAdRecallers
Double
我們預估在 2 天內詢問時,會記得看過您廣告的人數。
frequency
頻率
Double
廣告向每位使用者放送的平均次數。
impressions
曝光次數
長
廣告放送次數。在行動應用程式中,廣告首次顯示時,系統就會計算為一次放送。在所有其他 Facebook 介面中,廣告會在首次顯示於使用者的動態消息時放送,或每次顯示於右欄時放送。
inline_link_clicks
InlineLinkClicks
長
廣告中連結的總點擊次數。
inline_link_click_ctr
InlineLinkClicksCounter
Double
連結的內嵌點擊點閱率。
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
支出
十進位
到目前為止的總支出金額。
UniqueClicks
長
點擊廣告的不重複使用者總人數。舉例來說,如果 3 位使用者點擊同一則廣告 5 次,系統會計為 3 次不重複點擊。
UniqueCTR
Double
點按廣告的人數除以觸及人數。舉例來說,如果您獲得 20 次不重複點擊,且廣告向 1,000 位不重複使用者放送,則不重複點閱率為 2%。
inline_link_clicks
UniqueInlineLinkClicks
長
廣告獲得的不重複內嵌連結點擊次數。在 Facebook 使用者介面中,這是「不重複連結點擊次數」欄位。
UniqueInlineLinkClickCounter
Double
連結的不重複內嵌點擊點閱率。
UniqueLinkClicksCounter
Double
連結點擊的不重複點閱率。將點按廣告中導向 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 欄位名稱
類型
說明
目標
字串
要取得洞察資料的帳戶 ID。
date_start
DateStart
日期
要擷取洞察資料的起始日期。在 Facebook 使用者介面中,這是「報表開始」欄位。
date_stop
DateEnd
日期
要擷取洞察資料的結束日期。在 Facebook 使用者介面中,這是「報表結束」欄位。
TimeIncrement
字串
資料匯總的天數。這個值設為 1。
等級
字串
代表結果的層級。值是在 ad
設定。
action_attribution_windows
ActionAttributionWindows
字串
以半形逗號分隔的清單,用於決定動作的歸因回溯期。舉例來說,28d_click 表示 API 會傳回使用者點按廣告後 28 天內的所有動作。預設選項為 [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
字串
歸因期間的指標值,由以數據為準模式提供。
提供意見
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權 ,程式碼範例則為阿帕契 2.0 授權 。詳情請參閱《Google Developers 網站政策 》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-09-04 (世界標準時間)。
想進一步說明嗎?
[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間:2025-09-04 (世界標準時間)。"],[],[],null,["# Facebook Ads report transformation\n==================================\n\n|\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n| **Note:** To get support or provide feedback for this feature, contact [dts-preview-support@google.com](mailto:dts-preview-support@google.com).\n\nThis document describes how your Facebook Ads reports are\ntransformed when you [run a Facebook Ads transfer to BigQuery](/bigquery/docs/facebook-ads-transfer).\n\nTable mapping for Facebook Ads reports\n--------------------------------------\n\nWhen your Facebook Ads reports are transferred\nto BigQuery, the reports are transformed into the following\nBigQuery tables and views.\n\n### `AdAccounts` report\n\n### `AdInsights` report\n\n### `AdInsightsActions` report"]]