Google выпустил Google Ads API версии 13.0, и ниже приведен список изменений. Большие изменения включают максимальную производительность для целей путешествий и ремаркетинг со списками пользователей на основе правил, но в версии 13 есть масса изменений.

Версия 12.0 была выпущена в октябре 2022 года, версия 11.0 Google Ads API — в июне, а версия 11.1 — в августе. Также 27 апреля 2022 г. была выпущена версия 10.1, а 9 февраля 2022 г. — версия 10.0. А 27 апреля Google прекратил работу API AdWords, который полностью перестанет работать в конце июля.

Google опубликовано видео основных изменений в 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.

Аудитории

  • Удалены CombinedRuleUserListInfo и ExpressionRuleUserListInfo и их ссылки из RuleBasedUserListInfo. Вместо этого используйте FlexibleUserListInfo.

  • Добавлены QualifyingQuestion и Qualification_question для поддержки возврата сведений о квалификационных вопросах активов форм для потенциальных клиентов. Когда рекламодатели предлагают уточняющий вопрос, он проверяется и утверждается, прежде чем использоваться в формах для потенциальных клиентов.
ЧИТАТЬ  Google представляет Gemini и обновляет Bard до Gemini Pro

Пакетные задания

  • Добавлен параметр 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 будет возвращен, если вы загрузите ClickConversion с user_identifiers, установленным с помощью ConversionUploadService.UploadClickConversion, но не примете условия использования данных клиента.

  • ConversionUploadError.CLICK_CONVERSION_ALREADY_EXISTS будет возвращен, если вы попытаетесь загрузить одну и ту же комбинацию gbraid, convert_action и convert_date_time в разные дни.

  • ConversionUploadError.CUSTOMER_NOT_ENABLED_ENHANCED_CONVERSIONS_FOR_LEADS будет возвращен, если вы не выполнили инструкции по настройке перед использованием расширенных конверсий для лидов.

  • Добавлен 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, который недействителен для категории вашей кампании Local Service. Вы можете получить информацию о категории, выполнив запрос кампании.local_services_campaign_settings.category_bids.

Ошибки

  • Начиная с версии 13, коды ошибок, возвращаемые для некоторых недопустимых операций, изменились для следующих полей.
ЧИТАТЬ  Когда будет следующий подтвержденный алгоритм ранжирования в поиске Google?

Отель и путешествия

  • Добавлена ​​поддержка Performance Max для целей поездок со следующими новыми полями, ресурсами и перечислениями: поля Campaign.hotel_property_asset_set, AssetSet.hotel_property_data и HotelPropertyData, Asset.hotel_property_asset и HotelPropertyAsset. Enums: 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_VELPERFORMANCE_MAX_FOR_S

  • Только клиенты из закрытого списка разрешенных: добавлена ​​служба TravelAssetSuggestionService, которая предлагает необходимые изображения и текстовые ресурсы (такие как заголовки, описания, подробные описания) для использования при создании групп ресурсов в Performance Max для кампаний с целью путешествия.

  • Только для клиентов из разрешенного списка: добавлена ​​поддержка рекламных кампаний «Что делать» путем добавления следующих новых полей, ресурсов и перечислений: «Поля», «Перечисления», «Для создания кампании», «Для создания группы объявлений», «Ошибки», «Отчеты», «Travel_performance_view», «Travel_activity_group_view».

Рекомендации

  • Следующие рекомендации на основе фида заменены рекомендациями на основе объектов: рекомендация.

  • Добавлена ​​рекомендация.campaigns для отображения кампаний, на которые нацелена рекомендация. Удален ResponsiveSearchAdAssetRecommendation.current_ad.

Покупка

  • Удален ProductBiddingCategoryInfo.country_code.

  • Добавлена ​​поддержка segments.product_feed_label в shopping_performance_view.

видео

  • Удален PreferredContentInfo и его ссылка из AdGroupBidModifier.

  • Добавлены поля призыва к действию для видеообъявлений-заставок: VideoBumperInStreamAdInfo.action_button_label, VideoBumperInStreamAdInfo.action_headline.

  • Добавлены TargetCpm.target_frequency_goal и TargetCpmTargetFrequencyGoal для поддержки предоставления дополнительных сведений о цели стратегии назначения ставок «Целевая цена за тысячу показов».

  • Добавлен AdvertisingChannelSubType.VIDEO_REACH_TARGET_FREQUENCY.

  • Добавлен PlacementType.GOOGLE_PRODUCTS.

Обсуждение форума на Твиттер.



Source link