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 - 適用於協作廣告。 | |