新版 Search Ads 360 Reporting API 现已发布。您可以加入 searchads-api-announcements Google 网上论坛，及时了解即将发布的增强功能和版本。

此页面由 Cloud Translation API 翻译。

Package google.ads.searchads360.v0.common

索引

AdScheduleInfo（消息）
AdTextAsset（消息）
AgeRangeInfo（消息）
AssetInteractionTarget（消息）
AssetUsage（消息）
AudienceInfo（消息）
BusinessProfileLocation（消息）
CallToActionAsset（消息）
CustomParameter（消息）
DeviceInfo（消息）
EnhancedCpc（消息）
FrequencyCapEntry（消息）
GenderInfo（消息）
ImageAsset（消息）
ImageDimension（消息）
Keyword（消息）
KeywordInfo（消息）
LanguageInfo（消息）
ListingGroupInfo（消息）
LocationGroupInfo（消息）
LocationInfo（消息）
ManualCpa（消息）
ManualCpc（消息）
ManualCpm（消息）
MaximizeConversionValue（消息）
MaximizeConversions（消息）
Metrics（消息）
MobileAppAsset（消息）
PercentCpc（消息）
RealTimeBiddingSetting（消息）
SearchAds360ExpandedDynamicSearchAdInfo（消息）
SearchAds360ExpandedTextAdInfo（消息）
SearchAds360ProductAdInfo（消息）
SearchAds360ResponsiveSearchAdInfo（消息）
SearchAds360TextAdInfo（消息）
Segments（消息）
TargetCpa（消息）
TargetCpm（消息）
TargetImpressionShare（消息）
TargetOutrankShare（消息）
TargetRestriction（消息）
TargetRoas（消息）
TargetSpend（消息）
TargetingSetting（消息）
TextAsset（消息）
TextLabel（消息）
UnifiedCallAsset（消息）
UnifiedCalloutAsset（消息）
UnifiedLocationAsset（消息）
UnifiedPageFeedAsset（消息）
UnifiedSitelinkAsset（消息）
UserListInfo（消息）
Value（消息）
WebpageConditionInfo（消息）
WebpageInfo（消息）
YoutubeVideoAsset（消息）

AdScheduleInfo

表示 AdSchedule 条件。

AdSchedule 是指广告展示的星期几和时间间隔。

同一天最多只能添加 6 个广告时间表。

字段
`start_minute`	`MinuteOfHour` 此时间表的开始小时之后的分钟数。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
`end_minute`	`MinuteOfHour` 此时间表结束的结束小时之后的分钟数。时间表不含结束分钟数。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
`day_of_week`	`DayOfWeek` 投放时间是星期几。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
`start_hour`	`int32` 开始小时（采用 24 小时制）。此字段必须介于 0 到 23 之间（包括这两个数值）。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
`end_hour`	`int32` 结束时间（采用 24 小时制）；24 表示当天结束。此字段必须介于 0 和 24 之间（包括这两个数值）。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

AdTextAsset

广告中使用的文字素材资源。

字段

字段
`text`	`string` 素材资源文字。

text

string

素材资源文字。

AgeRangeInfo

年龄范围条件。

字段

字段
`type`	`AgeRangeType` 年龄段的类型。

type

AgeRangeType

年龄段的类型。

AssetInteractionTarget

AssetInteractionTarget 细分。

字段

字段
`asset`	`string` 素材资源名称。
`interaction_on_this_asset`	`bool` 仅适用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。

asset

string

素材资源名称。

interaction_on_this_asset

bool

仅适用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。

AssetUsage

包含资源的使用信息。

字段

字段
`asset`	`string` 资产的资源名称。
`served_asset_field_type`	`ServedAssetFieldType` 素材资源的投放字段类型。

asset

string

资产的资源名称。

served_asset_field_type

ServedAssetFieldType

素材资源的投放字段类型。

AudienceInfo

受众群体条件。

字段

字段
`audience`	`string` 受众群体资源名称。

audience

string

受众群体资源名称。

BusinessProfileLocation

从关联的商家资料账号同步的商家资料营业地点数据。

字段

字段
`labels[]`	`string` 广告客户为商家资料账号中的营业地点指定的标签。此信息会从商家资料账号同步。
`store_code`	`string` 此营业地点的商家资料商店代码。此信息会从商家资料账号同步。
`listing_id`	`int64` 此商家资料营业地点的商家信息 ID。此信息会从关联的商家资料账号同步过来。

labels[]

string

广告客户为商家资料账号中的营业地点指定的标签。此信息会从商家资料账号同步。

store_code

string

此营业地点的商家资料商店代码。此信息会从商家资料账号同步。

listing_id

int64

此商家资料营业地点的商家信息 ID。此信息会从关联的商家资料账号同步过来。

CallToActionAsset

号召性用语素材资源。

字段

字段
`call_to_action`	`CallToActionType` 号召性用语。

call_to_action

CallToActionType

号召性用语。

CustomParameter

可供 tracking_url_template、final_urls 或 mobile_final_urls 中的自定义参数标记使用的映射。

字段

字段
`key`	`string` 与参数代码名称匹配的键。
`value`	`string` 要替换的值。

key

string

与参数代码名称匹配的键。

value

string

要替换的值。

DeviceInfo

设备条件。

字段

字段
`type`	`Device` 设备类型。

type

Device

设备类型。

EnhancedCpc

此类型没有字段。

这是一种自动出价策略，会针对更有可能带来转化的点击提高出价，并针对不太可能带来转化的点击降低出价。

此出价策略已被弃用，无法再创建。将 enhanced_cpc_enabled 设置为 true 后，使用 ManualCpc 可实现等效的功能。

FrequencyCapEntry

此类型没有字段。

用于指定在特定时间段内，广告（或一组广告）可向用户展示的次数上限的规则。

GenderInfo

性别条件。

字段

字段
`type`	`GenderType` 性别的类型。

type

GenderType

性别的类型。

ImageAsset

图片素材资源。

字段

字段
`mime_type`	`MimeType` 图片素材资源的 MIME 类型。
`full_size`	`ImageDimension` 此图片的原始大小元数据。
`file_size`	`int64` 图片素材资源的文件大小（以字节为单位）。

mime_type

MimeType

图片素材资源的 MIME 类型。

full_size

ImageDimension

此图片的原始大小元数据。

file_size

int64

图片素材资源的文件大小（以字节为单位）。

ImageDimension

特定尺寸（原始尺寸或调整后的尺寸）的图片的元数据。

字段

字段
`height_pixels`	`int64` 图片的高度。
`width_pixels`	`int64` 图片的宽度。
`url`	`string` 用于返回此高度和宽度的图片的网址。

height_pixels

int64

图片的高度。

width_pixels

int64

图片的宽度。

url

string

用于返回此高度和宽度的图片的网址。

Keyword

关键字条件细分。

字段

字段
`info`	`KeywordInfo` 关键字信息。
`ad_group_criterion`	`string` AdGroupCriterion 资源名称。

info

KeywordInfo

关键字信息。

ad_group_criterion

string

AdGroupCriterion 资源名称。

KeywordInfo

关键字条件。

字段

字段
`match_type`	`KeywordMatchType` 关键字的匹配类型。
`text`	`string` 关键字文本（最多 80 个字符和 10 个字词）。

match_type

KeywordMatchType

关键字的匹配类型。

text

string

关键字文本（最多 80 个字符和 10 个字词）。

LanguageInfo

语言条件。

字段

字段
`language_constant`	`string` 语言常量资源名称。

language_constant

string

语言常量资源名称。

ListingGroupInfo

产品信息组条件。

字段

字段
`type`	`ListingGroupType` 商品详情组的类型。

type

ListingGroupType

商品详情组的类型。

LocationGroupInfo

通过 Feed 指定的地理位置列表周围的半径。

字段
`geo_target_constants[]`	`string` 用于限制 Feed 中地理区域范围的地理位置定位目标常量。目前仅允许一个地理位置定位常量。
`radius_units`	`LocationGroupRadiusUnits` 半径的单位。地理位置定位目标常量支持英里和米。Feed 项集支持使用英里和米。此字段是必需的，必须在 CREATE 操作中进行设置。
`feed_item_sets[]`	`string` 定位到的 FeedItemSet 中的 FeedItem。如果指定了多个 ID，则系统会定位到至少出现在一个集合中的所有项。此字段不能与 geo_target_constants 搭配使用。此字段是可选字段，只能在 CREATE 操作中设置。
`radius`	`int64` 以相应单位指定目标地理位置周边半径的距离。此字段是必需的，必须在 CREATE 操作中进行设置。

LocationInfo

地理位置条件。

字段

字段
`geo_target_constant`	`string` 目标地理位置常量资源名称。

geo_target_constant

string

目标地理位置常量资源名称。

ManualCpa

此类型没有字段。

人工出价策略，可让广告客户根据广告客户指定的操作设置出价。

ManualCpc

按点击次数付费的手动出价。

字段

字段
`enhanced_cpc_enabled`	`bool` 是否根据转化优化工具数据增强出价。

enhanced_cpc_enabled

bool

是否根据转化优化工具数据增强出价。

ManualCpm

此类型没有字段。

按展示次数进行人工出价，用户按每千次展示付费。

MaximizeConversionValue

这是一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能高的转化价值。

字段

字段
`cpc_bid_ceiling_micros`	`int64` 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。仅适用于组合出价策略，可更改。
`cpc_bid_floor_micros`	`int64` 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。仅适用于组合出价策略，可更改。
`target_roas`	`double` 目标广告支出回报率 (ROAS) 选项。如果设置此选项，出价策略会最大限度地增加收入，同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高，则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率，则出价策略的目标是尽可能为预算实现最高的广告支出回报率。

cpc_bid_ceiling_micros

int64

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。仅适用于组合出价策略，可更改。

cpc_bid_floor_micros

int64

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。仅适用于组合出价策略，可更改。

target_roas

double

目标广告支出回报率 (ROAS) 选项。如果设置此选项，出价策略会最大限度地增加收入，同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高，则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率，则出价策略的目标是尽可能为预算实现最高的广告支出回报率。

MaximizeConversions

这是一种自动出价策略，可帮助您在不超出预算的前提下，为广告系列争取尽可能多的转化。

字段

字段
`cpc_bid_ceiling_micros`	`int64` 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。仅适用于组合出价策略，可更改。
`cpc_bid_floor_micros`	`int64` 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。仅适用于组合出价策略，可更改。
`target_cpa_micros`	`int64` 目标每次转化费用 (CPA) 选项。这是您愿意为每次转化操作支付的平均金额，以出价策略所用币种的微单位指定。如果设置了此出价策略，系统会在不超出目标每次转化费用的前提下，争取尽可能多的转化。如果未设置目标每次转化费用，则出价策略的目标是在预算范围内尽可能降低每次转化费用。

cpc_bid_ceiling_micros

int64

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。仅适用于组合出价策略，可更改。

cpc_bid_floor_micros

int64

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。仅适用于组合出价策略，可更改。

target_cpa_micros

int64

目标每次转化费用 (CPA) 选项。这是您愿意为每次转化操作支付的平均金额，以出价策略所用币种的微单位指定。如果设置了此出价策略，系统会在不超出目标每次转化费用的前提下，争取尽可能多的转化。如果未设置目标每次转化费用，则出价策略的目标是在预算范围内尽可能降低每次转化费用。

指标

指标数据。

字段
`all_conversions_value_by_conversion_date`	`double` 所有转化的价值。如果选择此列并将其设置为“日期”，则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息，请访问 https://support.google.com/sa360/answer/9250611。
`all_conversions_by_conversion_date`	`double` 转化总次数。包括所有转化，无论 include_in_conversions_metric 的值如何。如果选择此列并将其设置为“日期”，则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息，请访问 https://support.google.com/sa360/answer/9250611。
`conversion_custom_metrics[]`	`Value` 转化自定义指标。
`conversions_value_by_conversion_date`	`double` 按转化日期统计的符合出价条件的转化价值的总和。如果选择此列并将其设置为日期，则“日期”列中的值表示转化日期。
`conversions_by_conversion_date`	`double` 按转化日期统计的针对可出价转化类型的转化次数总和。由于归因建模，此值可能会为小数。如果选择此列并将其设置为日期，则“日期”列中的值表示转化日期。
`historical_creative_quality_score`	`QualityScoreBucket` 广告素材的历史质量得分。
`historical_landing_page_quality_score`	`QualityScoreBucket` 历史着陆页体验的质量。
`historical_search_predicted_ctr`	`QualityScoreBucket` 历史搜索的预测点击率 (CTR)。
`interaction_event_types[]`	`InteractionEventType` 付费和免费互动的类型。
`raw_event_conversion_metrics[]`	`Value` 原始事件转化指标。
`absolute_top_impression_percentage`	`double` “搜索网络绝对页首展示次数份额”是指搜索广告在最显眼的搜索广告位置获得的展示次数所占的百分比。
`all_conversions_from_interactions_rate`	`double` 互动带来的所有转化（与浏览型转化不同）次数除以广告互动次数。
`all_conversions_value`	`double` 所有转化的值。
`all_conversions`	`double` 转化总次数。包括所有转化，无论 include_in_conversions_metric 的值如何。
`all_conversions_value_per_cost`	`double` 所有转化的价值除以广告互动（例如文字广告点击次数或视频广告观看次数）的总费用。
`all_conversions_from_click_to_call`	`double` 用户在广告展示过程中或点击广告后，点击“致电”按钮向相应实体店致电的次数。此数值不考虑致电是否接通，也不考虑通话时长。此指标仅适用于 Feed 内容。
`all_conversions_from_directions`	`double` 用户在点击广告后，点击“查询路线”按钮导航到相应实体店的次数。此指标仅适用于 Feed 内容。
`all_conversions_from_interactions_value_per_interaction`	`double` 互动带来的所有转化价值除以互动总次数。
`all_conversions_from_menu`	`double` 用户在点击广告后，点击链接查看相应实体店的菜单的次数。此指标仅适用于 Feed 内容。
`all_conversions_from_order`	`double` 用户在点击广告后，在相应商店下单的次数。此指标仅适用于 Feed 内容。
`all_conversions_from_other_engagement`	`double` 用户在点击广告后发生的其他转化（例如，发布对商店的评价或保存该商店的地理位置）的次数。此指标仅适用于 Feed 内容。
`all_conversions_from_store_visit`	`double` 用户在点击广告后光顾相应商店的次数估算值。此指标仅适用于 Feed 内容。
`visits`	`double` Search Ads 360 成功记录并转到广告主着陆页的点击次数。
`all_conversions_from_store_website`	`double` 用户在点击广告后，转到相应商店网址的次数。此指标仅适用于 Feed 内容。
`average_cost`	`double` 您为每次互动支付的平均金额。此金额是广告的总费用除以互动总次数。
`average_cpc`	`double` 所有点击总费用除以获得的总点击次数。此指标是一个货币值，默认以客户的币种返回。如需了解 metrics_currency 参数，请参阅 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`average_cpm`	`double` 平均每千次展示费用 (CPM)。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`clicks`	`int64` 点击次数。
`content_budget_lost_impression_share`	`double` 您的广告有资格在展示广告网络中展示但由于预算过低而未展示的次数的估算百分比。注意：内容预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
`content_impression_share`	`double` 您在展示广告网络中获得的展示次数除以您有资格获得的展示次数的估算值。注意：内容展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
`content_rank_lost_impression_share`	`double` 您的广告由于广告评级差而未在展示广告网络中获得的展示次数的估算百分比。注意：内容排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
`conversions_from_interactions_rate`	`double` 每次符合转化条件的互动带来的可出价转化次数（来自互动）。显示广告互动促成可出价转化的平均频率。
`client_account_conversions_value`	`double` 客户账号转化的值。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
`conversions_value_per_cost`	`double` 可出价转化的价值除以符合转化条件的互动总费用。
`conversions_from_interactions_value_per_interaction`	`double` 互动带来的转化价值除以广告互动次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
`client_account_conversions`	`double` 客户账号转化次数。这仅包括 include_in_client_account_conversions_metric 属性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
`cost_micros`	`int64` 在相应时间段内的每次点击费用 (CPC) 与每千次展示费用 (CPM) 之和。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`cost_per_all_conversions`	`double` 广告互动费用除以所有转化次数。
`cost_per_conversion`	`double` 每次可出价转化的平均转化次数所对应的转化次数可用的费用。
`cost_per_current_model_attributed_conversion`	`double` 广告互动费用除以当前模型归因转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
`cross_device_conversions`	`double` 转化是指客户在一台设备上点击广告，然后在另一台设备或另一个浏览器上进行转化。跨设备转化已包含在 all_conversions 中。
`cross_device_conversions_by_conversion_date`	`double` 按转化日期统计的跨设备转化次数。如需了解“by_conversion_date”列的详细信息，请访问 https://support.google.com/sa360/answer/9250611。
`cross_device_conversions_value`	`double` 跨设备转化的值的总和。
`cross_device_conversions_value_by_conversion_date`	`double` 按转化日期汇总的跨设备转化价值。如需了解“by_conversion_date”列的详细信息，请访问 https://support.google.com/sa360/answer/9250611。
`ctr`	`double` 广告获得的点击次数（点击次数）除以广告展示次数（展示次数）。
`conversions`	`double` 转化次数。这仅包括 include_in_conversions_metric 特性设置为 true 的转化操作。如果您使用基于转化的出价，您的出价策略会针对这些转化进行优化。
`conversions_value`	`double` “转化”字段中包含的转化带来的转化价值总和。要使用此指标，您必须为各项转化操作输入转化价值。
`average_quality_score`	`double` 平均质量得分。
`historical_quality_score`	`int64` 历史质量得分。
`impressions`	`int64` 广告在 Google 广告网络上的搜索结果页或网站中出现的频率计数。
`interaction_rate`	`double` 在用户看到您的广告后与其互动的频率。此频率是互动次数除以广告展示次数。
`interactions`	`int64` 互动次数。互动是指与某种广告格式关联的主用户操作：对于文字广告和购物广告而言是点击，对于视频广告而言是观看，诸如此类。
`invalid_click_rate`	`double` 报告期内从总点击次数（过滤后 + 未过滤的点击次数）过滤出的点击次数所占的百分比。
`invalid_clicks`	`int64` Google 认为不合规定且不向您收费的点击次数。
`general_invalid_click_rate`	`double` 从总点击次数（过滤后 + 未过滤的点击次数）中滤除的常规无效点击次数所占的百分比。这些是 Google 认为非法的点击次数，是通过常规滤除方式（即已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等）检测到的。我们不会向您收取这些点击的费用，您的账户统计信息也不会受其影响。如需了解详情，请参阅 https://support.google.com/campaignmanager/answer/6076504 提供的帮助页面。
`general_invalid_clicks`	`int64` 常规无效点击次数。这些是通过常规滤除方式（例如已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等）检测到的无效点击子集。我们不会向您收取这些点击的费用，您的账户统计信息也不会受其影响。如需了解详情，请参阅 https://support.google.com/campaignmanager/answer/6076504 提供的帮助页面。
`mobile_friendly_clicks_percentage`	`double` 适合移动设备的页面的移动点击次数所占的百分比。
`search_absolute_top_impression_share`	`double` 在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情，请参阅 https://support.google.com/sa360/answer/9566729。任何低于 0.1 的值都会报告为 0.0999。
`search_budget_lost_absolute_top_impression_share`	`double` 此数字用于估算您的广告因预算不足而未能在搜索结果中的页首广告中作为头条广告进行展示的频率。注意：搜索网络预算错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
`search_budget_lost_impression_share`	`double` 您的广告有资格在搜索网络中展示但由于预算过低而未展示的次数的估算百分比。注意：搜索网络预算错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
`search_budget_lost_top_impression_share`	`double` 此数字用于估算您的广告因预算低而未能在顶部自然搜索结果邻近位置展示的频率。注意：搜索网络预算错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
`search_click_share`	`double` 您在搜索网络中获得的点击次数除以您有资格获得的估算点击次数。注意：搜索网络点击次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
`search_exact_match_impression_share`	`double` 对于与关键字完全匹配（或是关键字的紧密变体形式）的搜索字词，此字段是您获得的展示次数除以您有资格在搜索网络上获得的估算展示次数。注意：搜索网络完全匹配展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
`search_impression_share`	`double` 您在搜索网络中获得的展示次数除以您有资格获得的估算展示次数。注意：在搜索网络中获得的展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。
`search_rank_lost_absolute_top_impression_share`	`double` 此数字用于估算您的广告因广告评级较低而未能在搜索结果中的页首广告中作为头条广告进行展示的频率。注意：搜索网络排名错失的绝对页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
`search_rank_lost_impression_share`	`double` 您的广告由于广告评级差而未在搜索网络中获得的展示次数的估算百分比。注意：搜索网络排名错失的展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
`search_rank_lost_top_impression_share`	`double` 此数字用于估算您的广告因广告评级较低而未能在顶部自然搜索结果邻近位置展示的频率。注意：搜索网络排名错失的页首展示次数份额的报告范围介于 0 到 0.9 之间。任何高于 0.9 的值都会报告为 0.9001。
`search_top_impression_share`	`double` 您在页首广告中实际获得的展示次数除以您有资格获得的估算展示次数所得到的百分比。注意：搜索网络页首展示次数份额的报告范围介于 0.1 到 1 之间。任何低于 0.1 的值都会报告为 0.0999。页首广告通常展示在顶部自然搜索结果上方，但在某些查询中，页首广告可能会展示在顶部自然搜索结果下方。
`top_impression_percentage`	`double` 广告在邻近顶部自然搜索结果的位置展示的次数所占百分比。
`value_per_all_conversions`	`double` 所有转化的价值除以所有转化的次数。
`value_per_all_conversions_by_conversion_date`	`double` 所有转化的价值除以所有转化的次数。如果选择此列并将其设置为“日期”，则“日期”列中的值表示转化日期。如需了解“by_conversion_date”列的详细信息，请访问 https://support.google.com/sa360/answer/9250611。
`value_per_conversion`	`double` 可出价转化的价值除以可出价转化的次数。显示每次可出价转化的平均价值。
`value_per_conversions_by_conversion_date`	`double` 按转化日期划分的可出价转化价值除以按转化日期划分的可出价转化次数。显示每次可出价转化的平均价值（按转化日期）。如果选择此列并将其设置为日期，则“日期”列中的值表示转化日期。
`client_account_view_through_conversions`	`int64` 浏览型转化总次数。当客户看到图片或富媒体广告，之后在您的网站上完成转化而不与另一个广告互动（例如，点击）时，就会发生这种情况。
`client_account_cross_sell_cost_of_goods_sold_micros`	`int64` 客户账号作为交叉销售产品时的销货成本 (COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。此订单的作为交叉销售产品时的销货成本为 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`cross_sell_cost_of_goods_sold_micros`	`int64` “作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。此订单的作为交叉销售产品时的销货成本为 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`client_account_cross_sell_gross_profit_micros`	`int64` “客户账号作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的其他产品给您带来的利润。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`cross_sell_gross_profit_micros`	`int64` “作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的其他产品给您带来的利润。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`client_account_cross_sell_revenue_micros`	`int64` “客户账号作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售所产生的总价值。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`cross_sell_revenue_micros`	`int64` “作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的收入”是指广告促成的交叉销售所产生的总价值。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`client_account_cross_sell_units_sold`	`double` “客户账号作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。
`cross_sell_units_sold`	`double` “作为交叉销售产品时的销量”是指因广告宣传某产品而售出的其他产品的总数。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。“作为交叉销售产品时的销量”是指广告促成的所有订单中的交叉售出产品的总数。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为交叉销售产品时的销量为 2。此指标仅在您报告了含购物车数据的转化的情况下可用。
`client_account_lead_cost_of_goods_sold_micros`	`int64` “作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些货品的成本会计入“作为主推产品时的销货成本”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为主推产品时的销货成本为 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`lead_cost_of_goods_sold_micros`	`int64` “作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些货品的成本会计入“作为主推产品时的销货成本”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为主推产品时的销货成本为 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`client_account_lead_gross_profit_micros`	`int64` “客户账号作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的同一产品给您带来的利润。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。在这笔订单中，作为主推产品时的毛利润就是：7 美元 = 10 美元 - 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`lead_gross_profit_micros`	`int64` “作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的同一产品给您带来的利润。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。在这笔订单中，作为主推产品时的毛利润就是：7 美元 = 10 美元 - 3 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`client_account_lead_revenue_micros`	`int64` “作为客户账号的主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为主推产品时的收入为 10 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`lead_revenue_micros`	`int64` “作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为主推产品时的收入为 10 美元。只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是一个货币值，默认以客户的币种返回。如需查看 metrics_currency 参数，请访问 https://developers.google.com/search-ads/reporting/query/query-structure#parameters_clause
`client_account_lead_units_sold`	`double` “客户账号作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些售出产品的总数会计入“作为主推产品时的销量”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。
`lead_units_sold`	`double` “作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些售出产品的总数会计入“作为主推产品时的销量”。示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。此指标仅在您报告了含购物车数据的转化的情况下可用。

MobileAppAsset

表示移动应用的素材资源。

字段

字段
`app_id`	`string` 必需。用于唯一标识移动应用的字符串。它应仅包含平台原生 ID，例如 Android 的“com.android.ebay”或 iOS 的“12345689”。
`app_store`	`MobileAppVendor` 必需。分发此特定应用的应用商店。

app_id

string

必需。用于唯一标识移动应用的字符串。它应仅包含平台原生 ID，例如 Android 的“com.android.ebay”或 iOS 的“12345689”。

app_store

MobileAppVendor

必需。分发此特定应用的应用商店。

PercentCpc

一种出价策略，出价是某件商品或服务的广告价格的一小部分。

字段

字段
`cpc_bid_ceiling_micros`	`int64` 可通过出价策略设置的出价上限。这是由广告客户输入的可选字段，以本地微单位指定。注意：零值的解读方式与 bid_ceiling 未定义相同。
`enhanced_cpc_enabled`	`bool` 根据转化可能性，上调或下调每次竞价的出价。个别出价可能会超过 cpc_bid_ceiling_micros，但广告系列的平均出价金额不应超过。

cpc_bid_ceiling_micros

int64

可通过出价策略设置的出价上限。这是由广告客户输入的可选字段，以本地微单位指定。注意：零值的解读方式与 bid_ceiling 未定义相同。

enhanced_cpc_enabled

bool

根据转化可能性，上调或下调每次竞价的出价。个别出价可能会超过 cpc_bid_ceiling_micros，但广告系列的平均出价金额不应超过。

RealTimeBiddingSetting

实时出价设置，此功能仅适用于定位到 Ad Exchange 广告网络的广告系列。

字段

字段
`opt_in`	`bool` 广告系列是否已选择启用实时出价。

opt_in

bool

广告系列是否已选择启用实时出价。

SearchAds360ExpandedDynamicSearchAdInfo

加大型动态搜索广告。

字段

字段
`description1`	`string` 广告说明的第一行。
`description2`	`string` 广告说明的第二行。
`ad_tracking_id`	`int64` 广告的跟踪 ID。

description1

string

广告说明的第一行。

description2

string

广告说明的第二行。

ad_tracking_id

int64

广告的跟踪 ID。

SearchAds360ExpandedTextAdInfo

Search Ads 360 加大型文字广告。

字段
`headline`	`string` 广告的标题。
`headline2`	`string` 广告的第二个标题。
`headline3`	`string` 广告的第三个标题。
`description1`	`string` 广告说明的第一行。
`description2`	`string` 广告说明的第二行。
`path1`	`string` 附加到自动生成的可见网址的文字（附带分隔符）。
`path2`	`string` 使用分隔符附加到 path1 的文本。
`ad_tracking_id`	`int64` 广告的跟踪 ID。

SearchAds360ProductAdInfo

此类型没有字段。

Search Ads 360 产品广告。

SearchAds360ResponsiveSearchAdInfo

Search Ads 360 自适应搜索广告。

字段
`headlines[]`	`AdTextAsset` 标题的文字素材资源列表。广告投放时，系统会从此列表中选择标题。
`descriptions[]`	`AdTextAsset` 说明的文字素材资源列表。广告投放时，系统会从此列表中选择说明。
`path1`	`string` 附加到自动生成的可见网址的文字（附带分隔符）。
`path2`	`string` 使用分隔符附加到 path1 的文本。
`ad_tracking_id`	`int64` 广告的跟踪 ID。

SearchAds360TextAdInfo

Search Ads 360 文字广告。

字段
`headline`	`string` 广告的标题。
`description1`	`string` 广告说明的第一行。
`description2`	`string` 广告说明的第二行。
`display_url`	`string` 广告的显示网址。
`display_mobile_url`	`string` 广告的显示移动网址。
`ad_tracking_id`	`int64` 广告的跟踪 ID。

细分

仅细分字段。

字段
`ad_network_type`	`AdNetworkType` 广告网络类型。
`conversion_action_category`	`ConversionActionCategory` 转化操作类别。
`conversion_custom_dimensions[]`	`Value` 转化自定义维度。
`day_of_week`	`DayOfWeek` 星期几，例如星期一。
`device`	`Device` 指标应用于的设备。
`keyword`	`Keyword` 关键字条件。
`product_channel`	`ProductChannel` 商品的渠道。
`product_channel_exclusivity`	`ProductChannelExclusivity` 商品的渠道独占性。
`product_condition`	`ProductCondition` 商品的使用情况。
`product_sold_condition`	`ProductCondition` 所售商品的使用情况。
`raw_event_conversion_dimensions[]`	`Value` 原始事件转化维度。
`conversion_action`	`string` 转化操作的资源名称。
`conversion_action_name`	`string` 转化操作名称。
`date`	`string` 指标适用的日期。yyyy-MM-dd 格式，例如 2018-04-17。
`geo_target_city`	`string` 表示城市的地理位置定位目标常量的资源名称。
`geo_target_country`	`string` 代表国家/地区的地理位置定位目标常量的资源名称。
`geo_target_metro`	`string` 代表都市圈的地理位置定位目标常量的资源名称。
`geo_target_region`	`string` 代表区域的地理位置定位目标常量的资源名称。
`hour`	`int32` 以介于 0 到 23 之间（包括 0 和 23）的数字表示的时段。
`month`	`string` 由一个月第一天的日期表示的月份。格式为 yyyy-MM-dd。
`product_bidding_category_level1`	`string` 商品的出价类别（第 1 级）。
`product_bidding_category_level2`	`string` 商品的出价类别（第 2 级）。
`product_bidding_category_level3`	`string` 商品的出价类别（第 3 级）。
`product_bidding_category_level4`	`string` 商品的出价类别（第 4 级）。
`product_bidding_category_level5`	`string` 商品的出价类别（第 5 级）。
`product_brand`	`string` 商品的品牌。
`product_country`	`string` 商品目标销售国家/地区的地理位置定位目标常量的资源名称。
`product_custom_attribute0`	`string` 商品的自定义属性 0。
`product_custom_attribute1`	`string` 商品的自定义属性 1。
`product_custom_attribute2`	`string` 商品的自定义属性 2。
`product_custom_attribute3`	`string` 商品的自定义属性 3。
`product_custom_attribute4`	`string` 商品的自定义属性 4。
`product_item_id`	`string` 商品的项目 ID。
`product_language`	`string` 商品语言的语言常量的资源名称。
`product_sold_bidding_category_level1`	`string` 所售商品的出价类别（第 1 级）。
`product_sold_bidding_category_level2`	`string` 所售商品的出价类别（第 2 级）。
`product_sold_bidding_category_level3`	`string` 所售商品的出价类别（第 3 级）。
`product_sold_bidding_category_level4`	`string` 所售商品的出价类别（第 4 级）。
`product_sold_bidding_category_level5`	`string` 所售商品的出价类别（第 5 级）。
`product_sold_brand`	`string` 所售商品的品牌。
`product_sold_custom_attribute0`	`string` 所售商品的自定义属性 0。
`product_sold_custom_attribute1`	`string` 所售商品的自定义属性 1。
`product_sold_custom_attribute2`	`string` 所售商品的自定义属性 2。
`product_sold_custom_attribute3`	`string` 所售商品的自定义属性 3。
`product_sold_custom_attribute4`	`string` 所售商品的自定义属性 4。
`product_sold_item_id`	`string` 所售商品的商品 ID。
`product_sold_title`	`string` 所售商品的名称。
`product_sold_type_l1`	`string` 所售商品的类型（第 1 级）。
`product_sold_type_l2`	`string` 所售商品的类型（第 2 级）。
`product_sold_type_l3`	`string` 所售商品的类型（第 3 级）。
`product_sold_type_l4`	`string` 所售商品的类型（第 4 级）。
`product_sold_type_l5`	`string` 所售商品的类型（第 5 级）。
`product_store_id`	`string` 商品的商店 ID。
`product_title`	`string` 商品的名称。
`product_type_l1`	`string` 商品的类型（第 1 级）。
`product_type_l2`	`string` 商品的类型（第 2 级）。
`product_type_l3`	`string` 商品的类型（第 3 级）。
`product_type_l4`	`string` 商品的类型（第 4 级）。
`product_type_l5`	`string` 商品的类型（第 5 级）。
`quarter`	`string` 由一个季度第一天的日期表示的季度。对季度使用日历年，例如 2018 年第 2 季度从 2018 年 4 月 1 日开始。格式为 yyyy-MM-dd。
`week`	`string` 定义为星期一到星期日的一周，由星期一的日期表示。格式为 yyyy-MM-dd。
`year`	`int32` 年份，格式为 yyyy。
`asset_interaction_target`	`AssetInteractionTarget` 仅适用于 CustomerAsset、CampaignAsset 和 AdGroupAsset 指标。指明互动指标是发生在素材资源本身还是其他素材资源或广告单元上。如果广告的所有部分（例如广告本身和附加链接等其他组件）一起投放，系统会统计这些部分获得的互动次数（例如点击次数）。如果 interaction_on_this_asset 为 true，则表示互动发生在此特定素材资源上；如果 interaction_on_this_asset 为 false，则表示互动并非发生在此特定素材资源上，而是发生在与此素材资源一起投放的广告的其他部分。

TargetCpa

一种自动出价策略，可为您设置合适的出价，在不超出您设置的目标每次转化费用 (CPA) 的前提下，帮您获得尽可能多的转化。

字段

字段
`target_cpa_micros`	`int64` 平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。
`cpc_bid_ceiling_micros`	`int64` 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。只能为组合出价策略设置此限制。
`cpc_bid_floor_micros`	`int64` 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。只能为组合出价策略设置此限制。

target_cpa_micros

int64

平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。

cpc_bid_ceiling_micros

int64

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。只能为组合出价策略设置此限制。

cpc_bid_floor_micros

int64

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。只能为组合出价策略设置此限制。

TargetCpm

此类型没有字段。

“目标每千次展示费用”是一种自动出价策略，可根据您设置的目标每千次展示费用来设置出价，以优化广告效果。

TargetImpressionShare

这是一种自动出价策略，可设置出价，以便一定比例的搜索广告展示在首页顶部（或其他目标位置）。

字段

字段
`location`	`TargetImpressionShareLocation` 搜索结果页上的目标位置。
`location_fraction_micros`	`int64` 在目标地理位置展示的广告所占的百分比（以微分表示）。例如，1% 等于 10,000。
`cpc_bid_ceiling_micros`	`int64` 自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段，该字段用于设置上限值，并以本地微单位指定。

location

TargetImpressionShareLocation

搜索结果页上的目标位置。

location_fraction_micros

int64

在目标地理位置展示的广告所占的百分比（以微分表示）。例如，1% 等于 10,000。

cpc_bid_ceiling_micros

int64

自动出价系统可以指定的最高每次点击费用出价。这是由广告客户输入的必填字段，该字段用于设置上限值，并以本地微单位指定。

TargetOutrankShare

这是一种自动出价策略，会根据广告客户应在竞价中超越特定竞争对手的目标百分比来设置出价。此策略已被弃用。

字段

字段
`cpc_bid_ceiling_micros`	`Int64Value` 可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

cpc_bid_ceiling_micros

Int64Value

可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

TargetRestriction

按定位维度显示的定位设置列表。

字段

字段
`targeting_dimension`	`TargetingDimension` 这些设置适用的定位维度。
`bid_only`	`bool` 指示是将广告限制为仅针对您为此 targeting_dimension 选择的条件展示，还是定位到此 targeting_dimension 的所有值，并根据您在其他 TargetingDimensions 中的定位条件展示广告。值为 `true` 表示这些条件只会应用出价调节器，而不会影响定位。值为 `false` 表示这些条件将限制定位以及应用出价调节系数。

targeting_dimension

TargetingDimension

这些设置适用的定位维度。

bid_only

bool

指示是将广告限制为仅针对您为此 targeting_dimension 选择的条件展示，还是定位到此 targeting_dimension 的所有值，并根据您在其他 TargetingDimensions 中的定位条件展示广告。值为 true 表示这些条件只会应用出价调节器，而不会影响定位。值为 false 表示这些条件将限制定位以及应用出价调节系数。

TargetRoas

这是一种自动出价策略，可帮助您在达到特定目标广告支出回报率 (ROAS) 平均值的同时，尽可能提高收入。

字段

字段
`target_roas`	`double` 必需。每单位支出所选择的收入（基于转化数据）。值必须介于 0.01 到 1000.0 之间（包括 0.01 和 1000.0）。
`cpc_bid_ceiling_micros`	`int64` 可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。只能为组合出价策略设置此限制。
`cpc_bid_floor_micros`	`int64` 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。只能为组合出价策略设置此限制。

target_roas

double

必需。每单位支出所选择的收入（基于转化数据）。值必须介于 0.01 到 1000.0 之间（包括 0.01 和 1000.0）。

cpc_bid_ceiling_micros

int64

可通过出价策略设置的出价上限。此限值适用于该策略管理的所有关键字。只能为组合出价策略设置此限制。

cpc_bid_floor_micros

int64

可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。只能为组合出价策略设置此限制。

TargetSpend

这是一种自动出价策略，使用该策略，系统会自动为您设置适当的出价，助您在不超出预算的前提下为您争取尽可能多的点击。

字段

字段
`target_spend_micros (deprecated)`	`int64` 此项已弃用！已废弃：尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定，则预算会被用作支出目标。此字段已废弃，不应再使用。如需了解详情，请访问 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。
`cpc_bid_ceiling_micros`	`int64` 可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

target_spend_micros
(deprecated)

int64

已废弃：尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定，则预算会被用作支出目标。此字段已废弃，不应再使用。如需了解详情，请访问 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。

cpc_bid_ceiling_micros

int64

可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

TargetingSetting

广告系列一级和广告组一级的与定位相关的功能设置。如需详细了解定位设置，请访问 https://support.google.com/google-ads/answer/7365594

字段

字段
`target_restrictions[]`	`TargetRestriction` 用于限制广告系列或广告组覆盖面的每个定位维度的设置。

target_restrictions[]

TargetRestriction

用于限制广告系列或广告组覆盖面的每个定位维度的设置。

TextAsset

文字素材资源。

字段

字段
`text`	`string` 文字素材资源的文本内容。

text

string

文字素材资源的文本内容。

TextLabel

一种在彩色背景上显示文本的标签。

字段

字段
`background_color`	`string` 标签的背景颜色（十六进制格式）。此字符串必须与正则表达式“^#([a-fA-F0-9]{6}\|[a-fA-F0-9]{3})$”匹配。注意：经理账号可能看不到背景颜色。
`description`	`string` 标签的简短说明。长度不得超过 200 个字符。

background_color

string

标签的背景颜色（十六进制格式）。此字符串必须与正则表达式“^#([a-fA-F0-9]{6}|[a-fA-F0-9]{3})$”匹配。注意：经理账号可能看不到背景颜色。

description

string

标签的简短说明。长度不得超过 200 个字符。

UnifiedCallAsset

统一的电话素材资源。

字段
`country_code`	`string` 电话号码对应的双字母国家/地区代码。示例：“US”“us”。
`phone_number`	`string` 广告客户的原始电话号码。示例：“1234567890”“(123)456-7890”
`call_conversion_reporting_state`	`CallConversionReportingState` 指示此 CallAsset 应使用自己的来电转化设置、遵循账号级设置，还是停用来电转化。
`call_conversion_action`	`string` 要将来电转化归因到的转化操作。如果未设置，系统将使用默认转化操作。只有在 call_conversion_reporting_state 设置为 USE_RESOURCE_LEVEL_CALL_CONVERSION_ACTION 时，此字段才有效。
`ad_schedule_targets[]`	`AdScheduleInfo` 非重叠时间表的列表，用于指定资源可以投放的所有时间间隔。每天最多可设置 6 个投放时间，总计 42 个。
`call_only`	`bool` 来电专用广告是否仅显示电话号码，而不显示指向网站的链接。适用于 Microsoft Ads。
`call_tracking_enabled`	`bool` 是否应在来电跟踪中启用相应来电。适用于 Microsoft Ads。
`use_searcher_time_zone`	`bool` 是否在搜索用户所在的时区显示来电号码附加信息。适用于 Microsoft Ads。
`start_date`	`string` 此素材资源生效并可开始投放的开始日期（采用 yyyy-MM-dd 格式）。
`end_date`	`string` 此素材资源有效且仍在投放的最后一天，格式为 yyyy-MM-dd。

UnifiedCalloutAsset

统一的宣传信息素材资源。

字段
`callout_text`	`string` 宣传信息文字。此字符串的长度应介于 1 和 25 之间（含 1 和 25）。
`start_date`	`string` 此素材资源生效并可开始投放的开始日期（采用 yyyy-MM-dd 格式）。
`end_date`	`string` 此素材资源有效且仍在投放的最后一天，格式为 yyyy-MM-dd。
`ad_schedule_targets[]`	`AdScheduleInfo` 非重叠时间表的列表，用于指定资源可以投放的所有时间间隔。每天最多可设置 6 个投放时间，总计 42 个。
`use_searcher_time_zone`	`bool` 是否在搜索用户的时区显示资源。适用于 Microsoft Ads。

UnifiedLocationAsset

统一的地址素材资源。

字段

字段
`place_id`	`string` 地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。对于给定的客户 ID 和素材资源类型，此字段是唯一的。如需详细了解地点 ID，请访问 https://developers.google.com/places/web-service/place-id。
`business_profile_locations[]`	`BusinessProfileLocation` 客户的营业地点列表。只有在地址素材资源从商家资料账号同步时，系统才会返回此值。同一账号下可以有多个指向同一地点 ID 的商家资料商家信息。
`location_ownership_type`	`LocationOwnershipType` 地点所有权类型。如果类型为 BUSINESS_OWNER，则会作为附加地址信息投放。如果类型为“AFFILIATE”（联属营销），则会作为联属营销营业地点投放。

place_id

string

地点 ID 可唯一标识 Google Places 数据库中和 Google 地图上的地点。对于给定的客户 ID 和素材资源类型，此字段是唯一的。如需详细了解地点 ID，请访问 https://developers.google.com/places/web-service/place-id。

business_profile_locations[]

BusinessProfileLocation

客户的营业地点列表。只有在地址素材资源从商家资料账号同步时，系统才会返回此值。同一账号下可以有多个指向同一地点 ID 的商家资料商家信息。

location_ownership_type

LocationOwnershipType

地点所有权类型。如果类型为 BUSINESS_OWNER，则会作为附加地址信息投放。如果类型为“AFFILIATE”（联属营销），则会作为联属营销营业地点投放。

UnifiedPageFeedAsset

统一页面 Feed 素材资源。

字段

字段
`page_url`	`string` 广告客户要定位到的网页。
`labels[]`	`string` 用于对网页网址进行分组的标签。

page_url

string

广告客户要定位到的网页。

labels[]

string

用于对网页网址进行分组的标签。

UnifiedSitelinkAsset

统一的站内链接素材资源。

字段
`link_text`	`string` 站内链接的网址显示文本。此字符串的长度应介于 1 和 25 之间（含 1 和 25）。
`description1`	`string` 站内链接的说明的第一行。如此行已设置，则长度应介于 1 到 35 之间（包括 1 和 35），并且还必须设置 description2。
`description2`	`string` 站内链接的说明的第二行。如此行已设置，则长度应介于 1 到 35 之间（包括 1 和 35），并且还必须设置 description1。
`start_date`	`string` 此素材资源生效并可开始投放的开始日期（采用 yyyy-MM-dd 格式）。
`end_date`	`string` 此素材资源有效且仍在投放的最后一天，格式为 yyyy-MM-dd。
`ad_schedule_targets[]`	`AdScheduleInfo` 非重叠时间表的列表，用于指定资源可以投放的所有时间间隔。每天最多可设置 6 个投放时间，总计 42 个。
`tracking_id`	`int64` 用于跟踪站内链接素材资源的点击次数的 ID。这是 Yahoo!“仅限日本”字段。
`use_searcher_time_zone`	`bool` 是否在搜索用户的时区显示站内链接素材资源。适用于 Microsoft Ads。
`mobile_preferred`	`bool` 站内链接素材资源是否应在移动设备上展示的偏好设置。适用于 Microsoft Ads。

UserListInfo

用户名单条件。表示广告客户定义要定位到的用户名单。

字段

字段
`user_list`	`string` 用户名单资源名称。

user_list

string

用户名单资源名称。

值

通用数据容器。

字段
联合字段 `value`。值。`value` 只能是下列其中一项：
`boolean_value`	`bool` 布尔值。
`int64_value`	`int64` int64。
`float_value`	`float` 浮点数。
`double_value`	`double` 双精度型。
`string_value`	`string` 它是一个字符串。

WebpageConditionInfo

用于定位广告客户网站网页的逻辑表达式。

字段

字段
`operand`	`WebpageConditionOperand` 网页定位条件的操作数。
`operator`	`WebpageConditionOperator` 网页定位条件的运算符。
`argument`	`string` 网页定位条件的参数。

operand

WebpageConditionOperand

网页定位条件的操作数。

operator

WebpageConditionOperator

网页定位条件的运算符。

argument

string

网页定位条件的参数。

WebpageInfo

表示用于定位广告客户网站网页的条件。

字段

字段
`conditions[]`	`WebpageConditionInfo` 网页定位的条件或逻辑表达式。在为定位进行评估时，网页定位条件列表会连接在一起。条件列表为空表示定位到广告系列所属网站的所有网页。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
`coverage_percentage`	`double` 网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如，如果覆盖率返回为 1，则表示覆盖率为 100%。此字段为只读字段。
`criterion_name`	`string` 由此参数定义的条件的名称。名称值将用于使用此类参数标识、排序和过滤条件。此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

conditions[]

WebpageConditionInfo

网页定位的条件或逻辑表达式。在为定位进行评估时，网页定位条件列表会连接在一起。条件列表为空表示定位到广告系列所属网站的所有网页。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

coverage_percentage

double

网站条件覆盖率。这是系统根据广告组和广告系列中的网站定位条件、否定网站定位条件和否定关键字计算出的网站覆盖率。例如，如果覆盖率返回为 1，则表示覆盖率为 100%。此字段为只读字段。

criterion_name

string

由此参数定义的条件的名称。名称值将用于使用此类参数标识、排序和过滤条件。

此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

YoutubeVideoAsset

YouTube 资产。

字段

字段
`youtube_video_title`	`string` YouTube 视频标题。
`youtube_video_id`	`string` YouTube 视频 ID。这是 YouTube 视频网址中使用的 11 个字符的字符串值。

youtube_video_title

string

YouTube 视频标题。

youtube_video_id

string

YouTube 视频 ID。这是 YouTube 视频网址中使用的 11 个字符的字符串值。

Package google.ads.searchads360.v0.common 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

索引

AdScheduleInfo

AdTextAsset

AgeRangeInfo

AssetInteractionTarget

AssetUsage

AudienceInfo

BusinessProfileLocation

CallToActionAsset

CustomParameter

DeviceInfo

EnhancedCpc

FrequencyCapEntry

GenderInfo

ImageAsset

ImageDimension

Keyword

KeywordInfo

LanguageInfo

ListingGroupInfo

LocationGroupInfo

LocationInfo

ManualCpa

ManualCpc

ManualCpm

MaximizeConversionValue

MaximizeConversions

指标

MobileAppAsset

PercentCpc

RealTimeBiddingSetting

SearchAds360ExpandedDynamicSearchAdInfo

SearchAds360ExpandedTextAdInfo

SearchAds360ProductAdInfo

SearchAds360ResponsiveSearchAdInfo

SearchAds360TextAdInfo

细分

TargetCpa

TargetCpm

TargetImpressionShare

TargetOutrankShare

TargetRestriction

TargetRoas

TargetSpend

TargetingSetting

TextAsset

TextLabel

UnifiedCallAsset

UnifiedCalloutAsset

UnifiedLocationAsset

UnifiedPageFeedAsset

UnifiedSitelinkAsset

UserListInfo

值

WebpageConditionInfo

WebpageInfo

YoutubeVideoAsset

Package google.ads.searchads360.v0.common