Facebook Ads 报告转换

本文档介绍了将 Facebook Ads 转移到 BigQuery 时 Facebook Ads 报告的转换方式。

Facebook Ads 报告的表映射

当 Facebook Ads 报告转移到 BigQuery 时，报告会转换为以下 BigQuery 表和视图。

AdAccounts 报告

Meta API 字段名称 映射的 BigQuery 字段名称 类型 说明
id ID [KEY] 字符串 广告账号的 ID。
Target 字符串 用于获取广告账号的目标。此值为“null”，表示获取所有广告账号。
account_id AccountId 字符串 直接在 Facebook 中查看时广告账号的 ID。
account_status AccountStatus 整数 账号的状态。1 = 有效；2 = 已停用；3 = 未结算；7 = 待审核；9 = 处于宽限期；101 = 暂时不可用；100 = 待关闭。
age 年龄 双精度型 广告账号开通的时间量（以天为单位）。
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 Name 字符串 账号名称；请注意，许多账号都没有名称，因此此字段可能为空。
offsite_pixels_tos_accepted OffsitePixelsTosAccepted 字符串 指示是否已签署 offsite pixel 服务条款合同。
owner OwnerId 字符串 广告账号所有者的 Facebook ID。
spend_cap SpendCap 整数 此账号的支出上限，超出此上限后广告系列将被暂停。值为 0 表示不设支出上限。
timezone_id TimezoneId 字符串 时区的 ID。
timezone_name TimezoneName 字符串 时区的名称。
timezone_offset_hours_utc TimezoneOffsetHoursUTC 双精度型 与世界协调时间 (UTC) 的时区差。

AdInsights 报告

Meta API 字段名称 映射的 BigQuery 字段名称 类型 说明
Target 字符串 要获取其数据分析的账号的 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 点击率 双精度型 您获得的点击次数除以展示次数所得的值。在 Facebook 界面中，此字段为“点击率（全部）%”。
estimated_ad_recall_rate EstimatedAdRecallRate 双精度型 回想过您广告的用户人数估算值除以广告覆盖的用户人数。
estimated_ad_recallers EstimatedAdRecallers 双精度型 我们估计在 2 天内，如果有人询问，会有更多人会记得看到过您的广告。
frequency 频率 双精度型 您的广告向每位用户展示的平均次数。
impressions 展示次数 长 您的广告投放的次数。在移动应用中，广告在首次被观看时即计为投放。在所有其他 Facebook 界面中，广告会在首次展示在用户的动态中或每次展示在右侧列中时计为一次展示。
inline_link_clicks InlineLinkClicks 长 用户点击广告中链接的总次数。
inline_link_click_ctr InlineLinkClicksCounter 双精度型 内嵌链接的点击率。
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 Reach 长 您的广告的展示次数。
spend 支出 小数 您目前支出的总金额。
UniqueClicks 长 点击过您的广告的唯一身份用户总数。例如，如果 3 位用户点击同一广告 5 次，则系统会将其计为 3 次唯一身份点击。
UniqueCTR 双精度型 点击广告的用户数除以覆盖的用户数。例如，如果您获得了 20 次唯一身份点击，并且您的广告向 1,000 名唯一身份用户投放，那么您的唯一身份点击率就是 2%。
inline_link_clicks UniqueInlineLinkClicks 长 您的广告获得的唯一身份内嵌链接点击次数。在 Facebook 界面中，此字段为“唯一身份链接点击次数”。
UniqueInlineLinkClickCounter 双精度型 指向链接的唯一身份内嵌点击的点击率。
UniqueLinkClicksCounter 双精度型 链接点击的唯一身份点击率。点击广告中指向 Facebook 以外网站的链接的用户数除以触达的用户数。例如，如果您获得了 20 次唯一身份用户点击链接，并且您的广告向 1,000 名唯一身份用户展示，那么您的唯一身份用户点击率就是 2%。
Checkins 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 字段名称 类型 说明
Target 字符串 要获取其数据分析的账号的 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 字符串 由以数据为依据的模型提供支持的归因回溯期的指标值。