v17 (2024-06-05)
v17 中新增了以下功能和变更。
Ads 相关
- 移除了
AdService.getAd
。这使得AdService
与 Google Ads API 中的其他服务一致。如需了解提取广告和其他资源类型的推荐方法,请参阅检索对象。 - 为
ImageAdInfo.image_asset
添加了更多关于尺寸和格式的验证。如果图片无效,系统可能会抛出以下错误:
素材资源
- 添加了新枚举:
ClickType.AD_IMAGE
- 添加了以下新报告,其中包含适用于效果最大化广告系列和搜索广告系列的新指标:
受众群体
批量作业
- 添加了
BatchJobError.REQUEST_TOO_LARGE
,当提交的AddBatchJobOperationsRequest
超过 10484504 字节时,系统会抛出此异常。 - 添加了对在使用
BatchJobService
时设置MutateOperation.asset_group_operation
的支持。这样,您就可以使用批处理来制作和管理整个效果最大化广告系列。不妨参阅我们新推出的专属指南。
广告系列
- 在所有字段、枚举和 Google Ads API 中所有资源(例如广告系列、广告和素材资源)的错误中,将发现广告重命名为需求开发广告系列。例如,
AdvertisingChannelType.DISCOVERY
现在是AdvertisingChannelType.DEMAND_GEN
。 - 添加了
Campaign.keyword_match_type
,可让您为广告系列中的所有关键字设置关键字匹配类型。
转化次数
- 对于 SKAdNetwork 转化:
- 将
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
- 为
gender_view
添加了对metrics.search_impression_share
的支持 - 为
keyword_view
添加了对metrics.phone_calls
的支持
本地生活服务
- 添加了
LocalServicesLeadService.AppendLeadConversation()
,用于将新的LocalServicesLeadConversation
附加到LocalServicesLead
,以便根据潜在客户的创建方式,通过短信等适当渠道将消息发送给用户。AppendLeadConversationRequest.conversations
的大小上限为 1000。- 在
Conversation.local_services_lead
中,只能指定lead_type
设置为LeadType.MESSAGE
的LocalServicesLead
。
- 向
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
- 添加了新报告
shopping_product
,对应于 Google Ads 界面的商品页面。它支持从与 Google Ads 帐号关联的 Google Merchant Center 帐号中返回与商品的当前状态相关的数据。- 在使用
GoogleAdsService.Search
或GoogleAdsService.SearchStream
时,您可以使用segments.date
过滤shopping_product
报告中的指标。不允许按日期细分,否则将返回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 个。
广告系列
- 支持使用
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
。 - 从
AccountLink
中移除了data_partner
和google_ads
。 - 添加了
IdentityVerificationService
,用于管理广告客户验证。StartIdentityVerification()
用于通过提供的verification_program
启动验证会话。它将创建一个新的验证会话,并为成功创建的验证返回空响应。GetIdentityVerification()
可用于检索验证信息,这些信息会返回IdentityVerification
的多个对象。每个IdentityVerification
均包含:verification_program
:这是身份验证程序类型identity_verification_requirement
,包含与广告客户完成验证的截止日期相关的详细信息verification_progress
,包含与验证会话相关的详细信息,包括:program_status
表示此验证会话的当前状态action_url
会将客户定向到一个网址以完成验证。invitation_link_expiration_time
表示action_url
的失效日期
- 枚举:
- 错误:
- 添加了
AuthorizationError.ACTION_NOT_PERMITTED_FOR_SUSPENDED_ACCOUNT
。
素材资源
- 对
asset_group
的变更:- 添加了对时间相关细分的支持,例如
segments.year
和segments.month
。 - 将
campaign
设为了归因资源,而不是对资源进行细分。
- 添加了对时间相关细分的支持,例如
广告系列
- 需求开发广告系列的变更:
- 新增了对在现有需求开发广告系列中设置
Campaign.shopping_setting
的支持。 - 添加了
ShoppingSetting.disable_product_feed
,用于停用需求开发广告系列的可选商品 Feed。 - 添加了
Ad.demand_gen_product_ad
和相应的DemandGenProductAdInfo
,适用于具有非 nullCampaign.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
,以允许广告客户检索他们添加的员工信息。
规划
- 从
AudienceInsightsAttributeMetadata
中移除了score
。
建议
- 添加了
RecommendationService.GenerateRecommendations()
,它会根据指定的设置(例如推荐类型和广告渠道类型)返回推荐。这在制作广告系列时特别有用。 - 添加了
RecommendationMetrics.conversions_value
。 - 现在,对于未设置关键字匹配类型的推荐关键字,系统会将
recommended_match_type
设置为UNSPECIFIED
(而非UNKNOWN
)。 - 添加了以下类型的建议:
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
,建议提高需求开发广告系列的广告效力
Shopping
- 添加了
CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
和CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
,以便为关联到 Comparison Shopping Service Center 帐号的购物广告系列提供更详细的错误。 - 向
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
生命周期目标
- 向
CustomerLifecycleGoalOperation
和CampaignLifecycleGoalOperation
添加了update
,以使这些操作类型与 API 中的其他操作类型保持一致。
v15 (2023-10-18)
v15 中引入了以下新功能和更新。
账号管理
- 如果您的帐号因未经授权的帐号活动而被暂停,则
customer.status
和customer_client.status
现在会返回为SUSPENDED
。以前,它们作为ENABLED
返回。 - 添加了对添加和移除 Google Ads 帐号与 Merchant Center 帐号之间的关联的支持:
- 添加了
ProductLinkInvitationService
和ProductLinkInvitation
,以支持更新从其他产品发送的关联邀请,适用于 Hotel Center 和 Merchant Center 帐号。 - 移除了
MerchantCenterLinkService
。- 如需将 Google Ads 帐号与 Merchant Center 帐号相关联,请使用
ProductLinkInvitationService
和ProductLinkService
。
- 如需将 Google Ads 帐号与 Merchant Center 帐号相关联,请使用
- 移除了
AccountLink.hotel_center
,并支持使用AccountLinkService
更新 Hotel Center 帐号的关联邀请。- 如需更新来自 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 用户未征得用户同意,则意见征求值将被视为未征得用户同意。未经 EEA 用户同意,我们不会处理这些用户的数据,也不会通过目标客户匹配将这些数据用于广告个性化。如需了解详情,请参阅我们的目标客户匹配指南。 - 对于实体店销售,添加了
UserData.consent
以支持提供用户意见。如需了解详情,请参阅我们的实体店销售指南。如果您要将目标客户匹配与实体店销售结合使用,请参阅常见问题解答了解更多信息。 - 添加了
UserList.lookalike_user_list
,以支持创建相似细分受众群,即基于提供的现有种子受众群体创建的受众群体。相似细分受众群只能在需求开发广告系列中使用。
广告系列
效果最大化广告系列的最新动态:
AssetGroupSignal
现在支持以下两种信号类型:AssetGroupSignal.audience
- 添加了
Audience.scope
和Audience.asset_group
,可将受众群体使用量限制为特定素材资源组。当且仅当Audience.scope
为ASSET_GROUP
时,才必须设置Audience.asset_group
。
- 添加了
AssetGroupSignal.search_theme
- 添加了
CriterionType.SEARCH_THEME
,可支持这种新的条件类型。这种新的条件类型只能在效果最大化广告系列中使用,目的是通过在AssetGroupSignal.search_theme
中填充SearchThemeInfo
条件来创建AssetGroupSignal
。
- 添加了
- 添加了
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
设置为该共享集)附加到广告系列。广告系列条件可以分别在搜索广告系列中定位和在效果最大化广告系列中排除。添加了
Campaign.asset_automation_settings[]
,用于显示每种素材资源类型的自动化状态。向
CampaignPrimaryStatusReason
枚举添加了以下值:NO_ASSET_GROUPS
ASSET_GROUPS_PAUSED
转化次数
- 添加了
CallConversion.consent
和ClickConversion.consent
,以支持提供用户意见。有关详情,请参阅我们的致电转化指南和点击转化指南。 - 添加了以下与 SKAdNetwork 转化相关的字段,在使用
customer
或campaign
查询时可用: - 将
metrics.sk_ad_network_conversions
替换为了metrics.sk_ad_network_installs
。 - 添加了对诊断线下转化数据上传功能的支持
- 将
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 跨广告网络归因:
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
中添加了对以下字段的支持:- 细分:
- 指标:
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
本地生活服务广告
- 向
customer
报告添加了LocalServicesSettings
及其字段,用于返回本地生活服务广告客户的精细许可和保险状态。 - 针对本地生活服务添加了以下新报告:
local_services_lead
包含与本地生活服务广告潜在客户相关的所有详细信息,例如lead_charged
、lead_type
、lead_status
。- 枚举:
local_services_lead_conversation
包含消息和电话对话详细信息,例如conversation_channel
、call_duration_millis
、call_recording_url
。- 系统会根据目标客户帐号及其经理帐号对通话录音网址进行身份验证。
local_services_verification_artifact
会返回本地生活服务广告客户的工件,例如背景调查、营业执照和商业保险数据。您可以通过网址访问与执照和保险相关联的任何文档。
规划
- 添加了对针对适用商品类型返回
ReachPlanService.ListPlannableProducts
的Forecast.views
和PlannedProductForecast.views
的支持。 - 添加了对为
ReachPlanService.ListPlannableProducts
返回PlannableTargeting.surface_targeting
的支持,后者描述了商品的可用 surface。 - 添加了新的
ReachPlanSurface
枚举。 - 添加了对使用
AdvancedProductTargeting.target_frequency_settings
定位目标频次的支持,该方法会返回PlannedProductForecast.average_frequency
。 - 添加了
AudienceInsightsService.GenerateSuggestedTargetingInsights
,可返回建议的可定位受众群体。 - 向
ReachPlanError
添加了以下值:NOT_FORECASTABLE_NOT_ENOUGH_INVENTORY
NOT_FORECASTABLE_ACCOUNT_NOT_ENABLED
建议
- 添加了
RecommendationSubscriptionService
,用于管理推荐订阅: - 添加了以下类型的建议:
FORECASTING_SET_TARGET_CPA
,建议在预计会增加流量的季节性活动之前,为未指定目标每次转化费用的广告系列设置目标每次转化费用。SET_TARGET_CPA
,建议为没有指定目标每次转化费用的广告系列设置目标每次转化费用。SET_TARGET_ROAS
,建议为没有指定目标广告支出回报率的广告系列设置目标广告支出回报率。
通报失准
- 添加了以下新指标,这些指标可通过
campaign
(适用于展示广告系列、视频广告系列、发现广告系列和应用广告系列)和segments.device
进行查询:
Shopping
- 移除了
ShoppingSetting.sales_country
,其值现在作为ShoppingSetting.feed_label
返回。- 您可以通过使用
ShoppingSetting.feed_label
字段继续为广告系列使用特定的 Merchant Center Feed。它应设置为 Feed 标签值或之前用于ShoppingSetting.sales_country
的两个字母的国家/地区代码。如需了解详情,请参阅有关 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
。 - 添加了以下含购物车数据的转化指标:
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
- 这些指标皆可在以下报告中选择:
统一目标
- 添加了
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 的支持:
- 添加了在广告系列级别定位 YouTube 的支持:
- 添加了
NetworkSettings.target_youtube
- 在
AdNetworkType
中,将YOUTUBE_WATCH
和YOUTUBE_SEARCH
合并到了YOUTUBE
中。 - 添加了
CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE
。
- 添加了
已归档的版本说明
如需查看已归档的版本说明,请参阅弃用版本。