Компания Google выпустила основной выпуск Google Ads API версии 14. Версия 14 содержит новые типы рекомендаций, минус-слова на уровне аккаунта, офлайн-конверсии, данные GA4 и многое другое. Google сказал обновленные клиентские библиотеки и примеры кода будут опубликованы на следующей неделе.
Этой новой версии, выпущенной в апреле 2023 г., предшествовала версия 13.1. Версия 12.0 была выпущена в октябре 2022 г., версия 11.0 Google Ads API была выпущена в июне, а версия 11.1 — в августе. Также 27 апреля 2022 г. была выпущена версия 10.1, а 9 февраля 2022 г. — версия 10.0. А 27 апреля Google прекратил работу API AdWords, который полностью перестанет работать в конце июля.
Вот видеообзор изменений:
Вот полный список изменений в версии 13.1 согласно список изменений:
Содержание
Кампании
- Добавлена ошибка бюджета кампании.BUDGET_AMOUNT_MUST_BE_UNSET_FOR_CUSTOM_BUDGET_PERIOD
Конверсии
- Добавлена поддержка идентификации конверсий 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, который обобщает статус и диагностическую информацию о загрузках и корректировках офлайн-конверсий клиента.
- Добавлен job_id в ответы, возвращаемые ConversionAdjustmentUploadService.UploadConversionAdjustments и ConversionUploadService.UploadClickConversions, для связывания ответа с OfflineConversionUploadSummary.job_id.
Питомник
- Добавлена поддержка получения, создания и обновления минус-слов на уровне аккаунта; поля, перечисления и ошибки
- Добавлен CriterionError.CANNOT_TARGET_SIMILAR_USER_LIST
Объявления отелей
- SuggestTravelAssetsRequest.place_id переименован в SuggestTravelAssetsRequest.place_ids.
Планирование
- Из KeywordPlanService удалены следующие методы: GenerateForecastCurve, GenerateForecastMetrics, GenerateForecastTimeSeries и GenerateHistoricalMetrics.
- Добавлен KeywordPlanIdeaService.GenerateKeywordForecastMetrics для поддержки создания показателей прогноза кампании по ключевым словам без необходимости предварительного создания плана ключевых слов.
- Удалена поддержка получения отчета кампании_критерия_симуляции.
- Добавлена поддержка YOUTUBE_DYNAMIC_LINEUP в качестве параметра в AudienceInsightsService.ListAudienceInsightsAttributes.
- Добавлены DynamicLineupAttributeMetadata.sample_channels, используемые в ответах GenerateAudienceCompositionInsights для предоставления образцов каналов в составах.
Рекомендации
- Добавлена рекомендация 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
Обсуждение форума на Твиттер.