Видеокампании

Видеокампании позволяют показывать видеорекламу на YouTube, а также на сайтах и в приложениях партнерских видеоресурсов Google.

Ограничения API

Google Ads API в основном поддерживает получение данных и создание отчетов по существующим видеокампаниям, группам объявлений, объявлениям и критериям. Видеокампании нельзя создавать или изменять с помощью Google Ads API, за исключением следующих случаев:

  • Изменяемость VideoResponsiveAdInfo. Начиная с версии 24 объекты VideoResponsiveAdInfo можно изменять (в более ранних версиях они неизменяемы). При создании или изменении VideoResponsiveAdInfo поля videos, business_name и logo_images являются обязательными.
  • Соответствие требованиям безопасности бренда. Начиная с версии 24, поле campaign.video_brand_safety_suitability на уровне кампании удалено. Запросите соответствие требованиям безопасности бренда на уровне аккаунта с помощью customer.video_brand_safety_suitability.
  • Эксперименты с видеокампаниями. Начиная с версии 24, experiment.video_experiment можно использовать для настройки экспериментов YOUTUBE_CUSTOM с видеокампаниями.

Альтернативные варианты управления кампаниями

Если вам нужно создавать видеокампании или управлять ими программно, воспользуйтесь одним из следующих вариантов:

  • Скрипты Google Рекламы. Вы можете управлять видеокампаниями с помощью скриптов Google Рекламы. Это позволяет автоматизировать управление в интерфейсе Google Рекламы.
  • Кампании для создания спроса. Если вы хотите показывать видеообъявления в сервисах Google, включая YouTube, то можете создавать кампании для создания спроса и управлять ими с помощью Google Ads API.

Получение данных об эффективности

Чтобы получить данные об эффективности видеокампаний, групп объявлений и критериев, используйте GoogleAdsService.SearchStream с фильтром campaign.advertising_channel_type = 'VIDEO'.

Эффективность групп объявлений

Следующий запрос извлекает показатели видеокампании и группы объявлений, включая просмотры видео TrueView и долю просмотров до конца по квартилям, из ресурса ad_group:

SELECT
  campaign.id,
  campaign.name,
  campaign.advertising_channel_type,
  ad_group.id,
  ad_group.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.video_trueview_views,
  metrics.video_quartile_p100_rate
FROM ad_group
WHERE campaign.advertising_channel_type = 'VIDEO'

Отчеты о местах размещения видео и критериях таргетинга

Поскольку ad_group_criterion не поддерживает показатели и сегменты напрямую, используйте ресурсы представлений критериев, например managed_placement_view, чтобы получать показатели эффективности для целевых видео YouTube, каналов YouTube или других управляемых мест размещения.

SELECT
  campaign.id,
  ad_group.id,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.youtube_channel.channel_id,
  metrics.impressions,
  metrics.video_trueview_views
FROM managed_placement_view
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND ad_group_criterion.type IN ('YOUTUBE_VIDEO', 'YOUTUBE_CHANNEL')
  AND segments.date DURING LAST_30_DAYS

Отчеты об охвате и частоте показов

Для видеокампаний можно запрашивать показатели охвата Unique Reach в ресурсах campaign и customer (начиная с версии 26), чтобы узнать, сколько уникальных пользователей видели ваши объявления с определенной частотой показов.

Охват аудитории по группам частоты показов можно оценивать с помощью следующих показателей:

  • metrics.unique_users – количество уникальных пользователей, которые видели ваше объявление хотя бы один раз за выбранный диапазон дат (до 92 дней). Его нельзя агрегировать по строкам.
  • metrics.unique_users_two_plus–metrics.unique_users_ten_plus – количество уникальных пользователей, которые видели ваше объявление от 2 до 10 раз соответственно за период до 31 дня. В версии 26 и более поздних версиях в набор показателей "Охват 2+" – "Охват 10+" входят также metrics.unique_users_six_plus–metrics.unique_users_nine_plus.
  • metrics.average_impression_frequency_per_user – среднее количество показов объявления уникальному пользователю за выбранный период (до 92 дней). Этот показатель доступен только в ресурсе campaign, не может быть агрегирован по строкам и не имеет сопутствующего поля _info.

В версии 26 и более поздних у каждого показателя охвата уникальных пользователей есть сопутствующее поле метаданных типа ReachMetricInfo: metrics.unique_users_info и metrics.unique_users_two_plus_info–metrics.unique_users_ten_plus_info.

В языке запросов Google Рекламы (GAQL) сопутствующие поля metrics.unique_users*_info – это показатели MESSAGE с filterable: false и sortable: false, поэтому их нельзя использовать в предложениях WHERE или ORDER BY. Выбирайте эти поля непосредственно в условии SELECT (например, metrics.unique_users_info). Не добавляйте .reach_metric_states в условие SELECT, поскольку выбор вложенных полей сообщений в GAQL приводит к ошибке UNRECOGNIZED_FIELD. Вместо этого при выборе metrics.unique_users_info возвращается сообщение ReachMetricInfo, содержащее повторяющееся поле enum reach_metric_states типа ReachMetricState, которое описывает, был ли показатель скрыт или он полный.

Если показатель охвата скрыт или находится за пределами окна хранения (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION или DATE_RANGE_BEYOND_RETENTION), его поле optional int64 в Metrics не задано (что оценивается как 0, если наличие поля не проверяется), а LOW_QUALITY по-прежнему заполняет числовой показатель.

Значения перечисления ReachMetricState указывают на статус данных об охвате:

  • COMPLETE – показатель охвата полный, без исключений, связанных с конфиденциальностью, качеством или другими ограничениями.
  • PRIVACY_SUPPRESSION – данные об охвате недоступны, поскольку не достигнуты пороговые значения, связанные с требованиями конфиденциальности пользователя (например, слишком мало показов для определенной аудитории).
  • QUALITY_SUPPRESSION: данные об охвате скрыты из-за проблем с качеством.
  • LOW_QUALITY – показатель охвата рассчитан, но помечен как низкокачественный.
  • DATE_RANGE_BEYOND_RETENTION: показатели охвата недоступны, поскольку выбранный диапазон дат превышает срок хранения данных (3 года).

Следующий запрос позволяет получить дедуплицированные показатели охвата за 30 дней и их статусы исключения для видеокампаний с сегментированием по устройствам и форматам объявлений. Удалите сегмент segments.date из условия SELECT, чтобы показатели охвата и N+ частоты показов дедублировались за весь период, а не за каждый день:

SELECT
  campaign.id,
  campaign.name,
  segments.device,
  segments.ad_format_type,
  segments.ad_sub_format_type,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date DURING LAST_30_DAYS

Поддерживаемые ресурсы, диапазоны дат и сегменты

В запросах об охвате и частоте показов необходимо использовать фильтр segments.date, который не выходит за пределы максимального диапазона дат для показателя. Если в запросе не указан фильтр по дате или задан период, превышающий допустимый, то поля охвата будут пустыми.

Показатель Ресурсы Максимальный диапазон дат Совместимые сегменты
metrics.unique_users campaign, customer (версия 26 и более поздние) 92 дня segments.date, segments.device, сегменты форматов объявлений (v26 и более поздние версии), сегменты рекламных сетей (v26 и более поздние версии) и скорректированные сегменты на основе демографических данных.
metrics.average_impression_frequency_per_user campaign 92 дня segments.date, segments.device и скорректированные сегменты на основе демографических данных
metrics.unique_users_two_plus–metrics.unique_users_ten_plus campaign, customer (версия 26 и более поздние) 31 день segments.date, segments.device, сегменты форматов объявлений (версия 26 и более поздние) и сегменты рекламных сетей (версия 26 и более поздние).
metrics.unique_users*_info (версия 26 и более поздние) campaign, customer Соответствует базовому показателю segments.date, segments.device, сегменты форматов объявлений и сегменты рекламных сетей

При сегментировании запросов об охвате применяйте следующие ограничения на совместное использование сегментов:

  • Сегменты по формату объявлений и по рекламной сети. Вы можете сегментировать данные по формату объявлений (segments.ad_format_type, при необходимости с segments.ad_sub_format_type) или по рекламной сети (segments.ad_network_type, при необходимости с segments.ad_sub_network_type), но не можете объединять сегменты по формату объявлений и по рекламной сети в одном запросе. При выборе подсегмента всегда выбирайте родительский сегмент (segments.ad_format_type или segments.ad_network_type). Сегмент segments.ad_sub_format_type позволяет разбить объявления In-Stream без возможности пропуска по продолжительности и возвращает значение UNSEGMENTED для других форматов объявлений, а сегмент segments.ad_sub_network_type позволяет разбить платформы YouTube (YOUTUBE_INSTREAM, YOUTUBE_INFEED и YOUTUBE_SHORTS) только для кампаний для создания спроса и возвращает значение UNSEGMENTED для видеокампаний.
  • Скорректированные сегменты на основе демографических данных. Сегменты segments.adjusted_age_range и segments.adjusted_gender доступны только для аккаунтов из белого списка. Их необходимо выбирать вместе и нельзя сочетать с показателями metrics.unique_users_*_plus, полями metrics.unique_users*_info и сегментами рекламных сетей.