发行说明

v17 (2024-06-05)

v17 中新增了以下功能和变更。

Ads 相关

• 移除了 AdService.getAd。这使得 AdService 与 Google Ads API 中的其他服务一致。如需了解提取广告和其他资源类型的推荐方法，请参阅检索对象。
• 为 ImageAdInfo.image_asset 添加了更多关于尺寸和格式的验证。如果图片无效，系统可能会抛出以下错误：
  • ImageError.UNEXPECTED_SIZE
  • ImageError.FORMAT_NOT_ALLOWED

素材资源

• 添加了新枚举：ClickType.AD_IMAGE
• 添加了以下新报告，其中包含适用于效果最大化广告系列和搜索广告系列的新指标：
  • campaign_aggregate_asset_view
  • channel_aggregate_asset_view

受众群体

• 添加了OfflineUserDataJobError.OPERATION_LEVEL_CONSENT_PROVIDED

批量作业

• 添加了 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。
• 现在，以下指标随响应一起返回（即使这些指标为零）。这使其与其他指标保持一致。
  • metrics.all_conversions_value_by_conversion_date
  • metrics.all_conversions_by_conversion_date
  • metrics.conversions_value_by_conversion_date
  • metrics.conversions_by_conversion_date

条件

• 向 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。

实验

• 新的枚举值：ExperimentError.INVALID_DURATION_FOR_AN_EXPERIMENT。

本地生活服务

• 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 启动验证会话。它将创建一个新的验证会话，并为成功创建的验证返回空响应。
    • 添加了 IdentityVerificationProgram.ADVERTISER_IDENTITY_VERIFICATION。
  • GetIdentityVerification() 可用于检索验证信息，这些信息会返回 IdentityVerification 的多个对象。每个 IdentityVerification 均包含：
    • verification_program：这是身份验证程序类型
    • identity_verification_requirement，包含与广告客户完成验证的截止日期相关的详细信息
    • verification_progress，包含与验证会话相关的详细信息，包括：
      • program_status 表示此验证会话的当前状态
      • action_url 会将客户定向到一个网址以完成验证。
      • invitation_link_expiration_time 表示 action_url 的失效日期
  • 枚举：
    • IdentityVerificationProgram
    • IdentityVerificationProgramStatus
  • 错误：
    • IdentityVerificationError
• 添加了 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，适用于具有非 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 添加了以下字段，以支持根据开展旅行活动的州和城市创建产品信息组：
  • activity_state
  • activity_city
• 向 travel_activity_performance_view 添加了对以下细分的支持：
  • segments.activity_city
  • segments.activity_country
  • segments.activity_state

本地生活服务

• 添加了 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 帐号之间的关联的支持：
  • 添加了 ProductLink.merchant_center 和 MerchantCenterIdentifier。
  • 添加了 LinkedProductType.MERCHANT_CENTER。
• 添加了 ProductLinkInvitationService 和 ProductLinkInvitation，以支持更新从其他产品发送的关联邀请，适用于 Hotel Center 和 Merchant Center 帐号。
• 移除了 MerchantCenterLinkService。
  • 如需将 Google Ads 帐号与 Merchant Center 帐号相关联，请使用 ProductLinkInvitationService 和 ProductLinkService。
• 移除了 AccountLink.hotel_center，并支持使用 AccountLinkService 更新 Hotel Center 帐号的关联邀请。
  • 如需更新来自 Hotel Center 账号的关联邀请，请使用 ProductLinkInvitationService。

素材资源

• 将 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 设置为该共享集）附加到广告系列。广告系列条件可以分别在搜索广告系列中定位和在效果最大化广告系列中排除。

  • 字段：
    • SharedCriterion.brand
    • CampaignCriterion.brand_list
  • 枚举：
    • SharedSetType.BRANDS
    • CriterionType.BRAND_LIST

• 添加了 Campaign.asset_automation_settings[]，用于显示每种素材资源类型的自动化状态。

• 向 CampaignPrimaryStatusReason 枚举添加了以下值：

  • NO_ASSET_GROUPS
  • ASSET_GROUPS_PAUSED

转化次数

• 添加了 CallConversion.consent 和 ClickConversion.consent，以支持提供用户意见。有关详情，请参阅我们的致电转化指南和点击转化指南。
• 添加了以下与 SKAdNetwork 转化相关的字段，在使用 customer 或 campaign 查询时可用：
  • 细分：
    • segments.sk_ad_network_coarse_conversion_value
    • segments.sk_ad_network_source_domain
    • segments.sk_ad_network_source_type
    • segments.sk_ad_network_postback_sequence_index
  • 指标：
    • metrics.sk_ad_network_total_conversions
    • metrics.sk_ad_network_installs
• 将 metrics.sk_ad_network_conversions 替换为了 metrics.sk_ad_network_installs。
• 添加了对诊断线下转化数据上传功能的支持
  • 将 offline_conversion_upload_client_summary 从 customer 资源上的某个字段移到了顶级报告。使用此报告获取转化上传状态的实用详细信息，例如成功事件数、成功率和错误百分比。
    • 注意：如果转化已上传但导致 ConversionUploadError.CLICK_NOT_FOUND 错误，则仍会计为成功，但也会被标记为 OfflineConversionAlert。
  • 针对以下请求类型添加了 job_id 作为可选参数，以便您在逻辑上将多个上传请求组合为一个概念性作业：
    • UploadConversionAdjustmentsRequest
    • UploadClickConversionsRequest
  • 向以下错误添加了 INVALID_JOB_ID：
    • ConversionAdjustmentUploadError
    • ConversionUploadError
  • 将以下错误中的 INVALID_CONVERSION_ACTION 替换为了 NO_CONVERSION_ACTION_FOUND 和 INVALID_CONVERSION_ACTION_TYPE：
    • ConversionAdjustmentUploadError
    • ConversionUploadError
• 添加了以下三个报告，以支持无重定向的 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 中添加了对以下字段的支持：
  • 细分：
    • segments.activity_account_id
    • segments.activity_rating
    • segments.external_activity_id
  • 指标：
    • 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。
    • 枚举：
      • LeadStatus
      • LeadType
  • local_services_lead_conversation 包含消息和电话对话详细信息，例如 conversation_channel、call_duration_millis、call_recording_url。
    • 系统会根据目标客户帐号及其经理帐号对通话录音网址进行身份验证。
  • local_services_verification_artifact 会返回本地生活服务广告客户的工件，例如背景调查、营业执照和商业保险数据。您可以通过网址访问与执照和保险相关联的任何文档。
    • 枚举：
      • LocalServicesVerificationArtifactStatus
      • LocalServicesVerificationArtifactType
      • LocalServicesInsuranceRejectionReason
      • LocalServicesLicenseRejectionReason

规划

• 添加了对针对适用商品类型返回 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，用于管理推荐订阅：
  • 资源：RecommendationSubscription
  • 字段：MutateOperation.recommendation_subscription_operation
  • 枚举：ChangeClientType.GOOGLE_ADS_RECOMMENDATIONS_SUBSCRIPTION
  • 错误：
    • RecommendationSubscriptionError
    • RecommendationSubscriptionStatus
• 添加了以下类型的建议：
  • FORECASTING_SET_TARGET_CPA，建议在预计会增加流量的季节性活动之前，为未指定目标每次转化费用的广告系列设置目标每次转化费用。
  • SET_TARGET_CPA，建议为没有指定目标每次转化费用的广告系列设置目标每次转化费用。
  • SET_TARGET_ROAS，建议为没有指定目标广告支出回报率的广告系列设置目标广告支出回报率。

通报失准

• 添加了以下新指标，这些指标可通过 campaign（适用于展示广告系列、视频广告系列、发现广告系列和应用广告系列）和 segments.device 进行查询：
  • metrics.unique_users
  • metrics.average_impression_frequency_per_user

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
  • 这些指标皆可在以下报告中选择：
    • ad_group
    • ad_group_ad
    • asset_group_product_group_view
    • campaign
    • customer
    • keyword_view
    • product_group_view
    • shopping_performance_view

统一目标

• 添加了 CustomerLifecycleGoalService.ConfigureCustomerLifecycleGoals，用于在客户级别配置客户获取目标。
  • 报告：customer_lifecycle_goal
• 添加了 CampaignLifecycleGoalService.ConfigureCampaignLifecycleGoals，用于在广告系列一级配置客户获取目标。
  • 报告：campaign_lifecycle_goal
• 添加了 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 的支持：
  • 添加了 NetworkSettings.target_google_tv_network
  • 添加了 AdNetworkType.GOOGLE_TV。
• 添加了在广告系列级别定位 YouTube 的支持：
  • 添加了 NetworkSettings.target_youtube
  • 在 AdNetworkType 中，将 YOUTUBE_WATCH 和 YOUTUBE_SEARCH 合并到了 YOUTUBE 中。
  • 添加了 CampaignError.CANNOT_TARGET_DISPLAY_NETWORK_WITHOUT_YOUTUBE。

已归档的版本说明

如需查看已归档的版本说明，请参阅弃用版本。