v17.1.0 (2024-08-07)
v17_1 中新增了以下功能和更新。
素材资源
受众群体
UserListCustomerTypeCategory
中的新枚举值:LOYALTY_TIER_1_MEMBERS
LOYALTY_TIER_2_MEMBERS
LOYALTY_TIER_3_MEMBERS
LOYALTY_TIER_4_MEMBERS
LOYALTY_TIER_5_MEMBERS
LOYALTY_TIER_6_MEMBERS
LOYALTY_TIER_7_MEMBERS
广告系列
ShareablePreviewService.GenerateShareablePreviews()
会为已启用和已暂停的素材资源组的可共享广告预览生成网址(响应中的shareable_preview_url
)。expiration_date_time
字段用于指明响应中网址的失效日期。- 如果发生错误,该方法将返回
partial_failure_error
而不是网址。
更改历史记录
- 新的更改状态资源类型:
ASSET_GROUP
。
转化次数
- 为 SKAdNetwork 版本新建细分字段:
segments.sk_ad_network_version
offline_conversion_upload_conversion_action_summary
,显示转化操作一级的转化上传诊断信息。- 系统会将以下指标添加到线下诊断报告,以传达仍在处理的已上传转化数据的数量: <ph type="x-smartling-placeholder">
规划
AudienceInsights.GenerateAudienceOverlapInsights()
:接受输入的主要属性和一系列受众群体属性,并返回主要属性和受众群体属性之间潜在 YouTube 覆盖面的重叠情况估算值。
报告
- 支持根据
segments.date
细分per_store_view
视频
- 支持使用报告(例如
ad_group
、campaign
)为视频广告系列检索与以下标准出价策略相关的信息:Campaign.fixed_cpm
(固定 CPM)Campaign.target_cpv
(目标每次观看费用)
Campaign.video_campaign_settings
,可让您使用以下报告字段确定可在哪些广告资源上展示视频广告:segments.ad_format_type
,可让您根据视频广告格式类型细分以下报告:
v17 (2024-06-05)
v17 中新增了以下功能和变更。
Ads
- 移除了
AdService.getAd
。这会使AdService
与 Google Ads API。如需了解更多详情,请参阅检索对象 抓取广告和其他资源类型的推荐方法。 - 已针对以下产品添加更多验证:
ImageAdInfo.image_asset
- 关于 尺寸和格式。如果图片 无效: <ph type="x-smartling-placeholder">
素材资源
- 添加了新枚举:
ClickType.AD_IMAGE
- 针对效果最大化广告系列和搜索广告系列,添加了以下包含新指标的新报告: <ph type="x-smartling-placeholder">
受众群体
批量作业
- 已添加
BatchJobError.REQUEST_TOO_LARGE
, 当提交的AddBatchJobOperationsRequest
大于 10484504 字节时,将抛出该异常。 - 添加了对设置
MutateOperation.asset_group_operation
的支持 使用BatchJobService
时。这样,您就可以 使用批处理创建 管理整个效果最大化广告系列。不妨参阅我们新推出的专属指南。
广告系列
- 在所有字段、枚举和所有错误中将发现广告系列重命名为需求开发广告系列
整个 Google Ads API 中的资源,例如广告系列、广告和素材资源。对于
例如,
AdvertisingChannelType.DISCOVERY
现在是AdvertisingChannelType.DEMAND_GEN
。 - 已添加
Campaign.keyword_match_type
让您可以为广告系列中的所有关键字设置关键字匹配类型。
转化次数
- 对于 SKAdNetwork
转化次数、
<ph type="x-smartling-placeholder">
- </ph>
segments.sk_ad_network_conversion_value
已重命名为segments.sk_ad_network_fine_conversion_value
。- 添加了
segments.sk_ad_network_redistributed_fine_conversion_value
。
- 现在,即使 它们都为零。这使其与其他指标保持一致。
条件
- 已添加到
AdGroupCriterion
的以下字段 来显示广告组条件是否正在投放,或未投放的原因 提供:primary_status
primary_status_reasons
- 添加了对
metrics.search_impression_share
的支持 关于“gender_view
” - 添加了对
metrics.phone_calls
的支持 关于“keyword_view
”
本地生活服务
- 添加了
LocalServicesLeadService.AppendLeadConversation()
用于向代码附加新的LocalServicesLeadConversation
发送到LocalServicesLead
,后者会将 通过适当的渠道(如短信)向用户提供消息,具体取决于 已创建潜在客户。AppendLeadConversationRequest.conversations
的大小受限 增加到 1,000。- 只有
LocalServicesLead
lead_type
已设为LeadType.MESSAGE
可在Conversation.local_services_lead
。
- 向
ConversationType
:WHATSAPP
表示通过 WhatsApp 引入的对话。ADS_API
表示使用新的LocalServicesLeadService.AppendLeadConversation()
方法。
- 向
local_services_verification_artifact
添加了以下新字段:local_services_verification_artifact.insurance_verification_artifact.expiration_date_time
local_services_verification_artifact.license_verification_artifact.expiration_date_time
报告
- 您现在只能选择与一个 关联产品相关的字段
在查询
product_link
时使用。选择多项 多个关联产品的字段,QueryError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE
。 例如:product_link.advertising_partner.customer
和product_link.data_partner.data_partner_id
不能在同一查询中选择。 - 将
page_size
传递给GoogleAdsService.Search
会导致RequestError.PAGE_SIZE_NOT_SUPPORTED
错误。
购物
- 添加了新报告
shopping_product
, 对应于 Google Ads 界面中的商品页面。它支持返回 Google Merchant Center 中与商品的当前状态相关的数据 与 Google Ads 账号相关联的账号。- 您可以在以下位置过滤指标:
shopping_product
使用以下工具进行报告segments.date
(使用GoogleAdsService.Search
或GoogleAdsService.SearchStream
。 不允许按日期细分,如果按日期进行细分,则系统会返回ShoppingProductError.UNSUPPORTED_DATE_SEGMENTATION
错误。
- 您可以在以下位置过滤指标:
统一目标
- 添加了
UserListCustomerTypeService.MutateUserListCustomerTypes()
配置受众群体客户 类型。 - 移除了
CustomerLifecycleGoal.lifecycle_goal_customer_definition_settings
。如需配置客户生命周期目标的受众群体设置,请使用UserListCustomerTypeService.MutateUserListCustomerTypes()
。- 通过设置附加或取消附加用户列表
UserListCustomerType.customer_type_category
更改为UserListCustomerTypeCategory.PURCHASERS
以将其包含在现有客户定义中或从中排除 客户生命周期目标。请访问细分您的 受众群体 了解详情。
- 通过设置附加或取消附加用户列表
视频
- 将以下值添加到
ContentLabelType
。 您可以在客户一级排除以下ContentLabelTypes
:BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
BRAND_SUITABILITY_GAMES_FIGHTING
BRAND_SUITABILITY_GAMES_MATURE
BRAND_SUITABILITY_HEALTH_SENSITIVE
BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
BRAND_SUITABILITY_NEWS_RECENT
BRAND_SUITABILITY_NEWS_SENSITIVE
BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
BRAND_SUITABILITY_POLITICS
BRAND_SUITABILITY_RELIGION
- 添加了
AdVideoAsset.ad_video_asset_info
以便在创建视频素材资源时DemandGenVideoResponsiveAdInfo
。 - (仅限列入许可名单的账号)已发出
Campaign.video_brand_safety_suitability
可变。
v16.1.0 (2024-04-24)
v16.1 中添加了以下功能和变更。
账号管理
CustomerNegativeCriterion.ip_block
支持在客户级别将 IP 添加为排除条件。- 新的枚举值:
ProductLinkError.LINK_EXISTS
。 - 新的枚举值:
ProductLinkInvitationError.CUSTOMER_NOT_PERMITTED_TO_CREATE_INVITATION
。
素材资源
- 支持与需求开发相关的素材资源,
ad_group_ad_asset_view
和asset_field_type_view
。 - 新的枚举值:
AssetFieldType.DISCOVERY_CAROUSEL_CARD
。
受众群体
- 新的枚举值:
ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER
这会将客户可以拥有的相似用户名单的数量限制为 1,000 个。
广告系列
- 支持返回 Target
广告支出回报率广告系列出价模拟结果:
应用广告系列
campaign_simulation
报告。 - 新的枚举值:
CampaignError.DYNAMIC_TEXT_ASSET_CANNOT_OPT_OUT_WITH_FINAL_URL_EXPANSION_OPT_IN
。 - 新的枚举值:
AdGroupPrimaryStatusReason.AD_GROUP_PAUSED_DUE_TO_LOW_ACTIVITY
。 - 新的枚举值:
CampaignCriterionError.CANNOT_REMOVE_ALL_LOCATIONS_DUE_TO_TOO_MANY_COUNTRY_EXCLUSIONS
。
转化次数
SkAdNetworkConversionValueSchema.postback_mappings
它支持 SKAdNetwork 4.0 功能。- 添加了对以下项的警告的支持:
CustomerSkAdNetworkConversionValueSchemaService
为MutateCustomerSkAdNetworkConversionValueSchemaRequest.enable_warnings
。 设置为true
时,与操作失败相关的任何非阻塞错误 将作为MutateCustomerSkAdNetworkConversionValueSchemaResponse.warning
。 CustomerSkAdNetworkConversionValueSchemaError
中的新枚举值:INVALID_EVENT_COUNTER
INVALID_EVENT_NAME
条件
BrandInfo
中的新字段:display_name
primary_url
rejection_reason
status
- 新枚举:
BrandRequestRejectionReason
。 - 新的枚举值:
CriterionType.LIFE_EVENT
。
实验
本地生活服务
local_services_lead.credit_details.credit_state
和local_services_lead.credit_details.credit_state_last_update_date_time
该函数会返回信用状态以及信用状态 分别更新了local_services_lead_conversation.message_details.attachment_urls
返回的是可用于下载 附件。
视频
customer.video_brand_safety_suitability
和BrandSafetySuitability
它支持检索视频对客户品牌保障的适宜性 。- 新的枚举值:
VideoCampaignError.MUTATE_REQUIRES_RESERVATION
。
v16 (2024-02-21)
v16 中新增了以下功能和变更。
账号管理
advertising_partner
从AccountLink
更改为ProductLink
和ProductLinkInvitation
。- 已将
data_partner
和google_ads
从以下群组中移除:AccountLink
。 - 已添加
IdentityVerificationService
至 管理广告客户验证。StartIdentityVerification()
用于启动验证会话,方法为使用提供的verification_program
。 它会创建一个新的验证会话,并针对 已成功创建验证。GetIdentityVerification()
可用于检索验证信息,该信息会返回IdentityVerification
的多个对象。 每个IdentityVerification
均包含:verification_program
也就是身份验证程序类型identity_verification_requirement
其中包含与提交 广告主应完成验证verification_progress
,其中包含与验证会话相关的详细信息,包括:program_status
表示 验证会话action_url
会将客户定向到一个网址以完成 验证。invitation_link_expiration_time
表示失效日期 (针对action_url
)
- 枚举: <ph type="x-smartling-placeholder">
- 错误: <ph type="x-smartling-placeholder">
- 已添加
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
。
素材资源
- 对
asset_group
的变更:- 添加了对时间相关细分的支持,例如
segments.year
和segments.month
。 - 将
campaign
设为了归因资源,而非归因资源 对资源进行细分
- 添加了对时间相关细分的支持,例如
广告系列
- 需求开发广告系列的变更:
<ph type="x-smartling-placeholder">
- </ph>
- 添加了对设置
Campaign.shopping_setting
至 现有的需求开发广告系列 - 已添加
ShoppingSetting.disable_product_feed
以停用需求开发广告系列的可选商品 Feed。 - 添加了
Ad.demand_gen_product_ad
和相应的DemandGenProductAdInfo
,提供给 采用非 null 值的需求开发广告系列Campaign.shopping_setting
。
- 添加了对设置
- 已添加到
AdGroup
的以下字段,以显示是否 广告组正在投放或未投放的原因:primary_status
primary_status_reasons
- 已添加到
AdGroupAd
的以下字段以显示 广告组的广告是否在正常投放或未投放的原因:primary_status
primary_status_reasons
- 将以下值添加到
AdGroupError
:CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
INVALID_STATUS
实验
- 已将
Experiment.sync_enabled
添加到 指定是否应在实验中启用同步功能。使用同步 启用后,对 在实验运行期间,原始广告系列会自动 复制到实验广告系列中 - 已添加
ExperimentError.CANNOT_ENABLE_SYNC_FOR_UNSUPPORTED_EXPERIMENT_TYPE
。 - 已添加
CampaignError.CANNOT_MODIFY_TEXT_ASSET_AUTOMATION_WITH_ENABLED_TRIAL
。
酒店与旅行
- 向
ListingDimensionInfo
:推荐活动 根据商家所在地的州和城市创建产品信息组 可以提供旅行活动: - 新增了对以下细分的支持
travel_activity_performance_view
:
本地生活服务
- 已添加
LocalServicesVerificationArtifact.business_registration_check_verification_artifact
和BusinessRegistrationCheckArtifact
供广告客户监控工商登记的进展情况 验证流程。 - 添加了一项新资源
local_services_employee
即可允许 来检索他们添加的员工信息。
规划
- 已将
score
从以下位置移除:AudienceInsightsAttributeMetadata
。
建议
- 已添加
RecommendationService.GenerateRecommendations()
该函数会根据指定的设置返回推荐内容,例如 以及广告渠道类型这在很大程度上 。 - 已添加
RecommendationMetrics.conversions_value
。 - 现在,对于未设置关键字匹配类型的推荐关键字,
recommended_match_type
已设置为UNSPECIFIED
,而不是UNKNOWN
。 - 添加了以下类型的建议:
<ph type="x-smartling-placeholder">
- </ph>
MAXIMIZE_CONVERSION_VALUE_OPT_IN
建议您启用“尽可能提高转化价值”出价策略 策略IMPROVE_GOOGLE_TAG_COVERAGE
建议在更多网页上部署 Google 代码PERFORMANCE_MAX_FINAL_URL_OPT_IN
建议您为效果最大化广告系列启用“最终到达网址扩展”功能 广告系列REFRESH_CUSTOMER_MATCH_LIST
建议您更新在 过去 90 天CUSTOM_AUDIENCE_OPT_IN
建议你创建自定义受众群体LEAD_FORM_ASSET
建议为广告系列或客户添加潜在客户表单素材资源 级别IMPROVE_DEMAND_GEN_AD_STRENGTH
建议提高需求开发广告系列的广告效力
购物
- 已添加
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
和CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
以便针对关联到 购物比较服务中心 账号。 - 将以下值添加到
AssetGroupListingGroupFilterError
:DIMENSION_TYPE_NOT_ALLOWED
DUPLICATE_WEBPAGE_FILTER_UNDER_ASSET_GROUP
FILTER_EXCLUSION_NOT_ALLOWED
LISTING_SOURCE_NOT_ALLOWED
MULTIPLE_LISTING_SOURCES
MULTIPLE_WEBPAGE_CONDITION_TYPES_NOT_ALLOWED
MULTIPLE_WEBPAGE_TYPES_PER_ASSET_GROUP
PAGE_FEED_FILTER_HAS_PARENT
生命周期目标
- 已将
update
添加到CustomerLifecycleGoalOperation
和CampaignLifecycleGoalOperation
以使这些操作类型与 API 中的其他操作类型保持一致。
v15 (2023-10-18)
v15 中引入了以下新功能和更新。
账号管理
- 如果您的账号因为未经授权的账号而被暂停
活动记录,
customer.status
和customer_client.status
现在会返回为SUSPENDED
。 以前,系统会以ENABLED
。 - 现已支持添加和移除 Google Ads 账号和 Merchant Center 账号: <ph type="x-smartling-placeholder">
- 已添加
ProductLinkInvitationService
和ProductLinkInvitation
,以便支持 更新从其他产品发送的链接邀请(适用于酒店广告系列) Center 和 Merchant 中心账号。 - 移除了
MerchantCenterLinkService
。- 要将 Google Ads 账号与 Merchant Center 账号相关联,请使用
ProductLinkInvitationService
和ProductLinkService
。
- 要将 Google Ads 账号与 Merchant Center 账号相关联,请使用
- 移除了
AccountLink.hotel_center
以及对更新链接邀请的支持。 使用AccountLinkService
。- 如需更新来自 Hotel Center 账号的关联邀请,请使用
ProductLinkInvitationService
。
- 如需更新来自 Hotel Center 账号的关联邀请,请使用
素材资源
- 已将“
ImageAdInfo.media_file
”替换为ImageAdInfo.image_asset
支持 使用素材资源添加和移除图片因此,我们还移除了MediaFileService
,不再需要。 - 已添加
ListingGroupFilterDimension.webpage
支持根据自定义标签和网址创建产品信息组过滤条件 子字符串。- 也将“
AssetGroupListingGroupFilter.vertical
”替换为AssetGroupListingGroupFilter.listing_source
和ListingGroupFilterListingSource
- 也将“
- 添加了
asset_group_asset.source
以显示 素材资源组素材资源的来源。 - 已添加
ad_group_ad_asset_view.source
至 显示广告组广告素材资源的来源。
受众群体
- 对于目标客户匹配,添加了
CustomerMatchUserListMetadata.consent
以支持提供同意声明。自 2024 年 3 月 6 日起,如果 就会被判定为未征得用户同意。 未经 EEA 用户同意,我们不会处理这些用户的数据,也不会将这些数据用于广告 提供个性化体验。请查看我们的 目标客户匹配指南 了解详情。 - 对于实体店销售,已将
UserData.consent
添加到 提供意见征求方面的支持。请查看我们的 实体店销售指南(适用于 。如果您为实体店销售使用目标客户匹配,请查看 如需了解更多相关信息,请参阅常见问题解答 信息。 - 已添加
UserList.lookalike_user_list
至 支持创建相似 细分受众群,即创建的受众群体 进行选择。相似细分受众群 (在需求开发广告系列中) 。
广告系列
效果最大化广告系列的最新动态:
AssetGroupSignal
现在支持两个 可以附加到素材资源组以实现增强型定位的信号类型:AssetGroupSignal.audience
- 添加了
Audience.scope
和Audience.asset_group
即可限制 对特定素材资源组的受众群体使用情况。 必须设置Audience.asset_group
当且仅当Audience.scope
是ASSET_GROUP
。
- 添加了
AssetGroupSignal.search_theme
- 已添加
CriterionType.SEARCH_THEME
来支持这一新的条件类型这一新条件类型只能 在效果最大化广告系列中使用,以创建AssetGroupSignal
来填充AssetGroupSignal.search_theme
SearchThemeInfo
条件。
- 已添加
- 已添加
AssetGroupSignalOperation.exempt_policy_violation_keys
以支持在添加素材资源组信号时请求豁免。 - 添加了新的
asset_group_top_combination_view
在素材资源组一级报告效果最佳的素材资源。 - 现在可以使用指标字段查询
asset_group
来支持检索效果最大化广告系列的效果。 - 在
PerformanceMaxUpgradeStatus
, 已将UPGRADE_ELIGIBLE
重命名为UPGRADE_ELIGIBLE
。
对于需求开发广告系列 发现广告系列 采用“目标每次转化费用”出价策略的广告系列,广告系列一级的目标每次转化费用出价模拟 (
campaign_simulation.target_cpa_point_list.points
) 现已返回TargetCpaSimulationPoint.interactions
而非TargetCpaSimulationPoint.clicks
。添加了
BrandSuggestionService
, 根据提供的品牌前缀和排除的列表来推荐品牌, 品牌。这些品牌可用于 已添加BRAND
个条件 添加到BRANDS
共享集, 然后通过创建CampaignCriterion
, 已将brand_list
设为共享集。 可在搜索广告系列中定位广告系列条件,并在 。- 字段: <ph type="x-smartling-placeholder">
- 枚举: <ph type="x-smartling-placeholder">
已添加
Campaign.asset_automation_settings[]
以显示每种素材资源类型的自动化状态。将以下值添加到
CampaignPrimaryStatusReason
枚举:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
转化次数
- 添加了
CallConversion.consent
和ClickConversion.consent
,以便支持 提供同意声明。请查看我们的 来电转化指南 和点击转化指南 。 - 添加了以下与以下内容相关的字段:
SKAdNetwork
使用
customer
或campaign
:- 细分: <ph type="x-smartling-placeholder">
- 指标: <ph type="x-smartling-placeholder">
- 已将“
metrics.sk_ad_network_conversions
”替换为metrics.sk_ad_network_installs
。 - 添加了对诊断线下转化数据上传功能的支持
<ph type="x-smartling-placeholder">
- </ph>
- 将
offline_conversion_upload_client_summary
从customer
资源上的某个字段复制到顶级报告。使用此 报告,以获取转化数据上传状态的有用详情, 成功事件数、成功率和错误百分比。- 注意:虽然上传后发生了转化,但
ConversionUploadError.CLICK_NOT_FOUND
错误仍会计为成功,但也会被标记为OfflineConversionAlert
。
- 注意:虽然上传后发生了转化,但
- 针对以下请求类型添加了
job_id
作为可选参数, 您可以从逻辑上将多个上传请求组合成单个概念 作业: - 向以下错误添加了
INVALID_JOB_ID
: - 已将“
INVALID_CONVERSION_ACTION
”替换为“NO_CONVERSION_ACTION_FOUND
”并INVALID_CONVERSION_ACTION_TYPE
:
- 将
- 添加了三种报告,可支持 Android Privacy Sandbox 跨广告网络
归因
重定向:
<ph type="x-smartling-placeholder">
- </ph>
android_privacy_shared_key_google_campaign
,其中包含shared_campaign_key
以及有助于对密钥进行编码的一些字段。android_privacy_shared_key_google_ad_group
,其中包含shared_ad_group_key
以及有助于对密钥进行编码的一些字段。android_privacy_shared_key_google_network_type
,其中包含shared_network_type_key
以及有助于对密钥进行编码的一些字段。
- 已添加
ConversionActionError.CANNOT_SET_RULE_BASED_ATTRIBUTION_MODELS
。 一个ConversionActionOperation
, 会尝试使用已弃用的基于规则的归因之一 模型 现在会失败并显示此错误。以前,操作会失败,并显示UNKNOWN
个错误。
酒店与旅行
- 在
travel_activity_group_view
和travel_activity_performance_view
:- 细分: <ph type="x-smartling-placeholder">
- 指标:
<ph type="x-smartling-placeholder">
- </ph>
metrics.search_absolute_top_impression_share
metrics.search_budget_lost_absolute_top_impression_share
metrics.search_budget_lost_impression_share
metrics.search_budget_lost_top_impression_share
metrics.search_impression_share
metrics.search_rank_lost_absolute_top_impression_share
metrics.search_rank_lost_impression_share
metrics.search_rank_lost_top_impression_share
metrics.search_top_impression_share
本地生活服务广告
- 添加了
LocalServicesSettings
及其customer
报告中的字段,用于返回本地 服务广告客户精细的许可和保险状态。 - 针对本地广告系列新增了以下报告
服务:
<ph type="x-smartling-placeholder">
- </ph>
local_services_lead
包含 与本地生活服务有关的详细信息 Google Ads 潜在客户,如lead_charged
、lead_type
,lead_status
。- 枚举:
<ph type="x-smartling-placeholder">
- </ph>
LeadStatus
LeadType
- 枚举:
<ph type="x-smartling-placeholder">
local_services_lead_conversation
包含消息和电话对话详情,例如conversation_channel
、call_duration_millis
、call_recording_url
。- 已针对目标客户对通话录音网址进行身份验证 账号及其经理账号。
local_services_verification_artifact
返回本地生活服务广告客户的制品,例如背景调查、 营业执照和商业保险数据任何相关文件 有执照和保险信息。- 枚举: <ph type="x-smartling-placeholder">
规划
- 添加了对返回
Forecast.views
和PlannedProductForecast.views
:ReachPlanService.ListPlannableProducts
。 - 添加了对退货的支持
PlannableTargeting.surface_targeting
用于ReachPlanService.ListPlannableProducts
, ,用于描述商品的可用展示途径。 - 添加了新的
ReachPlanSurface
枚举。 - 增加了对定位 Target 的支持
展示频次:
AdvancedProductTargeting.target_frequency_settings
, 该函数会返回PlannedProductForecast.average_frequency
。 - 已添加
AudienceInsightsService.GenerateSuggestedTargetingInsights
返回建议的可定位受众群体。 - 将以下值添加到
ReachPlanError
:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
建议
- 已添加
RecommendationSubscriptionService
用于管理推荐订阅:- 资源:
RecommendationSubscription
- 字段:
MutateOperation.recommendation_subscription_operation
- 枚举值:
ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
- 错误: <ph type="x-smartling-placeholder">
- 资源:
- 添加了以下类型的建议:
<ph type="x-smartling-placeholder">
- </ph>
FORECASTING_SET_TARGET_CPA
建议为没有目标每次转化费用的广告系列设置一个目标每次转化费用 在预计会有所增加的季节性活动开始前 流量。SET_TARGET_CPA
建议为没有目标每次转化费用的广告系列设置一个目标每次转化费用 。SET_TARGET_ROAS
建议为没有目标广告支出回报率的广告系列设置目标广告支出回报率 。
报告
- 新增了以下指标,可通过
campaign
(适用于展示广告、视频广告、发现广告和 应用广告系列)和segments.device
:
购物
- 移除了
ShoppingSetting.sales_country
,其值现在返回为ShoppingSetting.feed_label
。- 您可以继续使用某个特定的 Merchant Center 账号
为广告系列创建 Feed
该
ShoppingSetting.feed_label
字段。应设置为 Feed 标签值或两个字母的国家/地区 之前用于ShoppingSetting.sales_country
的代码。如需了解更多详情, 请参阅有关 Feed 的支持文章 标签。
- 您可以继续使用某个特定的 Merchant Center 账号
为广告系列创建 Feed
该
- 在报告中移除了商品类别对国家/地区代码的依赖性。
支持的类别 ID 集未更改。
- 替换了
shopping_performance_view
:segments.product_bidding_category_level1
:segments.product_category_level1
segments.product_bidding_category_level2
:segments.product_category_level2
segments.product_bidding_category_level3
:segments.product_category_level3
segments.product_bidding_category_level4
:segments.product_category_level4
segments.product_bidding_category_level5
:segments.product_category_level5
- 已将“
product_bidding_category_constant
”替换为product_category_constant
返回重复字段中某个类别的所有可用本地化语言。 - 已将“
ListingDimensionInfo.product_bidding_category
”替换为ListingDimensionInfo.product_category
。 - 已将“
ListingGroupFilterDimension.product_bidding_category
”替换为ListingGroupFilterDimension.product_category
。
- 替换了
- 不再支持添加
Campaign.shopping_setting
即可搜索 广告系列。尝试使用以下出价策略制作搜索广告系列:Campaign.shopping_setting
或添加Campaign.shopping_setting
到 现有搜索广告系列现在可提供OPERATION_NOT_PERMITTED_FOR_CONTEXT
。 - 不再支持添加
CampaignCriterion.listing_scope
搜索广告系列。正在尝试添加CampaignCriterion.listing_scope
添加到现有搜索广告系列的OPERATION_NOT_PERMITTED_FOR_CONTEXT
。 - 添加了以下含购物车的转化
data 指标:
<ph type="x-smartling-placeholder">
- </ph>
metrics.orders
metrics.average_order_value_micros
metrics.average_cart_size
metrics.cost_of_goods_sold_micros
metrics.gross_profit_micros
metrics.gross_profit_margin
metrics.revenue_micros
metrics.units_sold
metrics.cross_sell_cost_of_goods_sold_micros
metrics.cross_sell_gross_profit_micros
metrics.cross_sell_revenue_micros
metrics.cross_sell_units_sold
metrics.lead_cost_of_goods_sold_micros
metrics.lead_gross_profit_micros
metrics.lead_revenue_micros
metrics.lead_units_sold
- 这些指标皆可在以下报告中选择: <ph type="x-smartling-placeholder">
统一目标
- 已添加
CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals
在客户一级配置客户获取目标。 - 已添加
CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals
在广告系列一级配置客户获取目标。 - 已添加
CampaignConversionGoalError.CANNOT_USE_STORE_SALE_GOAL_FOR_PERFORMANCE_MAX_CAMPAIGN
。 - 将以下值添加到
ConversionGoalCampaignConfigError
:EMPTY_CONVERSION_GOALS
STORE_SALE_STORE_VISIT_CANNOT_BE_BOTH_INCLUDED
PERFORMANCE_MAX_CAMPAIGN_CANNOT_USE_CUSTOM_GOAL_WITH_STORE_SALES
视频
- 添加了在广告系列级别定位 Google TV 的支持:
<ph type="x-smartling-placeholder">
- </ph>
- 已添加
NetworkSettings.target_google_tv_network
- 已添加
AdNetworkType.GOOGLE_TV
。
- 已添加
- 现已支持在广告系列级别定位 YouTube:
<ph type="x-smartling-placeholder">
- </ph>
- 已添加
NetworkSettings.target_youtube
- 已在
AdNetworkType
中合并YOUTUBE_WATCH
和YOUTUBE_SEARCH
进入YOUTUBE
。 - 已添加
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
。
- 已添加
归档版本说明
如需查看已归档的版本说明,请参阅弃用版本。