索引
AccessibleBiddingStrategy(消息)AccessibleBiddingStrategy.MaximizeConversionValue(消息)AccessibleBiddingStrategy.MaximizeConversions(消息)AccessibleBiddingStrategy.TargetCpa(消息)AccessibleBiddingStrategy.TargetImpressionShare(消息)AccessibleBiddingStrategy.TargetRoas(消息)AccessibleBiddingStrategy.TargetSpend(消息)Ad(消息)AdGroup(消息)AdGroupAd(消息)AdGroupAdEffectiveLabel(消息)AdGroupAdLabel(消息)AdGroupAsset(消息)AdGroupAssetSet(消息)AdGroupAudienceView(消息)AdGroupBidModifier(消息)AdGroupCriterion(消息)AdGroupCriterion.PositionEstimates(消息)AdGroupCriterion.QualityInfo(消息)AdGroupCriterionEffectiveLabel(消息)AdGroupCriterionLabel(消息)AdGroupEffectiveLabel(消息)AdGroupLabel(消息)AgeRangeView(消息)Asset(消息)AssetGroup(消息)AssetGroupAsset(消息)AssetGroupAssetCombinationData(消息)AssetGroupListingGroupFilter(消息)AssetGroupSignal(消息)AssetGroupTopCombinationView(消息)AssetSet(消息)AssetSetAsset(消息)Audience(消息)BiddingStrategy(消息)Campaign(消息)Campaign.DynamicSearchAdsSetting(消息)Campaign.GeoTargetTypeSetting(消息)Campaign.NetworkSettings(消息)Campaign.OptimizationGoalSetting(消息)Campaign.SelectiveOptimization(消息)Campaign.ShoppingSetting(消息)Campaign.TrackingSetting(消息)CampaignAsset(消息)CampaignAssetSet(消息)CampaignAudienceView(消息)CampaignBudget(消息)CampaignCriterion(消息)CampaignEffectiveLabel(消息)CampaignLabel(消息)CartDataSalesView(消息)Conversion(消息)ConversionAction(消息)ConversionAction.AttributionModelSettings(消息)ConversionAction.FloodlightSettings(消息)ConversionAction.ValueSettings(消息)ConversionCustomVariable(消息)ConversionCustomVariable.FloodlightConversionCustomVariableInfo(消息)ConversionTrackingSetting(消息)CustomColumn(消息)Customer(消息)CustomerAsset(消息)CustomerAssetSet(消息)CustomerClient(消息)CustomerManagerLink(消息)DoubleClickCampaignManagerSetting(消息)DynamicSearchAdsSearchTermView(消息)GenderView(消息)GeoTargetConstant(消息)KeywordView(消息)Label(消息)LanguageConstant(消息)ListingGroupFilterDimension(消息)ListingGroupFilterDimension.ProductBiddingCategory(消息)ListingGroupFilterDimension.ProductBrand(消息)ListingGroupFilterDimension.ProductChannel(消息)ListingGroupFilterDimension.ProductCondition(消息)ListingGroupFilterDimension.ProductCustomAttribute(消息)ListingGroupFilterDimension.ProductItemId(消息)ListingGroupFilterDimension.ProductType(消息)ListingGroupFilterDimensionPath(消息)LocationView(消息)ProductBiddingCategoryConstant(消息)ProductGroupView(消息)SearchAds360Field(消息)ShoppingPerformanceView(消息)UserList(消息)UserLocationView(消息)Visit(消息)WebpageView(消息)
AccessibleBiddingStrategy
表示由客户拥有并与客户共享的出价策略的视图。
与 BiddingStrategy 不同,此资源除了包含客户拥有的策略之外,还包含客户经理拥有并与客户共享的策略。此资源不提供指标,并且仅公开一部分出价策略属性。
| 字段 | |
|---|---|
resource_name |
可访问的出价策略的资源名称。AccessibleBiddingStrategy 资源名称的格式为:
|
id |
出价策略的 ID。 |
name |
出价策略的名称。 |
type |
出价策略的类型。 |
owner_customer_id |
拥有出价策略的客户的 ID。 |
owner_descriptive_name |
拥有出价策略的客户的 descriptive_name。 |
联合字段 只能设置一个。 |
|
maximize_conversion_value |
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。 |
maximize_conversions |
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。 |
target_cpa |
一种出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。 |
target_impression_share |
一种出价策略,可自动针对所选的展示次数百分比进行优化。 |
target_roas |
这种出价策略有助于您在尽可能提高收入的同时,尽可能使平均广告支出回报率等于您设置的目标回报率。 |
target_spend |
一种出价策略,会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。 |
MaximizeConversionValue
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。
| 字段 | |
|---|---|
target_roas |
目标广告支出回报率 (ROAS) 选项。如果设置此选项,出价策略会最大限度地增加收入,同时使目标广告支出回报率达到平均值。如果目标广告支出回报率较高,则出价策略可能无法支出所有预算。如果未设置目标广告支出回报率,则出价策略的目标是尽可能为预算实现最高的广告支出回报率。 |
MaximizeConversions
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。
| 字段 | |
|---|---|
target_cpa |
目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。 |
target_cpa_micros |
目标每次转化费用 (CPA) 选项。这是您愿意为每次转化支付的平均金额。 |
TargetCpa
一种自动出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。
| 字段 | |
|---|---|
target_cpa_micros |
平均每次转化费用目标。此目标应大于或等于基于账号币种的最低计费单元。 |
TargetRoas
这是一种自动出价策略,可帮助您在尽可能提高收入的同时,尽可能使平均广告支出回报率 (ROAS) 等于您设置的目标回报率。
| 字段 | |
|---|---|
target_roas |
每单位支出所选择的收入(基于转化数据)。 |
TargetSpend
这是一种自动出价策略,使用该策略,系统会自动为您设置适当的出价,助您在不超出预算的前提下为您争取尽可能多的点击。
| 字段 | |
|---|---|
target_spend_micros |
尽可能争取更多点击次数的支出目标。TargetSpend 出价工具会尝试支出该值或自然限制支出金额中较低的金额。如果未指定,则预算会被用作支出目标。 此字段已废弃,不应再使用。如需了解详情,请访问 https://ads-developers.googleblog.com/2020/05/reminder-about-sunset-creation-of.html。 |
cpc_bid_ceiling_micros |
可通过出价策略设置的出价上限。此限制适用于该策略管理的所有关键字。 |
广告
某个广告。
| 字段 | |
|---|---|
resource_name |
广告的资源名称。广告资源名称的格式为:
|
final_urls[] |
广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
type |
广告的类型。 |
id |
广告的 ID。 |
display_url |
在某些广告格式的广告说明中显示的网址。 |
name |
广告的名称。此名称仅用于能够标识广告。该名称不必是唯一的,也不会影响投放的广告。目前只有 DisplayUploadAd、ImageAd、ShoppingComparisonListingAd 和 VideoAd 支持名称字段。 |
联合字段 ad_data。与广告类型相关的详细信息。必须设置一个值。ad_data 只能是下列其中一项: |
|
text_ad |
与文字广告相关的详细信息。 |
expanded_text_ad |
与加大型文字广告相关的详细信息。 |
responsive_search_ad |
与自适应搜索广告相关的详细信息。 |
product_ad |
与商品广告相关的详细信息。 |
expanded_dynamic_search_ad |
与加大型动态搜索广告相关的详细信息。 |
广告组
广告组。
| 字段 | |
|---|---|
resource_name |
广告组的资源名称。广告组资源名称的格式如下:
|
status |
广告组的状态。 |
type |
广告组的类型。 |
ad_rotation_mode |
广告组的广告轮播模式。 |
creation_time |
创建此 ad_group 时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
targeting_setting |
用于定位相关功能的设置。 |
labels[] |
附加到此广告组的标签的资源名称。 |
effective_labels[] |
附加到此广告组的有效标签的资源名称。有效标签是指继承或直接分配给此广告组的标签。 |
engine_id |
外部引擎账号中的广告组的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请改用“ad_group.id”。 |
start_date |
此广告组开始投放广告的日期。默认情况下,广告组会立即或在广告组的开始日期(以较早者为准)开始投放广告。如果设置了此字段,则广告组将从客户时区的指定日期开始时开始投放广告。此字段仅适用于 Microsoft Advertising 和 Facebook 网关账号。 格式:YYYY-MM-DD 示例:2019-03-14 |
end_date |
广告组停止投放广告的日期。默认情况下,广告组会在广告组的结束日期停止投放广告。如果设置了此字段,则广告组会在客户时区的指定日期结束时停止投放广告。此字段仅适用于 Microsoft Advertising 和 Facebook 网关账号。 格式:YYYY-MM-DD 示例:2019-03-14 |
language_code |
广告组中的广告和关键字的语言。此字段仅适用于 Microsoft Advertising 账号。更多详情:https://docs.microsoft.com/en-us/advertising/guides/ad-languages?view=bingads-13#adlanguage |
last_modified_time |
上次修改此广告组的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
id |
广告组的 ID。 |
name |
广告组的名称。 此字段为必填字段,在创建新广告组时不应为空。 它包含的 UTF-8 全宽字符不得超过 255 个。 并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
cpc_bid_micros |
每次点击费用 (cost-per-click) 出价上限。 |
engine_status |
广告组的引擎状态。 |
AdGroupAd
广告组广告。
| 字段 | |
|---|---|
resource_name |
广告的资源名称。广告组广告资源名称的格式如下:
|
status |
广告的状态。 |
ad |
广告。 |
creation_time |
创建此 ad_group_ad 时的时间戳。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
labels[] |
附加到此广告组广告的标签的资源名称。 |
effective_labels[] |
附加到此广告的有效标签的资源名称。有效标签是指继承或直接分配给此广告的标签。 |
engine_id |
外部引擎账号中的广告的 ID。此字段仅适用于 Search Ads 360 账号,例如 Yahoo Japan、Microsoft、百度等。对于非 Search Ads 360 实体,请改用“ad_group_ad.ad.id”。 |
engine_status |
外部引擎账号中的广告的其他状态。可能的状态(取决于外部账号的类型)包括“活跃”“有效”“待审核”等。 |
last_modified_time |
上次修改此广告组广告的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
AdGroupAdEffectiveLabel
广告组广告与有效标签之间的关系。有效标签是指继承或直接分配给此广告组广告的标签。
| 字段 | |
|---|---|
resource_name |
广告组广告有效标签的资源名称。广告组广告有效标签资源名称采用以下格式: |
ad_group_ad |
有效标签附加到的广告组广告。 |
label |
分配给广告组广告的有效标签。 |
owner_customer_id |
拥有有效标签的客户的 ID。 |
AdGroupAdLabel
广告组广告与标签之间的关系。
| 字段 | |
|---|---|
resource_name |
广告组广告标签的资源名称。广告组广告标签资源名称采用以下格式: |
ad_group_ad |
标签附加到的广告组广告。 |
label |
分配给广告组广告的标签。 |
owner_customer_id |
标签所属客户的 ID。 |
AdGroupAsset
广告组与素材资源之间的关联。
| 字段 | |
|---|---|
resource_name |
广告组素材资源的资源名称。AdGroupAsset 资源名称采用以下格式:
|
ad_group |
必需。素材资源关联到的广告组。 |
asset |
必需。与广告组关联的素材资源。 |
status |
广告组素材资源的状态。 |
AdGroupAssetSet
AdGroupAssetSet 是广告组与素材资源组之间的关联。创建 AdGroupAssetSet 会将素材资源组与广告组相关联。
| 字段 | |
|---|---|
resource_name |
广告组素材资源组的资源名称。广告组素材资源组资源名称的格式为:
|
ad_group |
此素材资源集关联到的广告组。 |
asset_set |
与广告组关联的素材资源集。 |
status |
广告组素材资源组的状态。只读。 |
AdGroupAudienceView
广告组受众群体视图。包括在受众群体一级汇总的展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据。
| 字段 | |
|---|---|
resource_name |
广告组受众群体视图的资源名称。广告组受众群体视图资源名称采用以下格式:
|
AdGroupBidModifier
表示广告组出价调节系数。
| 字段 | |
|---|---|
resource_name |
广告组出价调节系数的资源名称。广告组出价调节系数资源名称采用以下格式:
|
bid_modifier |
条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。对于 PreferredContent,该范围介于 1.0 - 6.0 之间。使用 0 可停用设备类型。 |
联合字段 从 V5 开始,在创建操作中必需提供。 |
|
device |
设备条件。 |
AdGroupCriterion
广告组条件。ad_group_criterion 报告仅会返回明确添加到广告组中的条件。
| 字段 | |
|---|---|
resource_name |
广告组条件的资源名称。广告组条件资源名称采用以下格式:
|
creation_time |
创建此广告组条件时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
status |
条件的状态。 这是广告组条件实体的状态,由客户端设置。注意:界面报告可能包含其他信息,这些信息会影响条件是否能够运行。在某些情况下,在 API 中移除的条件可能仍会在界面中显示为已启用。例如,默认情况下,广告系列会面向所有年龄段的用户展示(已被排除的除外)。该界面会将各个年龄段显示为“已启用”,因为它们有资格观看广告;但 AdGroupCriterion.status 会显示为“已移除”,因为系统未添加任何肯定条件。 |
quality_info |
有关标准质量的信息。 |
type |
条件的类型。 |
labels[] |
广告组条件所附标签的资源名称。 |
effective_labels[] |
附加到此广告组条件的有效标签的资源名称。有效标签是指继承或直接分配给此广告组条件的标签。 |
position_estimates |
针对不同位置的条件出价的估算值。 |
final_urls[] |
广告的所有跨网域重定向之后可能存在的最终到达网址列表。 |
engine_id |
外部引擎账号中的广告组条件的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请改用“ad_group_criterion.criterion_id”。 |
last_modified_time |
上次修改此广告组条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
criterion_id |
条件的 ID。 |
ad_group |
条件所属的广告组。 |
negative |
是定位 ( 该字段不可更改。 如需将条件从正切换为负,请先移除再重新添加。 |
bid_modifier |
条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。 |
cpc_bid_micros |
每次点击费用出价。 |
effective_cpc_bid_micros |
有效每次点击费用 (cost-per-click) 出价。 |
engine_status |
广告组条件的引擎状态。 |
final_url_suffix |
用于将参数附加到最终到达网址的网址模板。 |
tracking_url_template |
用于构建跟踪网址的网址模板。 |
联合字段 只能设置一个值。 |
|
keyword |
关键字。 |
listing_group |
商品信息组。 |
age_range |
年龄段。 |
gender |
性别。 |
user_list |
用户名单。 |
webpage |
网页 |
location |
位置信息。 |
PositionEstimates
针对不同位置的条件出价的估算值。
| 字段 | |
|---|---|
top_of_page_cpc_micros |
要让广告显示在搜索结果首页顶部所需的每次点击费用出价的估算值。 |
QualityInfo
用于存放广告组条件质量信息的容器。
| 字段 | |
|---|---|
quality_score |
质量得分。 如果 Google 没有足够的信息来确定值,则系统可能不会填充该字段。 |
AdGroupCriterionEffectiveLabel
广告组条件与有效标签之间的关系。有效标签是指继承或直接分配给此广告组条件的标签。
| 字段 | |
|---|---|
resource_name |
广告组条件有效标签的资源名称。广告组条件有效标签资源名称采用以下格式: |
ad_group_criterion |
有效标签附加到的广告组条件。 |
label |
分配给广告组条件的有效标签。 |
owner_customer_id |
拥有有效标签的客户的 ID。 |
AdGroupCriterionLabel
广告组条件与标签之间的关系。
| 字段 | |
|---|---|
resource_name |
广告组条件标签的资源名称。广告组条件标签资源名称采用以下格式: |
ad_group_criterion |
标签附加到的广告组条件。 |
label |
分配给广告组条件的标签。 |
owner_customer_id |
标签所属客户的 ID。 |
AdGroupEffectiveLabel
广告组与有效标签之间的关系。有效标签是指继承或直接分配给此广告组的标签。
| 字段 | |
|---|---|
resource_name |
广告组有效标签的资源名称。广告组有效标签资源名称采用以下格式: |
ad_group |
有效标签附加到的广告组。 |
label |
分配给广告组的有效标签。 |
owner_customer_id |
拥有有效标签的客户的 ID。 |
AdGroupLabel
广告组与标签之间的关系。
| 字段 | |
|---|---|
resource_name |
广告组标签的资源名称。广告组标签资源名称采用以下格式: |
ad_group |
标签附加到的广告组。 |
label |
分配给广告组的标签。 |
owner_customer_id |
标签所属客户的 ID。 |
AgeRangeView
年龄段视图。
| 字段 | |
|---|---|
resource_name |
年龄段视图的资源名称。年龄段视图资源名称采用以下格式:
|
素材资源
素材资源是广告的组成部分,可在多个广告中共享。它可以是图片 (ImageAsset)、视频 (YoutubeVideoAsset) 等。素材资源不可更改,也无法移除。如需停止投放某个素材资源,请从使用该素材资源的实体中移除该素材资源。
| 字段 | |
|---|---|
resource_name |
资源的资源名称。资产资源名称的格式为:
|
type |
资源的类型。 |
final_urls[] |
所有跨网域重定向之后可能存在的最终到达网址列表。 |
status |
素材资源的状态。 |
creation_time |
创建此素材资源时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
last_modified_time |
上次修改此素材资源的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
id |
资产的 ID。 |
name |
资产的名称(可选)。 |
tracking_url_template |
用于构建跟踪网址的网址模板。 |
engine_status |
素材资源的引擎状态。 |
联合字段 asset_data。资产的具体类型。asset_data 只能是下列其中一项: |
|
youtube_video_asset |
YouTube 视频素材资源。 |
image_asset |
图片素材资源。 |
text_asset |
文字素材资源。 |
callout_asset |
统一的宣传信息素材资源。 |
sitelink_asset |
统一的站内链接素材资源。 |
page_feed_asset |
统一的页面 Feed 素材资源。 |
mobile_app_asset |
移动应用素材资源。 |
call_asset |
统一的电话素材资源。 |
call_to_action_asset |
号召性用语素材资源。 |
location_asset |
统一的地址素材资源。 |
AssetGroup
素材资源组。AssetGroupAsset 用于将素材资源与素材资源组相关联。AssetGroupSignal 用于将信号与素材资源组相关联。
| 字段 | |
|---|---|
resource_name |
素材资源组的资源名称。素材资源组资源名称的格式为:
|
id |
素材资源组的 ID。 |
campaign |
此素材资源组所关联的广告系列。与素材资源组关联的素材资源。 |
name |
必需。素材资源组的名称。必需。长度不得少于 1 个字符,不得超过 128 个字符。在广告系列中,此维度必须是唯一的。 |
final_urls[] |
所有跨网域重定向之后的最终到达网址列表。在效果最大化广告系列中,除非您选择停用,否则网址默认符合扩展条件。 |
final_mobile_urls[] |
所有跨网域重定向之后的最终到达移动网址列表。在效果最大化广告系列中,除非您选择停用,否则网址默认符合扩展条件。 |
status |
素材资源组的状态。 |
path1 |
可能显示的文字的第一部分(附加到广告中展示的网址)。 |
path2 |
可能显示的文字的第二部分(附加到广告中展示的网址)。仅当设置了 path1 时才能设置此字段。 |
ad_strength |
此素材资源组的整体广告效力。 |
AssetGroupAsset
AssetGroupAsset 是将素材资源与素材资源组相关联的纽带。添加 AssetGroupAsset 可将素材资源与素材资源组相关联。
| 字段 | |
|---|---|
resource_name |
素材资源组素材资源的资源名称。素材资源组资产资源名称采用以下格式:
|
asset_group |
此素材资源组素材资源所关联的素材资源组。 |
asset |
此素材资源组素材资源所关联的素材资源。 |
field_type |
素材资源在素材资源组中的展示位置说明。例如:HEADLINE、YOUTUBE_VIDEO 等 |
status |
资产与素材资源组之间的关联状态。 |
AssetGroupAssetCombinationData
素材资源组素材资源组合数据
| 字段 | |
|---|---|
asset_combination_served_assets[] |
投放的素材资源。 |
AssetGroupListingGroupFilter
AssetGroupListingGroupFilter 表示素材资源组中的产品信息组过滤条件树节点。
| 字段 | |
|---|---|
resource_name |
素材资源组产品信息组过滤条件的资源名称。素材资源组产品信息组过滤条件资源名称采用以下形式:
|
asset_group |
此素材资源组产品信息组过滤条件所属的素材资源组。 |
id |
ListingGroupFilter 的 ID。 |
type |
产品信息组过滤条件节点的类型。 |
vertical |
当前节点树所代表的行业。同一树中的所有节点都必须属于同一行业。 |
case_value |
用于对其父级进行细分的维度值。根组为未定义。 |
parent_listing_group_filter |
父级商家信息群组细分的资源名称。根产品信息组过滤条件节点为 null。 |
path |
用于定义此商品详情组过滤条件的维度的路径。 |
AssetGroupSignal
AssetGroupSignal 表示素材资源组中的信号。信号的存在可告知效果最大化广告系列哪些用户最有可能完成转化。效果最大化广告系列会参考您的信号,寻找意向相似或更强烈的新用户,以在搜索网络、展示广告网络、视频平台等位置促成转化。
| 字段 | |
|---|---|
resource_name |
素材资源组信号的资源名称。素材资源组信号资源名称的格式为:
|
asset_group |
此素材资源组信号所属的素材资源组。 |
联合字段 signal。素材资源组的信号。signal 只能是下列其中一项: |
|
audience |
效果最大化广告系列要使用的受众群体信号。 |
AssetGroupTopCombinationView
显示素材资源组素材资源最佳组合使用情况的视图。
| 字段 | |
|---|---|
resource_name |
素材资源组“效果最佳的组合”视图的资源名称。素材资源组热门组合视图资源名称采用以下格式:“customers/{customer_id}/assetGroupTopCombinationViews/{asset_group_id}~{asset_combination_category}” |
asset_group_top_combinations[] |
一起投放的效果最佳的素材资源组合。 |
AssetSet
素材资源组,表示一组素材资源。使用 AssetSetAsset 将素材资源与素材资源集相关联。
| 字段 | |
|---|---|
id |
素材资源组的 ID。 |
resource_name |
素材资源集的资源名称。资产集资源名称的格式为:
|
AssetSetAsset
AssetSetAsset 是将资产与素材资源集相关联的纽带。添加 AssetSetAsset 可将资产与素材资源集相关联。
| 字段 | |
|---|---|
resource_name |
资产集资产的资源名称。资产集资产资源名称的格式为:
|
asset_set |
此素材资源集中的素材资源所关联的素材资源集。 |
asset |
此素材资源集中的素材资源所关联的素材资源。 |
status |
素材资源组素材资源的状态。只读。 |
受众群体
受众群体是一个非常实用的定位选项,可让您组合各种细分受众群属性(例如详细受众特征和兴趣相似的受众群体)来创建代表目标细分受众群某一部分的受众群体。
| 字段 | |
|---|---|
resource_name |
受众群体的资源名称。受众群体名称的格式为:
|
id |
受众群体的 ID。 |
name |
必需。受众群体的名称。它在所有受众群体中都应是唯一的。长度不得少于 1 个字符,不得超过 255 个字符。 |
description |
此受众群体的说明。 |
BiddingStrategy
出价策略。
| 字段 | |
|---|---|
resource_name |
出价策略的资源名称。出价策略资源名称的格式为:
|
status |
出价策略的状态。 此字段为只读字段。 |
type |
出价策略的类型。通过设置出价方案创建出价策略。 此字段为只读字段。 |
currency_code |
出价策略使用的币种(ISO 4217 三字母代码)。 对于经理客户中的出价策略,您可以在创建时设置此币种,默认值为经理客户的币种。对于投放广告的客户,此字段无法设置;投放广告的客户中的所有策略都会隐式使用投放广告的客户的币种。在所有情况下,effective_currency_code 字段都会返回策略使用的币种。 |
id |
出价策略的 ID。 |
name |
出价策略的名称。账号中的所有出价策略必须区分命名。 此字符串的长度应介于 1 到 255 之间(包括 1 和 255),以 UTF-8 字节为单位(经过修剪)。 |
effective_currency_code |
出价策略使用的币种(ISO 4217 三字母代码)。 对于经理客户中的出价策略,此字段是广告客户在创建策略时设置的货币。对于为客户提供服务,这是客户的 currency_code。 出价策略指标以此币种报告。 此字段为只读字段。 |
campaign_count |
附加到出价策略的广告系列的数量。 此字段为只读字段。 |
non_removed_campaign_count |
附加到出价策略的未移除广告系列的数量。 此字段为只读字段。 |
联合字段 只能设置一个。 |
|
enhanced_cpc |
此出价策略会针对更有可能带来转化的点击提高出价,并针对不太可能带来转化的点击降低出价。 |
maximize_conversion_value |
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能高的转化价值。 |
maximize_conversions |
这是一种自动出价策略,可帮助您在不超出预算的前提下,为广告系列争取尽可能多的转化。 |
target_cpa |
一种出价策略,可为您设置合适的出价,在不超出您设置的目标每次转化费用 (CPA) 的前提下,帮您获得尽可能多的转化。 |
target_impression_share |
一种出价策略,可自动针对所选的展示次数百分比进行优化。 |
target_outrank_share |
这种出价策略会根据广告客户应在竞价中胜过特定竞争对手的目标百分比来设置出价。该字段已弃用。使用此字段创建新的出价策略或将包含此字段的出价策略附加到广告系列将会失败。允许对已填充此架构的策略进行突变。 |
target_roas |
这种出价策略有助于您在尽可能提高收入的同时,尽可能使平均广告支出回报率等于您设置的目标回报率。 |
target_spend |
一种出价策略,会设置您的出价来帮助您在不超出预算的前提下争取尽可能多的点击。 |
广告系列
广告系列。
| 字段 | |
|---|---|
resource_name |
广告系列的资源名称。广告系列资源名称的格式如下:
|
status |
广告系列的状态。 添加新的广告系列时,状态默认为 ENABLED。 |
serving_status |
广告系列的广告投放状态。 |
bidding_strategy_system_status |
广告系列出价策略的系统状态。 |
ad_serving_optimization_status |
广告系列的广告投放优化状态。 |
advertising_channel_type |
广告系列中的广告的主要投放目标。您可以在 此字段为必填字段,在创建新广告系列时不应为空。 只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
advertising_channel_sub_type |
(可选)对 只能在创建广告系列时设置。创建广告系列后,此字段便无法更改。 |
url_custom_parameters[] |
用于替换 |
real_time_bidding_setting |
实时出价设置,此功能仅适用于定位到 Ad Exchange 广告网络的广告系列。 |
network_settings |
广告系列的投放网络设置。 |
dynamic_search_ads_setting |
用于控制动态搜索广告 (DSA) 的设置。 |
shopping_setting |
用于控制购物广告系列的设置。 |
geo_target_type_setting |
广告地理位置定位的设置。 |
effective_labels[] |
此广告系列所附有效标签的资源名称。有效标签是指继承或直接分配给此广告系列的标签。 |
labels[] |
此广告系列所附标签的资源名称。 |
bidding_strategy_type |
出价策略的类型。 您可以通过以下方式创建出价策略:设置出价方案来创建标准出价策略,或设置 此字段为只读字段。 |
accessible_bidding_strategy |
AccessibleBiddingStrategy 的资源名称,是附加的组合出价策略(通过“bidding_strategy”标识)的无限制属性的只读视图。如果广告系列未使用组合策略,则为空。不受限制的策略属性可供与该策略共享的所有客户使用,并从 AccessibleBiddingStrategy 资源读取。与之相反,受限属性仅供策略的客户所有者及其经理使用。受限属性只能从 BiddingStrategy 资源读取。 |
frequency_caps[] |
用于限制每位用户看到此广告系列的广告的频率的列表。 |
selective_optimization |
此广告系列的选择性优化设置,其中包含一组要针对此广告系列进行优化的转化操作。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType,并将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。 |
optimization_goal_setting |
此广告系列的优化目标设置,其中包含一组优化目标类型。 |
tracking_setting |
跟踪信息的广告系列级设置。 |
engine_id |
外部引擎账号中的广告系列的 ID。此字段仅适用于非 Google Ads 账号,例如 Yahoo Japan、Microsoft、百度等。对于 Google Ads 实体,请改用“campaign.id”。 |
excluded_parent_asset_field_types[] |
应从此广告系列中排除的素材资源字段类型。此广告系列不会从上级继承使用这些字段类型的素材资源关联。 |
create_time |
创建广告系列时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。create_time 将在 v1 中废弃。请改用 creation_time。 |
creation_time |
创建广告系列时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
last_modified_time |
上次修改此广告系列的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
id |
广告系列的 ID。 |
name |
广告系列的名称。 此字段为必填字段,在创建新广告系列时不应为空。 并且不得包含任何 null(码位 0x0)、NL 换行符(码位 0xA)或回车符(码位 0xD)。 |
tracking_url_template |
用于构建跟踪网址的网址模板。 |
campaign_budget |
广告系列的广告系列预算资源名称。 |
start_date |
广告系列在提供服务的客户所在时区开始运行的日期(采用 YYYY-MM-DD 格式)。 |
end_date |
广告系列在提供服务的客户所在时区运行的最后一天(采用 YYYY-MM-DD 格式)。创建时,默认为 2037-12-30,这表示广告系列将无限期投放。要将现有的广告系列设置为无限期投放,请将此字段设置为 2037-12-30。 |
final_url_suffix |
用于将查询参数附加到通过并行跟踪投放的着陆页的后缀。 |
url_expansion_opt_out |
表示选择不将网址扩展到更多定位网址。如果选择不扩展(true),则仅定位到素材资源组中的最终到达网址,或广告客户的 Google Merchant Center Feed 或商家数据 Feed 中指定的网址。如果选择启用(false),则会定位到整个网域。此字段只能为效果最大化广告系列设置,默认值为 false。 |
联合字段 必须是组合出价策略(通过 BiddingStrategy 服务创建)或嵌入到广告系列中的标准出价策略。 |
|
bidding_strategy |
广告系列使用的组合出价策略的资源名称。 |
manual_cpa |
标准的“每次转化费用人工出价”策略。人工出价策略,可让广告客户根据广告客户指定的操作设置出价。仅适用于本地生活服务广告系列。 |
manual_cpc |
标准的每次点击费用人工出价策略。按点击次数手动出价,用户按点击次数付费。 |
manual_cpm |
标准的“每千次展示费用人工出价”策略。按展示次数进行人工出价,用户按每千次展示付费。 |
maximize_conversions |
标准的“尽可能提高转化次数”出价策略,可在不超出预算的前提下自动尽可能提高转化次数。 |
maximize_conversion_value |
标准的“尽可能提高转化价值”出价策略,可自动设置出价,以便在您的预算范围内,最大限度提高收入。 |
target_cpa |
标准的“目标每次转化费用”出价策略,可自动设置适当的出价,帮助您以自己设定的目标每次转化费用 (CPA) 争取到尽可能多的转化。 |
target_impression_share |
“目标展示次数份额”出价策略。这是一种自动出价策略,系统会根据所选的展示次数百分比设置出价。 |
target_roas |
标准的“目标广告支出回报率”出价策略,可自动最大限度地提高收入,同时努力达到特定的平均目标广告支出回报率 (ROAS)。 |
target_spend |
标准的“目标支出”出价策略,会自动设置适当的出价,帮助您在不超出预算的前提下争取尽可能多的点击。 |
percent_cpc |
标准的“百分比形式的每次点击费用”出价策略,其中出价是某件商品或服务的广告价格的一小部分。 |
target_cpm |
一种自动优化每千次展示费用的出价策略。 |
DynamicSearchAdsSetting
用于控制动态搜索广告 (DSA) 的设置。
| 字段 | |
|---|---|
domain_name |
必需。此设置所代表的互联网域名,例如“google.com”或“www.google.com”。 |
language_code |
必需。用于指定网域语言的语言代码,例如“en”。 |
use_supplied_urls_only |
广告系列是否仅使用广告客户提供的网址。 |
GeoTargetTypeSetting
表示与广告地理位置定位相关的一组设置。
| 字段 | |
|---|---|
positive_geo_target_type |
此特定广告系列中用于正向地理位置定位的设置。 |
negative_geo_target_type |
此特定广告系列中用于否定地理位置定位的设置。 |
NetworkSettings
广告系列的投放网络设置。
| 字段 | |
|---|---|
target_google_search |
广告是否将随 Google.com 搜索结果一起投放。 |
target_search_network |
广告是否将在 Google 搜索网络中的合作伙伴网站上投放(要求 |
target_content_network |
广告是否将在 Google 展示广告网络中的指定展示位置上投放。您可以使用展示位置条件指定展示位置。 |
target_partner_search_network |
广告是否将在 Google 合作伙伴网络中投放。这仅可用于部分 Google 合作伙伴账号。 |
OptimizationGoalSetting
此广告系列的优化目标设置,其中包含一组优化目标类型。
| 字段 | |
|---|---|
optimization_goal_types[] |
优化目标类型列表。 |
SelectiveOptimization
此广告系列的选择性优化设置,其中包含一组要针对此广告系列进行优化的转化操作。此功能仅适用于将 MULTI_CHANNEL 用作 AdvertisingChannelType,并将 APP_CAMPAIGN 或 APP_CAMPAIGN_FOR_ENGAGEMENT 用作 AdvertisingChannelSubType 的应用广告系列。
| 字段 | |
|---|---|
conversion_actions[] |
为优化此广告系列而选择的一组转化操作资源名称。 |
ShoppingSetting
购物广告系列的设置。定义广告系列可以宣传的商品集合,以及此广告系列与其他购物广告系列的互动方式。
| 字段 | |
|---|---|
feed_label |
要纳入广告系列中的商品的 Feed 标签。只能设置 feed_label 或 sales_country 之一。如果将 feed_label 字段用作 sales_country 字段的替代项,则该字段接受采用相同格式的国家/地区代码,例如“XX”。否则,可以是 Google Merchant Center 中用于 Feed 标签的任何字符串。 |
use_vehicle_inventory |
是否定位到车辆商品目录广告资源。 |
merchant_id |
Merchant Center 账号的 ID。此字段对于创建操作是必需的。对于购物广告系列,此字段不可更改。 |
sales_country |
要纳入广告系列的商品的销售国家/地区。 |
campaign_priority |
广告系列的优先级。数值越高,相应广告系列的优先级就越高,反之越低。对于购物广告系列,此字段为必填字段,值介于 0 到 2 之间(包括这两个数值)。对于智能购物广告系列而言,此字段是选填项,如进行设置则须等于 3。 |
enable_local |
是否要添加本地商品。 |
TrackingSetting
跟踪信息的广告系列级设置。
| 字段 | |
|---|---|
tracking_url |
用于动态跟踪的网址。 |
CampaignAsset
广告系列与素材资源之间的关联。
| 字段 | |
|---|---|
resource_name |
广告系列素材资源的资源名称。CampaignAsset 资源名称的格式如下:
|
status |
广告系列素材资源的状态。 |
campaign |
素材资源关联到的广告系列。 |
asset |
与广告系列关联的素材资源。 |
CampaignAssetSet
CampaignAssetSet 是广告系列与素材资源组之间的关联。添加 CampaignAssetSet 会将素材资源组与广告系列相关联。
| 字段 | |
|---|---|
resource_name |
广告系列素材资源组的资源名称。资产集资产资源名称的格式为:
|
campaign |
此素材资源集所关联的广告系列。 |
asset_set |
与广告系列关联的素材资源集。 |
status |
广告系列素材资源组素材资源的状态。只读。 |
CampaignAudienceView
广告系列受众群体视图。包括展示广告网络和 YouTube 广告网络广告的兴趣和再营销名单以及搜索广告再营销名单 (RLSA) 的效果数据,按广告系列和受众群体条件汇总。此视图仅包含在广告系列一级附加的受众群体。
| 字段 | |
|---|---|
resource_name |
广告系列受众群体视图的资源名称。广告系列受众群体视图资源名称采用以下格式:
|
CampaignBudget
广告系列预算。
| 字段 | |
|---|---|
resource_name |
广告系列预算的资源名称。广告系列预算资源名称的格式为:
|
delivery_method |
确定广告系列预算的支出速率的投放方式。 如果在创建操作中未指定,则默认为 STANDARD。 |
period |
支出预算的时间段。如果未指定,则默认为“DAILY”。 |
amount_micros |
预算的金额,以账号的本地货币为单位。金额以微单位指定,即一百万等同于一个货币单位。每月支出上限为此金额的 30.4 倍。 |
CampaignCriterion
广告系列定位条件。
| 字段 | |
|---|---|
resource_name |
广告系列条件的资源名称。广告系列条件资源名称的格式如下:
|
display_name |
条件的显示名称。 对于变更,此字段会被忽略。 |
type |
条件的类型。 |
status |
条件的状态。 |
last_modified_time |
上次修改此广告系列条件的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
criterion_id |
条件的 ID。 在变更期间,此字段会被忽略。 |
bid_modifier |
条件匹配时出价的调节系数。调节系数的范围必须介于 0.1 - 10.0 之间。大多数可定位的条件类型都支持调节系数。使用 0 可停用设备类型。 |
negative |
是定位 ( |
联合字段 只能设置一个值。 |
|
keyword |
关键字。 |
location |
位置信息。 |
device |
设备。 |
age_range |
年龄段。 |
gender |
性别。 |
user_list |
用户名单。 |
language |
语言。 |
webpage |
网页。 |
location_group |
营业地点组 |
CampaignEffectiveLabel
表示广告系列与有效标签之间的关系。有效标签是指继承或直接分配给此广告系列的标签。
| 字段 | |
|---|---|
resource_name |
资源的名称。广告系列有效标签资源名称的格式为: |
campaign |
有效标签附加到的广告系列。 |
label |
分配给广告系列的有效标签。 |
owner_customer_id |
拥有有效标签的客户的 ID。 |
CampaignLabel
表示广告系列与标签之间的关系。
| 字段 | |
|---|---|
resource_name |
资源的名称。广告系列标签资源名称采用以下格式: |
campaign |
标签附加到的广告系列。 |
label |
分配给广告系列的标签。 |
owner_customer_id |
标签所属客户的 ID。 |
CartDataSalesView
购物车数据销售视图。
| 字段 | |
|---|---|
resource_name |
购物车数据销售视图的资源名称。购物车数据销售视图资源名称采用以下格式: |
转化
转化。
| 字段 | |
|---|---|
resource_name |
转化的资源名称。转化资源名称的格式为:
|
id |
转化的 ID |
criterion_id |
Search Ads 360 条件 ID。值为 0 表示条件未归因。 |
merchant_id |
包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时,Search Ads 360 会生成此 ID。 |
ad_id |
广告 ID。值为 0 表示广告未归因。 |
click_id |
转化归因于的访问的唯一字符串,该字符串会作为点击 ID 网址参数传递到着陆页。 |
visit_id |
转化归因于的 Search Ads 360 访问 ID。 |
advertiser_conversion_id |
对于线下转化,此 ID 由广告主提供。如果广告客户未指定此类 ID,Search Ads 360 会生成一个 ID。对于线上转化,这等于 ID 列或 floodlight_order_id 列,具体取决于广告客户的 Floodlight 指令。 |
product_id |
点击的商品的 ID。 |
product_channel |
获得点击的商品的销售渠道:线上或本地。 |
product_language_code |
为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。 |
product_store_id |
获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。 |
product_country_code |
为包含获得点击的商品的商品目录 Feed 注册的国家/地区(ISO-3166 格式)。 |
attribution_type |
转化归因于的原因:访问或关键字+广告。 |
conversion_date_time |
转化事件的时间戳。 |
conversion_last_modified_date_time |
转化上次修改的时间戳。 |
conversion_visit_date_time |
转化归因于的访问的时间戳。 |
conversion_quantity |
转化记录的商品数量,由 qty 网址参数确定。广告主负责动态填充该参数(如转化中售出的商品数量),否则默认为 1。 |
conversion_revenue_micros |
转化事件的调整后收入(以微为单位)。此字段始终采用广告投放账号所用的币种。 |
floodlight_original_revenue |
在修改 Floodlight 货币指令之前,与 Floodlight 事件关联的未更改的原始收入(采用当前报告所用的币种)。 |
floodlight_order_id |
广告主为转化提供的 Floodlight 订单 ID。 |
status |
转化的状态,可以是 ENABLED 或 REMOVED。 |
asset_id |
在转化事件期间互动过的素材资源的 ID。 |
asset_field_type |
转化事件的素材资源字段类型。 |
ConversionAction
转化操作。
| 字段 | |
|---|---|
resource_name |
转化操作的资源名称。转化操作资源名称的格式如下:
|
creation_time |
Floodlight 活动创建的时间戳,采用 ISO 8601 格式。 |
status |
针对转化事件累计的此转化操作的状态。 |
type |
此转化操作的类型。 |
category |
为此转化操作报告的转化类别。 |
value_settings |
与与此转化操作关联的转化事件的价值相关的设置。 |
attribution_model_settings |
与此转化操作的归因模型相关的设置。 |
floodlight_settings |
Floodlight 转化类型的 Floodlight 设置。 |
id |
转化操作的 ID。 |
name |
转化操作的名称。 此字段为必填字段,在创建新的转化操作时不应为空。 |
primary_for_goal |
如果转化操作的 primary_for_goal 位为 false,则无论客户转化目标或广告系列转化目标如何,所有广告系列都无法针对该转化操作出价。不过,自定义转化目标不遵循 primary_for_goal,因此,如果广告系列的自定义转化目标配置了 primary_for_goal = false 转化操作,则该转化操作仍可出价。默认情况下,如果未设置 primary_for_goal,则其值为 true。在 V9 中,primary_for_goal 只能在创建后通过“更新”操作设置为 false,因为它未声明为可选。 |
owner_customer |
转化操作所有者客户的资源名称;如果这是系统定义的转化操作,则为 null。 |
include_in_client_account_conversions_metric |
此转化操作是否应纳入“client_account_conversions”指标。 |
include_in_conversions_metric |
此转化操作是否应纳入“转化次数”指标。 |
click_through_lookback_window_days |
互动(例如点击)和转化事件之间可能相隔的天数上限。 |
app_id |
应用转化操作的应用 ID。 |
AttributionModelSettings
与此转化操作的归因模型相关的设置。
| 字段 | |
|---|---|
attribution_model |
此转化操作的归因模型类型。 |
data_driven_model_status |
转化操作采用以数据为依据的归因模型的状态。 |
FloodlightSettings
与 Floodlight 转化操作相关的设置。
| 字段 | |
|---|---|
activity_group_tag |
报告转化次数时用于标识 Floodlight 活动组的字符串。 |
activity_tag |
报告转化次数时用于标识 Floodlight 活动的字符串。 |
activity_id |
DoubleClick Campaign Manager (DCM) 中的 Floodlight 活动的 ID。 |
ValueSettings
与与此转化操作关联的转化事件的价值相关的设置。
| 字段 | |
|---|---|
default_value |
当为此转化操作发送的转化事件包含无效、被禁止或缺失的价值,或者此转化操作配置为始终使用默认价值时,要使用的值。 |
default_currency_code |
当为此转化操作发送的转化事件的币种代码无效或缺失,或者此转化操作配置为始终使用默认值时,要使用的币种代码。 |
always_use_default_value |
用于控制是否使用默认价值和默认货币代码来替代此转化操作的转化事件中指定的价值和货币代码。 |
ConversionCustomVariable
转化自定义变量。如需了解“新版 Search Ads 360 中的自定义 Floodlight 指标和维度简介”,请访问 https://support.google.com/sa360/answer/13567857
| 字段 | |
|---|---|
resource_name |
转化自定义变量的资源名称。转化自定义变量资源名称采用以下格式:
|
id |
转化自定义变量的 ID。 |
name |
必需。转化自定义变量的名称。名称应不重复。名称的最大长度为 100 个字符。姓氏前后不应有任何多余空格。 |
tag |
必需。转化自定义变量的代码。代码应是唯一的,由字符“u”和一个小于或等于 100 的数字组成。例如:“u4”。 |
status |
用于转化事件累计的转化自定义变量的状态。 |
owner_customer |
拥有转化自定义变量的客户的资源名称。 |
family |
转化自定义变量的系列。 |
cardinality |
转化自定义变量的基数。 |
floodlight_conversion_custom_variable_info |
Search Ads 360 Floodlight 转化自定义变量的字段。 |
custom_column_ids[] |
使用此转化自定义变量的自定义列的 ID。 |
FloodlightConversionCustomVariableInfo
Search Ads 360 Floodlight 转化自定义变量相关信息。
| 字段 | |
|---|---|
floodlight_variable_type |
Search Ads 360 中定义的 Floodlight 变量类型。 |
floodlight_variable_data_type |
Search Ads 360 中定义的 Floodlight 变量数据类型。 |
ConversionTrackingSetting
与 Search Ads 360 转化跟踪相关的一系列客户级设置。
| 字段 | |
|---|---|
accepted_customer_data_terms |
客户是否已接受客户数据条款。如果使用跨账号转化跟踪,此值会从经理账号继承。此字段为只读字段。如需了解详情,请参阅 https://support.google.com/adspolicy/answer/7475709。 |
conversion_tracking_status |
转化跟踪状态。该字段用于指明客户是否在使用转化跟踪,以及此客户的转化跟踪所有者是谁。如果此客户使用的是跨账号转化跟踪,则返回的值将因请求的 |
enhanced_conversions_for_leads_enabled |
客户是否已选择启用增强型潜在客户转化。如果使用跨账号转化跟踪,此值会从经理账号继承。此字段为只读字段。 |
google_ads_conversion_customer |
创建和管理转化的客户的资源名称。此字段为只读字段。 |
conversion_tracking_id |
此账号使用的转化跟踪 ID。此 ID 不会指明客户是否使用转化跟踪(conversion_tracking_status 会指明)。此字段为只读字段。 |
google_ads_cross_account_conversion_tracking_id |
客户经理的转化跟踪 ID。客户选择启用转化跟踪时会设置此 ID,它会替换 conversion_tracking_id。此字段只能通过 Google Ads 界面进行管理。此字段为只读字段。 |
cross_account_conversion_tracking_id |
客户经理的转化跟踪 ID。客户选择启用跨账号转化跟踪后,系统会设置此 ID,并将其替换为 conversion_tracking_id。 |
CustomColumn
自定义列。如需了解 Search Ads 360 自定义列,请访问 https://support.google.com/sa360/answer/9633916
| 字段 | |
|---|---|
resource_name |
自定义列的资源名称。自定义列资源名称的格式为:
|
id |
自定义列的 ID。 |
name |
自定义列的用户定义名称。 |
description |
自定义列的用户定义说明。 |
value_type |
自定义列的结果值的类型。 |
references_attributes |
如果自定义列引用一个或多个属性,则为 true。 |
references_metrics |
如果自定义列引用一个或多个指标,则为 true。 |
queryable |
如果自定义列可用于 SearchAds360Service.Search 和 SearchAds360Service.SearchStream 的查询,则为 true。 |
referenced_system_columns[] |
此自定义列引用的系统列的列表。例如,自定义列“展示次数和点击次数总和”引用了系统列 {"metrics.clicks", "metrics.impressions"}。 |
render_type |
如何解读自定义列的结果值。 |
客户
客户。
| 字段 | |
|---|---|
resource_name |
客户的资源名称。客户资源名称采用以下格式:
|
conversion_tracking_setting |
客户的转化跟踪设置。 |
account_type |
Engine 账号类型,例如 Google Ads、Microsoft Advertising、Yahoo Japan、百度、Facebook、Engine Track 等。 |
double_click_campaign_manager_setting |
经理客户的 DoubleClick Campaign Manager (DCM) 设置。 |
account_status |
账号状态,例如“已启用”“已暂停”“已移除”等 |
last_modified_time |
上次修改此客户的日期时间。日期时间采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss.ssssss”格式。 |
engine_id |
外部引擎账号中的账号的 ID。 |
status |
客户的状态。 |
creation_time |
创建此客户时的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
manager_id |
经理账号的客户 ID。值为 0 表示客户没有 SA360 经理。 |
manager_descriptive_name |
经理的描述性名称。 |
sub_manager_id |
子级经理的客户 ID。值为 0 表示客户没有子 SA360 经理账号。 |
sub_manager_descriptive_name |
子级经理的描述性名称。 |
associate_manager_id |
副经理的客户 ID。值为 0 表示客户没有 SA360 联络经理。 |
associate_manager_descriptive_name |
副经理的描述性名称。 |
account_level |
客户的账号级别:经理账号、子级经理账号、副经理账号、服务账号。 |
id |
客户的 ID。 |
descriptive_name |
(可选)客户的非唯一描述性名称。 |
currency_code |
账号采用的币种。支持 ISO 4217 标准中的一部分货币代码。 |
time_zone |
客户的当地时区 ID。 |
tracking_url_template |
用于根据参数构建跟踪网址的网址模板。 |
final_url_suffix |
用于将参数附加到最终到达网址的网址模板。 |
auto_tagging_enabled |
是否为客户启用了自动标记功能。 |
manager |
客户是否为经理。 |
CustomerAsset
客户与资产之间的关联。
| 字段 | |
|---|---|
resource_name |
客户素材资源的资源名称。CustomerAsset 资源名称采用以下格式:
|
asset |
必需。与客户关联的素材资源。 |
status |
客户素材资源的状态。 |
CustomerAssetSet
CustomerAssetSet 是客户与资产集之间的关联。添加 CustomerAssetSet 可将素材资源集与客户相关联。
| 字段 | |
|---|---|
resource_name |
客户素材资源集的资源名称。资产集资产资源名称的格式为:
|
asset_set |
与客户关联的素材资源集。 |
customer |
此素材资源集所关联的客户。 |
status |
客户素材资源组素材资源的状态。只读。 |
CustomerClient
给定客户与客户客户之间的关联。CustomerClient 仅适用于经理客户。包括所有直接客户和间接客户,以及经理本人。
| 字段 | |
|---|---|
resource_name |
客户客户端的资源名称。CustomerClient 资源名称采用以下格式: |
applied_labels[] |
请求方客户拥有的标签的资源名称,这些标签应用于客户客户。标签资源名称采用以下格式:
|
status |
客户客户的状态。只读。 |
client_customer |
与指定客户关联的客户-客户资源的名称。只读。 |
level |
给定客户与客户之间的距离。对于自链接,级别值为 0。只读。 |
time_zone |
客户端时区的通用区域设置数据资源库 (CLDR) 字符串表示法,例如 America/Los_Angeles。只读。 |
test_account |
用于确定客户账号是否为测试账号。只读。 |
manager |
用于标识客户端是否为经理。只读。 |
descriptive_name |
客户端的描述性名称。只读。 |
currency_code |
客户的货币代码(例如“USD”“EUR”)。只读。 |
id |
客户客户的 ID。只读。 |
CustomerManagerLink
表示客户-经理关联关系。
| 字段 | |
|---|---|
resource_name |
资源的名称。CustomerManagerLink 资源名称的格式为: |
status |
客户与经理之间的关联状态。 |
manager_customer |
与客户关联的经理客户。 |
manager_link_id |
客户-经理关联的 ID。此字段为只读字段。 |
start_time |
CustomerManagerLink 的创建时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
DoubleClickCampaignManagerSetting
经理客户的 DoubleClick Campaign Manager (DCM) 设置。
| 字段 | |
|---|---|
advertiser_id |
与此客户关联的 Campaign Manager 广告客户的 ID。 |
network_id |
与此客户相关联的 Campaign Manager 广告联盟的 ID。 |
time_zone |
与此客户关联的 Campaign Manager 广告网络的时区(采用 IANA 时区数据库格式),例如 America/New_York。 |
DynamicSearchAdsSearchTermView
动态搜索广告搜索字词视图。
| 字段 | |
|---|---|
resource_name |
动态搜索广告搜索字词视图的资源名称。动态搜索广告搜索字词视图资源名称的格式为:
|
landing_page |
展示的动态选择的着陆页网址。 此字段为只读字段。 |
GenderView
性别视图。gender_view 资源反映的是有效的投放状态,而不是添加了哪些条件。默认情况下,不指定性别条件的广告组会向所有性别的用户展示,因此所有性别都会显示在 gender_view 中并带有统计信息。
| 字段 | |
|---|---|
resource_name |
性别视图的资源名称。性别视图资源名称采用以下格式:
|
GeoTargetConstant
地理位置定位目标常量。
| 字段 | |
|---|---|
resource_name |
地理位置定位目标常量的资源名称。目标地理位置常量资源名称采用以下格式:
|
status |
地理位置定位条件常量状态。 |
id |
地理位置定位目标常量的 ID。 |
name |
地理位置定位目标常量的英语名称。 |
country_code |
与目标关联的 ISO 3166-1 alpha-2 国家/地区代码。 |
target_type |
地理位置定位目标常量目标类型。 |
canonical_name |
完整的英语名称,包括目标的名称及其父级和国家/地区的名称。 |
parent_geo_target |
父级地理位置定位目标常量的资源名称。目标地理位置常量资源名称采用以下格式:
|
KeywordView
关键字视图。
| 字段 | |
|---|---|
resource_name |
关键字视图的资源名称。关键字视图资源名称采用以下格式:
|
标签
标签。
| 字段 | |
|---|---|
resource_name |
资源的名称。标签资源名称采用以下格式: |
status |
标签的状态。只读。 |
text_label |
一种在彩色背景上显示文本的标签。 |
id |
标签的 ID。只读。 |
name |
标签的名称。 此字段为必填字段,在创建新标签时不应为空。 此字符串的长度应介于 1 到 80 之间(包括 1 和 80)。 |
LanguageConstant
语言。
| 字段 | |
|---|---|
resource_name |
语言常量的资源名称。语言常量资源名称的格式为:
|
id |
语言常量的 ID。 |
code |
语言代码,例如“en_US”“en_AU”“es”“fr”等。 |
name |
语言的全称(英语),例如“英语(美国)”“西班牙语”等。 |
targetable |
相应语言是否可定位。 |
ListingGroupFilterDimension
素材资源组产品信息组过滤条件的商品详情维度。
| 字段 | |
|---|---|
联合字段 dimension。维度始终属于以下某种类型。dimension 只能是下列其中一项: |
|
product_bidding_category |
商品的出价类别。 |
product_brand |
商品的品牌。 |
product_channel |
商品的本地性。 |
product_condition |
商品的使用情况。 |
product_custom_attribute |
商品的属性。 |
product_item_id |
商品优惠的商品 ID。 |
product_type |
商品优惠的类型。 |
ProductBiddingCategory
出价类别在某一级别的元素。顶级类别位于第 1 级,其子类别位于第 2 级,以此类推。我们目前最多支持 5 个级别。用户必须指定一个维度类型,用于指明类别的级别。同一细分中的所有案例都必须具有相同的维度类型(类别级别)。
| 字段 | |
|---|---|
level |
表示分类中的类别级别。 |
id |
商品出价类别的 ID。 此 ID 相当于本文中所述的 google_product_category ID:https://support.google.com/merchants/answer/6324436 |
ProductBrand
商品的品牌。
| 字段 | |
|---|---|
value |
商品品牌的字符串值。 |
ProductChannel
商品的本地性。
| 字段 | |
|---|---|
channel |
相应地区的值。 |
ProductCondition
商品的使用情况。
| 字段 | |
|---|---|
condition |
条件的值。 |
ProductCustomAttribute
商品的属性。
| 字段 | |
|---|---|
index |
表示自定义属性的索引。 |
value |
商品自定义属性的字符串值。 |
ProductItemId
商品优惠的商品 ID。
| 字段 | |
|---|---|
value |
ID 的值。 |
ProductType
商品优惠的类型。
| 字段 | |
|---|---|
level |
类型的级别。 |
value |
类型的值。 |
ListingGroupFilterDimensionPath
用于定义用于定义商家信息群组过滤条件的维度的路径。
| 字段 | |
|---|---|
dimensions[] |
维度从产品信息组过滤条件层次结构(不包括根节点)到此产品信息组过滤条件的完整路径。 |
LocationView
“地理位置”视图会按地理位置条件汇总广告系列的效果。
| 字段 | |
|---|---|
resource_name |
位置视图的资源名称。营业地点视图资源名称采用以下格式:
|
ProductBiddingCategoryConstant
产品出价类别。
| 字段 | |
|---|---|
resource_name |
商品出价类别的资源名称。商品出价类别资源名称的格式为:
|
level |
商品出价类别的级别。 |
status |
商品出价类别的状态。 |
id |
商品出价类别的 ID。 此 ID 相当于本文中所述的 google_product_category ID:https://support.google.com/merchants/answer/6324436。 |
country_code |
商品出价类别的双字母大写国家/地区代码。 |
product_bidding_category_constant_parent |
父级商品出价类别的资源名称。 |
language_code |
商品出价类别的语言代码。 |
localized_name |
商品出价类别的显示值,已根据 language_code 进行本地化。 |
ProductGroupView
产品组视图。
| 字段 | |
|---|---|
resource_name |
商品组视图的资源名称。产品组视图资源名称采用以下格式:
|
SearchAds360Field
SearchAds360Service 使用的字段或资源(工件)。
| 字段 | |
|---|---|
resource_name |
工件的资源名称。工件资源名称的格式为:
|
category |
工件所属的类别。 |
selectable_with[] |
可通过所述工件选择的所有资源、细分和指标的名称。 |
attribute_resources[] |
可通过所述工件选择的所有资源的名称。当这些资源中的字段包含在搜索查询中时,不会对指标进行细分。 此字段仅针对类别为 RESOURCE 的工件进行设置。 |
metrics[] |
此字段列出了在 FROM 子句中使用所述工件时可通过该工件选择的所有指标的名称。仅为类别为 RESOURCE 的工件设置此属性。 |
segments[] |
此字段列出了在搜索查询中包含细分指标以及在 FROM 子句中使用所述工件时,所有工件(无论是细分还是其他资源)的名称。仅为类别为 RESOURCE 的工件设置此属性。 |
enum_values[] |
如果工件是类型为 ENUM 的字段,则可以假定的工件值。 此字段仅针对类别为“SEGMENT”或“ATTRIBUTE”的工件进行设置。 |
data_type |
此字段用于确定可以在 WHERE 子句中与工件搭配使用的运算符。 |
name |
工件的名称。 |
selectable |
工件是否可以在搜索查询的 SELECT 子句中使用。 |
filterable |
工件是否可以在搜索查询的 WHERE 子句中使用。 |
sortable |
工件是否可以在搜索查询的 ORDER BY 子句中使用。 |
type_url |
描述工件数据类型的 proto 的网址。 |
is_repeated |
字段工件是否重复。 |
ShoppingPerformanceView
购物广告效果视图。提供按多个产品维度级别汇总的购物广告系列统计信息。Merchant Center 中的商品维度值(例如品牌、类别、自定义属性、商品状况和商品类型)将反映相应事件记录的日期和时间各个维度的状态。
| 字段 | |
|---|---|
resource_name |
购物广告效果视图的资源名称。购物广告效果视图资源名称采用以下格式: |
UserList
用户列表。这是客户可能定位到的用户列表。
| 字段 | |
|---|---|
resource_name |
用户列表的资源名称。用户列表资源名称采用以下格式:
|
type |
此列表的类型。 此字段为只读字段。 |
id |
用户列表的 ID。 |
name |
此用户列表的名称。用户名单名称可能不具有唯一性,具体取决于其 access_reason(例如,如果 access_reason=SHARED) |
UserLocationView
用户位置信息视图。
“用户所在位置”视图包含在国家/地区一级汇总的所有指标,每个国家/地区一行。它会按定位到或未定位到的地理位置,报告基于用户实际所在地理位置的指标。如果使用其他细分受众群字段,则每个国家/地区可能会有多个行。
| 字段 | |
|---|---|
resource_name |
用户位置信息视图的资源名称。UserLocation 视图资源名称采用以下格式:
|
country_criterion_id |
国家/地区的条件 ID。 |
targeting_location |
指明是否定位到地理位置。 |
访问
一次访问。
| 字段 | |
|---|---|
resource_name |
访问的资源名称。访问资源名称的格式为:
|
id |
访问的 ID。 |
criterion_id |
Search Ads 360 关键字 ID。值为 0 表示关键字未归因。 |
merchant_id |
包含获得点击的商品的 Search Ads 360 商品目录账号 ID。当您在 Search Ads 360 中关联商品目录账号时,Search Ads 360 会生成此 ID。 |
ad_id |
广告 ID。值为 0 表示广告未归因。 |
click_id |
作为点击 ID 网址参数传递到着陆页的每次访问的唯一字符串。 |
visit_date_time |
访问事件的时间戳。时间戳采用客户的时区,并采用“yyyy-MM-dd HH:mm:ss”格式。 |
product_id |
点击的商品的 ID。 |
product_channel |
获得点击的商品的销售渠道:线上或本地。 |
product_language_code |
为包含商品数据的 Merchant Center Feed 设置的语言 (ISO-639-1)。 |
product_store_id |
获得点击的本地商品目录广告中的商店。此 ID 应与本地商品 Feed 中使用的商店 ID 一致。 |
product_country_code |
为包含获得点击的商品的商品目录 Feed 注册的国家/地区(ISO-3166 格式)。 |
asset_id |
在访问事件期间与之互动的素材资源的 ID。 |
asset_field_type |
访问事件的素材资源字段类型。 |
WebpageView
网页视图。
| 字段 | |
|---|---|
resource_name |
网页视图的资源名称。网页视图资源名称采用以下格式:
|