Google Ads API 13.0 版现已推出

Google 发布了Google Ads API 13.0 版,下面列出了更改内容。重大变化包括旅行目标的性能最大化和基于规则的用户列表的再营销,但版本13 中有大量变化。

12.0 版于2022 年10 月发布,Google Ads API 11.0 版于6 月发布,11.1 版于8 月发布。此外,10.1 版于2022 年4 月27 日发布,10.0 版于2022 年2 月9 日发布。谷歌已于4 月27 日停用AdWords API,该API 将在7 月底完全停止工作。

谷歌 发表 13.0 中主要变化的视频:

以下是完整的变更列表:

帐户管理

  • 添加了ProductLinkService 以支持添加和删除Google Ads 帐户与其他产品之间的链接。这类似于Google Ads 用户界面中的关联帐户视图。在此版本中,仅支持客户匹配数据合作伙伴链接。

资产

  • 向客户添加以下字段以跟踪位置和图像资产的迁移状态:location_asset_auto_migration_done、image_asset_auto_migration_done、location_asset_auto_migration_done_time、image_asset_auto_migration_done_time。
  • 向CustomerAsset、CampaignAsset、AdGroupAsset 添加了以下字段:primary_status、primary_status_details、primary_status_reasons
  • 添加了Asset.field_type_policy_summaries 以返回有关每个字段类型的策略摘要的信息。
  • 资产字段类型; 添加了AssetFieldType.BUSINESS_LOGO。添加了对将CampaignAsset.field_type 设置为以下值的支持:AssetFieldType.BUSINESS_NAME、AssetFieldType.BUSINESS_LOGO
  • 将INVALID_EXCLUDED_PARENT_ASSET_SET_TYPE 添加到AdGroupError、CampaignError
  • 向AssetSetError 添加了以下字段:OAUTH_INFO_INVALID、OAUTH_INFO_MISSING、CANNOT_DELETE_AS_ENABLED_LINKAGES_EXIST

听众

  • 从RuleBasedUserListInfo 中删除了CombinedRuleUserListInfo 和ExpressionRuleUserListInfo 及其引用。请改用FlexibleUserListInfo。
  • 添加了QualifyingQuestion 和qualifying_question 以支持返回有关潜在客户表单资产的合格问题的详细信息。当广告商提出符合条件的问题时,将在将其用于潜在客户表单之前对其进行审查和批准。

批处理作业

  • 添加了BatchJobMetadata.execution_limit_seconds 以返回以秒为单位的执行限制。如果批处理作业的执行时间长于此字段中指定的时间,则批处理作业将被取消。

计费

  • 添加了InvalidActivitySummary 以允许返回有关发票无效活动的更多详细信息。
  • 添加了AccountBudgetProposalError.CANCELED_BILLING_SETUP。

活动

  • 添加了SmartCampaignSettingService.GetSmartCampaignStatus,用于检索属于智能营销活动的资产的更聚合视图。这应该优先于其他状态字段- 例如,智能广告系列的Campaign.primary_status 或Campaign.primary_status_reasons。
  • 将AdGroup.explorer_auto_optimizer_setting 替换为AdGroup.optimized_targeting_enabled 以支持优化定位。这适用于以下AdvertisingChannelType:DISPLAY、VIDEO、DISCOVERY。此字段仅适用于列入白名单的客户。
  • Added several new enum values to CampaignError: AVERAGE_DAILY_SPEND_TOO_HIGH, CANNOT_ATTACH_TO_REMOVED_CAMPAIGN_GROUP, CANNOT_ATTACH_TO_BIDDING_STRATEGY, CANNOT_CHANGE_BUDGET_PERIOD CANNOT_CREATE_DRAFT_CAMPAIGN, CANNOT_CREATE_MORE_THAN_ONE_DRAFT_CAMPAIGN, NOT_ENOUGH_CONVERSIONS CANNOT_SET_MORE_THAN_ONE_CONVERSION_ACTION, NOT_COMPATIBLE_WITH_BUDGET_TYPE, NOT_COMPATIBLE_WITH_UPLOAD_CLICKS_CONVERSION, TRIAL_MUST_USE_SAME_BUDGET_AS_BASE, INVALID_EXCLUDED_PARENT_ASSET_SET_TYPE

转换

  • ConversionUploadError.CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS 如果您使用ConversionUploadService.UploadClickConversion 设置了user_identifiers 上传ClickConversion,但未接受客户数据条款,则会返回ConversionUploadError.CUSTOMER_NOT_ACCEPTED_CUSTOMER_DATA_TERMS。
  • 如果您尝试在不同日期上传相同的gbraid、conversion_action 和conversion_date_time 组合,将返回ConversionUploadError.CLICK_CONVERSION_ALREADY_EXISTS。
  • ConversionUploadError.CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS 如果您在对潜在客户使用增强型转化之前未按照设置说明进行操作,则会返回ConversionUploadError。
  • 添加了ConversionActionType.WEBPAGE_CODELESS 以表示从网站事件创建的转化。

标准

  • 添加了CampaignCriterion.local_service_id 和LocalServiceIdInfo 以允许添加和删除广告商为本地服务广告系列提供的服务。
  • CampaignCriterionError.AT_LEAST_ONE_LOCAL_SERVICE_ID_CRITERION_REQUIRED_FOR_LOCAL_SERVICES_CAMPAIGN 如果您尝试从本地服务广告系列中删除包含local_service_id 的最后一个广告系列标准,则会返回。
  • CampaignCriterionError.LOCAL_SERVICE_ID_NOT_FOUND_FOR_CATEGORY 如果您尝试添加包含对本地服务广告系列类别无效的local_service_id 的广告系列标准,则会返回。您可以通过获取campaign.local_services_campaign_settings.category_bids 来获取有关类别的信息。

错误

  • 从v13 开始,针对某些无效操作返回的错误代码已针对以下字段进行了更改。

酒店旅游

  • 使用以下新字段、资源和枚举添加了对旅行目标的Performance Max 的支持:字段Campaign.hotel_property_asset_set、AssetSet.hotel_property_data 和HotelPropertyData、Asset.hotel_property_asset 和HotelPropertyAsset。枚举:将HOTEL_PROPERTY 添加到:AssetSetType、AssetType、AssetFieldType、AssetGroupAssetError.HOTEL_PROPERTY_ASSET_NOT_LINKED_TO_CAMPAIGN、CampaignError.ASSET_SET_NOT_A_HOTEL_PROPERTY_ASSET_SET、CampaignError.HOTEL_PROPERTY_ASSET_SET_ONLY_FOR_PERFORMANCE_MAX_FOR_TRAVEL_GOALS
  • 仅限已关闭的许可名单客户:添加了TravelAssetSuggestionService 以建议所需的图像和文本资产(例如标题、描述、详细描述),以用于在Performance Max 中为旅行目标活动创建资产组。
  • 仅限白名单客户:通过添加以下新字段、资源和枚举添加了对Things to do 广告活动的支持:字段、枚举、用于创建活动、用于创建广告组、错误、报告、travel_performance_view、travel_activity_group_view

建议

  • 以下基于Feed 的建议替换为基于资产的建议: Recommendation.call_extension_recommendation 替换为Recommendation.call_asset_recommendation
  • 添加了Recommendation.campaigns 以显示推荐所针对的活动。移除了ResponsiveSearchAdAssetRecommendation.current_ad。

购物

  • 删除了ProductBiddingCategoryInfo.country_code。
  • 在shopping_performance_view 中添加了对segments.product_feed_label 的支持。

视频

  • 从AdGroupBidModifier 中删除了PreferredContentInfo 及其引用。
  • 为视频导视广告添加了号召性用语字段:VideoBumperInStreamAdInfo.action_button_label、VideoBumperInStreamAdInfo.action_headline
  • 添加了TargetCpm.target_frequency_goal 和TargetCpmTargetFrequencyGoal 以支持提供有关目标CPM 出价策略目标的更多详细信息。
  • 添加了AdvertisingChannelSubType.VIDEO_REACH_TARGET_FREQUENCY。
  • 添加了PlacementType.GOOGLE_PRODUCTS。

论坛讨论于 推特.

0 条回复 A文章作者 M管理员
    暂无讨论,说说你的看法吧
个人中心
购物车
优惠劵
今日签到
搜索