此页面由 Cloud Translation API 翻译。

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。
	Level	字符串	表示结果的级别。此值设置为“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 秒），则会计为一次观看。
常规细分
	年龄	字符串	相应行中指标的年龄段。
	性别	字符串	相应行中指标的性别。
	国家/地区	字符串	相应行中指标所对应的国家/地区。
	区域	字符串	用户观看广告时所在的区域。
	FrequencyValue	字符串	覆盖面和频次广告系列中的广告向每位用户展示的次数。
	HStatsByAdvertiserTZ	字符串	广告客户的统计信息所涵盖的时间段。
	HStatsByAudienceTZ	字符串	统计相应受众群体数据的时间段。
	ImpressionDevice	字符串	用于查看广告的设备。
	PlatformPosition	字符串	平台上的位置。
	PublisherPlatform	字符串	广告的发布平台。
	ProductId	字符串	广告中宣传的商品 ID。

`AdInsightsActions` 报告

ACTION_COLLECTION 是指用户对您的广告采取的行动类型。如需查看操作集合的完整列表，请参阅操作集合。

Meta API 字段名称	映射的 BigQuery 字段名称	类型	说明
	Target	字符串	要获取其数据分析的账号的 ID。
`date_start`	DateStart	日期	要检索数据分析的开始日期。在 Facebook 界面中，此字段为“报告开始时间”。
`date_stop`	DateEnd	日期	要检索数据分析的结束日期。在 Facebook 界面中，此字段为“报告结束时间”。
	TimeIncrement	字符串	数据汇总的天数。此值设置为 1。
	Level	字符串	表示结果的级别。此值设置为 `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	字符串	Canvas 广告中某个组件的名称。
	ActionCarouselCardId	字符串	用户看到您的广告时与之互动的特定轮播广告卡的 ID。
	ActionCarouselCardName	字符串	用户看到您的广告时与之互动的特定轮播广告卡片。卡片通过其标题进行标识。
	ActionDestination	字符串	用户点击您的广告后到达的目标网址。
	ActionDevice	字符串	您跟踪的转化事件发生的设备。
	ActionReaction	字符串	您的广告或加推帖子获得的回应次数。
	ActionTargetId	字符串	用户点击广告后到达的目标页面的 ID。
	ActionVideoSound	字符串	用户观看视频广告时的声音状态（开启/关闭）。
	ActionVideoType	字符串	视频指标细分。
	ActionConvertedProductId	字符串	转化后的商品 ID - 适用于协作广告。