Google Ads 报告转换
本文档介绍了如何转换 Google Ads(以前称为 Google AdWords)报告。
Google Ads 报告的表映射
当 Google Ads 报告转移到 BigQuery 时,报告会转换为以下 BigQuery 表和视图。
在 BigQuery 中查看表和视图时,customer_id 的值就是您的 Google Ads 客户 ID。
| AdWords 报告(已弃用) | BigQuery AdWords 表 | Google Ads 表格 | Google Ads API 资源 (v21.0.0) | BigQuery 视图 |
|---|---|---|---|---|
| 账号效果报告 |
p_Customer_customer_id p_HourlyAccountConversionStats_customer_id p_AccountConversionStats_customer_id p_HourlyAccountStats_customer_id p_AccountNonClickStats_customer_id p_AccountBasicStats_customer_id p_AccountStats_customer_id |
p_ads_Customer_customer_id p_ads_HourlyAccountConversionStats_customer_id p_ads_AccountConversionStats_customer_id p_ads_HourlyAccountStats_customer_id p_ads_AccountNonClickStats_customer_id p_ads_AccountBasicStats_customer_id p_ads_AccountStats_customer_id |
客户 |
Customer_customer_id HourlyAccountConversionStats_customer_id AccountConversionStats_customer_id HourlyAccountStats_customer_id AccountNonClickStats_customer_id AccountBasicStats_customer_id AccountStats_customer_id |
| 广告效果报告 |
p_AdBasicStats_customer_id p_AdCrossDeviceStats_customer_id p_AdConversionStats_customer_id p_AdStats_customer_id p_AdCrossDeviceConversionStats_customer_id p_Ad_customer_id |
p_ads_AdBasicStats_customer_id p_ads_AdCrossDeviceStats_customer_id p_ads_AdConversionStats_customer_id p_ads_AdStats_customer_id p_ads_AdCrossDeviceConversionStats_customer_id p_ads_Ad_customer_id |
广告组广告 |
AdBasicStats_customer_id AdCrossDeviceStats_customer_id AdConversionStats_customer_id AdStats_customer_id AdCrossDeviceConversionStats_customer_id Ad_customer_id |
| 广告组效果报告 |
p_AdGroupStats_customer_id p_AdGroupBasicStats_customer_id p_AdGroupCrossDeviceStats_customer_id p_HourlyAdGroupConversionStats_customer_id p_HourlyAdGroupStats_customer_id p_AdGroupConversionStats_customer_id p_AdGroupCrossDeviceConversionStats_customer_id p_AdGroup_customer_id |
p_ads_AdGroupStats_customer_id p_ads_AdGroupBasicStats_customer_id p_ads_AdGroupCrossDeviceStats_customer_id p_ads_HourlyAdGroupConversionStats_customer_id p_ads_HourlyAdGroupStats_customer_id p_ads_AdGroupConversionStats_customer_id p_ads_AdGroupCrossDeviceConversionStats_customer_id p_ads_AdGroup_customer_id |
广告组 |
AdGroupStats_customer_id AdGroupBasicStats_customer_id AdGroupCrossDeviceStats_customer_id HourlyAdGroupConversionStats_customer_id HourlyAdGroupStats_customer_id AdGroupConversionStats_customer_id AdGroupCrossDeviceConversionStats_customer_id AdGroup_customer_id |
| 年龄段效果报告 |
p_AgeRange_customer_id p_AgeRangeBasicStats_customer_id p_AgeRangeStats_customer_id p_AgeRangeConversionStats_customer_id p_AgeRangeNonClickStats_customer_id |
p_ads_AgeRange_customer_id p_ads_AgeRangeBasicStats_customer_id p_ads_AgeRangeStats_customer_id p_ads_AgeRangeConversionStats_customer_id p_ads_AgeRangeNonClickStats_customer_id |
年龄段视图 |
AgeRange_customer_id AgeRangeBasicStats_customer_id AgeRangeStats_customer_id AgeRangeConversionStats_customer_id AgeRangeNonClickStats_customer_id |
| 受众群体效果报告 |
p_Audience_customer_id p_AudienceConversionStats_customer_id p_AudienceNonClickStats_customer_id p_AudienceBasicStats_customer_id p_AudienceStats_customer_id |
NULLNULLNULLNULLNULL
|
广告组受众群体视图 广告系列受众群体视图 |
Audience_customer_id AudienceConversionStats_customer_id AudienceNonClickStats_customer_id AudienceBasicStats_customer_id AudienceStats_customer_id |
| 出价目标效果报告 |
p_BidGoal_customer_id p_BidGoalStats_customer_id p_HourlyBidGoalStats_customer_id p_BidGoalConversionStats_customer_id |
p_ads_BidGoal_customer_id p_ads_BidGoalStats_customer_id p_ads_HourlyBidGoalStats_customer_id p_ads_BidGoalConversionStats_customer_id |
出价策略 |
BidGoal_customer_id BidGoalStats_customer_id HourlyBidGoalStats_customer_id BidGoalConversionStats_customer_id |
| 预算效果报告 |
p_Budget_customer_id p_BudgetStats_customer_id |
p_ads_Budget_customer_id p_ads_BudgetStats_customer_id |
广告系列预算 |
Budget_customer_id BudgetStats_customer_id |
| 广告系列的地理位置定位目标报告 |
p_CampaignLocationTargetStats_customer_id p_LocationBasedCampaignCriterion_customer_id |
p_ads_CampaignLocationTargetStats_customer_id p_ads_LocationBasedCampaignCriterion_customer_id |
位置视图 |
CampaignLocationTargetStats_customer_id LocationBasedCampaignCriterion_customer_id |
| 广告系列效果报告 |
p_Campaign_customer_id p_CampaignBasicStats_customer_id p_CampaignConversionStats_customer_id p_CampaignCrossDeviceStats_customer_id p_HourlyCampaignConversionStats_customer_id p_CampaignStats_customer_id p_HourlyCampaignStats_customer_id p_CampaignCrossDeviceConversionStats_customer_id p_CampaignCookieStats_customer_id |
p_ads_Campaign_customer_id p_ads_CampaignBasicStats_customer_id p_ads_CampaignConversionStats_customer_id p_ads_CampaignCrossDeviceStats_customer_id p_ads_HourlyCampaignConversionStats_customer_id p_ads_CampaignStats_customer_id p_ads_HourlyCampaignStats_customer_id p_ads_CampaignCrossDeviceConversionStats_customer_id p_ads_CampaignCookieStats_customer_id |
语音广播系列 |
Campaign_customer_id CampaignBasicStats_customer_id CampaignConversionStats_customer_id CampaignCrossDeviceStats_customer_id HourlyCampaignConversionStats_customer_id CampaignStats_customer_id HourlyCampaignStats_customer_id CampaignCrossDeviceConversionStats_customer_id CampaignCookieStats_customer_id |
| 点击效果报告 | p_ClickStats_customer_id | p_ads_ClickStats_customer_id | 点击视图。 | ClickStats_customer_id |
| 条件效果报告 |
p_Criteria_customer_id p_CriteriaBasicStats_customer_id p_CriteriaStats_customer_id p_CriteriaConversionStats_customer_id p_CriteriaNonClickStats_customer_id |
NULLNULLNULLNULLNULL
|
Criteria_customer_id CriteriaBasicStats_customer_id CriteriaStats_customer_id CriteriaConversionStats_customer_id CriteriaNonClickStats_customer_id |
|
| 性别效果报告 |
p_Gender_customer_id p_GenderBasicStats_customer_id p_GenderStats_customer_id p_GenderConversionStats_customer_id p_GenderNonClickStats_customer_id |
p_ads_Gender_customer_id p_ads_GenderBasicStats_customer_id p_ads_GenderStats_customer_id p_ads_GenderConversionStats_customer_id p_ads_GenderNonClickStats_customer_id |
性别视图 |
Gender_customer_id GenderBasicStats_customer_id GenderStats_customer_id GenderConversionStats_customer_id GenderNonClickStats_customer_id |
| 地理位置效果报告 |
p_GeoConversionStats_customer_id p_GeoStats_customer_id |
p_ads_GeoConversionStats_customer_id p_ads_GeoStats_customer_id |
地理位置视图 |
GeoConversionStats_customer_id GeoStats_customer_id |
| 关键字效果报告 |
p_Keyword_customer_id p_KeywordBasicStats_customer_id p_KeywordCrossDeviceStats_customer_id p_KeywordStats_customer_id p_KeywordCrossDeviceConversionStats_customer_id p_KeywordConversionStats_customer_id |
p_ads_Keyword_customer_id p_ads_KeywordBasicStats_customer_id p_ads_KeywordCrossDeviceStats_customer_id p_ads_KeywordStats_customer_id p_ads_KeywordCrossDeviceConversionStats_customer_id p_ads_KeywordConversionStats_customer_id |
关键字视图 |
Keyword_customer_id KeywordBasicStats_customer_id KeywordCrossDeviceStats_customer_id KeywordStats_customer_id KeywordCrossDeviceConversionStats_customer_id KeywordConversionStats_customer_id |
| 付费自然查询报告 | p_PaidOrganicStats_customer_id | p_ads_PaidOrganicStats_customer_id | 付费自然搜索字词视图 | PaidOrganicStats_customer_id |
| 育儿状况效果报告 |
p_ParentalStatus_customer_id p_ParentalStatusBasicStats_customer_id p_ParentalStatusStats_customer_id p_ParentalStatusConversionStats_customer_id p_ParentalStatusNonClickStats_customer_id |
p_ads_ParentalStatus_customer_id p_ads_ParentalStatusBasicStats_customer_id p_ads_ParentalStatusStats_customer_id p_ads_ParentalStatusConversionStats_customer_id p_ads_ParentalStatusNonClickStats_customer_id |
育儿状况视图 |
ParentalStatus_customer_id ParentalStatusBasicStats_customer_id ParentalStatusStats_customer_id ParentalStatusConversionStats_customer_id ParentalStatusNonClickStats_customer_id |
| 展示位置效果报告 |
p_PlacementBasicStats_customer_id p_PlacementNonClickStats_customer_id p_PlacementStats_customer_id p_Placement_customer_id p_PlacementConversionStats_customer_id |
p_ads_PlacementBasicStats_customer_id p_ads_PlacementNonClickStats_customer_id p_ads_PlacementStats_customer_id p_ads_Placement_customer_id p_ads_PlacementConversionStats_customer_id |
自选展示位置视图 |
PlacementBasicStats_customer_id PlacementNonClickStats_customer_id PlacementStats_customer_id Placement_customer_id PlacementConversionStats_customer_id |
| 搜索查询效果报告 |
p_SearchQueryStats_customer_id p_SearchQueryConversionStats_customer_id |
p_ads_SearchQueryStats_customer_id p_ads_SearchQueryConversionStats_customer_id |
搜索字词视图 |
SearchQueryStats_customer_id SearchQueryConversionStats_customer_id |
| 购物效果报告 |
p_ShoppingProductConversionStats_customer_id p_ShoppingProductStats_customer_id |
p_ads_ShoppingProductConversionStats_customer_id p_ads_ShoppingProductStats_customer_id |
购物效果视图 |
ShoppingProductConversionStats_customer_id ShoppingProductStats_customer_id |
| 视频效果报告 |
p_VideoBasicStats_customer_id p_VideoConversionStats_customer_id p_VideoStats_customer_id p_Video_customer_id p_VideoNonClickStats_customer_id |
p_ads_VideoBasicStats_customer_id p_ads_VideoConversionStats_customer_id p_ads_VideoStats_customer_id p_ads_Video_customer_id p_ads_VideoNonClickStats_customer_id |
视频 |
VideoBasicStats_customer_id VideoConversionStats_customer_id VideoStats_customer_id Video_customer_id VideoNonClickStats_customer_id |
| AdGroupBidModifier | 广告组出价调节系数 | |||
| AdGroupAdLabel | 广告组广告标签 | |||
| CampaignLabel | 广告系列标签 | |||
| CampaignCriterion | 广告系列条件 | |||
| AdGroupLabel | 广告组标签 | |||
|
AdGroupAudience AdGroupAudienceStats AdGroupAudienceConversionStats AdGroupAudienceNonClickStats AdGroupAudienceBasicStats |
广告组受众群体视图 | |||
| Assets (available if Pmax data is enabled) | 资产 | |||
| AssetGroup (available if Pmax data is enabled) | 素材资源组 | |||
| AssetGroupAsset (available if Pmax data is enabled) | 素材资源组素材资源 | |||
| AssetGroupSignal (available if Pmax data is enabled) | 素材资源组信号 | |||
| AssetGroupProductGroupStats (available if Pmax data is enabled) | AssetGroupProductGroupStats | |||
| CampaignAssetStats (available if Pmax data is enabled) | CampaignAssetStats |
Google Ads 报告的列映射
由 Google Ads 转移作业创建的 BigQuery 表包含以下列(字段):
Google Ads 表名称:AccountBasicStats
Google Ads API 资源: customer
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如:2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_slot | 广告的位置。 | 时段 |
Google Ads 表名称:AccountConversionStats
Google Ads API 资源: customer
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如:2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_slot | 广告的位置。 | 时段 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AccountNonClickStats
Google Ads API 资源: customer
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_content_budget_lost_impression_share | 您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意:内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | ContentBudgetLostImpressionShare |
| metrics_content_impression_share | 您在展示广告网络中获得的展示次数除以您有资格获得的估算展示次数。注意: 内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | ContentImpressionShare |
| metrics_content_rank_lost_impression_share | 您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | ContentRankLostImpressionShare |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_invalid_click_rate | 报告期内从总点击次数(过滤后 + 未过滤的点击次数)过滤出的点击次数所占的百分比。 | InvalidClickRate |
| metrics_invalid_clicks | Google 认为不合规定且不向您收费的点击次数。 | InvalidClicks |
| metrics_search_budget_lost_impression_share | 您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostImpressionShare |
| metrics_search_exact_match_impression_share | 对于与关键字完全匹配(或是关键字的紧密变体形式)的搜索字词,此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意:搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchExactMatchImpressionShare |
| metrics_search_impression_share | 您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:搜索展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchImpressionShare |
| metrics_search_rank_lost_impression_share | 您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostImpressionShare |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如:2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AccountStats
Google Ads API 资源: customer
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如:2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:Ad
Google Ads API 资源: ad_group_ad
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_added_by_google_ads | 指示此广告是否由 Google Ads 自动添加,而不是由用户添加。例如,当根据现有广告的效果自动创建广告作为新广告的建议时,可能会发生这种情况。 | 自动 |
| ad_group_ad_ad_app_ad_descriptions | 说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 | UniversalAppAdDescriptions |
| ad_group_ad_ad_app_ad_headlines | 标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 | UniversalAppAdHeadlines |
| ad_group_ad_ad_app_ad_html5_media_bundles | 可与广告一起使用的媒体包素材资源列表。 | UniversalAppAdHtml5MediaBundles |
| ad_group_ad_ad_app_ad_images | 可以与广告一起展示的图片素材资源列表。 | UniversalAppAdImages |
| ad_group_ad_ad_app_ad_mandatory_ad_text | 可选的文字素材资源(如果已指定)必须在投放广告时始终展示。 | UniversalAppAdMandatoryAdText |
| ad_group_ad_ad_app_ad_youtube_videos | 可与广告一起展示的 YouTube 视频素材资源列表。 | UniversalAppAdYouTubeVideos |
| ad_group_ad_ad_call_ad_phone_number | 广告中的手机号码。 | CallOnlyPhoneNumber |
| ad_group_ad_ad_device_preference | 广告的设备偏好设置。您只能指定移动设备的偏好设置。设置此偏好设置后,当某广告在移动设备上展示时,该广告将优于其他广告。该广告仍可在其他类型的设备上展示。例如,如果没有其他广告可用。如果未指定(无设备偏好设置),则系统会定位所有设备。仅受部分广告类型支持。 | |
| ad_group_ad_ad_display_url | 在某些广告格式的广告说明中显示的网址。 | DisplayUrl |
| ad_group_ad_ad_expanded_dynamic_search_ad_description | 广告的说明。 | |
| ad_group_ad_ad_expanded_dynamic_search_ad_description2 | 广告的第二条说明。 | ExpandedDynamicSearchCreativeDescription2 |
| ad_group_ad_ad_expanded_text_ad_description | 广告的说明。 | |
| ad_group_ad_ad_expanded_text_ad_description2 | 广告的第二条说明。 | ExpandedTextAdDescription2 |
| ad_group_ad_ad_expanded_text_ad_headline_part1 | 广告标题的第一部分。 | HeadlinePart1 |
| ad_group_ad_ad_expanded_text_ad_headline_part2 | 广告标题的第二部分。 | HeadlinePart2 |
| ad_group_ad_ad_expanded_text_ad_headline_part3 | 广告标题的第三部分。 | ExpandedTextAdHeadlinePart3 |
| ad_group_ad_ad_expanded_text_ad_path1 | 可以与广告的显示网址一起显示的文字。 | Path1 |
| ad_group_ad_ad_expanded_text_ad_path2 | 可以与广告的显示网址一起显示的其他文字。 | Path2 |
| ad_group_ad_ad_final_app_urls | 用户安装了特定应用后在移动设备上使用的最终到达应用网址列表。 | CreativeFinalAppUrls |
| ad_group_ad_ad_final_mobile_urls | 广告的所有跨网域重定向之后可能存在的最终到达移动网址列表。 | CreativeFinalMobileUrls |
| ad_group_ad_ad_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 | CreativeFinalUrls |
| ad_group_ad_ad_group | 广告所属的广告组。 | |
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_ad_ad_image_ad_image_url | 全尺寸图片的网址。 | ImageAdUrl |
| ad_group_ad_ad_image_ad_mime_type | 图片的 MIME 类型。 | ImageCreativeMimeType |
| ad_group_ad_ad_image_ad_name | 图片的名称。如果图片是通过 MediaFile 创建的,则为 MediaFile 的名称。如果图片是通过字节创建的,则为空。 | ImageCreativeName |
| ad_group_ad_ad_image_ad_pixel_height | 全尺寸图片的高度(以像素为单位)。 | ImageCreativeImageHeight |
| ad_group_ad_ad_image_ad_pixel_width | 全尺寸图片的宽度(以像素为单位)。 | ImageCreativeImageWidth |
| ad_group_ad_ad_legacy_responsive_display_ad_accent_color | 广告的强调色(采用十六进制)。例如,#ffffff 表示白色。如果设置了 main_color 和 accent_color 之一,则还需要另一个字段。 | AccentColor |
| ad_group_ad_ad_legacy_responsive_display_ad_allow_flexible_color | 广告主同意使用灵活的颜色。如果为 true,则系统可根据需要以不同颜色投放广告。如果为 false,则系统会以指定颜色或中性颜色投放广告。默认值为 true。如果未设置 main_color 和 accent_color,则必须为 true。 | AllowFlexibleColor |
| ad_group_ad_ad_legacy_responsive_display_ad_business_name | 广告中的商家名称。 | BusinessName |
| ad_group_ad_ad_legacy_responsive_display_ad_call_to_action_text | 广告的号召性用语。 | CallToActionText |
| ad_group_ad_ad_legacy_responsive_display_ad_description | 广告的说明。 | 说明 |
| ad_group_ad_ad_legacy_responsive_display_ad_format_setting | 指定投放广告采用的格式。默认为 ALL_FORMATS。 | FormatSetting |
| ad_group_ad_ad_legacy_responsive_display_ad_logo_image | 广告中使用的徽标图片的 MediaFile 资源名称。 | EnhancedDisplayCreativeLandscapeLogoImageMediaId |
| ad_group_ad_ad_legacy_responsive_display_ad_long_headline | 长版本的广告标题。 | LongHeadline |
| ad_group_ad_ad_legacy_responsive_display_ad_main_color | 广告的主要颜色(采用十六进制)。例如,#ffffff 表示白色。如果设置了 main_color 和 accent_color 之一,则还需要另一个字段。 | MainColor |
| ad_group_ad_ad_legacy_responsive_display_ad_marketing_image | 广告中使用的营销图片的 MediaFile 资源名称。 | EnhancedDisplayCreativeMarketingImageMediaId |
| ad_group_ad_ad_legacy_responsive_display_ad_price_prefix | 价格之前的前缀。例如“低至”。 | PricePrefix |
| ad_group_ad_ad_legacy_responsive_display_ad_promo_text | 用于动态格式自适应广告的宣传文字。例如“两日运费免费”。 | PromoText |
| ad_group_ad_ad_legacy_responsive_display_ad_short_headline | 短版本的广告标题。 | ShortHeadline |
| ad_group_ad_ad_legacy_responsive_display_ad_square_logo_image | 广告中使用的方形徽标图片的 MediaFile 资源名称。 | EnhancedDisplayCreativeLogoImageMediaId |
| ad_group_ad_ad_legacy_responsive_display_ad_square_marketing_image | 广告中使用的方形营销图片的 MediaFile 资源名称。 | EnhancedDisplayCreativeMarketingImageSquareMediaId |
| ad_group_ad_ad_responsive_display_ad_accent_color | 广告的强调色(采用十六进制)。例如,#ffffff 表示白色。 如果设置了 main_color 和 accent_color 之一,则还需要另一个字段。 | MultiAssetResponsiveDisplayAdAccentColor |
| ad_group_ad_ad_responsive_display_ad_business_name | 广告客户或品牌名称。最大展示宽度为 25。 | MultiAssetResponsiveDisplayAdBusinessName |
| ad_group_ad_ad_responsive_display_ad_call_to_action_text | 广告的号召性用语文字。最大展示宽度为 30。 | MultiAssetResponsiveDisplayAdCallToActionText |
| ad_group_ad_ad_responsive_display_ad_descriptions | 广告的说明文字。最大长度为 90 个字符。可以指定至少 1 个和最多 5 个标题。 | MultiAssetResponsiveDisplayAdDescriptions |
| ad_group_ad_ad_responsive_display_ad_format_setting | 指定投放广告采用的格式。默认为 ALL_FORMATS。 | MultiAssetResponsiveDisplayAdFormatSetting |
| ad_group_ad_ad_responsive_display_ad_headlines | 广告的短格式标题。最大长度为 30 个字符。可以指定至少 1 个和最多 5 个标题。 | MultiAssetResponsiveDisplayAdHeadlines |
| ad_group_ad_ad_responsive_display_ad_logo_images | 要在广告中使用的徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 512x128,宽高比必须为 4:1 (+-1%)。 与 square_logo_images 结合使用时,最大值为 5。 | MultiAssetResponsiveDisplayAdLandscapeLogoImages |
| ad_group_ad_ad_responsive_display_ad_long_headline | 必需的长格式标题。最大长度为 90 个字符。 | MultiAssetResponsiveDisplayAdLongHeadline |
| ad_group_ad_ad_responsive_display_ad_main_color | 广告的主要颜色(采用十六进制)。例如,#ffffff 表示白色。如果设置了 main_color 和 accent_color 之一,则还需要另一个字段。 | MultiAssetResponsiveDisplayAdMainColor |
| ad_group_ad_ad_responsive_display_ad_marketing_images | 要在广告中使用的营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 600x314,宽高比必须为 1.91:1 (+-1%)。必须至少提供一个 marketing_image。与 square_marketing_images 结合使用时,最大值为 15。 | MultiAssetResponsiveDisplayAdMarketingImages |
| ad_group_ad_ad_responsive_display_ad_price_prefix | 价格之前的前缀。例如“低至”。 | MultiAssetResponsiveDisplayAdDynamicSettingsPricePrefix |
| ad_group_ad_ad_responsive_display_ad_promo_text | 用于动态格式自适应广告的宣传文字。例如“两日运费免费”。 | MultiAssetResponsiveDisplayAdDynamicSettingsPromoText |
| ad_group_ad_ad_responsive_display_ad_square_logo_images | 要在广告中使用的方形徽标图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 128x128,宽高比必须为 1:1 (+-1%)。与 square_logo_images 结合使用时,最大值为 5。 | MultiAssetResponsiveDisplayAdLogoImages |
| ad_group_ad_ad_responsive_display_ad_square_marketing_images | 要在广告中使用的方形营销图片。有效的图片类型包括 GIF、JPEG 和 PNG。最小尺寸为 300x300,宽高比必须为 1:1 (+-1%)。至少需要一个方形 marketing_image。与 marketing_images 结合使用时,最大值为 15。 | MultiAssetResponsiveDisplayAdSquareMarketingImages |
| ad_group_ad_ad_responsive_display_ad_youtube_videos | (可选)广告的 YouTube 视频。最多可以指定 5 个视频。 | MultiAssetResponsiveDisplayAdYouTubeVideos |
| ad_group_ad_ad_responsive_search_ad_descriptions | 说明的文字素材资源列表。广告投放时,系统会从此列表中选择说明。 | ResponsiveSearchAdDescriptions |
| ad_group_ad_ad_responsive_search_ad_headlines | 标题的文字素材资源列表。广告投放时,系统会从此列表中选择标题。 | ResponsiveSearchAdHeadlines |
| ad_group_ad_ad_responsive_search_ad_path1 | 可能显示的文字的第一部分(附加到广告中展示的网址)。 | ResponsiveSearchAdPath1 |
| ad_group_ad_ad_responsive_search_ad_path2 | 可能显示的文字的第二部分(附加到广告中展示的网址)。仅当同时设置了 path1 时才能设置此字段。 | ResponsiveSearchAdPath2 |
| ad_group_ad_ad_strength | 广告组广告的整体广告效力。 | AdStrengthInfo |
| ad_group_ad_ad_system_managed_resource_source | 如果广告由系统管理,则此字段会指示来源。 此字段为只读字段。 | SystemManagedEntitySource |
| ad_group_ad_ad_text_ad_description1 | 广告说明的第一行。 | Description1 |
| ad_group_ad_ad_text_ad_description2 | 广告说明的第二行。 | Description2 |
| ad_group_ad_ad_text_ad_headline | 广告的标题。 | 标题 |
| ad_group_ad_ad_tracking_url_template | 用于构建跟踪网址的网址模板。 | CreativeTrackingUrlTemplate |
| ad_group_ad_ad_type | 广告的类型。 | AdType |
| ad_group_ad_ad_url_custom_parameters | 可用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。对于变更,请使用网址自定义参数操作。 | CreativeUrlCustomParameters |
| ad_group_ad_status | 广告的状态。 | 状态 |
| ad_group_id | 仅限输出。广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:AdBasicStats
Google Ads API 资源: ad_group_ad
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_group | 广告所属的广告组。 | |
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 仅限输出。广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_slot | 广告的位置。 | 时段 |
Google Ads 表名称:AdConversionStats
Google Ads API 资源: ad_group_ad
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_group | 广告所属的广告组。 | |
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 仅限输出。广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_slot | 广告的位置。 | 时段 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AdCrossDeviceConversionStats
Google Ads API 资源: ad_group_ad
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_group | 广告所属的广告组。 | |
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 仅限输出。广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AdCrossDeviceStats
Google Ads API 资源: ad_group_ad
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_group | 广告所属的广告组。 | |
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 仅限输出。广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_average_page_views | 每个会话浏览网页的平均次数。 | AveragePageviews |
| metrics_average_time_on_site | 所有会话的总时长(以秒为单位)/会话数。从 Google Analytics 导入。 | AverageTimeOnSite |
| metrics_bounce_rate | 用户只访问了网站上的单个网页时使用的点击次数所占百分比。自 Google Analytics 导入。 | BounceRate |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_percent_new_visitors | 首次会话数(来自之前从未访问过您的网站的用户)所占的百分比。自 Google Analytics 导入。 | PercentNewVisitors |
| metrics_top_impression_percentage | 显示在自然搜索结果上方的任何位置的广告展示次数所占百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AdGroup
Google Ads API 资源: ad_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_rotation_mode | 广告组的广告轮播模式。 | AdRotationMode |
| ad_group_cpc_bid_micros | 每次点击费用 (cost-per-click) 出价上限。 | CpcBid |
| ad_group_cpm_bid_micros | 每千次展示费用(每千次可见展示费用)出价上限。 | CpmBidStr |
| ad_group_cpv_bid_micros | 每次观看费用 (cost-per-view) 出价。 | CpvBid |
| ad_group_display_custom_bid_dimension | 可让广告客户指定要为其设置绝对出价的定位维度。仅适用于仅定位展示广告网络而不是搜索网络的广告系列。 | ContentBidCriterionTypeGroup |
| ad_group_effective_target_cpa_micros | 有效目标每次转化费用 (cost-per-acquisition)。此字段为只读字段。 | TargetCpa |
| ad_group_effective_target_cpa_source | 有效目标每次转化费用的来源。此字段为只读字段。 | TargetCpaBidSource |
| ad_group_effective_target_roas | 有效目标广告支出回报率 (return-on-ad-spend)。此字段为只读字段。 | EffectiveTargetRoas |
| ad_group_effective_target_roas_source | 有效目标广告支出回报率的来源。此字段为只读字段。 | EffectiveTargetRoasSource |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | AdGroupName |
| ad_group_status | 广告组的状态。 | AdGroupStatus |
| ad_group_tracking_url_template | 用于构建跟踪网址的网址模板。 | TrackingUrlTemplate |
| ad_group_type | 广告组的类型。 | AdGroupType |
| ad_group_url_custom_parameters | 用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。 | UrlCustomParameters |
| campaign_bidding_strategy | 广告系列使用的组合出价策略。 | BiddingStrategyId |
| campaign_bidding_strategy_type | 出价策略的类型。您可以通过以下方式创建出价策略:设置出价方案来创建标准出价策略,或设置“bidding_strategy”字段来创建组合出价策略。此字段为只读字段。 | BiddingStrategyType |
| campaign_id | 广告系列的 ID。 | CampaignId |
| campaign_manual_cpc_enhanced_cpc_enabled | 是否根据转化优化工具数据增强出价。 | EnhancedCpcEnabled |
| campaign_percent_cpc_enhanced_cpc_enabled | 根据转化可能性,在每次竞价中提高或降低出价。个别出价可能会超过 cpc_bid_ceiling_micros,但广告系列的平均出价金额不应超过。 | |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:AdGroupAdLabel
Google Ads API 资源: ad_group_ad_label
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_label_ad_group_ad | 标签附加到的广告组广告。 | |
| ad_group_ad_label_label | 分配给广告组广告的标签。 | |
| ad_group_ad_label_resource_name | 广告组广告标签的资源名称。广告组广告标签资源名称采用以下格式: `customers/{customer_id}/adGroupAdLabels/{ad_group_id}~{ad_id}~{label_id}` | |
| ad_group_id | 广告组的 ID。 | |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| label_id | 标签的 ID。只读。 | |
| label_name | 标签的名称。创建新标签时,此字段为必填字段,不应为空。此字符串的长度应介于 1 和 80 之间(包括 1 和 80)。 | |
| label_resource_name | 资源的名称。标签资源名称采用以下格式: `customers/{customer_id}/labels/{label_id}` |
Google Ads 表名称:AdGroupAudience
Google Ads API 资源: ad_group_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | |
| ad_group_campaign | 广告组所属的广告系列。 | |
| ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 | |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | |
| ad_group_criterion_effective_cpc_bid_micros | 有效每次点击费用 (cost-per-click) 出价。 | |
| ad_group_criterion_effective_cpc_bid_source | 有效每次点击费用出价的来源。 | |
| ad_group_criterion_effective_cpm_bid_micros | 有效每千次展示费用(每千次可见的展示费用)出价。 | |
| ad_group_criterion_effective_cpm_bid_source | 有效每千次展示费用出价的来源。 | |
| ad_group_criterion_final_mobile_urls | 所有跨网域重定向之后可能存在的最终到达移动网址列表。 | |
| ad_group_criterion_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 | |
| ad_group_criterion_keyword_text | 关键字文本(最多 80 个字符和 10 个字词)。 | |
| ad_group_criterion_status | 条件的状态。 | |
| ad_group_id | 广告组的 ID。 | |
| ad_group_targeting_setting_target_restrictions | 用于限制广告系列或广告组覆盖面的每个定位维度的设置。 | |
| ad_group_tracking_url_template | 用于构建跟踪网址的网址模板。 | |
| ad_group_url_custom_parameters | 用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。 | |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| campaign_bidding_strategy | 广告系列使用的组合出价策略。 | |
| customer_id | 客户的 ID。 |
Google Ads 表名称:AdGroupAudienceBasicStats
Google Ads API 资源: ad_group_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | |
| ad_group_campaign | 广告组所属的广告系列。 | |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | |
| ad_group_id | 广告组的 ID。 | |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| customer_id | 客户的 ID。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_interaction_event_types | 付费和免费互动的类型。 | |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_device | 指标应用于的设备。 | |
| segments_slot | 广告的位置。 |
Google Ads 表名称:AdGroupAudienceConversionStats
Google Ads API 资源: ad_group_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | |
| ad_group_campaign | 广告组所属的广告系列。 | |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | |
| ad_group_id | 广告组的 ID。 | |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| customer_id | 客户的 ID。 | |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_all_conversions_value | 所有转化的总价值。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_conversion_action | 转化操作的资源名称。 | |
| segments_conversion_action_category | 转化操作类别。 | |
| segments_conversion_action_name | 转化操作名称。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_device | 指标应用于的设备。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:AdGroupAudienceNonClickStats
Google Ads API 资源: ad_group_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | |
| ad_group_campaign | 广告组所属的广告系列。 | |
| ad_group_id | 广告组的 ID。 | |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| customer_id | 客户的 ID。 | |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | |
| metrics_video_views | 视频广告的观看次数。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_device | 指标应用于的设备。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:AdGroupAudienceStats
Google Ads API 资源: ad_group_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | |
| ad_group_campaign | 广告组所属的广告系列。 | |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | |
| ad_group_id | 广告组的 ID。 | |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| customer_id | 客户的 ID。 | |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_interaction_event_types | 付费和免费互动的类型。 | |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_click_type | 点击类型。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_device | 指标应用于的设备。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:AdGroupBasicStats
Google Ads API 资源: ad_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_slot | 广告的位置。 | 时段 |
Google Ads 表名称:AdGroupBidModifier
Google Ads API 资源: ad_group_bid_modifier
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_bid_modifier_ad_group | 条件所属的广告组。 | |
| ad_group_bid_modifier_base_ad_group | 从中创建草稿或试验广告组出价调节系数的基础广告组。如果 ad_group 是基础广告组,则此字段等于 ad_group。如果广告组是在草稿或试验中创建的,但没有对应的基础广告组,则此字段为 null。此字段为只读字段。 | |
| ad_group_bid_modifier_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。对于 PreferredContent,该范围介于 1.0 - 6.0 之间。使用 0 可停用设备类型。 | |
| ad_group_bid_modifier_bid_modifier_source | 出价调节系数来源。 | |
| ad_group_bid_modifier_criterion_id | 要修改出价的条件的 ID。对于变更,此字段会被忽略。 | |
| ad_group_bid_modifier_device_type | 设备类型。 | |
| ad_group_bid_modifier_resource_name | 广告组出价调节系数的资源名称。广告组出价调节系数资源名称采用以下格式: `customers/{customer_id}/adGroupBidModifiers/{ad_group_id}~{criterion_id}` | |
| ad_group_id | 广告组的 ID。 | |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
Google Ads 表名称:AdGroupConversionStats
Google Ads API 资源: ad_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_slot | 广告的位置。 | 时段 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AdGroupCriterion
Google Ads API 资源: ad_group_criterion
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_criterion_ad_group | 条件所属的广告组。 | |
| ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 | |
| ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 | |
| ad_group_criterion_cpm_bid_micros | 每千次展示费用(每千次可见展示费用)出价。 | |
| ad_group_criterion_cpv_bid_micros | 每次点击费用 (CPC) 出价。 | |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | |
| ad_group_criterion_display_name | 条件的显示名称。对于变更,此字段会被忽略。 | |
| ad_group_criterion_negative | 是定位(“false”)还是排除(“true”)条件。 | |
| ad_group_criterion_status | 条件的状态。 | |
| ad_group_criterion_type | 条件的类型。 | |
| ad_group_id | 广告组的 ID。 | |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
Google Ads 表名称:AdGroupCriterionLabel
Google Ads API 资源: ad_group_criterion_label
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | |
| ad_group_criterion_label_ad_group_criterion | 标签附加到的广告组条件。 | |
| ad_group_criterion_label_label | 分配给广告组条件的标签。 | |
| ad_group_criterion_label_resource_name | 广告组条件标签的资源名称。广告组条件标签资源名称采用以下格式: `customers/{customer_id}/adGroupCriterionLabels/{ad_group_id}~{criterion_id}~{label_id}` | |
| label_id | 标签的 ID。只读。 | |
| label_name | 标签的名称。创建新标签时,此字段为必填字段,不应为空。此字符串的长度应介于 1 和 80 之间(包括 1 和 80)。 | |
| label_resource_name | 资源的名称。标签资源名称采用以下格式: `customers/{customer_id}/labels/{label_id}` |
Google Ads 表名称:AdGroupCrossDeviceConversionStats
Google Ads API 资源: ad_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AdGroupCrossDeviceStats
Google Ads API 资源: ad_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_average_page_views | 每个会话浏览网页的平均次数。 | AveragePageviews |
| metrics_average_time_on_site | 所有会话的总时长(以秒为单位)/会话数。从 Google Analytics 导入。 | AverageTimeOnSite |
| metrics_bounce_rate | 用户只访问了网站上的单个网页时使用的点击次数所占百分比。自 Google Analytics 导入。 | BounceRate |
| metrics_content_impression_share | 您在展示广告网络中获得的展示次数除以您有资格获得的估算展示次数。注意: 内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | ContentImpressionShare |
| metrics_content_rank_lost_impression_share | 您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | ContentRankLostImpressionShare |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_percent_new_visitors | 首次会话数(来自之前从未访问过您的网站的用户)所占的百分比。自 Google Analytics 导入。 | PercentNewVisitors |
| metrics_phone_calls | 离线通话次数。 | NumOfflineInteractions |
| metrics_phone_impressions | 离线电话号码展示次数。 | NumOfflineImpressions |
| metrics_phone_through_rate | 接听的手机次数 (phone_calls) 除以手机号码展示次数 (phone_impressions)。 | OfflineInteractionRate |
| metrics_relative_ctr | 您的点击率 (Ctr) 除以展示您的广告的网站上所有广告主的平均点击率。衡量您的广告与同一网站上的其他广告相比在展示广告网络中的效果。 | RelativeCtr |
| metrics_search_absolute_top_impression_share | 在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请访问 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。 | SearchAbsoluteTopImpressionShare |
| metrics_search_budget_lost_absolute_top_impression_share | 此数字用于估算您的广告由于预算低而不是自然搜索结果上方的第一个广告的频率。注意:搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostAbsoluteTopImpressionShare |
| metrics_search_budget_lost_top_impression_share | 此数字用于估算您的广告由于预算低而未出现在自然搜索结果上方的任何位置的频率。注意:搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostTopImpressionShare |
| metrics_search_exact_match_impression_share | 对于与关键字完全匹配(或是关键字的紧密变体形式)的搜索字词,此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意:搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchExactMatchImpressionShare |
| metrics_search_impression_share | 您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:搜索展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchImpressionShare |
| metrics_search_rank_lost_absolute_top_impression_share | 此数字用于估算您的广告由于广告评级差而不是自然搜索结果上方的第一个广告的频率。注意:搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostAbsoluteTopImpressionShare |
| metrics_search_rank_lost_impression_share | 您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostImpressionShare |
| metrics_search_rank_lost_top_impression_share | 此数字用于估算您的广告由于广告评级差而未出现在自然搜索结果上方的任何位置的频率。注意:搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostTopImpressionShare |
| metrics_search_top_impression_share | 您在热门位置(自然搜索结果上方的任何位置)获得的展示次数相较于您有资格在热门位置获得的估算展示次数。注意:搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchTopImpressionShare |
| metrics_top_impression_percentage | 显示在自然搜索结果上方的任何位置的广告展示次数所占百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AdGroupLabel
Google Ads API 资源: ad_group_label
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_id | 广告组的 ID。 | |
| ad_group_label_ad_group | 标签附加到的广告组。 | |
| ad_group_label_label | 分配给广告组的标签。 | |
| ad_group_label_resource_name | 广告组标签的资源名称。广告组标签资源名称采用以下格式: `customers/{customer_id}/adGroupLabels/{ad_group_id}~{label_id}` | |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| label_id | 标签的 ID。只读。 | |
| label_name | 标签的名称。创建新标签时,此字段为必填字段,不应为空。此字符串的长度应介于 1 和 80 之间(包括 1 和 80)。 | |
| label_resource_name | 资源的名称。标签资源名称采用以下格式: `customers/{customer_id}/labels/{label_id}` |
Google Ads 表名称:AdGroupStats
Google Ads API 资源: ad_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cost_per_current_model_attributed_conversion | 广告互动费用除以当前模型归因转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | CostPerCurrentModelAttributedConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_current_model_attributed_conversions | 显示历史转化数据在您选择的归因模型下的情况。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CurrentModelAttributedConversions |
| metrics_current_model_attributed_conversions_value | 当前模型归因转化的总价值。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | CurrentModelAttributedConversionValue |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | GmailForwards |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | GmailSecondaryClicks |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_value_per_current_model_attributed_conversion | 当前模型归因转化的价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerCurrentModelAttributedConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AdStats
Google Ads API 资源: ad_group_ad
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_group | 广告所属的广告组。 | |
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 仅限输出。广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cost_per_current_model_attributed_conversion | 广告互动费用除以当前模型归因转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | CostPerCurrentModelAttributedConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_current_model_attributed_conversions | 显示历史转化数据在您选择的归因模型下的情况。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CurrentModelAttributedConversions |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | GmailForwards |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | GmailSecondaryClicks |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_value_per_current_model_attributed_conversion | 当前模型归因转化的价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerCurrentModelAttributedConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AgeRange
Google Ads API 资源: age_range_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_age_range_type | 年龄段的类型。 | 条件 |
| ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 | BidModifier |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效每次点击费用 (cost-per-click) 出价。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效每次点击费用出价的来源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效每千次展示费用(每千次可见的展示费用)出价。 | CpmBidStr |
| ad_group_criterion_effective_cpm_bid_source | 有效每千次展示费用出价的来源。 | CpmBidSource |
| ad_group_criterion_final_mobile_urls | 所有跨网域重定向之后可能存在的最终到达移动网址列表。 | FinalMobileUrls |
| ad_group_criterion_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 | FinalUrls |
| ad_group_criterion_negative | 是定位(“false”)还是排除(“true”)条件。此字段不可更改。如需将条件从正切换为负,请先移除再重新添加。 | IsNegative |
| ad_group_criterion_status | 条件的状态。 | 状态 |
| ad_group_criterion_tracking_url_template | 用于构建跟踪网址的网址模板。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。 | UrlCustomParameters |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| ad_group_targeting_setting_target_restrictions | 用于限制广告系列或广告组覆盖面的每个定位维度的设置。 | |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_bidding_strategy | 广告系列使用的组合出价策略。 | BiddingStrategyId |
| campaign_bidding_strategy_type | 出价策略的类型。您可以通过以下方式创建出价策略:设置出价方案来创建标准出价策略,或设置“bidding_strategy”字段来创建组合出价策略。此字段为只读字段。 | BiddingStrategyType |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:AgeRangeBasicStats
Google Ads API 资源: age_range_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
Google Ads 表名称:AgeRangeConversionStats
Google Ads API 资源: age_range_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AgeRangeNonClickStats
Google Ads API 资源: age_range_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:AgeRangeStats
Google Ads API 资源: age_range_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | GmailForwards |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | GmailSecondaryClicks |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:Asset
Google Ads API 资源: asset
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| asset_final_urls | 仅限输出。相应资产的类型。 | |
| asset_name | 素材资源的可选名称。 | |
| asset_source | 仅限输出。相应素材资源的来源。 | |
| asset_type | 所有跨网域重定向之后可能存在的最终到达网址列表。 | |
| segments_conversion_action | 转化操作的资源名称。 |
Google Ads 表名称:AssetGroup
Google Ads API 资源: asset_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| asset_group_campaign | 不可变。相应素材资源组关联到的广告系列。与素材资源组相关联的素材资源。 | |
| asset_group_final_mobile_urls | 所有跨网域重定向之后的最终到达移动网址列表。在效果最大化广告系列中,默认情况下,网址符合扩展条件,除非选择停用。 | |
| asset_group_final_urls | 所有跨网域重定向之后的最终到达网址列表。在效果最大化广告系列中, 默认情况下,网址符合扩展条件,除非选择停用。 | |
| asset_group_id | 仅限输出。素材资源组的 ID。 | |
| asset_group_name | 必需。素材资源组的名称。必需。长度不得少于 1 个字符,不得超过 128 个字符。在广告系列中必须具有唯一性。 | |
| asset_group_status | 素材资源组的状态。 |
Google Ads 表名称:AssetGroupAsset
Google Ads API 资源: asset_group_asset
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| asset_group_asset_asset | 相应素材资源组中的素材资源所关联的素材资源。 | |
| asset_group_asset_asset_group | 相应素材资源组资产所关联的素材资源组。 | |
| asset_group_asset_field_type | 素材资源在素材资源组中的展示位置说明。例如:HEADLINE、YOUTUBE_VIDEO。 | |
| asset_group_asset_performance_label | 相应素材资源组素材资源的效果。 | |
| asset_group_asset_policy_summary_approval_status | 根据各个政策主题条目的状态计算得出的总体审批状态。 | |
| asset_group_asset_policy_summary_policy_topic_entries | 政策结果列表。 | |
| asset_group_asset_policy_summary_review_status | 资源在审核流程中所处的阶段。 |
Google Ads 表名称:AssetGroupListingGroupFilter
Google Ads API 资源: asset_group_listing_group_filter
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| asset_group_listing_group_filter_asset_group | 相应素材资源组产品信息组过滤条件所属的素材资源组。 | |
| asset_group_listing_group_filter_case_value_product_bidding_category_id (obsolete - use asset_group_listing_group_filter_case_value_product_category_category_id instead) | 商品出价类别的 ID。此 ID 等同于本文档中所述的 google_product_category ID: https://support.google.com/merchants/answer/6324436 | |
| asset_group_listing_group_filter_case_value_product_bidding_category_level (obsolete - use asset_group_listing_group_filter_case_value_product_category_level instead) | 指明类目在分类中的级别。 | |
| asset_group_listing_group_filter_case_value_product_brand_value | 商品品牌的字符串值。 | |
| asset_group_listing_group_filter_case_value_product_channel_channel | 相应地区的价值。 | |
| asset_group_listing_group_filter_case_value_product_condition_condition | 条件的值。 | |
| asset_group_listing_group_filter_case_value_product_custom_attribute_index | 表示自定义属性的索引。 | |
| asset_group_listing_group_filter_case_value_product_custom_attribute_value | 商品自定义属性的字符串值。 | |
| asset_group_listing_group_filter_case_value_product_item_id_value | 相应 ID 的值。 | |
| asset_group_listing_group_filter_case_value_product_type_level | 类型的级别。 | |
| asset_group_listing_group_filter_case_value_product_type_value | 相应类型的值。 | |
| asset_group_listing_group_filter_id | ListingGroupFilter 的 ID。 | |
| asset_group_listing_group_filter_parent_listing_group_filter | 父级商品详情组细分的资源名称。对于根商品详情组过滤条件节点,为 null。 | |
| asset_group_listing_group_filter_type | 商品详情组过滤条件节点的类型。 | |
| asset_group_listing_group_filter_vertical (obsolete - use asset_group_listing_group_filter_listing_source instead) | 当前节点树所代表的行业。同一树中的所有节点都必须属于同一垂直行业。 |
Google Ads 表名称:AssetGroupProductGroupStats
Google Ads API 资源: asset_group_product_group_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| asset_group_product_group_view_asset_group | 与相应产品信息组过滤条件相关联的素材资源组。 | |
| asset_group_product_group_view_asset_group_listing_group_filter | 素材资源组产品信息组过滤条件的资源名称。 | |
| asset_group_product_group_view_resource_name | 素材资源组商品组视图的资源名称。素材资源组产品组视图资源名称采用以下格式:customers/{customer_id}/assetGroupProductGroupViews/{asset_group_id}~{listing_group_filter_id} | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 | |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 | |
| metrics_conversions_value | 转化的价值。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_device | 指标应用于的设备。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:AssetGroupSignal
Google Ads API 资源: asset_group_signal
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| asset_group_signal_asset_group | 相应素材资源组信号所属的素材资源组。 | |
| asset_group_signal_audience_audience | 受众群体资源名称。 | |
| asset_group_signal_resource_name | 素材资源组信号的资源名称。素材资源组信号资源名称采用以下格式:customers/{customer_id}/assetGroupSignals/{asset_group_id}~{signal_id} |
Google Ads 表名称:Audience
Google Ads API 资源: audience
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| audience_description | 相应受众群体的说明。 | |
| audience_dimensions | 指定受众群体构成的正维度。 | |
| audience_exclusion_dimension | 指定受众群体构成的负维度。 | |
| audience_id | 受众群体的 ID。 | |
| audience_name | 受众群体的名称。在所有受众群体中应该是唯一的。长度不得少于 1 个字符,不得超过 255 个字符。 | |
| audience_status | 相应受众群体的状态。指示相应受众群体是已启用还是已移除。 |
Google Ads 表名称:BidGoal
Google Ads API 资源: bidding_strategy
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| bidding_strategy_id | 出价策略的 ID。 | BidStrategyID |
| bidding_strategy_name | 出价策略的名称。账号中的所有出价策略必须区分命名。此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 | 名称 |
| bidding_strategy_status | 出价策略的状态。此字段为只读字段。 | 状态 |
| bidding_strategy_target_cpa_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 | TargetCpaMaxCpcBidCeiling |
| bidding_strategy_target_cpa_cpc_bid_floor_micros | 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 | TargetCpaMaxCpcBidFloor |
| bidding_strategy_target_cpa_target_cpa_micros | 平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。 | TargetCpa |
| bidding_strategy_target_roas_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 | TargetRoasBidCeiling |
| bidding_strategy_target_roas_cpc_bid_floor_micros | 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 | TargetRoasBidFloor |
| bidding_strategy_target_roas_target_roas | 必需。每单位支出的预期收入(基于转化数据)。值必须介于 0.01 到 1000.0 之间(包括 0.01 和 1000.0)。 | TargetRoas |
| bidding_strategy_target_spend_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 | TargetSpendBidCeiling |
| bidding_strategy_target_spend_target_spend_micros | 尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 | TargetSpendSpendTarget |
| bidding_strategy_type | 出价策略的类型。通过设置出价方案创建出价策略。此字段为只读字段。 | 类型 |
| customer_descriptive_name | (可选)客户的非唯一描述性名称。 | AccountDescriptiveName |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:BidGoalConversionStats
Google Ads API 资源: bidding_strategy
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| bidding_strategy_campaign_count | 附加到出价策略的广告系列的数量。此字段为只读字段。 | CampaignCount |
| bidding_strategy_id | 出价策略的 ID。 | BidStrategyID |
| bidding_strategy_non_removed_campaign_count | 附加到相应出价策略的未移除广告系列的数量。 此字段为只读字段。 | NonRemovedCampaignCount |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:BidGoalStats
Google Ads API 资源: bidding_strategy
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| bidding_strategy_campaign_count | 附加到出价策略的广告系列的数量。此字段为只读字段。 | CampaignCount |
| bidding_strategy_id | 出价策略的 ID。 | BidStrategyID |
| bidding_strategy_non_removed_campaign_count | 附加到相应出价策略的未移除广告系列的数量。 此字段为只读字段。 | NonRemovedCampaignCount |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:Budget
Google Ads API 资源: campaign_budget
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_budget_amount_micros | 预算的金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。 每月支出上限为该金额的 30.4 倍。 | 金额 |
| campaign_budget_delivery_method | 确定广告系列预算的支出速率的投放方式。如果在创建操作中未指定,则默认为 STANDARD。 | DeliveryMethod |
| campaign_budget_explicitly_shared | 指定预算是否为明确共享的预算。如果在创建操作中未指定,则默认为 true。如果为 true,则创建预算的目的是在一个或多个广告系列之间共享。如果为 false,则创建预算的意图是仅用于一个广告系列。 预算的名称和状态会与广告系列的名称和状态保持同步。尝试与第二个广告系列共享预算会导致错误。非共享预算可以成为明确共享的预算。 同一操作还必须为预算指定一个名称。共享的广告系列预算绝不能成为非共享预算。 | IsBudgetExplicitlyShared |
| campaign_budget_has_recommended_budget | 指示相应广告系列预算是否有建议的预算。 此字段为只读字段。 | HasRecommendedBudget |
| campaign_budget_id | 广告系列预算的 ID。广告系列预算通过 CampaignBudgetService 创建操作创建,并分配有预算 ID。预算 ID 可在不同的广告系列之间共享;然后,系统会在不同的广告系列之间分配广告系列预算,以获得较佳结果。 | BudgetId |
| campaign_budget_name | 广告系列预算的名称。通过 CampaignBudgetService 创建广告系列预算时,每个明确共享的广告系列预算都必须具有一个非 null、非空的名称。未明确共享的广告系列预算会从附加的广告系列的名称派生其名称。此字符串的长度必须介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 | BudgetName |
| campaign_budget_period | 支出预算的时间段。如果未指定,则默认为 DAILY。 | 时段 |
| campaign_budget_recommended_budget_amount_micros | 建议的预算金额。如果没有建议,则此字段设置为预算金额。金额以微单位指定,即一百万等同于一个货币单位。此字段为只读字段。 | RecommendedBudgetAmount |
| campaign_budget_reference_count | 正在使用预算的广告系列数量。此字段为只读字段。 | BudgetReferenceCount |
| campaign_budget_status | 广告系列预算的状态。此字段为只读字段。 | BudgetStatus |
| campaign_budget_total_amount_micros | 预算的生命周期金额,以账号的本地货币为单位。 金额以微单位指定,即一百万等同于一个货币单位。 | TotalAmount |
| customer_descriptive_name | (可选)客户的非唯一描述性名称。 | AccountDescriptiveName |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:BudgetStats
Google Ads API 资源: campaign_budget
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_budget_id | 广告系列预算的 ID。广告系列预算通过 CampaignBudgetService 创建操作创建,并分配有预算 ID。预算 ID 可在不同的广告系列之间共享;然后,系统会在不同的广告系列之间分配广告系列预算,以获得较佳结果。 | BudgetId |
| campaign_budget_recommended_budget_estimated_change_weekly_clicks | 应用建议的预算后,每周点击次数的预期变化。此字段为只读字段。 | RecommendedBudgetEstimatedChangeInWeeklyClicks |
| campaign_budget_recommended_budget_estimated_change_weekly_cost_micros | 应用建议的预算后,每周费用的估计变化(以微美元为单位)。一百万等同于一个货币单位。此字段为只读字段。 | RecommendedBudgetEstimatedChangeInWeeklyCost |
| campaign_budget_recommended_budget_estimated_change_weekly_interactions | 应用建议的预算后,每周互动次数的预期变化。此字段为只读字段。 | RecommendedBudgetEstimatedChangeInWeeklyInteractions |
| campaign_budget_recommended_budget_estimated_change_weekly_views | 应用建议的预算后,每周观看次数的预期变化。 此字段为只读字段。 | RecommendedBudgetEstimatedChangeInWeeklyViews |
| campaign_id | 广告系列的 ID。 | AssociatedCampaignId |
| campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | AssociatedCampaignName |
| campaign_status | 广告系列的状态。添加新的广告系列时,状态默认为 ENABLED。 | AssociatedCampaignStatus |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 |
Google Ads 表名称:Campaign
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| bidding_strategy_name | 出价策略的名称。账号中的所有出价策略必须区分命名。此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 | BiddingStrategyName |
| campaign_advertising_channel_sub_type | (可选)对“advertising_channel_type”进行优化。必须是父级渠道类型的有效子类型。只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 | AdvertisingChannelSubType |
| campaign_advertising_channel_type | 广告系列中的广告的主要投放目标。可以在“network_settings”中优化定位选项。此字段为必填字段,在创建新广告系列时不应为空。只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 | AdvertisingChannelType |
| campaign_bidding_strategy | 广告系列使用的组合出价策略。 | BiddingStrategyId |
| campaign_bidding_strategy_type | 出价策略的类型。您可以通过以下方式创建出价策略:设置出价方案来创建标准出价策略,或设置“bidding_strategy”字段来创建组合出价策略。此字段为只读字段。 | BiddingStrategyType |
| campaign_budget_amount_micros | 预算的金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。 每月支出上限为该金额的 30.4 倍。 | 金额 |
| campaign_budget_explicitly_shared | 指定预算是否为明确共享的预算。如果在创建操作中未指定,则默认为 true。如果为 true,则创建预算的目的是在一个或多个广告系列之间共享。如果为 false,则创建预算的意图是仅用于一个广告系列。 预算的名称和状态会与广告系列的名称和状态保持同步。尝试与第二个广告系列共享预算会导致错误。非共享预算可以成为明确共享的预算。 同一操作还必须为预算指定一个名称。共享的广告系列预算绝不能成为非共享预算。 | IsBudgetExplicitlyShared |
| campaign_budget_has_recommended_budget | 指示相应广告系列预算是否有建议的预算。 此字段为只读字段。 | HasRecommendedBudget |
| campaign_budget_period | 支出预算的时间段。如果未指定,则默认为 DAILY。 | 时段 |
| campaign_budget_recommended_budget_amount_micros | 建议的预算金额。如果没有建议,则此字段设置为预算金额。金额以微单位指定,即一百万等同于一个货币单位。此字段为只读字段。 | RecommendedBudgetAmount |
| campaign_budget_total_amount_micros | 预算的生命周期金额,以账号的本地货币为单位。 金额以微单位指定,即一百万等同于一个货币单位。 | TotalAmount |
| campaign_campaign_budget | 广告系列的预算。 | BudgetId |
| campaign_end_date | 广告系列的结束日期。此字段不得用于 WHERE 子句。 | EndDate |
| campaign_experiment_type | 广告系列的类型:正常、草稿或实验。 | CampaignTrialType |
| campaign_id | 广告系列的 ID。 | CampaignId |
| campaign_manual_cpc_enhanced_cpc_enabled | 是否根据转化优化工具数据增强出价。 | EnhancedCpcEnabled |
| campaign_maximize_conversion_value_target_roas | 目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。 | MaximizeConversionValueTargetRoas |
| campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | CampaignName |
| campaign_percent_cpc_enhanced_cpc_enabled | 根据转化可能性,在每次竞价中提高或降低出价。个别出价可能会超过 cpc_bid_ceiling_micros,但广告系列的平均出价金额不应超过。 | |
| campaign_serving_status | 广告系列的广告投放状态。 | ServingStatus |
| campaign_start_date | 广告系列的开始日期。此字段不得用于 WHERE 子句。 | StartDate |
| campaign_status | 广告系列的状态。添加新的广告系列时,状态默认为 ENABLED。 | CampaignStatus |
| campaign_tracking_url_template | 用于构建跟踪网址的网址模板。 | TrackingUrlTemplate |
| campaign_url_custom_parameters | 用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。 | UrlCustomParameters |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:CampaignAssetStats
Google Ads API 资源: campaign_asset
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_asset_asset | 与广告系列关联的素材资源。 | |
| campaign_asset_campaign | 素材资源关联到的广告系列。 | |
| campaign_asset_field_type | 素材资源在关联的广告系列中扮演的角色。 | |
| campaign_asset_resource_name | 相应广告系列素材资源的资源名称。CampaignAsset 资源名称采用以下格式: customers/{customer_id}/campaignAssets/{campaign_id}~{asset_id}~{field_type} | |
| campaign_asset_source | 广告系列素材资源链接的来源。 | |
| campaign_asset_status | 广告系列素材资源的状态。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 | |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 | |
| metrics_conversions_value | 转化的价值。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | |
| metrics_top_impression_percentage | 显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_device | 指标应用于的设备。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:CampaignAudience
Google Ads API 资源: campaign_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| campaign_criterion_bid_modifier | 广告系列使用的组合出价策略。 | |
| campaign_criterion_criterion_id | 仅限输出。条件的 ID。在变更期间,此字段会被忽略。 | |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 |
Google Ads 表名称:CampaignAudienceBasicStats
Google Ads API 资源: campaign_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| campaign_criterion_criterion_id | 仅限输出。条件的 ID。在变更期间,此字段会被忽略。 | |
| customer_id | 客户的 ID。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_interaction_event_types | 付费和免费互动的类型。 | |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_device | 指标应用于的设备。 | |
| segments_slot | 广告的位置。 |
Google Ads 表名称:CampaignAudienceConversionStats
Google Ads API 资源: campaign_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| campaign_criterion_criterion_id | 仅限输出。条件的 ID。在变更期间,此字段会被忽略。 | |
| customer_id | 客户的 ID。 | |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_all_conversions_value | 所有转化的总价值。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_conversion_action | 转化操作的资源名称。 | |
| segments_conversion_action_category | 转化操作类别。 | |
| segments_conversion_action_name | 转化操作名称。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_device | 指标应用于的设备。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:CampaignAudienceNonClickStats
Google Ads API 资源: campaign_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| customer_id | 客户的 ID。 | |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | |
| metrics_video_views | 视频广告的观看次数。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_device | 指标应用于的设备。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:CampaignAudienceStats
Google Ads API 资源: campaign_audience_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | |
| campaign_criterion_criterion_id | 仅限输出。条件的 ID。在变更期间,此字段会被忽略。 | |
| customer_id | 客户的 ID。 | |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_interaction_event_types | 付费和免费互动的类型。 | |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| segments_ad_network_type | 广告网络类型。 | |
| segments_click_type | 点击类型。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_device | 指标应用于的设备。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:CampaignBasicStats
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_slot | 广告的位置。 | 时段 |
Google Ads 表名称:CampaignConversionStats
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_conversion_attribution_event_type | 转化归因事件类型。 | ConversionAttributionEventType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_slot | 广告的位置。 | 时段 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:CampaignCookieStats
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。 | AbsoluteTopImpressionPercentage |
| metrics_search_budget_lost_absolute_top_impression_share | 此数字用于估算您的广告由于预算低而不是自然搜索结果上方的第一个广告的频率。注意:搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostAbsoluteTopImpressionShare |
| metrics_search_budget_lost_top_impression_share | 此数字用于估算您的广告由于预算低而未出现在自然搜索结果上方的任何位置的频率。注意:搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostTopImpressionShare |
| metrics_search_rank_lost_absolute_top_impression_share | 此数字用于估算您的广告由于广告评级差而不是自然搜索结果上方的第一个广告的频率。注意:搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostAbsoluteTopImpressionShare |
| metrics_search_rank_lost_top_impression_share | 此数字用于估算您的广告由于广告评级差而未出现在自然搜索结果上方的任何位置的频率。注意:搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostTopImpressionShare |
| metrics_search_top_impression_share | 您在热门位置(自然搜索结果上方的任何位置)获得的展示次数相较于您有资格在热门位置获得的估算展示次数。注意:搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchTopImpressionShare |
| metrics_top_impression_percentage | 显示在自然搜索结果上方的任何位置的广告展示次数所占百分比。 | TopImpressionPercentage |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
Google Ads 表名称:CampaignCriterion
Google Ads API 资源: campaign_criterion
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。使用 0 可停用设备类型。 | |
| campaign_criterion_campaign | 条件所属的广告系列。 | |
| campaign_criterion_criterion_id | 条件的 ID。在变更期间,此字段会被忽略。 | |
| campaign_criterion_device_type | 设备类型。 | |
| campaign_criterion_display_name | 条件的显示名称。对于变更,此字段会被忽略。 | |
| campaign_criterion_negative | 是定位(“false”)还是排除(“true”)条件。 | |
| campaign_criterion_status | 条件的状态。 | |
| campaign_criterion_type | 条件的类型。 | |
| campaign_id | 广告系列的 ID。 | |
| campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
Google Ads 表名称:CampaignCrossDeviceConversionStats
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_conversion_attribution_event_type | 转化归因事件类型。 | ConversionAttributionEventType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:CampaignCrossDeviceStats
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_average_page_views | 每个会话浏览网页的平均次数。 | AveragePageviews |
| metrics_average_time_on_site | 所有会话的总时长(以秒为单位)/会话数。从 Google Analytics 导入。 | AverageTimeOnSite |
| metrics_bounce_rate | 用户只访问了网站上的单个网页时使用的点击次数所占百分比。自 Google Analytics 导入。 | BounceRate |
| metrics_content_budget_lost_impression_share | 您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意:内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | ContentBudgetLostImpressionShare |
| metrics_content_impression_share | 您在展示广告网络中获得的展示次数除以您有资格获得的估算展示次数。注意: 内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | ContentImpressionShare |
| metrics_content_rank_lost_impression_share | 您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | ContentRankLostImpressionShare |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_invalid_click_rate | 报告期内从总点击次数(过滤后 + 未过滤的点击次数)过滤出的点击次数所占的百分比。 | InvalidClickRate |
| metrics_invalid_clicks | Google 认为不合规定且不向您收费的点击次数。 | InvalidClicks |
| metrics_percent_new_visitors | 首次会话数(来自之前从未访问过您的网站的用户)所占的百分比。自 Google Analytics 导入。 | PercentNewVisitors |
| metrics_phone_calls | 离线通话次数。 | NumOfflineInteractions |
| metrics_phone_impressions | 离线电话号码展示次数。 | NumOfflineImpressions |
| metrics_phone_through_rate | 接听的手机次数 (phone_calls) 除以手机号码展示次数 (phone_impressions)。 | OfflineInteractionRate |
| metrics_relative_ctr | 您的点击率 (Ctr) 除以展示您的广告的网站上所有广告主的平均点击率。衡量您的广告与同一网站上的其他广告相比在展示广告网络中的效果。 | RelativeCtr |
| metrics_search_absolute_top_impression_share | 在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请访问 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。 | SearchAbsoluteTopImpressionShare |
| metrics_search_budget_lost_absolute_top_impression_share | 此数字用于估算您的广告由于预算低而不是自然搜索结果上方的第一个广告的频率。注意:搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostAbsoluteTopImpressionShare |
| metrics_search_budget_lost_impression_share | 您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostImpressionShare |
| metrics_search_budget_lost_top_impression_share | 此数字用于估算您的广告由于预算低而未出现在自然搜索结果上方的任何位置的频率。注意:搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostTopImpressionShare |
| metrics_search_click_share | 您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意:搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchClickShare |
| metrics_search_exact_match_impression_share | 对于与关键字完全匹配(或是关键字的紧密变体形式)的搜索字词,此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意:搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchExactMatchImpressionShare |
| metrics_search_impression_share | 您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:搜索展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchImpressionShare |
| metrics_search_rank_lost_absolute_top_impression_share | 此数字用于估算您的广告由于广告评级差而不是自然搜索结果上方的第一个广告的频率。注意:搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostAbsoluteTopImpressionShare |
| metrics_search_rank_lost_impression_share | 您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostImpressionShare |
| metrics_search_rank_lost_top_impression_share | 此数字用于估算您的广告由于广告评级差而未出现在自然搜索结果上方的任何位置的频率。注意:搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostTopImpressionShare |
| metrics_search_top_impression_share | 您在热门位置(自然搜索结果上方的任何位置)获得的展示次数相较于您有资格在热门位置获得的估算展示次数。注意:搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchTopImpressionShare |
| metrics_top_impression_percentage | 显示在自然搜索结果上方的任何位置的广告展示次数所占百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:CampaignLabel
Google Ads API 资源: campaign_label
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_id | 广告系列的 ID。 | |
| campaign_label_campaign | 标签附加到的广告系列。 | |
| campaign_label_label | 分配给广告系列的标签。 | |
| campaign_label_resource_name | 资源的名称。广告系列标签资源名称采用以下格式: `customers/{customer_id}/campaignLabels/{campaign_id}~{label_id}` | |
| campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| label_id | 标签的 ID。只读。 | |
| label_name | 标签的名称。创建新标签时,此字段为必填字段,不应为空。此字符串的长度应介于 1 和 80 之间(包括 1 和 80)。 | |
| label_resource_name | 资源的名称。标签资源名称采用以下格式: `customers/{customer_id}/labels/{label_id}` |
Google Ads 表名称:CampaignLocationTargetStats
Google Ads API 资源: location_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_criterion_criterion_id | 条件的 ID。在变更期间,此字段会被忽略。 | CriterionId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:CampaignStats
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cost_per_current_model_attributed_conversion | 广告互动费用除以当前模型归因转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | CostPerCurrentModelAttributedConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_current_model_attributed_conversions | 显示历史转化数据在您选择的归因模型下的情况。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CurrentModelAttributedConversions |
| metrics_current_model_attributed_conversions_value | 当前模型归因转化的总价值。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | CurrentModelAttributedConversionValue |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | GmailForwards |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | GmailSecondaryClicks |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_value_per_current_model_attributed_conversion | 当前模型归因转化的价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerCurrentModelAttributedConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:ClickStats
Google Ads API 资源: click_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_id | 广告组的 ID。 | AdGroupId |
| ad_group_status | 广告组的状态。 | |
| campaign_id | 广告系列的 ID。 | CampaignId |
| click_view_ad_group_ad | 关联的广告。 | CreativeId |
| click_view_area_of_interest_city | 与展示相关联的城市位置条件。 | AoiCityCriteriaId |
| click_view_area_of_interest_country | 与展示相关联的国家/地区位置条件。 | AoiCountryCriteriaId |
| click_view_area_of_interest_metro | 与展示相关联的都市区地理位置条件。 | AoiMetroCriteriaId |
| click_view_area_of_interest_most_specific | 与展示相关联的最具体的地理位置条件。 | AoiMostSpecificTargetId |
| click_view_area_of_interest_region | 与展示相关联的地理位置条件。 | AoiRegionCriteriaId |
| click_view_gclid | Google 点击 ID。 | GclId |
| click_view_keyword | 关联的关键字(如果存在),并且点击对应于搜索渠道。 | CriteriaId |
| click_view_keyword_info_match_type | 关键字的匹配类型。 | KeywordMatchType |
| click_view_keyword_info_text | 关键字文本(最多 80 个字符和 10 个字词)。 | CriteriaParameters |
| click_view_location_of_presence_city | 与展示相关联的城市位置条件。 | LopCityCriteriaId |
| click_view_location_of_presence_country | 与展示相关联的国家/地区位置条件。 | LopCountryCriteriaId |
| click_view_location_of_presence_metro | 与展示相关联的都市区地理位置条件。 | LopMetroCriteriaId |
| click_view_location_of_presence_most_specific | 与展示相关联的最具体的地理位置条件。 | LopMostSpecificTargetId |
| click_view_location_of_presence_region | 与展示相关联的地理位置条件。 | LopRegionCriteriaId |
| click_view_page_number | 展示广告的页面在搜索结果中的页码。 | 页面 |
| customer_descriptive_name | (可选)客户的非唯一描述性名称。 | AccountDescriptiveName |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_clicks | 点击次数。 | 点击次数 |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_slot | 广告的位置。 | 时段 |
Google Ads 表名称:Customer
Google Ads API 资源: customer
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_auto_tagging_enabled | 客户是否启用了自动标记功能。 | IsAutoTaggingEnabled |
| customer_currency_code | 账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。 | AccountCurrencyCode |
| customer_descriptive_name | (可选)客户的非唯一描述性名称。 | AccountDescriptiveName、CustomerDescriptiveName |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| customer_manager | 相应客户是否为经理。 | CanManageClients |
| customer_test_account | 客户使用的账号是否为测试账号。 | IsTestAccount |
| customer_time_zone | 客户的当地时区 ID。 | AccountTimeZone |
Google Ads 表名称:DisplayVideoAutomaticPlacementsStats
Google Ads API 资源: group_placement_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_id | 广告组的 ID。 | |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| campaign_id | 广告系列的 ID。 | |
| campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| customer_id | 客户的 ID。 | |
| group_placement_view_placement | 组级别的系统推荐的展示位置字符串,例如网域、移动应用 ID 或 YouTube 频道 ID。 | |
| group_placement_view_placement_type | 展示位置的类型。例如,网站、YouTube 频道、移动应用。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | |
| metrics_clicks | 点击次数。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | |
| metrics_video_views | 视频广告的观看次数。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:DisplayVideoKeywordStats
Google Ads API 资源: display_keyword_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_criterion_keyword_text | 关键字文本(最多 80 个字符和 10 个字词)。 | |
| ad_group_id | 广告组的 ID。 | |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| campaign_advertising_channel_sub_type | (可选)对“advertising_channel_type”进行优化。必须是父级渠道类型的有效子类型。只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 | |
| campaign_bidding_strategy_type | 出价策略的类型。您可以通过以下方式创建出价策略:设置出价方案来创建标准出价策略,或设置“bidding_strategy”字段来创建组合出价策略。此字段为只读字段。 | |
| campaign_id | 广告系列的 ID。 | |
| campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| customer_id | 客户的 ID。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:DisplayVideoTopicStats
Google Ads API 资源: topic_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_criterion_status | 条件的状态。 | |
| ad_group_criterion_topic_path | 要定位或排除的类别。数组中的每个后续元素都描述了一个更具体的子类别。例如,“宠物与动物”“宠物”“狗”表示“宠物与动物/宠物/狗”类别。 | |
| ad_group_id | 广告组的 ID。 | |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| campaign_id | 广告系列的 ID。 | |
| campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| customer_id | 客户的 ID。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | |
| metrics_clicks | 点击次数。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:Gender
Google Ads API 资源: gender_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 | BidModifier |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效每次点击费用 (cost-per-click) 出价。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效每次点击费用出价的来源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效每千次展示费用(每千次可见的展示费用)出价。 | CpmBidStr |
| ad_group_criterion_effective_cpm_bid_source | 有效每千次展示费用出价的来源。 | CpmBidSource |
| ad_group_criterion_final_mobile_urls | 所有跨网域重定向之后可能存在的最终到达移动网址列表。 | FinalMobileUrls |
| ad_group_criterion_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 | FinalUrls |
| ad_group_criterion_gender_type | 性别的类型。 | 条件 |
| ad_group_criterion_negative | 是定位(“false”)还是排除(“true”)条件。此字段不可更改。如需将条件从正切换为负,请先移除再重新添加。 | IsNegative |
| ad_group_criterion_status | 条件的状态。 | 状态 |
| ad_group_criterion_tracking_url_template | 用于构建跟踪网址的网址模板。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。 | UrlCustomParameters |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| ad_group_targeting_setting_target_restrictions | 用于限制广告系列或广告组覆盖面的每个定位维度的设置。 | |
| bidding_strategy_name | 出价策略的名称。账号中的所有出价策略必须区分命名。此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 | BiddingStrategyName |
| bidding_strategy_type | 出价策略的类型。通过设置出价方案创建出价策略。此字段为只读字段。 | BiddingStrategyType |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_bidding_strategy | 广告系列使用的组合出价策略。 | BiddingStrategyId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:GenderBasicStats
Google Ads API 资源: gender_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
Google Ads 表名称:GenderConversionStats
Google Ads API 资源: gender_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:GenderNonClickStats
Google Ads API 资源: gender_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:GenderStats
Google Ads API 资源: gender_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | GmailForwards |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | GmailSecondaryClicks |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:GeoConversionStats
Google Ads API 资源: geographic_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_id | 广告组的 ID。 | AdGroupId |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | AdGroupName |
| ad_group_status | 广告组的状态。 | AdGroupStatus |
| campaign_id | 广告系列的 ID。 | CampaignId |
| campaign_status | 广告系列的状态。添加新的广告系列时,状态默认为 ENABLED。 | |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| geographic_view_country_criterion_id | 国家/地区的条件 ID。 | CountryCriteriaId |
| geographic_view_location_type | 广告系列的地理位置定位类型。 | LocationType |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_geo_target_most_specific_location | 代表最具体位置的地理位置定位目标常量的资源名称。 | MostSpecificCriteriaId |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:GeoStats
Google Ads API 资源: geographic_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_id | 广告组的 ID。 | AdGroupId |
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | AdGroupName |
| ad_group_status | 广告组的状态。 | AdGroupStatus |
| campaign_id | 广告系列的 ID。 | CampaignId |
| campaign_status | 广告系列的状态。添加新的广告系列时,状态默认为 ENABLED。 | |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| geographic_view_country_criterion_id | 国家/地区的条件 ID。 | CountryCriteriaId |
| geographic_view_location_type | 广告系列的地理位置定位类型。 | LocationType |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_geo_target_most_specific_location | 代表最具体位置的地理位置定位目标常量的资源名称。 | MostSpecificCriteriaId |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:HourlyAccountConversionStats
Google Ads API 资源: customer
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_hour | 以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 | HourOfDay |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:HourlyAccountStats
Google Ads API 资源: customer
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_hour | 以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 | HourOfDay |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:HourlyAdGroupConversionStats
Google Ads API 资源: ad_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_hour | 以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 | HourOfDay |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:HourlyAdGroupStats
Google Ads API 资源: ad_group
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_hour | 以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 | HourOfDay |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:HourlyBidGoalStats
Google Ads API 资源: bidding_strategy
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| bidding_strategy_campaign_count | 附加到出价策略的广告系列的数量。此字段为只读字段。 | CampaignCount |
| bidding_strategy_id | 出价策略的 ID。 | BidStrategyID |
| bidding_strategy_non_removed_campaign_count | 附加到相应出价策略的未移除广告系列的数量。 此字段为只读字段。 | NonRemovedCampaignCount |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_hour | 以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 | HourOfDay |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:HourlyCampaignConversionStats
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_hour | 以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 | HourOfDay |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:HourlyCampaignStats
Google Ads API 资源: campaign
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_hour | 以介于 0 到 23 之间(包括 0 和 23)的数字表示的时段。 | HourOfDay |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:Keyword
Google Ads API 资源: keyword_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_criterion_approval_status | 条件的审批状态。 | ApprovalStatus |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效每次点击费用 (cost-per-click) 出价。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效每次点击费用出价的来源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效每千次展示费用(每千次可见的展示费用)出价。 | CpmBidStr |
| ad_group_criterion_final_mobile_urls | 所有跨网域重定向之后可能存在的最终到达移动网址列表。 | FinalMobileUrls |
| ad_group_criterion_final_url_suffix | 用于将参数附加到最终到达网址的网址模板。 | FinalUrlSuffix |
| ad_group_criterion_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 | FinalUrls |
| ad_group_criterion_keyword_match_type | 关键字的匹配类型。 | KeywordMatchType |
| ad_group_criterion_keyword_text | 关键字文本(最多 80 个字符和 10 个字词)。 | 条件 |
| ad_group_criterion_negative | 是定位(“false”)还是排除(“true”)条件。此字段不可更改。如需将条件从正切换为负,请先移除再重新添加。 | IsNegative |
| ad_group_criterion_position_estimates_estimated_add_clicks_at_first_position_cpc | 通过将关键字出价更改为 first_position_cpc_micros 中的值,估算每周可能会获得的点击次数。 | EstimatedAddClicksAtFirstPositionCpc |
| ad_group_criterion_position_estimates_estimated_add_cost_at_first_position_cpc | 估算将关键字出价更改为 first_position_cpc_micros 中的值时,每周的费用可能发生的变化。 | EstimatedAddCostAtFirstPositionCpc |
| ad_group_criterion_position_estimates_first_page_cpc_micros | 要让广告显示在搜索结果首页所需的每次点击费用出价的估算值。 | FirstPageCpc |
| ad_group_criterion_position_estimates_first_position_cpc_micros | 要让广告显示在搜索结果首页顶部首位所需的每次点击费用出价的估算值。 | FirstPositionCpc |
| ad_group_criterion_position_estimates_top_of_page_cpc_micros | 要让广告显示在搜索结果首页顶部所需的每次点击费用出价的估算值。 | TopOfPageCpc |
| ad_group_criterion_quality_info_creative_quality_score | 与其他广告主相比广告的效果。 | CreativeQualityScore |
| ad_group_criterion_quality_info_post_click_quality_score | 着陆页的质量得分。 | PostClickQualityScore |
| ad_group_criterion_quality_info_quality_score | 质量得分。如果 Google 没有足够的信息来确定一个值,则系统可能不会填充该字段。 | QualityScore |
| ad_group_criterion_quality_info_search_predicted_ctr | 与其他广告主点击率相比的点击率。 | SearchPredictedCtr |
| ad_group_criterion_status | 条件的状态。 | 状态 |
| ad_group_criterion_system_serving_status | 条件的投放状态。 | SystemServingStatus |
| ad_group_criterion_topic_topic_constant | 主题常量资源名称。 | VerticalId |
| ad_group_criterion_tracking_url_template | 用于构建跟踪网址的网址模板。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。 | UrlCustomParameters |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_bidding_strategy | 广告系列使用的组合出价策略。 | BiddingStrategyId |
| campaign_bidding_strategy_type | 出价策略的类型。您可以通过以下方式创建出价策略:设置出价方案来创建标准出价策略,或设置“bidding_strategy”字段来创建组合出价策略。此字段为只读字段。 | BiddingStrategyType |
| campaign_id | 广告系列的 ID。 | CampaignId |
| campaign_manual_cpc_enhanced_cpc_enabled | 是否根据转化优化工具数据增强出价。 | EnhancedCpcEnabled |
| campaign_percent_cpc_enhanced_cpc_enabled | 根据转化可能性,在每次竞价中提高或降低出价。个别出价可能会超过 cpc_bid_ceiling_micros,但广告系列的平均出价金额不应超过。 | |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:KeywordBasicStats
Google Ads API 资源: keyword_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_slot | 广告的位置。 | 时段 |
Google Ads 表名称:KeywordConversionStats
Google Ads API 资源: keyword_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_slot | 广告的位置。 | 时段 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:KeywordCrossDeviceConversionStats
Google Ads API 资源: keyword_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:KeywordCrossDeviceStats
Google Ads API 资源: keyword_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_average_page_views | 每个会话浏览网页的平均次数。 | AveragePageviews |
| metrics_average_time_on_site | 所有会话的总时长(以秒为单位)/会话数。从 Google Analytics 导入。 | AverageTimeOnSite |
| metrics_bounce_rate | 用户只访问了网站上的单个网页时使用的点击次数所占百分比。自 Google Analytics 导入。 | BounceRate |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_percent_new_visitors | 首次会话数(来自之前从未访问过您的网站的用户)所占的百分比。自 Google Analytics 导入。 | PercentNewVisitors |
| metrics_search_absolute_top_impression_share | 在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请访问 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。 | SearchAbsoluteTopImpressionShare |
| metrics_search_budget_lost_absolute_top_impression_share | 此数字用于估算您的广告由于预算低而不是自然搜索结果上方的第一个广告的频率。注意:搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostAbsoluteTopImpressionShare |
| metrics_search_budget_lost_top_impression_share | 此数字用于估算您的广告由于预算低而未出现在自然搜索结果上方的任何位置的频率。注意:搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchBudgetLostTopImpressionShare |
| metrics_search_exact_match_impression_share | 对于与关键字完全匹配(或是关键字的紧密变体形式)的搜索字词,此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意:搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchExactMatchImpressionShare |
| metrics_search_impression_share | 您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:搜索展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchImpressionShare |
| metrics_search_rank_lost_absolute_top_impression_share | 此数字用于估算您的广告由于广告评级差而不是自然搜索结果上方的第一个广告的频率。注意:搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostAbsoluteTopImpressionShare |
| metrics_search_rank_lost_impression_share | 您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostImpressionShare |
| metrics_search_rank_lost_top_impression_share | 此数字用于估算您的广告由于广告评级差而未出现在自然搜索结果上方的任何位置的频率。注意:搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 | SearchRankLostTopImpressionShare |
| metrics_search_top_impression_share | 您在热门位置(自然搜索结果上方的任何位置)获得的展示次数相较于您有资格在热门位置获得的估算展示次数。注意:搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchTopImpressionShare |
| metrics_top_impression_percentage | 显示在自然搜索结果上方的任何位置的广告展示次数所占百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:KeywordStats
Google Ads API 资源: keyword_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cost_per_current_model_attributed_conversion | 广告互动费用除以当前模型归因转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | CostPerCurrentModelAttributedConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_current_model_attributed_conversions | 显示历史转化数据在您选择的归因模型下的情况。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CurrentModelAttributedConversions |
| metrics_current_model_attributed_conversions_value | 当前模型归因转化的总价值。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | CurrentModelAttributedConversionValue |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | GmailForwards |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | GmailSecondaryClicks |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_value_per_current_model_attributed_conversion | 当前模型归因转化的价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerCurrentModelAttributedConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:LandingPageStats
Google Ads API 资源: landing_page_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| ad_group_status | 广告组的状态。 | |
| campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 | |
| customer_id | 客户的 ID。 | |
| landing_page_view_unexpanded_final_url | 广告主指定的最终到达网址。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_clicks | 点击次数。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_mobile_friendly_clicks_percentage | 适合移动设备的页面的移动点击次数所占的百分比。 | |
| metrics_speed_score | 衡量点击移动广告后网页加载的速度。 得分范围介于 1 到 10 之间,10 是最快的。 | |
| metrics_valid_accelerated_mobile_pages_clicks_percentage | 到达有效 AMP 网页的 Accelerated Mobile Pages (AMP) 着陆页的广告点击次数所占百分比。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:LocationBasedCampaignCriterion
Google Ads API 资源: location_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| campaign_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。使用 0 可停用设备类型。 | BidModifier |
| campaign_criterion_criterion_id | 条件的 ID。在变更期间,此字段会被忽略。 | CriterionId |
| campaign_criterion_negative | 是定位(“false”)还是排除(“true”)条件。 | IsNegative |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:LocationsDistanceStats
Google Ads API 资源: distance_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_id | 客户的 ID。 | |
| distance_view_distance_bucket | 附加地址信息中的用户距离分组。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:LocationsUserLocationsStats
Google Ads API 资源: user_location_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| customer_id | 客户的 ID。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_clicks | 点击次数。 | |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_geo_target_city | 表示城市的地理位置定位目标常量的资源名称。 | |
| segments_geo_target_most_specific_location | 代表最具体位置的地理位置定位目标常量的资源名称。 | |
| segments_geo_target_region | 代表区域的地理位置定位目标常量的资源名称。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 | |
| user_location_view_country_criterion_id | 国家/地区的条件 ID。 | |
| user_location_view_targeting_location | 目标位置。 |
Google Ads 表名称:PaidOrganicStats
Google Ads API 资源: paid_organic_search_term_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_combined_clicks | 您的广告或网站的商品详情在未付费结果中的点击次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 | CombinedAdsOrganicClicks |
| metrics_combined_clicks_per_query | 您的广告或网站的商品详情在未付费结果中的点击次数 (combined_clicks) 除以 combined_queries。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 | CombinedAdsOrganicClicksPerQuery |
| metrics_combined_queries | 在未付费结果中返回您的网站的网页或展示一个文字广告的搜索次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 | CombinedAdsOrganicQueries |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_organic_clicks | 某人针对特定查询点击未付费结果中您的网站的商品详情的次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 | OrganicClicks |
| metrics_organic_clicks_per_query | 某人点击未付费结果中您的网站的商品详情的次数 (organic_clicks) 除以返回您的网站的网页的总搜索次数 (organic_queries)。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 | OrganicClicksPerQuery |
| metrics_organic_impressions | 未付费搜索结果中您的网站的商品详情数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 | OrganicImpressions |
| metrics_organic_impressions_per_query | 您的网站的网页在未付费搜索结果中列出的次数 (organic_impressions) 除以在未付费结果中返回您的网站的商品详情的搜索次数 (organic_queries)。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 | OrganicImpressionsPerQuery |
| metrics_organic_queries | 在未付费结果中返回您的网站的商品详情的总搜索次数。如需了解详情,请参阅 https://support.google.com/google-ads/answer/3097241 提供的帮助页面。 | OrganicQueries |
| paid_organic_search_term_view_search_term | 搜索字词。 | SearchQuery |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_search_engine_results_page_type | 搜索引擎结果页 (SERP) 的类型。 | SerpType |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:ParentalStatus
Google Ads API 资源: parental_status_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效每次点击费用 (cost-per-click) 出价。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效每次点击费用出价的来源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效每千次展示费用(每千次可见的展示费用)出价。 | CpmBidStr |
| ad_group_criterion_effective_cpm_bid_source | 有效每千次展示费用出价的来源。 | CpmBidSource |
| ad_group_criterion_final_mobile_urls | 所有跨网域重定向之后可能存在的最终到达移动网址列表。 | FinalMobileUrls |
| ad_group_criterion_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 | FinalUrls |
| ad_group_criterion_negative | 是定位(“false”)还是排除(“true”)条件。此字段不可更改。如需将条件从正切换为负,请先移除再重新添加。 | IsNegative |
| ad_group_criterion_parental_status_type | 育儿状况的类型。 | 条件 |
| ad_group_criterion_status | 条件的状态。 | 状态 |
| ad_group_criterion_tracking_url_template | 用于构建跟踪网址的网址模板。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。 | UrlCustomParameters |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| ad_group_targeting_setting_target_restrictions | 用于限制广告系列或广告组覆盖面的每个定位维度的设置。 | |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_bidding_strategy | 广告系列使用的组合出价策略。 | BiddingStrategyId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:ParentalStatusBasicStats
Google Ads API 资源: parental_status_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
Google Ads 表名称:ParentalStatusConversionStats
Google Ads API 资源: parental_status_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:ParentalStatusNonClickStats
Google Ads API 资源: parental_status_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:ParentalStatusStats
Google Ads API 资源: parental_status_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | GmailForwards |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | GmailSecondaryClicks |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:Placement
Google Ads API 资源: managed_placement_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 | BidModifier |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_criterion_effective_cpc_bid_micros | 有效每次点击费用 (cost-per-click) 出价。 | CpcBid |
| ad_group_criterion_effective_cpc_bid_source | 有效每次点击费用出价的来源。 | CpcBidSource |
| ad_group_criterion_effective_cpm_bid_micros | 有效每千次展示费用(每千次可见的展示费用)出价。 | CpmBidStr |
| ad_group_criterion_effective_cpm_bid_source | 有效每千次展示费用出价的来源。 | CpmBidSource |
| ad_group_criterion_final_mobile_urls | 所有跨网域重定向之后可能存在的最终到达移动网址列表。 | FinalMobileUrls |
| ad_group_criterion_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 | FinalUrls |
| ad_group_criterion_negative | 是定位(“false”)还是排除(“true”)条件。此字段不可更改。如需将条件从正切换为负,请先移除再重新添加。 | IsNegative |
| ad_group_criterion_placement_url | 展示位置的网址。例如,“http://www.domain.com”。 | 条件 |
| ad_group_criterion_status | 条件的状态。 | 状态 |
| ad_group_criterion_tracking_url_template | 用于构建跟踪网址的网址模板。 | TrackingUrlTemplate |
| ad_group_criterion_url_custom_parameters | 用于替换“tracking_url_template”“final_urls”或“mobile_final_urls”中的自定义参数标记的映射列表。 | UrlCustomParameters |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| ad_group_targeting_setting_target_restrictions | 用于限制广告系列或广告组覆盖面的每个定位维度的设置。 | |
| bidding_strategy_name | 出价策略的名称。账号中的所有出价策略必须区分命名。此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 | BiddingStrategyName |
| bidding_strategy_type | 出价策略的类型。通过设置出价方案创建出价策略。此字段为只读字段。 | BiddingStrategyType |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_bidding_strategy | 广告系列使用的组合出价策略。 | BiddingStrategyId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
Google Ads 表名称:PlacementBasicStats
Google Ads API 资源: managed_placement_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
Google Ads 表名称:PlacementConversionStats
Google Ads API 资源: managed_placement_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:PlacementNonClickStats
Google Ads API 资源: managed_placement_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:PlacementStats
Google Ads API 资源: managed_placement_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_base_ad_group | 对于草稿或实验广告组,此字段是从中创建此广告组的基础广告组的资源名称。如果草稿或实验广告组没有基础广告组,则此字段为 null。对于基础广告组,此字段与广告组资源名称相同。 此字段为只读字段。 | BaseAdGroupId |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | CriterionId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_base_campaign | 广告系列草稿或实验广告系列的基准广告系列资源名称。 对于基准广告系列,与“resource_name”相同。此字段为只读字段。 | BaseCampaignId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_active_view_cpm | 可见的展示(“active_view_impressions”)的平均费用。 | ActiveViewCpm |
| metrics_active_view_ctr | Active View 可衡量的点击次数除以 Active View 可见的展示次数。 系统仅会针对展示广告网络报告此指标。 | ActiveViewCtr |
| metrics_active_view_impressions | 衡量广告在展示广告网络网站上的可见频率。 | ActiveViewImpressions |
| metrics_active_view_measurability | Active View 可衡量的展示次数与投放展示次数之比。 | ActiveViewMeasurability |
| metrics_active_view_measurable_cost_micros | Active View 可衡量的您获得的展示费用。 | ActiveViewMeasurableCost |
| metrics_active_view_measurable_impressions | 广告出现在可见位置中的展示位置的次数。 | ActiveViewMeasurableImpressions |
| metrics_active_view_viewability | 广告出现在启用了 Active View 的网站上(可衡量的展示次数)且可见(可见的展示次数)的时间百分比。 | ActiveViewViewability |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate、ConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_gmail_forwards | 广告以邮件形式转发给其他人的次数。 | GmailForwards |
| metrics_gmail_saves | 某人将 Gmail 广告以邮件形式保存到收件箱的次数。 | GmailSaves |
| metrics_gmail_secondary_clicks | Gmail 广告展开状态下的着陆页点击次数。 | GmailSecondaryClicks |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:ProductGroupStats
Google Ads API 资源: product_group_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 | |
| ad_group_criterion_criterion_id | 条件的 ID。对于变更,此字段会被忽略。 | |
| ad_group_criterion_display_name | 条件的显示名称。对于变更,此字段会被忽略。 | |
| ad_group_criterion_listing_group_case_value_product_bidding_category_id (obsolete - use ad_group_criterion_listing_group_case_value_product_category_category_id instead) | 商品出价类别的 ID。此 ID 等同于本文档中所述的 google_product_category ID: https://support.google.com/merchants/answer/6324436 | |
| ad_group_criterion_listing_group_case_value_product_bidding_category_level (obsolete - use ad_group_criterion_listing_group_case_value_product_category_level instead) | 商品出价类别的级别。 | |
| ad_group_criterion_listing_group_case_value_product_brand_value | 商品品牌的字符串值。 | |
| ad_group_criterion_listing_group_case_value_product_channel_channel | 相应地区的价值。 | |
| ad_group_criterion_listing_group_case_value_product_channel_exclusivity_channel_exclusivity | 提供情况的值。 | |
| ad_group_criterion_listing_group_case_value_product_condition_condition | 条件的值。 | |
| ad_group_criterion_listing_group_case_value_product_custom_attribute_index | 表示自定义属性的索引。 | |
| ad_group_criterion_listing_group_case_value_product_custom_attribute_value | 商品自定义属性的字符串值。 | |
| ad_group_criterion_listing_group_case_value_product_item_id_value | 相应 ID 的值。 | |
| ad_group_criterion_listing_group_case_value_product_type_level | 类型的级别。 | |
| ad_group_criterion_listing_group_case_value_product_type_value | 相应类型的值。 | |
| ad_group_criterion_status | 条件的状态。 | |
| ad_group_id | 广告组的 ID。 | |
| campaign_id | 广告系列的 ID。 | |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | |
| metrics_clicks | 点击次数。 | |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | |
| product_group_view_resource_name | 商品组视图的资源名称。产品组视图资源名称采用以下格式:customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id} | |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | |
| segments_day_of_week | 星期几。例如,MONDAY。 | |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | |
| segments_year | 年份,格式为 yyyy。 |
Google Ads 表名称:SearchQueryConversionStats
Google Ads API 资源: search_term_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| search_term_view_search_term | 搜索字词。 | 查询 |
| search_term_view_status | 指示搜索字词是否为定位关键字或排除关键字。 | QueryTargetingStatus |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_search_term_match_type | 触发广告的关键字的匹配类型,包括变体形式。 | QueryMatchTypeWithVariant |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:SearchQueryStats
Google Ads API 资源: search_term_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_absolute_top_impression_percentage | 显示为自然搜索结果上方的第一个广告的广告展示次数所占百分比。 | AbsoluteTopImpressionPercentage |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cost | 您为每次互动支付的平均金额。其计算方式为广告的总费用除以广告的总互动次数。 | AverageCost |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_average_cpe | 您为广告深度互动支付的平均金额。此金额是所有广告深度互动的总费用除以广告深度互动总次数。 | AverageCpe |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_interaction_event_types | 付费和免费互动的类型。 | InteractionTypes |
| metrics_interaction_rate | 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。 | InteractionRate |
| metrics_interactions | 互动次数。互动是指与某种广告格式关联的主要用户操作,例如文字广告和购物广告的点击,或视频广告的观看。 | 互动次数 |
| metrics_top_impression_percentage | 显示在自然搜索结果上方的任何位置的广告展示次数所占百分比。 | TopImpressionPercentage |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| search_term_view_search_term | 搜索字词。 | 查询 |
| search_term_view_status | 指示搜索字词是否为定位关键字或排除关键字。 | QueryTargetingStatus |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如:2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_search_term_match_type | 触发广告的关键字的匹配类型,包括变体形式。 | QueryMatchTypeWithVariant |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:ShoppingProductConversionStats
Google Ads API 资源: shopping_performance_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| campaign_status | 广告系列的状态。添加新的广告系列时,状态默认为 ENABLED。 | |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_product_aggregator_id | 商品的集合商家 ID。 | AggregatorId |
| segments_product_bidding_category_level1 (obsolete - use segments_product_category_level1 instead) | 商品的出价类别(第 1 级)。 | CategoryL1 |
| segments_product_bidding_category_level2 (obsolete - use segments_product_category_level2 instead) | 商品的出价类别(第 2 级)。 | CategoryL2 |
| segments_product_bidding_category_level3 (obsolete - use segments_product_category_level3 instead) | 商品的出价类别(第 3 级)。 | CategoryL3 |
| segments_product_bidding_category_level4 (obsolete - use segments_product_category_level4 instead) | 商品的出价类别(第 4 级)。 | CategoryL4 |
| segments_product_bidding_category_level5 (obsolete - use segments_product_category_level5 instead) | 商品的出价类别(第 5 级)。 | CategoryL5 |
| segments_product_category_level1 | 商品的类别(第 1 级)。 | CategoryL1 |
| segments_product_category_level2 | 商品的类别(第 2 级)。 | CategoryL2 |
| segments_product_category_level3 | 商品的类别(第 3 级)。 | CategoryL3 |
| segments_product_category_level4 | 商品的类别(第 4 级)。 | CategoryL4 |
| segments_product_category_level5 | 商品的类别(第 5 级)。 | CategoryL5 |
| segments_product_brand | 商品的品牌。 | 品牌 |
| segments_product_channel | 商品的渠道。 | 渠道 |
| segments_product_channel_exclusivity | 商品的渠道独占性。 | ChannelExclusivity |
| segments_product_condition | 商品的使用情况。 | ProductCondition |
| segments_product_country | 商品目标销售国家/地区的地理位置定位目标常量的资源名称。 | CountryCriteriaId |
| segments_product_custom_attribute0 | 商品的自定义属性 0。 | CustomAttribute0 |
| segments_product_custom_attribute1 | 商品的自定义属性 1。 | CustomAttribute1 |
| segments_product_custom_attribute2 | 商品的自定义属性 2。 | CustomAttribute2 |
| segments_product_custom_attribute3 | 商品的自定义属性 3。 | CustomAttribute3 |
| segments_product_custom_attribute4 | 商品的自定义属性 4。 | CustomAttribute4 |
| segments_product_item_id | 商品的项目 ID。 | OfferId |
| segments_product_language | 商品语言的语言常量的资源名称。 | LanguageCriteriaId |
| segments_product_merchant_id | 商品的商家 ID。 | MerchantId |
| segments_product_store_id | 商品的商店 ID。 | StoreId |
| segments_product_type_l1 | 商品的类型(第 1 级)。 | ProductTypeL1 |
| segments_product_type_l2 | 商品的类型(第 2 级)。 | ProductTypeL2 |
| segments_product_type_l3 | 商品的类型(第 3 级)。 | ProductTypeL3 |
| segments_product_type_l4 | 商品的类型(第 4 级)。 | ProductTypeL4 |
| segments_product_type_l5 | 商品的类型(第 5 级)。 | ProductTypeL5 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:ShoppingProductStats
Google Ads API 资源: shopping_performance_view
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| campaign_status | 广告系列的状态。添加新的广告系列时,状态默认为 ENABLED。 | |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cpc | 所有点击的总费用除以获得的总点击次数。 | AverageCpc |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_from_interactions_rate | 互动带来的转化次数除以广告互动次数(例如文字广告点击次数或视频广告观看次数)。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionRate |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_search_absolute_top_impression_share | 在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情,请访问 https://support.google.com/google-ads/answer/7501826。任何低于 0.1 的值都会报告为 0.0999。 | SearchAbsoluteTopImpressionShare |
| metrics_search_click_share | 您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意:搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchClickShare |
| metrics_search_impression_share | 您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:搜索展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 | SearchImpressionShare |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_value_per_conversion | 转化价值除以转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | ValuePerConversion |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如:2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_product_aggregator_id | 商品的集合商家 ID。 | AggregatorId |
| segments_product_bidding_category_level1 (obsolete - use segments_product_category_level1 instead) | 商品的出价类别(第 1 级)。 | CategoryL1 |
| segments_product_bidding_category_level2 (obsolete - use segments_product_category_level2 instead) | 商品的出价类别(第 2 级)。 | CategoryL2 |
| segments_product_bidding_category_level3 (obsolete - use segments_product_category_level3 instead) | 商品的出价类别(第 3 级)。 | CategoryL3 |
| segments_product_bidding_category_level4 (obsolete - use segments_product_category_level4 instead) | 商品的出价类别(第 4 级)。 | CategoryL4 |
| segments_product_bidding_category_level5 (obsolete - use segments_product_category_level5 instead) | 商品的出价类别(第 5 级)。 | CategoryL5 |
| segments_product_category_level1 | 商品的类别(第 1 级)。 | CategoryL1 |
| segments_product_category_level2 | 商品的类别(第 2 级)。 | CategoryL2 |
| segments_product_category_level3 | 商品的类别(第 3 级)。 | CategoryL3 |
| segments_product_category_level4 | 商品的类别(第 4 级)。 | CategoryL4 |
| segments_product_category_level5 | 商品的类别(第 5 级)。 | CategoryL5 |
| segments_product_brand | 商品的品牌。 | 品牌 |
| segments_product_channel | 商品的渠道。 | 渠道 |
| segments_product_channel_exclusivity | 商品的渠道独占性。 | ChannelExclusivity |
| segments_product_condition | 商品的使用情况。 | ProductCondition |
| segments_product_country | 商品目标销售国家/地区的地理位置定位目标常量的资源名称。 | CountryCriteriaId |
| segments_product_custom_attribute0 | 商品的自定义属性 0。 | CustomAttribute0 |
| segments_product_custom_attribute1 | 商品的自定义属性 1。 | CustomAttribute1 |
| segments_product_custom_attribute2 | 商品的自定义属性 2。 | CustomAttribute2 |
| segments_product_custom_attribute3 | 商品的自定义属性 3。 | CustomAttribute3 |
| segments_product_custom_attribute4 | 商品的自定义属性 4。 | CustomAttribute4 |
| segments_product_item_id | 商品的项目 ID。 | OfferId |
| segments_product_language | 商品语言的语言常量的资源名称。 | LanguageCriteriaId |
| segments_product_merchant_id | 商品的商家 ID。 | MerchantId |
| segments_product_type_l1 | 商品的类型(第 1 级)。 | ProductTypeL1 |
| segments_product_type_l2 | 商品的类型(第 2 级)。 | ProductTypeL2 |
| segments_product_type_l3 | 商品的类型(第 3 级)。 | ProductTypeL3 |
| segments_product_type_l4 | 商品的类型(第 4 级)。 | ProductTypeL4 |
| segments_product_type_l5 | 商品的类型(第 5 级)。 | ProductTypeL5 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
Google Ads 表名称:Video
Google Ads API 资源: 视频
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_status | 广告的状态。 | |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| video_duration_millis | 视频的时长(以毫秒为单位)。 | VideoDuration |
| video_id | 视频的 ID。 | VideoId |
| video_title | 视频的标题。 | VideoTitle |
Google Ads 表名称:VideoBasicStats
Google Ads API 资源: 视频
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_ad_status | 广告的状态。 | CreativeStatus |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| metrics_view_through_conversions | 浏览型转化总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 | ViewThroughConversions |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_device | 指标应用于的设备。 | 设备 |
| video_channel_id | 视频的所有者频道 ID。 | VideoChannelId |
| video_id | 视频的 ID。 | VideoId |
Google Ads 表名称:VideoConversionStats
Google Ads API 资源: 视频
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_ad_status | 广告的状态。 | CreativeStatus |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_conversion_action | 转化操作的资源名称。 | ConversionTrackerId |
| segments_conversion_action_category | 转化操作类别。 | ConversionCategoryName |
| segments_conversion_action_name | 转化操作名称。 | ConversionTypeName |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
| video_channel_id | 视频的所有者频道 ID。 | VideoChannelId |
| video_id | 视频的 ID。 | VideoId |
Google Ads 表名称:VideoNonClickStats
Google Ads API 资源: 视频
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_ad_status | 广告的状态。 | |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions | 转化总次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | AllConversions |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | AllConversionRate |
| metrics_all_conversions_value | 所有转化的总价值。 | AllConversionValue |
| metrics_average_cpv | 每次有人观看您的广告时您需要支付的平均金额。平均每次观看费用通过所有广告观看次数总费用除以观看次数来定义。 | AverageCpv |
| metrics_cost_per_all_conversions | 广告互动费用除以所有转化次数。 | CostPerAllConversion |
| metrics_cross_device_conversions | 客户在一台设备上点击 Google Ads 广告,然后在其他设备或浏览器中转化时带来的转化。跨设备转化已包含在 all_conversions 中。 | CrossDeviceConversions |
| metrics_engagement_rate | 在用户看到广告后与其互动的频率。此频率是广告展开次数除以广告展示次数。 | EngagementRate |
| metrics_engagements | 深度互动次数。当观看者展开灯箱广告时会发生深度互动。另外,将来其他广告类型可能也会支持互动指标。 | 互动 |
| metrics_value_per_all_conversions | 所有转化的价值除以所有转化的次数。 | ValuePerAllConversion |
| metrics_video_quartile_p100_rate | 观看者观看了您的所有视频时使用的展示次数所占百分比。 | VideoQuartile100Rate |
| metrics_video_quartile_p25_rate | 观看者观看了 25% 的视频时使用的展示次数所占百分比。 | VideoQuartile25Rate |
| metrics_video_quartile_p50_rate | 观看者观看了 50% 的视频时使用的展示次数所占百分比。 | VideoQuartile50Rate |
| metrics_video_quartile_p75_rate | 观看者观看了 75% 的视频时使用的展示次数所占百分比。 | VideoQuartile75Rate |
| metrics_video_view_rate | TrueView 视频广告获得的观看次数除以其展示次数,包括 TrueView 展示广告的缩略图展示次数。 | VideoViewRate |
| metrics_video_views | 视频广告的观看次数。 | VideoViews |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如,2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
| video_channel_id | 视频的所有者频道 ID。 | VideoChannelId |
| video_id | 视频的 ID。 | VideoId |
Google Ads 表名称:VideoStats
Google Ads API 资源: 视频
| Google Ads 字段名称 | 说明 | Google Ads 映射的字段名称 |
|---|---|---|
| ad_group_ad_ad_id | 广告的 ID。 | CreativeId |
| ad_group_ad_status | 广告的状态。 | CreativeStatus |
| ad_group_id | 广告组的 ID。 | AdGroupId |
| campaign_id | 广告系列的 ID。 | CampaignId |
| customer_id | 客户的 ID。 | ExternalCustomerId |
| metrics_all_conversions_from_interactions_rate | 互动带来的所有转化(与浏览型转化不同)次数除以广告互动次数。 | ConversionRate |
| metrics_average_cpm | 平均每千次展示费用 (CPM)。 | AverageCpm |
| metrics_clicks | 点击次数。 | 点击次数 |
| metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 属性设置为 true 的转化操作。 | 转化次数 |
| metrics_conversions_value | 转化的总价值。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | ConversionValue |
| metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 | 费用 |
| metrics_cost_per_conversion | 广告互动费用除以转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 | CostPerConversion |
| metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 | 点击率 |
| metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 | 展示次数 |
| segments_ad_network_type | 广告网络类型。 | AdNetworkType2 |
| segments_click_type | 点击类型。 | ClickType |
| segments_date | 指标适用的日期。格式为 yyyy-MM-dd。例如:2018-04-17。 | 日期 |
| segments_day_of_week | 星期几。例如,MONDAY。 | DayOfWeek |
| segments_device | 指标应用于的设备。 | 设备 |
| segments_month | 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。 | 月 |
| segments_quarter | 由一个季度第一天的日期表示的季度。使用日历年作为季度。例如,2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。 | 季度 |
| segments_week | 定义为星期一到星期日的一周,由星期一的日期表示。格式为 yyyy-MM-dd。 | 周 |
| segments_year | 年份,格式为 yyyy。 | 年 |
| video_channel_id | 视频的所有者频道 ID。 | VideoChannelId |
| video_id | 视频的 ID。 | VideoId |
Google Ads 匹配表
Google Ads 匹配表是仅包含特性字段(包含设置或其他固定数据的字段)的表,是为用户查询账号结构信息而定义。如果您使用刷新窗口或安排回填,则系统不会更新匹配表快照。
以下是 Google Ads 转移作业中的匹配表列表:
- Ad
- AdGroup
- AdGroupAudience
- AdGroupBidModifier
- AdGroupAdLabel
- AdGroupCriterion
- AdGroupCriterionLabel
- AdGroupLabel
- AgeRange
- 素材资源
- AssetGroup
- AssetGroupAsset
- AssetGroupListingGroupFilter
- AssetGroupSignal
- 受众群体
- BidGoal
- 预算
- Campaign
- CampaignAudience
- CampaignCriterion
- CampaignLabel
- 客户
- 性别
- 关键字
- LocationBasedCampaignCriterion
- ParentalStatus
- Placement
- 视频