Facebook Ads 报告转换

本文档介绍了在您将 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 相对于世界协调时间 (UTC) 的时差。

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 字符串 与报告行关联的广告组的名称。
AdId ad_id 字符串 与报告行关联的广告的 ID。
ad_name AdName 字符串 与报告行关联的广告的名称。
buying_type BuyingType 字符串 在广告系列中为目标广告付费的方式。
clicks 点击次数 Long 您的广告获得的总点击次数。这可能包括网页赞、活动回复或应用安装,具体取决于您要宣传的内容。在 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 展示次数 Long 您的广告投放的次数。在移动应用中,广告在首次被观看时即计为投放了一次。在所有其他 Facebook 界面中,广告会在首次展示在用户的动态中或每次展示在右侧列中时计为一次展示。
inline_link_clicks InlineLinkClicks Long 用户点击广告中链接的总次数。
inline_link_click_ctr InlineLinkClicksCounter Double 内嵌链接的点击率。
inline_post_engagement InlinePostEngagement Long 帖子的互动总次数。
instant_experience_clicks_to_open InstantExperienceClicksToOpen Long 对应于 META API 中的 instant_experience_clicks_to_open 字段。
instant_experience_clicks_to_start InstantExperienceClicksToStart Long 对应于 META API 中的 instant_experience_clicks_to_start 字段。
instant_experience_outbound_clicks InstantExperienceOutboundClicks Long 对应于 META API 中的 instant_experience_outbound_clicks 字段。
objective 目标 字符串 您为广告系列选择的目标。您的目标反映了您希望通过广告实现的目标。
quality_ranking QualityRanking 字符串 质量排名。
reach 覆盖面 Long 您的广告的展示次数。
spend 支出 小数 您目前支出的总金额。
UniqueClicks Long 点击过您的广告的唯一身份用户总数。例如,如果 3 位用户点击同一广告 5 次,则系统会将其计为 3 次唯一身份点击。
UniqueCTR Double 点击广告的用户数除以广告覆盖的用户数。例如,如果您获得了 20 次唯一身份点击,并且您的广告向 1,000 名唯一身份用户投放,那么您的唯一身份点击率就是 2%。
inline_link_clicks UniqueInlineLinkClicks Long 您的广告获得的唯一身份内嵌链接点击次数。在 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 秒),则会计为一次观看。

AdInsightsActions 报告

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 字符串 要检索的操作集合。该值设置为 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.action_type ActionType 字符串 用户在看到您的广告后对您的广告、网页、应用或活动执行的操作,即使用户未点击广告也是如此。
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 字符串 归因时间范围的指标值,由以数据为依据的归因模型提供支持。
actions.action_canvas_component_name ActionCanvasComponentName 字符串 Canvas 广告中的组件的名称。
actions.action_carousel_card_id ActionCarouselCardId 字符串 用户在看到您的广告时互动过的特定轮播界面卡片的 ID。
actions.action_carousel_card_name ActionCarouselCardName 字符串 用户在看到您的广告时互动过的特定轮播界面卡片。卡片通过其标题进行标识。
actions.action_destination ActionDestination 字符串 用户点击广告后到达的目标页面。
actions.action_device ActionDevice 字符串 您所跟踪的转化事件发生的设备。
actions.action_reaction ActionReaction 字符串 您的广告或提升后的帖子获得的回应次数。
actions.action_target_id ActionTargetId 字符串 用户点击您的广告后到达的目标页面的 ID。
actions.action_video_sound ActionVideoSound 字符串 用户观看您的视频广告时的声音状态(开启/关闭)。