v16.1.0(2024 年 4 月 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 年 2 月 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
以支持这种新的条件类型。这种新的条件类型只能在效果最大化广告系列中使用,以便通过使用SearchThemeInfo
条件填充AssetGroupSignal.search_theme
来创建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
:
- 将
- 添加了 3 份报告,以支持 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
。
- 添加了
v14.1.0(2023 年 8 月 9 日)
v14.1 中引入了以下新功能和更新。
账号管理
Customer.customer_agreement_setting
显示客户是否已接受潜在客户表单的服务条款
资产
AssetGroup
中新增了一些字段,用于显示素材资源组是否正在投放或未投放的原因:primary_status
primary_status_reasons
AssetGroupAsset
中新增了一些字段,用于显示素材资源组素材资源是否正在投放或为何未投放:primary_status
primary_status_details
primary_status_reasons
CallToActionType
枚举中的新值:BUY_NOW
DONATE_NOW
ORDER_NOW
PLAY_NOW
SEE_MORE
START_NOW
VISIT_SITE
WATCH_NOW
AssetLinkError
枚举中的新值:CUSTOMER_NOT_VERIFIED
UNSUPPORTED_CALL_TO_ACTION
PAGE_FEED_INVALID_LABEL_TEXT
结算
Invoice
和AccountSummary
中的新字段:export_charge_subtotal_amount_micros
export_charge_tax_amount_micros
export_charge_total_amount_micros
广告系列
CampaignPrimaryStatusReason
枚举中的新值:HAS_ASSET_GROUPS_DISAPPROVED
HAS_ASSET_GROUPS_LIMITED_BY_POLICY
MOST_ASSET_GROUPS_UNDER_REVIEW
(仅限列入许可名单的帐号)将
DiscoveryCampaignSettings
与upgraded_targeting
结合使用:- 当
upgraded_targeting
设置为true
时,您可以添加地理位置和语言作为广告组条件
- 当
条件
(仅限列入许可名单的帐号)支持将
LanguageInfo
和LocationInfo
添加为AdGroupCriterion
:- 这仅适用于已启用升级后的定位功能的发现广告系列
实验
ExperimentError
枚举中的新值:DUPLICATE_EXPERIMENT_CAMPAIGN_NAME
CANNOT_REMOVE_IN_CREATION_EXPERIMENT
CANNOT_ADD_CAMPAIGN_WITH_DEPRECATED_AD_TYPES
建议
- 新的推荐类型:
PerformanceMaxOptInRecommendation
:建议您在账号中制作第一个效果最大化广告系列ImprovePerformanceMaxAdStrengthRecommendation
:建议提高效果最大化广告系列的素材资源组效力MigrateDynamicSearchAdsCampaignToPerformanceMaxRecommendation
:建议将动态搜索广告系列迁移到效果最大化广告系列
报告
- 关于新客户和回头客的新指标和细分:
- 新的
customer_search_term_insight
和campaign_search_term_insight
视图:metrics.search_volume
显示搜索字词数据分析类别的音量范围
Shopping
- 用于产品信息组的新字段:
- 新字段:
ShoppingSetting.advertising_partner_ids
CampaignError
枚举中的新值:NOT_LINKED_ADVERTISING_PARTNER
INVALID_NUMBER_OF_ADVERTISING_PARTNER_IDS
视频
- (仅限列入许可名单的帐号)
AdType.DISCOVERY_VIDEO_RESPONSIVE_AD
及其对应的DiscoveryVideoResponsiveAdInfo
v14(2023 年 6 月 7 日)
v14 中引入了以下新功能和更新。
广告系列
转化次数
新增了对识别 Google Analytics(分析)转化以及确定转化是从 Universal Analytics 媒体资源还是 GA4 媒体资源导入的支持:
- 向
ConversionActionType
添加了以下值:UNIVERSAL_ANALYTICS_GOAL
UNIVERSAL_ANALYTICS_TRANSACTION
GOOGLE_ANALYTICS_4_CUSTOM
GOOGLE_ANALYTICS_4_PURCHASE
- 添加了
ConversionAction.google_analytics_4_settings
- 向
添加了
Customer.offline_conversion_client_summaries
,其中汇总了客户线下转化上传和调整项的状态和诊断信息。- 枚举
OfflineEventUploadClient
:GOOGLE_ADS_API
GOOGLE_ADS_WEB_CLIENT
ADS_DATA_CONNECTOR
OfflineConversionDiagnosticStatus
:EXCELLENT
GOOD
NEEDS_ATTENTION
NO_RECENT_UPLOAD
- 枚举
向
ConversionAdjustmentUploadService.UploadConversionAdjustments
和ConversionUploadService.UploadClickConversions
返回的响应中添加了job_id
,用于将响应与OfflineConversionUploadSummary.job_id
相关联。
条件
新增了对检索、创建和更新帐号级否定关键字的支持:
- 字段:
- 枚举:
CriterionType.NEGATIVE_KEYWORD_LIST
SharedSetType.ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ResourceLimitType
SHARED_SETS_PER_ACCOUNT_FOR_ACCOUNT_LEVEL_NEGATIVE_KEYWORDS
ACCOUNT_LEVEL_NEGATIVE_KEYWORDS_PER_SHARED_SET
- 错误:
CriterionError
NEGATIVE_KEYWORD_SHARED_SET_DOES_NOT_EXIST
CANNOT_ADD_REMOVED_NEGATIVE_KEYWORD_SHARED_SET
CANNOT_HAVE_MULTIPLE_NEGATIVE_KEYWORD_LIST_PER_ACCOUNT
CUSTOMER_CANNOT_ADD_CRITERION_OF_THIS_TYPE
酒店广告
SuggestTravelAssetsRequest.place_id
已重命名为SuggestTravelAssetsRequest.place_ids
规划
- 从
KeywordPlanService
中移除了以下方法:GenerateForecastCurve
GenerateForecastMetrics
GenerateForecastTimeSeries
GenerateHistoricalMetrics
- 添加了
KeywordPlanIdeaService.GenerateKeywordForecastMetrics
,以支持无需先创建关键字方案即可生成关键字广告系列预测指标。 - 不再支持检索
campaign_criterion_simulation
报告 - 在
AudienceInsightsService.ListAudienceInsightsAttributes
中添加了对YOUTUBE_DYNAMIC_LINEUP
作为维度的支持。 - 添加了
DynamicLineupAttributeMetadata.sample_channels
,用于在GenerateAudienceCompositionInsights
响应中提供频道组中的示例频道。
建议
- 添加了
DynamicImageExtensionOptInRecommendation
,建议在帐号中启用动态图片附加信息 - 添加了
LowerTargetRoasRecommendation
,建议降低目标广告支出回报率 - 添加了
RaiseTargetCpaRecommendation
,建议提高目标每次转化费用 - 添加了
ResponsiveSearchAdAssetRecommendation.current_ad
报告
- 向
ServedAssetFieldType
(可通过ad_group_ad_asset_view.pinned_field
获取)添加了以下值:SITELINK
CALL
MOBILE_APP
CALLOUT
STRUCTURED_SNIPPET
PRICE
PROMOTION
AD_IMAGE
LEAD_FORM
BUSINESS_LOGO
已归档的版本说明
如需查看已归档的版本说明,请参阅已停用的版本。