Package google.ads.searchads360.v0.common

索引

• AdScheduleInfo（消息）
• AdTextAsset（消息）
• AgeRangeInfo（消息）
• AssetInteractionTarget（消息）
• AssetUsage（消息）
• AudienceInfo（消息）
• BusinessProfileLocation（消息）
• CallToActionAsset（消息）
• CustomParameter（消息）
• DeviceInfo（消息）
• EnhancedCpc（消息）
• FinalAppUrl（消息）
• 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（消息）
• SyntheticContentAttestation（消息）
• SyntheticContentInfo（消息）
• 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 之间（含 0 和 23）。 此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。
end_hour	int32 结束小时（采用 24 小时制）；24 表示一天结束。此字段的值必须介于 0 到 24 之间（含边界值）。 此字段对 CREATE 操作是必需的，而在 UPDATE 操作中是被禁止的。

AdTextAsset

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

字段
text	string 素材资源文字。

AgeRangeInfo

年龄段条件。

字段
type	AgeRangeType 年龄段的类型。

AssetInteractionTarget

AssetInteractionTarget 段。

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

AssetUsage

包含资产的使用情况信息。

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

AudienceInfo

一种受众群体条件。

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

BusinessProfileLocation

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

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

CallToActionAsset

号召性用语素材资源。

字段
call_to_action	CallToActionType 号召性用语。

CustomParameter

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

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

DeviceInfo

设备条件。

字段
type	Device 设备类型。

EnhancedCpc

此类型没有字段。

一种自动出价策略，可针对更有可能促成转化的点击提高出价，而针对不太可能促成转化的点击降低出价。

此出价策略已被弃用，无法再创建。请使用 ManualCpc 并将 enhanced_cpc_enabled 设置为 true，以实现相同的功能。

FinalAppUrl

用于深层链接到指定操作系统的应用的网址。

字段
os_type	AppUrlOperatingSystemType 相应网址定位到的操作系统。必填。
url	string 应用深层链接网址。深层链接用于指定应用中与您要展示的内容相对应的位置，应采用 {scheme}://{host_path} 格式。架构用于标识要打开哪个应用。对于您的应用，您可以使用以应用名称开头的自定义协议。主机和路径用于指定应用中存储内容的唯一位置。示例：“exampleapp://productid_1234”。必填。

FrequencyCapEntry

此类型没有字段。

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

GenderInfo

性别条件。

字段
type	GenderType 性别的类型。

ImageAsset

图片素材资源。

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

ImageDimension

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

字段
height_pixels	int64 图片的高度。
width_pixels	int64 图片的宽度。
url	string 返回具有相应高度和宽度的图片的网址。

关键字

关键字条件细分。

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

KeywordInfo

关键字条件。

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

LanguageInfo

语言条件。

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

ListingGroupInfo

一种产品信息组条件。

字段
type	ListingGroupType 产品信息组的类型。

LocationGroupInfo

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

字段
geo_target_constants[]	string 用于限制 Feed 中地理区域范围的地理位置定位常量。目前仅允许一个地理位置定位常量。
radius_units	LocationGroupRadiusUnits 半径的单位。地理位置定位条件常量支持英里和米。FeedItemSet 支持毫英里和米。此字段是必需的，必须在 CREATE 操作中设置。
feed_item_sets[]	string FeedItemSet，其 FeedItem 已定位。如果指定了多个 ID，则至少出现在一个集合中的所有商品都会成为定位对象。此字段不能与 geo_target_constants 搭配使用。此字段为可选字段，只能在 CREATE 操作中设置。
radius	int64 以指定单位表示的距离，用于指定目标地理位置的周边半径。此字段是必需的，必须在 CREATE 操作中设置。

LocationInfo

地理位置条件。

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

ManualCpa

此类型没有字段。

一种人工出价策略，可让广告客户针对广告客户指定的每次操作设置出价。

ManualCpc

基于点击次数的手动出价，用户按每次点击付费。

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

ManualCpm

此类型没有字段。

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

MaximizeConversionValue

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

字段
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)”选项。这是您希望为出价策略的币种（以微单位指定）中的每项转化操作支付的平均金额。如果设置了此出价策略，系统会在不超出目标每次转化费用的前提下，尽可能争取更多转化。如果未设置目标每次转化费用，则出价策略的目标是尽可能为预算实现最低的每次转化费用。

指标

指标数据。

字段
all_conversions_value_by_conversion_date	double 所有转化的值。 如果同时选择此列和“日期”列，则“日期”列中的值表示转化日期。如需了解 by_conversion_date 列的详细信息，请参阅“所有转化次数”列简介。
all_conversions_by_conversion_date	double 转化总次数。包括所有转化，无论 include_in_conversions_metric 的值如何。 如果同时选择此列和“日期”列，则“日期”列中的值表示转化日期。如需了解 by_conversion_date 列的详细信息，请参阅“所有转化次数”列简介。
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 所有点击的总费用除以获得的总点击次数。此指标是货币价值，默认情况下以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
average_cpm	double 平均每千次展示费用 (CPM)。此指标是货币价值，默认情况下以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
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) 之和。此指标是货币价值，默认以客户的币种返回。如需了解详情，请参阅“PARAMETERS”子句中的 metrics_currency 参数。
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 列，请参阅“所有转化次数”列简介
cross_device_conversions_value	double 跨设备转化的值的总和。
cross_device_conversions_value_by_conversion_date	double 按转化日期计算的跨设备转化价值的总和。如需详细了解 by_conversion_date 列，请参阅“所有转化次数”列简介
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 认为非法的点击次数，是通过常规滤除方式（即已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等）检测到的。我们不会向您收取这些点击的费用，您的账户统计信息也不会受其影响。请参阅滤除无效流量以确保质量。
general_invalid_clicks	int64 常规无效点击次数。这些是通过常规滤除方式（例如已知无效的数据中心流量、漫游器和“蜘蛛”程序或其他抓取工具、不规则模式等）检测到的无效点击子集。我们不会向您收取这些点击的费用，您的账户统计信息也不会受其影响。请参阅滤除无效流量以确保质量。
mobile_friendly_clicks_percentage	double 适合移动设备的页面的移动点击次数所占的百分比。
search_absolute_top_impression_share	double 在最显眼购物位置展示的客户的购物或搜索广告展示次数所占百分比。如需了解详情，请参阅页首展示指标和绝对页首展示指标简介。任何低于 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 列的详细信息，请参阅“所有转化次数”列简介。
value_per_conversion	double 可出价的转化的价值除以可出价的转化的次数。显示每种可出价的转化的平均价值。
value_per_conversions_by_conversion_date	double 按转化日期划分的可出价转化价值除以按转化日期划分的可出价转化次数。显示每次可出价转化的平均价值（按转化日期）。如果同时选择此列和日期列，则日期列中的值表示转化日期。
client_account_view_through_conversions	int64 浏览型转化总次数。当客户看到图片或富媒体广告，之后在您的网站上完成转化而不与另一个广告互动（例如，点击）时，就会发生这种情况。
orders	double “订单数”是指广告为您带来的购买转化总数。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果某次转化是由于用户之前与您广告的互动（点击文字广告或购物广告、观看视频广告等）带来的，系统会将其计为一笔订单。 示例：某用户点击了宣传一款帽子的购物广告，然后在您的网站上下单购买了该帽子和一件衬衫。虽然该用户购买了 2 件商品，但仍会计为 1 笔订单。 此指标仅在您报告了含购物车数据的转化的情况下可用。
average_order_value_micros	int64 “平均订单价值”是指广告促成的每笔订单带来的平均收入。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。系统会用订单带来的总收入除以订单总数，计算出平均订单价值。 示例：您收到了 3 笔订单，它们分别带来了 10 美元、15 美元和 20 美元的收入。平均订单价值为 15 美元，计算方法为：（10 美元 + 15 美元 + 20 美元）/3。 此指标仅在您报告了含购物车数据的转化的情况下可用。
average_cart_size	double “平均购物车内商品数量”是指广告带来的每个订单的平均商品数量。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。系统会用所售商品总数除以您获得的订单总数，计算出平均购物车内商品数量。 示例：您获得了 2 个订单，第一个订单包含 3 件商品，第二个订单包含 2 件商品。平均购物车内产品数量即为 2.5 件产品，计算方法为：(3+2)/2。 此指标仅在您报告了含购物车数据的转化的情况下可用。
cost_of_goods_sold_micros	int64 “所售商品的成本”(COGS) 是指广告促成的订单中所售产品的总成本。 运作方式：您可以在 Merchant Center 中为每个产品添加销货成本价值。在您报告含购物车数据的转化时，系统会将所售产品与其销货成本价值进行匹配，并可据此计算每笔订单的毛利润。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。那么，这笔订单的销货成本就是：8 美元 = 3 美元 + 5 美元。 此指标仅在您报告了含购物车数据的转化的情况下可用。
gross_profit_micros	int64 毛利润是指扣除销货成本 (COGS) 后，归因于广告的订单所产生的利润。 运作方式：毛利润是指扣除销货成本后，归因于广告的销售所带来的收益。在计算毛利润时，只会涵盖在 Merchant Center 中具有销货成本值的产品。 示例：某个用户点击了宣传帽子的购物广告，然后在您的网站上下单购买了同款帽子和一件衬衫。帽子的价格为 10 美元，衬衫的价格为 20 美元。帽子的销货成本值为 3 美元，但衬衫没有销货成本值。在计算此订单的毛利润时，仅会考虑帽子，因此毛利润为 7 美元（10 美元 - 3 美元）。 此指标仅在您报告了含购物车数据的转化的情况下可用。
gross_profit_margin	double “毛利润率”是指在扣除销货成本 (COGS) 后，广告促成的订单带来的毛利润所占的百分比。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。毛利润率是指用所得毛利润除以总收入，然后再乘 100%，计算得出的值。计算毛利率时，只会纳入 Merchant Center 中具有销货成本价值的产品。 示例：客户在您的网站上下单购买了帽子和衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。衬衫的价格为 20 美元，但没有销货成本价值。这笔订单中只有帽子有销货成本价值，因此计算毛利率时只会将帽子考虑在内，也就是 70% =（10 美元 - 3 美元）/10 美元 x 100%。 此指标仅在您报告了含购物车数据的转化的情况下可用。
revenue_micros	int64 “收入”是指您从广告促成的订单中赚到的总金额。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。广告促成的所有订单的总价值减去所有折扣即为收入。 示例：某个用户点击了宣传帽子的购物广告，然后在您的网站上下单购买了同款帽子和一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。整个订单有 5 美元的折扣。那么，这笔订单的收入就是：25 美元 =（10 美元 + 20 美元）- 5 美元。 此指标仅在您报告了含购物车数据的转化的情况下可用。
units_sold	double “售出数量”是指广告促成的订单中的售出产品的总数。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。“售出数量”是指广告促成的所有订单中的售出产品的总数。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，售出数量为 3。 此指标仅在您报告了含购物车数据的转化的情况下可用。
client_account_cross_sell_cost_of_goods_sold_micros	int64 “客户账号交叉销售产品的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。此订单的作为交叉销售产品时的销货成本为 5 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
cross_sell_cost_of_goods_sold_micros	int64 “作为交叉销售产品时的销货成本”(COGS) 是指通过对其他产品进行广告宣传而售出产品产生的总成本。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的销货成本是指未宣传的售出产品的总成本。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。此订单的作为交叉销售产品时的销货成本为 5 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
client_account_cross_sell_gross_profit_micros	int64 “客户账号作为交叉销售产品时的毛利润”是指因广告宣传某产品而售出的其他产品时，所产生的销售收入减去销货成本 (COGS) 后给您带来的利润。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
cross_sell_gross_profit_micros	int64 “作为交叉销售产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的其他产品给您带来的利润。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。购买交易中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的毛利润就是广告促成的交叉销售所产生的收入减去销货成本。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。衬衫的价格为 20 美元，其销货成本价值为 5 美元。在这笔订单中，作为交叉销售产品时的毛利润就是：15 美元 = 20 美元 - 5 美元。 此指标仅在您报告了含购物车数据的转化的情况下可用。 此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
client_account_cross_sell_revenue_micros	int64 “客户账号交叉销售收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的收入就是广告促成的交叉销售所产生的总价值。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
cross_sell_revenue_micros	int64 “作为交叉销售产品时的收入”是指因广告宣传某产品而售出的其他产品给您带来的收入总金额。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品不符，就属于交叉销售。作为交叉销售产品时的收入就是广告促成的交叉销售所产生的总价值。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为交叉销售产品时的收入为 20 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
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 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认情况下以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
lead_cost_of_goods_sold_micros	int64 “作为主推产品时的销货成本”(COGS) 是指因广告宣传某产品而售出的同一产品的总成本。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些货品的成本会计入“作为主推产品时的销货成本”。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的销货成本价值为 3 美元，衬衫的销货成本价值为 5 美元。在这笔订单中，作为主推产品时的销货成本为 3 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
client_account_lead_gross_profit_micros	int64 “客户账号主推产品毛利润”是指因广告宣传某产品而售出同一产品时，所产生的销售收入减去销货成本 (COGS) 后给您带来的利润。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。在这笔订单中，作为主推产品时的毛利润就是：7 美元 = 10 美元 - 3 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
lead_gross_profit_micros	int64 “作为主推产品时的毛利润”是指在减去销货成本 (COGS) 后，因广告宣传某产品而售出的同一产品给您带来的利润。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些销售所产生的收入减去销货成本就是作为主推产品时的毛利润。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。帽子的价格为 10 美元，其销货成本价值为 3 美元。在这笔订单中，作为主推产品时的毛利润就是：7 美元 = 10 美元 - 3 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认情况下以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
client_account_lead_revenue_micros	int64 “客户账号主推产品的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为主推产品时的收入为 10 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认情况下以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
lead_revenue_micros	int64 “作为主推产品时的收入”是指因广告宣传某产品而售出的同一产品给您带来的收入总金额。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么您因销售这些产品所得收入的总价值会计入“作为主推产品时的收入”。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫。这顶帽子的价格是 10 美元，这件衬衫的价格是 20 美元。在这笔订单中，作为主推产品时的收入为 10 美元。 只有在您跟踪含购物车数据的转化时，该指标才可用。此指标是货币价值，默认以客户的币种返回。请参阅PARAMETERS 子句中的 metrics_currency 参数。
client_account_lead_units_sold	double “客户账号主推产品销量”是指因广告宣传某产品而售出的同一产品的总数。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些售出产品的总数会计入“主打产品的销量”。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。 此指标仅在您报告了含购物车数据的转化的情况下可用。
lead_units_sold	double “作为主推产品时的销量”是指因广告宣传某产品而售出的同一产品的总数。 运作方式：您负责就网站上已完成的购买交易报告含购物车数据的转化。如果客户在购买前互动过的广告含有关联产品（详见购物广告），此产品会被视为广告宣传的产品。客户订单中包含的所有产品都属于售出产品。如果广告宣传的产品与售出产品相符，那么这些售出产品的总数会计入“主打产品的销量”。 示例：客户点击了宣传某款帽子的购物广告，然后购买了该款帽子，同时还购买了一件衬衫和一件夹克。在这笔订单中，作为主推产品时的销量为 1。 此指标仅在您报告了含购物车数据的转化的情况下可用。
unique_users	int64 在所请求的时间段内，看到您广告的唯一身份用户数量。此指标无法进行汇总，只能针对 92 天或更短的日期范围进行请求。此指标适用于以下广告系列类型：展示广告系列、视频广告系列、发现广告系列和应用广告系列。
average_impression_frequency_per_user	double 在所请求的时间段内，唯一身份用户看到您广告的平均次数。此指标无法进行汇总，只能针对 92 天以内的时间范围进行请求。此指标适用于以下广告系列类型：展示广告系列、视频广告系列、发现广告系列和应用广告系列。

MobileAppAsset

表示移动应用的资源。

字段
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，但广告系列的平均出价金额不应超过。

RealTimeBiddingSetting

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

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

SearchAds360ExpandedDynamicSearchAdInfo

加大型动态搜索广告。

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

SearchAds360ExpandedTextAdInfo

Search Ads 360 加大型文字广告。加大型文字广告已弃用。请改用 SearchAds360ResponsiveSearchAd。

字段
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_format_type	AdFormatType 广告格式类型。
ad_network_type	AdNetworkType 广告网络类型。
conversion_action_category	ConversionActionCategory 转化操作类别。
conversion_custom_dimensions[]	Value 转化自定义维度。
day_of_week	DayOfWeek 星期几，例如 MONDAY。
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_postal_code	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。
vertical_ads_event_participant_display_names	string 活动详情中参与者的显示名称，例如表演者、演讲者或球队。
vertical_ads_hotel_class	int64 酒店的星级。一般在 1 到 5 星之间，但在酒店 Feed 中可以完全自定义。
vertical_ads_listing	string 与商家信息展示、点击或转化相关联的商家信息。
vertical_ads_listing_brand	string 与垂直广告情境中的特定商品详情相关联的品牌，例如租车、度假屋或活动的品牌。
vertical_ads_listing_city	string 垂直广告列表所在的城市。
vertical_ads_listing_country	string 竖屏广告资源目录所在的国家/地区。
vertical_ads_listing_region	string 竖屏广告商品详情所在的地区。
vertical_ads_partner_account	int64 合作伙伴中心（例如 Hotel Center）内为垂直广告提供商品目录 Feed 数据的特定合作伙伴账号。
vertical_ads_vertical	VerticalAdsItemVerticalType 垂直广告的类型，例如民宿、租车或活动，用于在垂直广告的上下文中对数据进行分类和细分。
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，则表示互动不是发生在相应素材资源上，而是发生在投放的广告中包含相应素材资源的其他部分上。

SyntheticContentAttestation

表示来自单个来源的合成内容的相关证明。

字段
status	SyntheticContentAttestationStatus 指示相应来源是否将相应内容视为合成内容。
source	SyntheticContentSource 合成内容证明的来源。

SyntheticContentInfo

来自不同来源（例如广告客户和 Google 系统）的合成内容证明的容器。

字段
advertiser_attestation	SyntheticContentAttestation 广告客户提供的数据。
system_attestation	SyntheticContentAttestation 有关 Google 系统生成的合成内容的信息。

TargetCpa

一种自动出价策略，可通过设置出价来帮助您达成所设置的目标每次转化费用，同时争取尽可能多的转化。

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

TargetOutrankShare

一种自动出价策略，可根据广告客户应在多少比例的竞价中胜过特定竞争对手来设置出价。此策略已被弃用。

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

TargetRestriction

每个定位维度对应的定位设置列表。

字段
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 可通过出价策略设置的出价下限。此限值适用于该策略管理的所有关键字。 只能为组合出价策略设置此限制。

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 可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。

TargetingSetting

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

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

TextAsset

文字素材资源。

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

TextLabel

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

字段
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”“[phone]”
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，则会作为关联商户地址提供。

UnifiedPageFeedAsset

统一的页面 Feed 素材资源。

字段
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 用户名单资源名称。

值

一个通用数据容器。

字段
联合字段 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 网页定位条件的实参。

WebpageInfo

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

字段
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 个字符的字符串值。