Facebook 廣告報表轉換

本文件說明將 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 字串 以數據為準歸因模式支援的歸因時間窗口指標值。