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

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

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

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

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

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

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

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

Получите данные о производительности.

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

Примечание: Используйте поля metrics.video_trueview_views , metrics.video_trueview_view_rate и metrics.trueview_average_cpv (переименованные из устаревших полей metrics.video_views , metrics.video_view_rate и metrics.average_cpv в v22 ). Начиная с v25 , вы также можете выбрать segments.ad_sub_format_type (наряду с segments.ad_format_type ), чтобы разбить неотключаемые внутрипотоковые рекламные объявления по продолжительности, а также показатели вовлеченности в видеоконтент в социальных сетях ( metrics.youtube_comments , metrics.youtube_likes и metrics.youtube_shares ).

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

Следующий запрос извлекает метрики видеокампаний и групп объявлений, включая количество просмотров видео в 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