透過集合功能整理內容
你可以依據偏好儲存及分類內容。
本文件說明將 Facebook Ads 資料移轉至 BigQuery時,如何轉換 Facebook Ads 報表。
Facebook Ads 報表的資料表對應
當您的 Facebook Ads 報表移轉至 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 使用者介面中,這個欄位為「Report End」(報表結束時間)。 |
|
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 UI 中,這個欄位為「點閱率 (全部)」%。 |
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 UI 中,這會是「連結點擊次數」欄位。 |
|
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 使用者介面中,這個欄位為「Report End」(報表結束時間)。 |
|
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-07-14 (世界標準時間)。
[[["容易理解","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-07-14 (世界標準時間)。"],[],[]]