Search Ads 360 报告转换
本文档介绍了如何转换 Search Ads 360 报告。
如需查看使用旧版 Search Ads 360 Reporting API 的 Search Ads 360 报告转换,请参阅 Search Ads 360 报告转换(已弃用)。
Search Ads 360 报告的表映射
当 Search Ads 360 报告转移到 BigQuery 时,报告会转换为以下 BigQuery 表和视图。当您在 BigQuery 中查看表和视图时,customer_id 的值就是您的 Search Ads 360 客户 ID。
ad_group
- 表格:
-
p_sa_AdGroup_customer_id
p_sa_AdGroupConversionActionAndDeviceStats_customer_id
p_sa_AdGroupDeviceStats_customer_id
p_sa_AdGroupStats_customer_id - 观看次数:
-
sa_AdGroup_customer_id
sa_AdGroupConversionActionAndDeviceStats_customer_id
sa_AdGroupDeviceStats_customer_id
sa_AdGroupStats_customer_id
ad_group_ad
- 表格:
-
p_sa_Ad_customer_id
p_sa_AdConversionActionAndDeviceStats_customer_id
p_sa_AdDeviceStats_customer_id - 观看次数:
-
a_Ad_customer_id
sa_AdConversionActionAndDeviceStats_customer_id
sa_AdDeviceStats_customer_id
ad_group_asset
- 表格:
-
p_sa_AdGroupAssetStats_customer_id
p_sa_AdGroupConversionActionAndAssetStats_customer_id - 观看次数:
-
sa_AdGroupAssetStats_customer_id
sa_AdGroupConversionActionAndAssetStats_customer_id
ad_group_audience_view
- 表格:
-
p_sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
p_sa_AdGroupAudienceDeviceStats_customer_id - 观看次数:
-
sa_AdGroupAudienceConversionActionAndDeviceStats_customer_id
sa_AdGroupAudienceDeviceStats_customer_id
ad_group_criterion
- 表格:
-
p_sa_AdGroupCriterion_customer_id
p_sa_NegativeAdGroupCriterion_customer_id
p_sa_NegativeAdGroupKeyword_customer_id - 观看次数:
-
sa_AdGroupCriterion_customer_id
sa_NegativeAdGroupCriterion_customer_id
sa_NegativeAdGroupKeyword_customer_id
age_range_view
- 表格:
-
p_sa_AgeRangeConversionActionAndDeviceStats_customer_id
p_sa_AgeRangeDeviceStats_customer_id - 观看次数:
-
sa_AgeRangeConversionActionAndDeviceStats_customer_id
sa_AgeRangeDeviceStats_customer_id
资产
- 表格:
- p_sa_Asset_customer_id
- 观看次数:
- sa_Asset_customer_id
asset_set_asset
- 表格:
-
p_sa_AccountConversionActionAndAssetStats_customer_id
p_sa_AssetSetStats_customer_id - 观看次数:
-
sa_AccountConversionActionAndAssetStats_customer_id
sa_AssetSetStats_customer_id
bidding_strategy
- 表格:
-
p_sa_BidStrategy_customer_id
p_sa_BidStrategyStats_customer_id - 观看次数:
-
sa_BidStrategy_customer_id
sa_BidStrategyStats_customer_id
广告系列
- 表格:
-
p_sa_Campaign_customer_id
p_sa_CampaignConversionActionAndDeviceStats_customer_id
p_sa_CampaignDeviceStats_customer_id
p_sa_CampaignStats_customer_id - 观看次数:
-
sa_Campaign_customer_id
sa_CampaignConversionActionAndDeviceStats_customer_id
sa_CampaignDeviceStats_customer_id
sa_CampaignStats_customer_id
campaign_asset
- 表格:
-
p_sa_CampaignAssetStats_customer_id
p_sa_CampaignConversionActionAndAssetStats_customer_id - 观看次数:
-
sa_CampaignAssetStats_customer_id
sa_CampaignConversionActionAndAssetStats_customer_id
campaign_audience_view
- 表格:
-
p_sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
p_sa_CampaignAudienceDeviceStats_customer_id - 观看次数:
-
sa_CampaignAudienceConversionActionAndDeviceStats_customer_id
sa_CampaignAudienceDeviceStats_customer_id
campaign_criterion
- 表格:
-
p_sa_CampaignCriterion_customer_id
p_sa_NegativeCampaignCriterion_customer_id
p_sa_NegativeCampaignKeyword_customer_id - 观看次数:
-
sa_CampaignCriterion_customer_id
sa_NegativeCampaignCriterion_customer_id
sa_NegativeCampaignKeyword_customer_id
cart_data_sales_view
- 表格:
- p_sa_CartDataSalesStats_customer_id
- 观看次数:
- sa_CartDataSalesStats_customer_id
转化
- 表格:
- p_sa_Conversion_customer_id
- 观看次数:
- sa_Conversion_customer_id
conversion_action
- 表格:
- p_sa_ConversionAction_customer_id
- 观看次数:
- sa_ConversionAction_customer_id
customer
- 表格:
-
p_sa_Account_customer_id
p_sa_AccountConversionActionAndDeviceStats_customer_id
p_sa_AccountDeviceStats_customer_id
p_sa_AccountStats_customer_id - 观看次数:
-
sa_Account_customer_id
sa_AccountConversionActionAndDeviceStats_customer_id
sa_AccountDeviceStats_customer_id
sa_AccountStats_customer_id
customer_asset
- 表格:
- p_sa_AccountAssetStats_customer_id
- 观看次数:
- sa_AccountAssetStats_customer_id
gender_view
- 表格:
-
p_sa_GenderConversionActionAndDeviceStats_customer_id
p_sa_GenderDeviceStats_customer_id - 观看次数:
-
sa_GenderConversionActionAndDeviceStats_customer_id
sa_GenderDeviceStats_customer_id
keyword_view
- 表格:
-
p_sa_Keyword_customer_id
p_sa_KeywordConversionActionAndDeviceStats_customer_id
p_sa_KeywordDeviceStats_customer_id
p_sa_KeywordStats_customer_id - 观看次数:
-
sa_Keyword_customer_id
sa_KeywordConversionActionAndDeviceStats_customer_id
sa_KeywordDeviceStats_customer_id
sa_KeywordStats_customer_id
location_view
- 表格:
-
p_sa_LocationConversionActionAndDeviceStats_customer_id
p_sa_LocationDeviceStats_customer_id - 观看次数:
-
sa_LocationConversionActionAndDeviceStats_customer_id
sa_LocationDeviceStats_customer_id
product_group_view
- 表格:
-
p_sa_ProductGroup_customer_id
p_sa_ProductGroupStats_customer_id - 观看次数:
-
sa_ProductGroup_customer_id
sa_ProductGroupStats_customer_id
shopping_performance_view
- 表格:
-
p_sa_ProductAdvertised_customer_id
p_sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
p_sa_ProductAdvertisedDeviceStats_customer_id - 观看次数:
-
sa_ProductAdvertised_customer_id
sa_ProductAdvertisedConversionActionAndDeviceStats_customer_id
sa_ProductAdvertisedDeviceStats_customer_id
访问
- 表格:
- p_sa_Visit_customer_id
- 观看次数:
- sa_Visit_customer_id
webpage_view
- 表格:
-
p_sa_WebpageConversionActionAndDeviceStats_customer_id
p_sa_WebpageDeviceStats_customer_id - 观看次数:
-
sa_WebpageConversionActionAndDeviceStats_customer_id
sa_WebpageDeviceStats_customer_id
Search Ads 360 报告的列详细信息
Search Ads 360 转移作业创建的 BigQuery 表包含以下列(字段):
Search Ads 360 表名称:Account
Search Ads 360 API 资源:customer
Search Ads 360 字段名称 | 说明 |
---|---|
customer_account_type | 引擎账号类型。例如:Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track。 |
customer_creation_time | 创建此客户时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
customer_currency_code | 账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。 |
customer_descriptive_name | (可选)客户的非唯一描述性名称。 |
customer_engine_id | 外部引擎账号中的账号的 ID。 |
customer_id | 客户的 ID。 |
customer_last_modified_time | 上次修改此客户的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
customer_status | 客户的状态。 |
customer_time_zone | 客户的当地时区 ID。 |
Search Ads 360 表名称:AccountAssetStats
Search Ads 360 API 资源:customer_asset
Search Ads 360 字段名称 | 说明 |
---|---|
customer_asset_asset | 必需。不可变。与客户关联的素材资源。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:AccountConversionActionAndAssetStats
Search Ads 360 API 资源:asset_set_asset
Search Ads 360 字段名称 | 说明 |
---|---|
asset_set_asset_asset | 不可变。此素材资源集中的素材资源所关联的素材资源。 |
asset_set_asset_asset_set | 不可变。此素材资源集中的素材资源所关联的素材资源集。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:AccountConversionActionAndDeviceStats
Search Ads 360 API 资源:customer
Search Ads 360 字段名称 | 说明 |
---|---|
customer_engine_id | 外部引擎账号中的账号的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AccountDeviceStats
Search Ads 360 API 资源:customer
Search Ads 360 字段名称 | 说明 |
---|---|
customer_engine_id | 外部引擎账号中的账号的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
metrics_visits | Search Ads 360 成功记录并转到广告主着陆页的点击次数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AccountStats
Search Ads 360 API 资源:customer
Search Ads 360 字段名称 | 说明 |
---|---|
customer_engine_id | 外部引擎账号中的账号的 ID。 |
customer_id | 客户的 ID。 |
metrics_content_budget_lost_impression_share | 您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
metrics_content_impression_share | 您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
metrics_content_rank_lost_impression_share | 您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
metrics_historical_quality_score | 历史质量得分。 |
metrics_search_budget_lost_impression_share | 您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
metrics_search_impression_share | 您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
metrics_search_rank_lost_impression_share | 您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:Ad
Search Ads 360 API 资源:ad_group_ad
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_ad_ad_display_url | 在某些广告格式的广告说明中显示的网址。 |
ad_group_ad_ad_expanded_dynamic_search_ad_description1 | 广告说明的第一行。 |
ad_group_ad_ad_expanded_dynamic_search_ad_description2 | 广告说明的第二行。 |
ad_group_ad_ad_expanded_text_ad_description1 | 广告说明的第一行。 |
ad_group_ad_ad_expanded_text_ad_description2 | 广告说明的第二行。 |
ad_group_ad_ad_expanded_text_ad_headline | 广告的标题。 |
ad_group_ad_ad_expanded_text_ad_headline2 | 广告的第二个标题。 |
ad_group_ad_ad_expanded_text_ad_headline3 | 广告的第三个标题。 |
ad_group_ad_ad_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
ad_group_ad_ad_id | 广告的 ID。 |
ad_group_ad_ad_name | 广告的名称。此名称仅用于能够标识广告。该名称不必是唯一的,也不会影响投放的广告。目前只有 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd 支持名称字段。 |
ad_group_ad_ad_text_ad_description1 | 广告说明的第一行。 |
ad_group_ad_ad_text_ad_description2 | 广告说明的第二行。 |
ad_group_ad_ad_text_ad_headline | 广告的标题。 |
ad_group_ad_ad_type | 广告的类型。 |
ad_group_ad_creation_time | 创建广告组广告时的时间戳。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
ad_group_ad_engine_id | 外部引擎账号中的广告的 ID。此字段仅适用于 Search Ads 360 账号。例如:Yahoo Japan、Microsoft、百度。对于非 Search Ads 360 实体,请改用“ad_group_ad.ad.id”。 |
ad_group_ad_engine_status | 外部引擎账号中的广告的其他状态。可能的状态(取决于外部账号的类型)包括“活跃”“有效”“待审核”。 |
ad_group_ad_labels | 附加到此广告组广告的标签的资源名称。 |
ad_group_ad_last_modified_time | 上次修改此广告组广告的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
ad_group_ad_status | 广告的状态。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:AdConversionActionAndDeviceStats
Search Ads 360 API 资源:ad_group_ad
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_ad_ad_id | 广告的 ID。 |
ad_group_ad_engine_id | 外部引擎账号中的广告的 ID。此字段仅适用于 Search Ads 360 账号。例如:Yahoo Japan、Microsoft、百度。对于非 Search Ads 360 实体,请改用“ad_group_ad.ad.id”。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_by_conversion_date | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_all_conversions_value_by_conversion_date | 所有转化的价值。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_by_conversion_date | 按转化日期统计的跨设备转化次数。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
metrics_cross_device_conversions_value_by_conversion_date | 按转化日期汇总的跨设备转化价值。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AdDeviceStats
Search Ads 360 API 资源:ad_group_ad
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_ad_ad_id | 广告的 ID。 |
ad_group_ad_engine_id | 外部引擎账号中的广告的 ID。此字段仅适用于 Search Ads 360 账号。例如:Yahoo Japan、Microsoft、百度。对于非 Search Ads 360 实体,请改用“ad_group_ad.ad.id”。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
metrics_visits | Search Ads 360 成功记录并转到广告主着陆页的点击次数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AdGroup
Search Ads 360 API 资源:ad_group
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_bid_modifier_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。对于 PreferredContent,该范围介于 1.0 - 6.0 之间。使用 0 可停用设备类型。 |
ad_group_bid_modifier_device_type | 设备类型。 |
ad_group_cpc_bid_micros | 每次点击费用出价上限。 |
ad_group_creation_time | 创建此广告组时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
ad_group_end_date | 广告组停止投放广告的日期。默认情况下,广告组会在广告组的结束日期停止投放广告。如果设置了此字段,则广告组会在客户时区的指定日期结束时停止投放广告。此字段仅可用于 Microsoft Advertising 和 Facebook 网关账号。格式:YYYY-MM-DD 示例:2019-03-14 |
ad_group_engine_id | 外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“ad_group.id”。 |
ad_group_engine_status | 广告组的引擎状态。 |
ad_group_id | 广告组的 ID。 |
ad_group_labels | 附加到此广告组的标签的资源名称。 |
ad_group_language_code | 广告组中的广告和关键字的语言。此字段仅可用于 Microsoft Advertising 账号。 |
ad_group_last_modified_time | 上次修改此广告组的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
ad_group_start_date | 此广告组开始投放广告的日期。默认情况下,广告组会立即或在广告组的开始日期(以较早者为准)开始投放广告。如果设置了此字段,则广告组将从客户时区的指定日期开始时开始投放广告。此字段仅可用于 Microsoft Advertising 和 Facebook 网关账号。格式:YYYY-MM-DD 示例:2019-03-14 |
ad_group_status | 广告组的状态。 |
ad_group_targeting_setting_target_restrictions | 用于限制广告系列或广告组覆盖面的每个定位维度的设置。 |
bidding_strategy_id | 出价策略的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:AdGroupAssetStats
Search Ads 360 API 资源:ad_group_asset
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_asset_ad_group | 必需。不可变。素材资源关联到的广告组。 |
ad_group_asset_asset | 必需。不可变。与广告组关联的素材资源。 |
ad_group_engine_id | 外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“ad_group.id”。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:AdGroupAudienceConversionActionAndDeviceStats
Search Ads 360 API 资源:ad_group_audience_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17。 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AdGroupAudienceDeviceStats
Search Ads 360 API 资源:ad_group_audience_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AdGroupConversionActionAndAssetStats
Search Ads 360 API 资源:ad_group_asset
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_asset_ad_group | 必需。不可变。素材资源关联到的广告组。 |
ad_group_asset_asset | 必需。不可变。与广告组关联的素材资源。 |
ad_group_engine_id | 外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“ad_group.id”。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2018-04-17 |
Search Ads 360 表名称:AdGroupConversionActionAndDeviceStats
Search Ads 360 API 资源:ad_group
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_engine_id | 仅供输出。外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“ad_group.id”。 |
ad_group_id | 仅限输出。广告组的 ID。 |
bidding_strategy_id | 仅供输出。出价策略的 ID。 |
campaign_id | 仅供输出。广告系列的 ID。 |
customer_id | 仅供输出。客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AdGroupCriterion
Search Ads 360 API 资源:ad_group_criterion
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_creation_time | 创建此广告组条件时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_last_modified_time | 上次修改此广告组条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_status | 条件的状态。 这是广告组条件实体的状态,由客户端设置。注意:界面报告可能包含其他信息,这些信息会影响条件是否能够运行。在某些情况下,在 API 中移除的条件可能仍会在界面中显示为已启用。例如,默认情况下,广告系列会面向所有年龄段的用户展示(已被排除的除外)。该界面会将各个年龄段显示为“已启用”,因为它们有资格观看广告;但 AdGroupCriterion.status 会显示为“已移除”,因为系统未添加任何肯定条件。 |
ad_group_criterion_type | 条件的类型。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
ad_group_name | 广告组的名称。此字段为必填字段,在创建新广告组时不应为空。它包含的 UTF-8 全宽字符不得超过 255 个,并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
ad_group_status | 广告组的状态。 |
campaign_id | 广告系列的 ID。 |
campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
campaign_status | 广告系列的状态。 |
customer_account_type | 引擎账号类型。例如:Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track。 |
customer_descriptive_name | (可选)客户的非唯一描述性名称。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:AdGroupDeviceStats
Search Ads 360 API 资源:ad_group
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_engine_id | 外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“ad_group.id”。 |
ad_group_id | 广告组的 ID。 |
bidding_strategy_id | 出价策略的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
metrics_visits | Search Ads 360 成功记录并转到广告主着陆页的点击次数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AdGroupStats
Search Ads 360 API 资源:ad_group
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_engine_id | 外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“ad_group.id”。 |
ad_group_id | 广告组的 ID。 |
bidding_strategy_id | 出价策略的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_content_impression_share | 您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
metrics_content_rank_lost_impression_share | 您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
metrics_historical_quality_score | 历史质量得分。 |
metrics_search_impression_share | 您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
metrics_search_rank_lost_impression_share | 您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17。 |
Search Ads 360 表名称:AgeRangeConversionActionAndDeviceStats
Search Ads 360 API 资源:age_range_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:AgeRangeDeviceStats
Search Ads 360 API 资源:age_range_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:Asset
Search Ads 360 API 资源:asset
Search Ads 360 字段名称 | 说明 |
---|---|
asset_creation_time | 创建此素材资源时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
asset_engine_status | 素材资源的引擎状态。 |
asset_final_urls | 所有跨网域重定向之后可能存在的最终到达网址列表。 |
asset_id | 素材资源的 ID。 |
asset_last_modified_time | 上次修改此素材资源的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
asset_sitelink_asset.description1 | 站内链接的说明的第一行。如此行已设置,则长度应介于 1 到 35 之间(包括 1 和 35),并且还必须设置 description2。 |
asset_sitelink_asset.description2 | 站内链接的说明的第二行。如此行已设置,则长度应介于 1 到 35 之间(包括 1 和 35),并且还必须设置 description1。 |
asset_sitelink_asset_link_text | 站内链接的网址显示文本。此字符串的长度应介于 1 和 25 之间(包括 1 和 25)。 |
asset_status | 素材资源的状态。 |
asset_tracking_url_template | 用于构建跟踪网址的网址模板。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:AssetSetStats
Search Ads 360 API 资源:asset_set_asset
Search Ads 360 字段名称 | 说明 |
---|---|
asset_set_asset_asset | 不可变。此素材资源集中的素材资源所关联的素材资源。 |
asset_set_asset_asset_set | 不可变。此素材资源集中的素材资源所关联的素材资源集。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:BidStrategy
Search Ads 360 API 资源:bidding_strategy
Search Ads 360 字段名称 | 说明 |
---|---|
bidding_strategy_id | 出价策略的 ID。 |
bidding_strategy_name | 出价策略的名称。账号中的所有出价策略必须区分命名。此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 |
bidding_strategy_status | 出价策略的状态。 |
bidding_strategy_target_cpa_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
bidding_strategy_target_cpa_cpc_bid_floor_micros | 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
bidding_strategy_target_cpa_target_cpa_micros | 平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。 |
bidding_strategy_target_impression_share_cpc_bid_ceiling_micros | 自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段,该字段用于设置上限值,并以本地微单位指定。 |
bidding_strategy_target_outrank_share_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 |
bidding_strategy_target_roas_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
bidding_strategy_target_roas_cpc_bid_floor_micros | 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
bidding_strategy_target_roas_target_roas | 每单位支出所选择的收入(基于转化数据)。值必须介于 0.01 到 1000.0 之间(包括 0.01 和 1000.0)。 |
bidding_strategy_target_spend_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 |
bidding_strategy_target_spend_target_spend_micros | 尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 此字段已废弃,不应再使用。 |
segments_conversion_action | 转化操作的资源名称。 |
Search Ads 360 表名称:BidStrategyStats
Search Ads 360 API 资源:bidding_strategy
Search Ads 360 字段名称 | 说明 |
---|---|
bidding_strategy_id | 出价策略的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_by_conversion_date | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_all_conversions_value_by_conversion_date | 所有转化的价值。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_by_conversion_date | 按转化日期统计的跨设备转化次数。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
metrics_cross_device_conversions_value_by_conversion_date | 按转化日期汇总的跨设备转化价值。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:Campaign
Search Ads 360 API 资源:campaign
Search Ads 360 字段名称 | 说明 |
---|---|
bidding_strategy_id | 出价策略的 ID。 |
bidding_strategy_name | 出价策略的名称。账号中的所有出价策略必须区分命名。此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 |
campaign_advertising_channel_sub_type | (可选)对 advertising_channel_type 的优化。必须是父级渠道类型的有效子类型。只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
campaign_advertising_channel_type | 广告系列中的广告的主要投放目标。可以在 network_settings 中优化定位选项。此字段为必填字段,在创建新广告系列时不应为空。只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
campaign_bidding_strategy_type | 出价策略的类型。您可以通过以下方式创建出价策略:设置出价方案来创建标准出价策略,或设置“bidding_strategy”字段来创建组合出价策略。此字段为只读字段。 |
campaign_budget_amount_micros | 预算的金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。每月支出上限为此金额的 30.4 倍。 |
campaign_budget_delivery_method | 确定广告系列预算的支出速率的投放方式。如果在创建操作中未指定,则默认为 STANDARD。 |
campaign_budget_period | 支出预算的时间段。如果未指定,则默认为“DAILY”。 |
campaign_creation_time | 创建广告系列时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
campaign_end_date | 广告系列在提供服务的客户所在时区运行的最后一天(采用 YYYY-MM-DD 格式)。创建时,默认为 2037-12-30,这表示广告系列将无限期投放。要将现有的广告系列设置为无限期投放,请将此字段设置为 2037-12-30。 |
campaign_engine_id | 外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“campaign.id”。 |
campaign_id | 广告系列的 ID。 |
campaign_labels | 此广告系列所附标签的资源名称。 |
campaign_last_modified_time | 上次修改此广告系列的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
campaign_name | 广告系列的名称。此字段为必填字段,在创建新广告系列时不应为空。并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
campaign_network_settings_target_content_network | 广告是否将在 Google 展示广告网络中的指定展示位置投放。您可以使用展示位置条件指定展示位置。 |
campaign_network_settings_target_google_search | 广告是否将随 Google.com 搜索结果一起投放。 |
campaign_network_settings_target_partner_search_network | 广告是否将在 Google 合作伙伴网络中投放。这仅可用于部分 Google 合作伙伴账号。 |
campaign_network_settings_target_search_network | 广告是否将在 Google 搜索网络中的合作伙伴网站上投放(要求 target_google_search 也设为 true)。 |
campaign_start_date | 广告系列在提供服务的客户所在时区开始运行的日期(采用 YYYY-MM-DD 格式)。 |
campaign_status | 广告系列的状态。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:CampaignAssetStats
Search Ads 360 API 资源:campaign_asset
Search Ads 360 字段名称 | 说明 |
---|---|
campaign_asset_asset | 不可变。与广告系列关联的素材资源。 |
campaign_asset_campaign | 不可变。素材资源关联到的广告系列。 |
campaign_engine_id | 外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“campaign.id”。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:CampaignAudienceConversionActionAndDeviceStats
Search Ads 360 API 资源:campaign_audience_view
Search Ads 360 字段名称 | 说明 |
---|---|
campaign_criterion_criterion_id | 条件的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:CampaignAudienceDeviceStats
Search Ads 360 API 资源:campaign_audience_view
Search Ads 360 字段名称 | 说明 |
---|---|
campaign_criterion_criterion_id | 条件的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:CampaignConversionActionAndAssetStats
Search Ads 360 API 资源:campaign_asset
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_id | 广告组的 ID。 |
campaign_asset_campaign | 不可变。素材资源关联到的广告系列。 |
campaign_engine_id | 外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“campaign.id”。 |
campaign_id | 广告系列的 ID。 |
campain_asset_asset | 不可变。与广告系列关联的素材资源。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:CampaignConversionActionAndDeviceStats
Search Ads 360 API 资源:campaign
Search Ads 360 字段名称 | 说明 |
---|---|
bidding_strategy_id | 出价策略的 ID。 |
campaign_engine_id | 外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“campaign.id”。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_by_conversion_date | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_all_conversions_value_by_conversion_date | 所有转化的价值。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_by_conversion_date | 按转化日期统计的跨设备转化次数。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
metrics_cross_device_conversions_value_by_conversion_date | 按转化日期汇总的跨设备转化价值。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:CampaignCriterion
Search Ads 360 API 资源:campaign_criterion
Search Ads 360 字段名称 | 说明 |
---|---|
campaign_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
campaign_criterion_criterion_id | 条件的 ID。 |
campaign_criterion_last_modified_time | 上次修改此广告系列条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
campaign_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
campaign_criterion_status | 条件的状态。 |
campaign_criterion_type | 条件的类型。 |
campaign_criterion_user_list_user_list | 用户名单资源名称。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:CampaignDeviceStats
Search Ads 360 API 资源:campaign
Search Ads 360 字段名称 | 说明 |
---|---|
bidding_strategy_id | 出价策略的 ID。 |
campaign_engine_id | 外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“campaign.id”。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
metrics_visits | Search Ads 360 成功记录并转到广告主着陆页的点击次数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:CampaignStats
Search Ads 360 API 资源:campaign
Search Ads 360 字段名称 | 说明 |
---|---|
bidding_strategy_id | 出价策略的 ID。 |
campaign_engine_id | 外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号。例如:Yahoo Japan、Microsoft、百度。对于 Google Ads 实体,请改用“campaign.id”。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_content_budget_lost_impression_share | 您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何大于 0.9 的值都会报告为 0.9001。 |
metrics_content_impression_share | 您在展示广告网络中获得的展示次数除以您有资格获得的估算展示次数。注意:内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
metrics_content_rank_lost_impression_share | 您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意:内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何大于 0.9 的值都会报告为 0.9001。 |
metrics_conversions | 转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。 如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_conversions_value | “转化”字段中包含的转化带来的转化价值总和。只有在您为各项转化操作输入了价值的情况下,这项指标才能派上用场。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_historical_quality_score | 历史质量得分。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
metrics_search_budget_lost_impression_share | 您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意:搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
metrics_search_impression_share | 您在搜索网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意:在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。 |
metrics_search_rank_lost_impression_share | 您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意:搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。 |
metrics_visits | Search Ads 360 成功记录并转到广告主着陆页的点击次数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:CartDataSalesStats
Search Ads 360 API 资源:cart_data_sales_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_client_account_cross_sell_gross_profit_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_gross_profit_micros |
metrics_client_account_cross_sell_revenue_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_revenue_micros |
metrics_client_account_cross_sell_units_sold | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_cross_sell_units_sold |
metrics_client_account_lead_gross_profit_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_gross_profit_micros |
metrics_client_account_lead_revenue_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_revenue_micros |
metrics_client_account_lead_units_sold | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.client_account_lead_units_sold |
metrics_cross_sell_gross_profit_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_gross_profit_micros |
metrics_cross_sell_revenue_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_revenue_micros |
metrics_cross_sell_units_sold | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.cross_sell_units_sold |
metrics_lead_gross_profit_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_gross_profit_micros |
metrics_lead_revenue_micros | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_revenue_micros |
metrics_lead_units_sold | https://developers.google.com/search-ads/reporting/api/reference/fields/v0/cart_data_sales_view#metrics.lead_units_sold |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_product_brand | 商品的品牌。 |
segments_product_item_id | 商品的项目 ID。 |
segments_product_sold_brand | 所售商品的品牌。 |
segments_product_sold_item_id | 所售商品的商品 ID。 |
segments_product_sold_title | 所售商品的名称。 |
segments_product_sold_type_l1 | 所售商品的类型(第 1 级)。 |
segments_product_sold_type_l2 | 所售商品的类型(第 2 级)。 |
segments_product_sold_type_l3 | 所售商品的类型(第 3 级)。 |
segments_product_sold_type_l4 | 所售商品的类型(第 4 级)。 |
segments_product_sold_type_l5 | 所售商品的类型(第 5 级)。 |
segments_product_title | 商品的名称。 |
segments_product_type_l1 | 商品的类型(第 1 级)。 |
segments_product_type_l2 | 商品的类型(第 2 级)。 |
segments_product_type_l3 | 商品的类型(第 3 级)。 |
segments_product_type_l4 | 商品的类型(第 4 级)。 |
segments_product_type_l5 | 商品的类型(第 5 级)。 |
Search Ads 360 表名称:Conversion
Search Ads 360 API 资源:conversion
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
conversion_ad_id | 广告 ID。值为 0 表示广告未归因。 |
conversion_advertiser_conversion_id | 对于线下转化,此 ID 由广告主提供。如果广告客户未指定此类 ID,Search Ads 360 会生成一个 ID。对于线上转化,这等于 ID 列或 floodlight_order_id 列,具体取决于广告客户的 Floodlight 指令。 |
conversion_attribution_type | 转化归因于的原因:访问或关键字+广告。 |
conversion_click_id | 转化归因于的访问的唯一字符串,该字符串会作为点击 ID 网址参数传递到着陆页。 |
conversion_conversion_date_time | 转化事件的时间戳。 |
conversion_conversion_last_modified_date_time | 转化上次修改的时间戳。 |
conversion_conversion_quantity | 转化记录的商品数量,由 qty 网址参数确定。广告主负责动态填充该参数(如转化中售出的商品数量),否则默认为 1。 |
conversion_conversion_revenue_micros | 转化事件的调整后收入(以微为单位)。此字段始终采用广告投放账号所用的币种。 |
conversion_conversion_visit_date_time | 转化归因于的访问的时间戳。 |
conversion_criterion_id | Search Ads 360 条件 ID。值为 0 表示条件未归因。 |
conversion_floodlight_order_id | 广告主为转化提供的 Floodlight 订单 ID。 |
conversion_floodlight_original_revenue | 在修改 Floodlight 货币指令之前,与 Floodlight 事件关联的未更改的原始收入(采用当前报告所用的币种)。 |
conversion_id | 转化的 ID |
conversion_merchant_id | 包含获得点击的商品的 SearchAds360 商品目录账号 ID。当您在 SearchAds360 中关联商品目录账号时,SearchAds360 会生成此 ID。 |
conversion_product_channel | 获得点击的商品的销售渠道:线上或本地。 |
conversion_product_country_code | 为包含获得点击的商品的商品目录 Feed 注册的国家/地区(ISO-3166 格式)。 |
conversion_product_id | 点击的商品的 ID。 |
conversion_product_language_code | 为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。 |
conversion_product_store_id | 获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。 |
conversion_status | 转化的状态,可以是 ENABLED 或 REMOVED。 |
conversion_visit_id | 转化归因于的 SearchAds360 访问 ID。 |
customer_account_type | 引擎账号类型。例如:Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track。 |
customer_descriptive_name | (可选)客户的非唯一描述性名称。 |
customer_id | 客户的 ID。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:ConversionAction
Search Ads 360 API 资源:conversion_action
Search Ads 360 字段名称 | 说明 |
---|---|
conversion_action_creation_time | Floodlight 活动创建的时间戳,采用 ISO 8601 格式。 |
conversion_action_floodlight_settings_activity_group_tag | 报告转化次数时用于标识 Floodlight 活动组的字符串。 |
conversion_action_floodlight_settings_activity_id | DoubleClick Campaign Manager (DCM) 中的 Floodlight 活动的 ID。 |
conversion_action_floodlight_settings_activity_tag | 报告转化次数时用于标识 Floodlight 活动的字符串。 |
conversion_action_name | 转化操作的名称。此字段为必填字段,在创建新的转化操作时不应为空。 |
conversion_action_status | 针对转化事件累计的此转化操作的状态。 |
conversion_action_type | 此转化操作的类型。 |
Search Ads 360 表名称:GenderConversionActionAndDeviceStats
Search Ads 360 API 资源:gender_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:GenderDeviceStats
Search Ads 360 API 资源:gender_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:Keyword
Search Ads 360 API 资源:keyword_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_creation_time | 创建此广告组条件时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_effective_cpc_bid_micros | 有效每次点击费用出价。 |
ad_group_criterion_engine_id | 外部引擎账号中的广告组条件的 ID。此字段仅适用于 Search Ads 360 账号。例如:Yahoo Japan、Microsoft、百度。对于非 Search Ads 360 实体,请改用“ad_group_criterion.criterion_id”。 |
ad_group_criterion_engine_status | 广告组条件的引擎状态。 |
ad_group_criterion_final_url_suffix | 用于将参数附加到最终到达网址的网址模板。 |
ad_group_criterion_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
ad_group_criterion_keyword_match_type | 关键字的匹配类型。 |
ad_group_criterion_keyword_text | 关键字文本(最多 80 个字符和 10 个字词)。 |
ad_group_criterion_labels | 广告组条件所附标签的资源名称。 |
ad_group_criterion_last_modified_time | 上次修改此广告组条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
ad_group_criterion_quality_info_quality_score | 质量得分。如果 Google 没有足够的信息来确定一个值,则系统可能不会填充该字段。 |
ad_group_criterion_status | 条件的状态。 这是广告组条件实体的状态,由客户端设置。注意:界面报告可能包含其他信息,这些信息会影响条件是否能够运行。在某些情况下,在 API 中移除的条件可能仍会在界面中显示为已启用。例如,默认情况下,广告系列会面向所有年龄段的用户展示(已被排除的除外)。该界面会将各个年龄段显示为“已启用”,因为它们有资格观看广告;但 AdGroupCriterion.status 会显示为“已移除”,因为系统未添加任何肯定条件。 |
ad_group_criterion_tracking_url_template | 用于构建跟踪网址的网址模板。 |
ad_group_id | 广告组的 ID。 |
bidding_strategy_id | 出价策略的 ID。 |
bidding_strategy_target_cpa_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
bidding_strategy_target_cpa_cpc_bid_floor_micros | 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
bidding_strategy_target_impression_share_cpc_bid_ceiling_micros | 自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段,该字段用于设置上限值,并以本地微单位指定。 |
bidding_strategy_target_outrank_share_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 |
bidding_strategy_target_roas_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
bidding_strategy_target_roas_cpc_bid_floor_micros | 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。 |
bidding_strategy_target_spend_cpc_bid_ceiling_micros | 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:KeywordConversionActionAndDeviceStats
Search Ads 360 API 资源:keyword_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_engine_id | 外部引擎账号中的广告组条件的 ID。此字段仅适用于 Search Ads 360 账号。例如:Yahoo Japan、Microsoft、百度。对于非 Search Ads 360 实体,请改用“ad_group_criterion.criterion_id”。 |
ad_group_id | 广告组的 ID。 |
bidding_strategy_id | 出价策略的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_by_conversion_date | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_all_conversions_value_by_conversion_date | 所有转化的价值。如果选择此列并将其设置为“日期”,则“日期”列中的值表示转化日期。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_by_conversion_date | 按转化日期统计的跨设备转化次数。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
metrics_cross_device_conversions_value_by_conversion_date | 按转化日期汇总的跨设备转化价值。如需详细了解 by_conversion_date 列,请参阅“所有转化次数”列简介。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:KeywordDeviceStats
Search Ads 360 API 资源:keyword_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_engine_id | 外部引擎账号中的广告组条件的 ID。此字段仅适用于 Search Ads 360 账号。例如:Yahoo Japan、Microsoft、百度。对于非 Search Ads 360 实体,请改用“ad_group_criterion.criterion_id”。 |
ad_group_id | 广告组的 ID。 |
bidding_strategy_id | 出价策略的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
metrics_visits | Search Ads 360 成功记录并转到广告主着陆页的点击次数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:KeywordStats
Search Ads 360 API 资源:keyword_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_id | 广告组的 ID。 |
bidding_strategy_id | 出价策略的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_historical_quality_score | 历史质量得分。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:LocationConversionActionAndDeviceStats
Search Ads 360 API 资源:location_view
Search Ads 360 字段名称 | 说明 |
---|---|
campaign_criterion_criterion_id | 条件的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:LocationDeviceStats
Search Ads 360 API 资源:location_view
Search Ads 360 字段名称 | 说明 |
---|---|
campaign_criterion_criterion_id | 条件的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:NegativeAdGroupCriterion
Search Ads 360 API 资源:ad_group_criterion
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_creation_time | 创建此广告组条件时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_last_modified_time | 上次修改此广告组条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_status | 条件的状态。 这是广告组条件实体的状态,由客户端设置。注意:界面报告可能包含其他信息,这些信息会影响条件是否能够运行。在某些情况下,在 API 中移除的条件可能仍会在界面中显示为已启用。例如,默认情况下,广告系列会面向所有年龄段的用户展示(已被排除的除外)。该界面会将各个年龄段显示为“已启用”,因为它们有资格观看广告;但 AdGroupCriterion.status 会显示为“已移除”,因为系统未添加任何肯定条件。 |
ad_group_criterion_type | 条件的类型。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 用于网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:NegativeAdGroupKeyword
Search Ads 360 API 资源:ad_group_criterion
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_creation_time | 创建此广告组条件时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_keyword_match_type | 关键字的匹配类型。 |
ad_group_criterion_keyword_text | 关键字文本(最多 80 个字符和 10 个字词)。 |
ad_group_criterion_last_modified_time | 上次修改此广告组条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
ad_group_criterion_status | 条件的状态。 这是广告组条件实体的状态,由客户端设置。注意:界面报告可能包含其他信息,这些信息会影响条件是否能够运行。在某些情况下,在 API 中移除的条件可能仍会在界面中显示为已启用。例如,默认情况下,广告系列会面向所有年龄段的用户展示(已被排除的除外)。该界面会将各个年龄段显示为“已启用”,因为它们有资格观看广告;但 AdGroupCriterion.status 会显示为“已移除”,因为系统未添加任何肯定条件。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:NegativeCampaignCriterion
Search Ads 360 API 资源:campaign_criterion
Search Ads 360 字段名称 | 说明 |
---|---|
campaign_criterion_age_range_type | 年龄段的类型。 |
campaign_criterion_criterion_id | 条件的 ID。 |
campaign_criterion_gender_type | 性别的类型。 |
campaign_criterion_last_modified_time | 上次修改此广告系列条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
campaign_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
campaign_criterion_status | 条件的状态。 |
campaign_criterion_type | 条件的类型。 |
campaign_criterion_user_list_user_list | 用户名单资源名称。 |
campaign_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:NegativeCampaignKeyword
Search Ads 360 API 资源:campaign_criterion
Search Ads 360 字段名称 | 说明 |
---|---|
campaign_criterion_criterion_id | 条件的 ID。 |
campaign_criterion_keyword_match_type | 关键字的匹配类型。 |
campaign_criterion_keyword_text | 关键字文本(最多 80 个字符和 10 个字词)。 |
campaign_criterion_last_modified_time | 上次修改此广告组条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
campaign_criterion_status | 条件的状态。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
Search Ads 360 表名称:ProductAdvertised
Search Ads 360 API 资源:shopping_performance_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_product_bidding_category_level1 | 商品的出价类别(第 1 级)。 |
segments_product_bidding_category_level2 | 商品的出价类别(第 2 级)。 |
segments_product_bidding_category_level3 | 商品的出价类别(第 3 级)。 |
segments_product_bidding_category_level4 | 商品的出价类别(第 4 级)。 |
segments_product_bidding_category_level5 | 商品的出价类别(第 5 级)。 |
segments_product_brand | 商品的品牌。 |
segments_product_channel | 商品的渠道。 |
segments_product_channel_exclusivity | 商品的渠道独占性。 |
segments_product_condition | 商品的使用情况。 |
segments_product_country | 商品目标销售国家/地区的地理位置定位目标常量的资源名称。 |
segments_product_custom_attribute0 | 商品的自定义属性 0。 |
segments_product_custom_attribute1 | 商品的自定义属性 1。 |
segments_product_custom_attribute2 | 商品的自定义属性 2。 |
segments_product_custom_attribute3 | 商品的自定义属性 3。 |
segments_product_custom_attribute4 | 商品的自定义属性 4。 |
segments_product_item_id | 商品的项目 ID。 |
segments_product_language | 商品语言的语言常量的资源名称。 |
segments_product_store_id | 商品的商店 ID。 |
segments_product_title | 商品的名称。 |
segments_product_type_l1 | 商品的类型(第 1 级)。 |
segments_product_type_l2 | 商品的类型(第 2 级)。 |
segments_product_type_l3 | 商品的类型(第 3 级)。 |
segments_product_type_l4 | 商品的类型(第 4 级)。 |
segments_product_type_l5 | 商品的类型(第 5 级)。 |
Search Ads 360 表名称:ProductAdvertisedConversionActionAndDeviceStats
Search Ads 360 API 资源:shopping_performance_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments.conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
segments_product_item_id | 商品的项目 ID。 |
Search Ads 360 表名称:ProductAdvertisedDeviceStats
Search Ads 360 API 资源:shopping_performance_view
Search Ads 360 字段名称 | 说明 |
---|---|
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
segments_product_item_id | 商品的项目 ID。 |
Search Ads 360 表名称:ProductGroup
Search Ads 360 API 资源:product_group_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_creation_time | 仅供输出。创建此广告组条件时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
ad_group_criterion_criterion_id | 仅供输出。条件的 ID。 |
ad_group_criterion_effective_cpc_bid_micros | 仅供输出。有效每次点击费用出价。 |
ad_group_criterion_engine_status | 仅供输出。广告组条件的引擎状态。 |
ad_group_criterion_final_urls | 广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
ad_group_criterion_last_modified_time | 仅供输出。上次修改此广告组条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
ad_group_criterion_listing_group_type | 商品详情组的类型。 |
ad_group_criterion_status | 条件的状态。 这是广告组条件实体的状态,由客户端设置。注意:界面报告可能包含其他信息,这些信息会影响条件是否能够运行。在某些情况下,在 API 中移除的条件可能仍会在界面中显示为已启用。例如,默认情况下,广告系列会面向所有年龄段的用户展示(已被排除的除外)。该界面会将各个年龄段显示为“已启用”,因为它们有资格观看广告;但 AdGroupCriterion.status 会显示为“已移除”,因为系统未添加任何肯定条件。 |
ad_group_criterion_tracking_url_template | 用于构建跟踪网址的网址模板。 |
ad_group_id | 仅供输出。广告组的 ID。 |
campaign_id | 仅供输出。广告系列的 ID。 |
customer_id | 客户的 ID。 |
product_group_view_resource_name | 仅供输出。商品组视图的资源名称。产品组视图资源名称采用以下格式:customers/{customer_id}/productGroupViews/{ad_group_id}~{criterion_id} |
Search Ads 360 表名称:ProductGroupStats
Search Ads 360 API 资源:product_group_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_criterion_id | 仅供输出。条件的 ID。 |
ad_group_id | 仅供输出。广告组的 ID。 |
campaign_id | 仅供输出。广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_all_conversions | 转化总次数。包括所有转化,无论 include_in_conversions_metric 的值如何。 |
metrics_all_conversions_value | 所有转化的值。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
Search Ads 360 表名称:Visit
Search Ads 360 API 资源:visit
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_account_type | 引擎账号类型。例如:Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track。 |
customer_descriptive_name | (可选)客户的非唯一描述性名称。 |
customer_id | 客户的 ID。 |
segments_ad_network_type | 广告网络类型。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
visit_ad_id | 广告 ID。值为 0 表示广告未归因。 |
visit_click_id | 作为点击 ID 网址参数传递到着陆页的每次访问的唯一字符串。 |
visit_criterion_id | Search Ads 360 关键字 ID。值为 0 表示关键字未归因。 |
visit_id | 访问的 ID。 |
visit_merchant_id | 包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时,Search Ads 360 会生成此 ID。 |
visit_product_channel | 获得点击的商品的销售渠道:线上或本地。 |
visit_product_country_code | 为包含获得点击的商品的商品目录 Feed 注册的国家/地区(ISO-3166 格式)。 |
visit_product_id | 点击的商品的 ID。 |
visit_product_language_code | 为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。 |
visit_product_store_id | 获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。 |
visit_visit_date_time | 访问事件的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
Search Ads 360 表名称:WebpageConversionActionAndDeviceStats
Search Ads 360 API 资源:webpage_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_cross_device_conversions | 转化是指客户在一台设备上点击广告,然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。 |
metrics_cross_device_conversions_value | 跨设备转化的值的总和。 |
segments_conversion_action_name | 转化操作名称。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 表名称:WebpageDeviceStats
Search Ads 360 API 资源:webpage_view
Search Ads 360 字段名称 | 说明 |
---|---|
ad_group_criterion_age_range_type | 年龄段的类型。 |
ad_group_criterion_bid_modifier | 条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
ad_group_criterion_cpc_bid_micros | 每次点击费用出价。 |
ad_group_criterion_criterion_id | 条件的 ID。 |
ad_group_criterion_gender_type | 性别的类型。 |
ad_group_criterion_location_geo_target_constant | 目标地理位置常量资源名称。 |
ad_group_criterion_user_list_user_list | 用户名单资源名称。 |
ad_group_criterion_webpage_conditions | 网页定位的条件或逻辑表达式。在为定位进行评估时,网页定位条件列表会连接在一起。如果条件列表为空,则表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的,而在 UPDATE 操作中是被禁止的。 |
ad_group_criterion_webpage_coverage_percentage | 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如,如果覆盖率返回为 1,则表示覆盖率为 100%。 |
ad_group_id | 广告组的 ID。 |
campaign_id | 广告系列的 ID。 |
customer_id | 客户的 ID。 |
metrics_average_cpc | 所有点击总费用除以获得的总点击次数。 |
metrics_average_cpm | 平均每千次展示费用 (CPM)。 |
metrics_clicks | 点击次数。 |
metrics_client_account_conversions | 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_conversions_value | 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价,您的出价策略会针对这些转化进行优化。 |
metrics_client_account_view_through_conversions | 浏览型转化的总次数。当客户看到图片或富媒体广告,之后在您的网站上完成转化而不与另一个广告互动(例如,点击)时,就会发生这种情况。 |
metrics_cost_micros | 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。 |
metrics_ctr | 广告获得的点击次数(点击次数)除以广告展示次数(展示次数)。 |
metrics_impressions | 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。 |
segments_date | 指标适用的日期,格式为 yyyy-MM-dd。例如:2024-04-17 |
segments_device | 指标应用于的设备。 |
Search Ads 360 匹配表
Search Ads 360 匹配表是仅包含特性字段(包含设置或其他固定数据的字段)的表,是为用户查询账号结构信息而定义。如果您使用刷新窗口或安排回填,则系统不会更新匹配表快照。
以下是 Search Ads 360 转移作业中的匹配表列表:
- 账号
- 广告
- AdGroup
- AdGroupCriterion
- 任何 ID 映射表
- 素材资源
- BidStrategy
- 宣传活动
- CampaignCriterion
- ConversionAction
- 关键字
- NegativeAdGroupKeyword
- NegativeAdGroupCriterion
- NegativeCampaignKeyword
- NegativeCampaignCriterion
- ProductGroup