Google Реклама API версии 18 уже доступна

Как опытный цифровой маркетолог с более чем десятилетним опытом работы за плечами, я должен сказать, что недавние обновления Google Ads действительно пробудили у меня интерес! Возможность устанавливать целевую цену за конверсию для категории через Campaign.local_services_campaign_settings меняет правила игры для местных предприятий сферы услуг, стремящихся оптимизировать свои расходы на рекламу.


Платформа Google Ads выпустила новую версию своего API, которая теперь имеет версию 18. В этой последней версии были внесены улучшения в различные функции, такие как управление учетными записями, группы объявлений, объявления, активы, кампании (включая PMax), отель/путешествие, местный поиск и отчетность. Это обновление знаменует собой существенную переработку Google Ads API.

Вот видео от команды Google Ads API, в котором рассказывается о некоторых новинках:

В хронологическом порядке последним выпуском является новая версия (не указана), за ней следует версия 13.1 в апреле 2023 г., затем версия 14.1 в августе 2023 г. и версия 15 в октябре 2023 г. До этого была версия 16, выпущенная в феврале 2024 г. до версии 16.1 также в феврале 2024 года. Затем появились версии 17.0 в июне 2024 года и 17.1 в августе 2024 года. До этого Google Ads API увидел версию 12.0 в октябре 2022 года, затем версию 11.0 в июне 2022 года и версию 11.1 в августе 2022 года. Примечательно, что Google прекратил работу API AdWords 27 апреля 2022 года, который перестанет работать после конца июля.

Вот полный журнал изменений:

Управление аккаунтом:

  • (Только для аккаунтов из белого списка) Добавлен DataLinkService.CreateDataLink, который позволяет связать аккаунт Google Рекламы с видео автора, размещенными на его канале YouTube. Связь с видео позволяет аккаунту Google Рекламы показывать партнерскую рекламу с использованием видео авторов.

Группы объявлений:

  • Добавлена ​​AdGroup.exclude_demographic_expansion, которая позволяет исключить расширение демографических данных, если для параметра оптимизированный_таргетинг_enabled установлено значение true. Эта функция ранее поддерживалась только для формирования спроса.

Объявления:

  • Добавлен параметр AdGroupAd.ad_group_ad_asset_automation_settings, который позволяет включать или отключать автоматическое создание объектов для объявлений.
  • В AssetAutomationType добавлены следующие значения:
  • GENERATE_VERTICAL_YOUTUBE_VIDEOS
  • GENERATE_SHORTER_YOUTUBE_VIDEOS
  • Добавлен AdNetworkType.GOOGLE_OWNED_CHANNELS, который используется объявлениями, показываемыми на каналах, принадлежащих Google, таких как YouTube, Gmail и канал Discover.

Ресурсы:

  • AssetType.DISCOVERY_CAROUSEL_CARD переименован в AssetType.DEMAND_GEN_CAROUSEL_CARD.

Кампании:

  • Добавлена ​​metrics.store_visits_last_click_model_attributed_conversions, которая возвращает количество посещений магазинов, связанных с моделью последнего клика кампании.
  • Для кампании добавлены следующие показатели, связанные с просмотрами видео:
  • metrics.video_view_rate_in_feed
  • metrics.video_view_rate_in_stream
  • metrics.video_view_rate_shorts
  • Добавлен metrics.results_conversions_purchase, который возвращает покупки-конверсии для результатов унифицированных целей кампании.
  • Изменено значение по умолчанию для DemandGenCampaignSettings.upgraded_targeting с false на true.

Критерий:

  • Добавлен content_criterion_view, который возвращает показатели эффективности целевого контента, например ключевых слов, мест размещения и тем, для кампаний в контекстно-медийной сети, формирования спроса и видеокампаний.

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

  • Поддержка фидов о путешествиях в поисковых объявлениях
  • Добавлен ClickType.TRAVEL_ASSETS, позволяющий сегментировать показатели ленты путешествий в поисковых объявлениях.
  • Добавлен AssetSetType.TRAVEL_FEED, который можно использовать для включения и отказа от использования ленты путешествий в поисковых объявлениях.
  • (Только для аккаунтов из белого списка) Маршрут путешествия добавлен в качестве нового правила ценности конверсии со следующими новыми полями и значениями:
  • ConversionValueRule.itinerary_condition с ValueRuleItineraryCondition, который позволяет указать окно предварительного бронирования, продолжительность маршрута и дни недели начала путешествия.
  • ConversionValueRulePrimaryDimensionEnum.ITINERARY
  • ValueRuleSetDimension.ITINERARY
  • Добавлены следующие сегменты для отчетов кампании и группы объявлений, чтобы можно было сегментировать данные об эффективности на основе конкретных направлений (городов, стран и регионов) для гостиниц и поисковых кампаний:
  • segments.travel_destination_city
  • segments.travel_destination_country
  • segments.travel_destination_region

Местные службы:

  • PhoneCallDetails.call_recording_url будет пустым вместо предоставления недопустимого URL-адреса, если запись звонка не существует для данного разговора с ведущим специалистом в местных службах.
  • Добавлен CategoryBid.target_cpa_bid_micro, который позволяет устанавливать целевую цену за конверсию для категории через Campaign.local_services_campaign_settings.

Максимальная производительность:

  • PSПоддержка принципов бренда.
  • Добавлен Campaign.brand_guidelines_enabled, который показывает, включены ли правила бренда для конкретной кампании с максимальной эффективностью. Если этот параметр включен, ресурсы с полем_type, установленным на BUSINESS_NAME, LOGO, LANDSCAPE_LOGO, должны быть связаны как ресурсы CampaignAsset, а не как ресурсы AssetGroupAsset.
  • Добавлены ошибки CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED и CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED, которые указывают на то, что в кампаниях с максимальной эффективностью с включенными рекомендациями по бренду нет необходимых ресурсов CampaignAsset, связанных с кампанией.
  • Если правила бренда включены, по крайней мере один объект с полем type_type, установленным на BUSINESS_NAME, и хотя бы один с LOGO должен быть связан с кампанией в качестве ресурсов CampaignAsset. Кампании с максимальной эффективностью для онлайн-продаж с фидом товаров должны соответствовать этому требованию только при наличии объектов, связанных с группами объектов кампании.
  • В AssetLinkError добавлены следующие значения:
  • BRAND_ASSETS_NOT_LINKED_AT_ASSET_GROUP_LEVEL, который выдается при попытке связать активы бренда с кампаниями в качестве ресурсов CampaignAsset вместо ресурсов AssetGroupAsset в кампаниях с максимальной эффективностью, в которых не включены рекомендации по бренду.
  • Ошибка BRAND_ASSETS_NOT_LINKED_AT_CAMPAIGN_LEVEL, которая возникает при попытке связать ресурсы бренда с кампаниями как ресурсы AssetGroupAsset вместо ресурсов CampaignAsset в кампаниях с максимальной эффективностью с включенными рекомендациями по бренду.
  • Добавлено представление Performance_max_placement_view, которое возвращает показы мест размещения, где показывались объявления с максимальной эффективностью.
  • Добавлен AssetGroupListingGroupFilterError.TREE_WAS_INVALID_BEFORE_MUTATION

Планирование:

  • (Только для аккаунтов из белого списка) Добавлен новый сервис с методом ContentCreatorInsightsService.GenerateCreatorInsights, который позволяет пользователям получать информацию о лучших авторах YouTube. Это позволяет клиентам искать авторов по комбинации таргетинга на аудиторию и контент или получать информацию об авторах по списку идентификаторов каналов YouTube.
  • Обновления AudienceInsightsService.GenerateSuggestedTargetingInsights:
  • Аудитория, baseline_audience и data_month перемещены в Audience_definition.
  • Добавлено Audience_description для генерации предложений по таргетингу на основе текстового описания в произвольной форме с использованием Gen AI.
  • Добавлен AudienceInsightsService.GenerateTargetingSuggestionMetrics, который возвращает потенциальные показатели охвата для заданных комбинаций таргетинга на аудиторию.

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

  • RecommendationService.GenerateRecommendations теперь можно использовать для создания рекомендаций по оптимизированному бюджету во время создания кампании, включив тип рекомендации CAMPAIGN_BUDGET в GenerateRecommendationsRequest.recommendation_types[]. Это работает для кампаний с максимальной эффективностью и кампаний в поисковой сети.

Отчетность:

  • Поля summary_row_setting и return_total_results_count в SearchGoogleAdsRequest заменены на поле search_settings типа SearchSettings со следующими полями:
  • опустить_результаты
  • return_summary_row
  • return_total_results_count
  • Добавлены следующие новые показатели по общим недействительным кликам, например, созданным ботами или сканерами, а также по нестандартным шаблонам. Их можно запросить в отчете о кампании.
  • metrics.general_invalid_clicks
  • metrics.general_invalid_click_rate
  • В QuotaError добавлены следующие значения:
  • EXCESSIVE_SHORT_TERM_QUERY_RESOURCE_CONSUMPTION
  • EXCESSIVE_LONG_TERM_QUERY_RESOURCE_CONSUMPTION

Вот и все, ребята.

Смотрите также

2024-10-17 16:14