Google Реклама API версии 18 уже вышла

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

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

До этого выпуска была версия 17.1 в августе, затем до этого была версия 17.0 в июне 2024 года, затем до этого была версия 16.1, а затем версия 16 в феврале 2024 года. До этого была версия 15 еще в октябре 2023 года. Затем до этого была версия 14.1, которая был выпущен в августе. Этой новой версии предшествовала версия 13.1, выпущенная в апреле 2023 года. Версия 12.0 была выпущена в октябре 2022 года, версия 11.0 Google Ads API была выпущена в июне, а версия 11.1 — в августе. Также версия 10.1 была выпущена 27 апреля 2022 года, а версия 10.0 — 9 февраля 2022 года. А 27 апреля Google прекратил работу API AdWords, который полностью перестанет работать в конце июля.

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

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

• (Только для аккаунтов из белого списка) Добавлен 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
• В отчеты о кампаниях и группах объявлений добавлены следующие сегменты, позволяющие сегментировать данные об эффективности на основе конкретных направлений (городов, стран и регионов) для гостиничных и поисковых кампаний:
• сегменты.travel_destination_city
• сегменты.travel_destination_country
• сегменты.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.
• Добавлена ​​аудитория_description для генерации предложений по таргетингу из текстового описания в свободной форме с использованием Gen AI.
• Добавлен AudienceInsightsService.GenerateTargetingSuggestionMetrics, который возвращает потенциальные показатели охвата для заданных комбинаций таргетинга на аудиторию.

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

• РекомендацияService.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

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

Обсуждение на форуме Х.