Facebook 廣告報表轉換
本文說明將 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 秒),就會計為一次觀看。 |
一般細目 | |||
|
年齡 | 字串 | 這列指標的年齡範圍。 |
|
性別 | 字串 | 這列指標的性別。 |
|
國家/地區 | 字串 | 這個資料列中指標的國家/地區。 |
|
區域 | 字串 | 使用者觀看廣告的區域。 |
|
FrequencyValue | 字串 | 觸及和頻率廣告活動中的廣告向每位使用者放送的次數。 |
|
HStatsByAdvertiserTZ | 字串 | 廣告主統計資料的計算時間範圍。 |
|
HStatsByAudienceTZ | 字串 | 目標對象的統計資料所涵蓋的時間範圍。 |
|
ImpressionDevice | 字串 | 用來觀看廣告的裝置。 |
|
PlatformPosition | 字串 | 平台上的位置。 |
|
PublisherPlatform | 字串 | 廣告發布平台。 |
|
ProductId | 字串 | 廣告中宣傳的產品 ID。 |
「AdInsightsActions
」報表
ACTION_COLLECTION
是指使用者對廣告採取的行動類型。如需動作集合的完整清單,請參閱「動作集合」。
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 | 字串 | 這項資訊來自您在轉移時選擇的動作集合。 |
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 | 字串 | 與報表列相關聯的廣告名稱。 |
ACTION_COLLECTION.value |
ActionValue | 整數 | 預設歸因期間的指標值。 |
ACTION_COLLECTION.1d_click |
Action1dClick | 字串 | 廣告獲得點擊後 1 天的歸因期指標值。 |
ACTION_COLLECTION.1d_view |
Action1dView | 字串 | 歸因回溯期為 1 天時的指標值。 |
ACTION_COLLECTION.7d_click |
Action7dClick | 字串 | 廣告獲得點擊後 7 天的歸因期指標值。 |
ACTION_COLLECTION.7d_view |
Action7dView | 字串 | 廣告觀看後 7 天的歸因回溯期指標值。 |
ACTION_COLLECTION.28d_click |
Action28dClick | 字串 | 廣告獲得點擊後 28 天的歸因期指標值。 |
ACTION_COLLECTION.28d_view |
Action28dView | 字串 | 歸因期為觀看廣告後 28 天的指標值。 |
ACTION_COLLECTION.dda |
ActionDDA | 字串 | 歸因期間的指標值,由以數據為準模式提供。 |
一般細目 | |||
|
年齡 | 字串 | 這列指標的年齡範圍。 |
|
性別 | 字串 | 這列指標的性別。 |
|
國家/地區 | 字串 | 這個資料列中指標的國家/地區。 |
|
區域 | 字串 | 使用者觀看廣告的區域。 |
|
FrequencyValue | 字串 | 觸及和頻率廣告活動中的廣告向每位使用者放送的次數。 |
|
HStatsByAdvertiserTZ | 字串 | 廣告主統計資料的計算時間範圍。 |
|
HStatsByAudienceTZ | 字串 | 目標對象的統計資料所涵蓋的時間範圍。 |
|
ImpressionDevice | 字串 | 用來觀看廣告的裝置。 |
|
PlatformPosition | 字串 | 平台上的位置。 |
|
PublisherPlatform | 字串 | 廣告發布平台。 |
|
ProductId | 字串 | 廣告中宣傳的產品 ID。 |
動作細目 | |||
ActionType | 字串 | 使用者看到廣告後採取的動作,即使他們沒有點擊廣告也算在內。 | |
ActionCanvasComponentName | 字串 | 畫布廣告中的元件名稱。 | |
ActionCarouselCardId | 字串 | 使用者看到廣告時互動的特定輪播資訊卡 ID。 | |
ActionCarouselCardName | 字串 | 使用者看到廣告時與之互動的特定輪播資訊卡。資訊卡會以標題識別。 | |
ActionDestination | 字串 | 使用者點按廣告後前往的到達網頁。 | |
ActionDevice | 字串 | 您追蹤的轉換事件發生所在的裝置。 | |
ActionReaction | 字串 | 廣告或加強推廣貼文的表情符號回應次數。 | |
ActionTargetId | 字串 | 使用者點按廣告後前往的到達網頁 ID。 | |
ActionVideoSound | 字串 | 使用者觀看影片廣告時的音效狀態 (開啟/關閉)。 | |
ActionVideoType | 字串 | 影片指標細目。 | |
ActionConvertedProductId | 字串 | 已轉換的產品 ID - 適用於協作廣告。 |