Примечания к выпуску

v18 (16 октября 2024 г.)

Следующие новые функции и обновления были добавлены в v18.

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

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

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

  • Добавлен AdGroup.exclude_demographic_expansion , который позволяет исключить расширение демографических данных, если для optimized_targeting_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.

Ресурсы

Кампании

Критерий

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

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

Местные услуги

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

Максимальная эффективность

  • Поддержка рекомендаций бренда
    • Добавлен Campaign.brand_guidelines_enabled , который показывает, включены ли правила бренда для данной кампании с максимальной эффективностью. Если этот параметр включен, активы с field_type установленным на BUSINESS_NAME , LOGO , LANDSCAPE_LOGO должны быть связаны как ресурсы CampaignAsset а не как ресурсы AssetGroupAsset .
    • Добавлены ошибки CampaignError.REQUIRED_BUSINESS_NAME_ASSET_NOT_LINKED и CampaignError.REQUIRED_LOGO_ASSET_NOT_LINKED , которые указывают на то, что в кампаниях с максимальной эффективностью с включенными рекомендациями по бренду нет необходимых ресурсов CampaignAsset связанных с кампанией.
    • Если правила бренда включены, по крайней мере один объект с field_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 :
    • audience , baseline_audience и data_month перемещены в audience_definition .
    • Добавлена audience_description для генерации предложений по таргетингу из текстового описания в свободной форме с использованием Gen AI.
  • Добавлен AudienceInsightsService.GenerateTargetingSuggestionMetrics , который возвращает потенциальные показатели охвата для заданных комбинаций таргетинга на аудиторию.

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

Отчетность

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

v17.1.0 (07.08.2024)

Следующие новые функции и обновления были добавлены в v17_1.

Ресурсы

Аудитории

  • Новые значения перечисления в UserListCustomerTypeCategory :
    • LOYALTY_TIER_1_MEMBERS
    • LOYALTY_TIER_2_MEMBERS
    • LOYALTY_TIER_3_MEMBERS
    • LOYALTY_TIER_4_MEMBERS
    • LOYALTY_TIER_5_MEMBERS
    • LOYALTY_TIER_6_MEMBERS
    • LOYALTY_TIER_7_MEMBERS

Кампании

История изменений

  • Новый тип ресурса статуса изменения: ASSET_GROUP .

Конверсии

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

  • AudienceInsights.GenerateAudienceOverlapInsights() который принимает входной основной атрибут и набор атрибутов аудитории и возвращает оценки перекрытия потенциального охвата YouTube между основным атрибутом и атрибутами аудитории.

Отчетность

Видео

v17 (05.06.2024)

Следующие функции и изменения были добавлены в v17.

Объявления

Ресурсы

Аудитории

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

Кампании

  • Обнаружение переименовано в Генерирование спроса во всех полях, перечислениях и ошибках всех ресурсов в API Google Рекламы, таких как кампании, объявления и активы. Например, AdvertisingChannelType.DISCOVERY теперь называется AdvertisingChannelType.DEMAND_GEN .
  • Добавлен Campaign.keyword_match_type , позволяющий установить тип соответствия ключевых слов для всех ключевых слов в кампании.

Конверсии

Критерии

  • В следующие поля AdGroupCriterion добавлено, чтобы показать, выполняется ли критерий группы объявлений или причины, по которым он не показывается:
    • primary_status
    • primary_status_reasons
  • Добавлена ​​поддержка metrics.search_impression_share для gender_view
  • Добавлена ​​поддержка metrics.phone_calls для keyword_view

Местные услуги

Отчетность

Шоппинг

  • Добавлен новый отчет shopping_product , который соответствует странице «Товары» в пользовательском интерфейсе Google Рекламы. Он поддерживает возврат данных, связанных с текущим состоянием продуктов, из учетных записей Google Merchant Center, связанных с учетной записью Google Рекламы.

Единые цели

Видео

  • В ContentLabelType добавлены следующие значения. Вы можете исключить эти ContentLabelTypes на уровне клиента:
    • BRAND_SUITABILITY_CONTENT_FOR_FAMILIES
    • BRAND_SUITABILITY_GAMES_FIGHTING
    • BRAND_SUITABILITY_GAMES_MATURE
    • BRAND_SUITABILITY_HEALTH_SENSITIVE
    • BRAND_SUITABILITY_HEALTH_SOURCE_UNDETERMINED
    • BRAND_SUITABILITY_NEWS_RECENT
    • BRAND_SUITABILITY_NEWS_SENSITIVE
    • BRAND_SUITABILITY_NEWS_SOURCE_NOT_FEATURED
    • BRAND_SUITABILITY_POLITICS
    • BRAND_SUITABILITY_RELIGION
  • Добавлен AdVideoAsset.ad_video_asset_info для поддержки настроек инвентаря для видеоресурсов при создании DemandGenVideoResponsiveAdInfo .
  • (Только учетные записи из белого списка) Campaign.video_brand_safety_suitability стал изменяемым.

v16.1.0 (24 апреля 2024 г.)

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

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

Ресурсы

Аудитории

  • Новое значение перечисления: ResourceLimitType.LOOKALIKE_USER_LISTS_PER_CUSTOMER , которое ограничивает количество похожих списков пользователей, которые может иметь клиент, до 1000.

Кампании

Конверсии

Критерии

Эксперименты

Местные услуги

Видео

v16 (21 февраля 2024 г.)

Следующие функции и изменения были добавлены в v16.

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

Ресурсы

  • Изменения в asset_group :
    • Добавлена ​​поддержка сегментов, связанных со временем, таких как segments.year и segments.month .
    • campaign стала атрибутивным ресурсом вместо сегментированного ресурса.

Кампании

  • Изменения в кампаниях по формированию спроса:
  • В следующие поля в AdGroup добавлено, чтобы показать, показывается ли группа объявлений или почему она не показывается:
    • primary_status
    • primary_status_reasons
  • В следующие поля в AdGroupAd добавлено, чтобы показать, показывается ли объявление группы объявлений или причины, по которым оно не показывается:
    • primary_status
    • primary_status_reasons
  • В AdGroupError добавлены следующие значения:
    • CANNOT_ADD_AD_GROUP_FOR_CAMPAIGN_TYPE
    • INVALID_STATUS

Эксперимент

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

Местные услуги

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

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

  • Добавлена RecommendationService.GenerateRecommendations() , которая возвращает рекомендации на основе указанных настроек, таких как типы рекомендаций и типы рекламных каналов. Это особенно полезно во время разработки кампании.
  • Добавлена RecommendationMetrics.conversions_value .
  • Для рекомендуемых ключевых слов с неустановленным типом соответствия ключевого слова теперь recommended_match_type имеет значение UNSPECIFIED вместо UNKNOWN .
  • Добавлены следующие типы рекомендаций:
    • MAXIMIZE_CONVERSION_VALUE_OPT_IN , который рекомендует выбрать стратегию назначения ставок "Максимальная ценность конверсии".
    • IMPROVE_GOOGLE_TAG_COVERAGE , который рекомендует использовать тег Google на большем количестве страниц.
    • PERFORMANCE_MAX_FINAL_URL_OPT_IN , в котором рекомендуется включить расширение конечного URL для кампаний с максимальной эффективностью.
    • REFRESH_CUSTOMER_MATCH_LIST , который рекомендует обновить список клиентов, который не обновлялся в течение последних 90 дней.
    • CUSTOM_AUDIENCE_OPT_IN , который рекомендует создать собственную аудиторию.
    • LEAD_FORM_ASSET , который рекомендует добавлять активы форм для потенциальных клиентов на уровне кампании или клиента.
    • IMPROVE_DEMAND_GEN_AD_STRENGTH , который рекомендует повысить эффективность рекламы в кампаниях по формированию спроса.

Шоппинг

Цели жизненного цикла

Архивные примечания к выпуску см. в разделе «Устаревшие версии» .