Videokampagnen

Mit Videokampagnen können Sie Videoanzeigen auf YouTube sowie auf Websites und in Apps von Google-Videopartnern schalten.

API-Einschränkungen

Mit der Google Ads API können Sie hauptsächlich vorhandene Videokampagnen, Anzeigengruppen, Anzeigen und Kriterien abrufen und Berichte dazu erstellen. Videokampagnen können nicht mit der Google Ads API erstellt oder geändert werden. Es gelten jedoch die folgenden versionsspezifischen Ausnahmen und Verhaltensweisen:

• Veränderbarkeit von VideoResponsiveAdInfo: Ab v24 sind VideoResponsiveAdInfo-Objekte veränderbar. In früheren Versionen sind sie unveränderbar. Beim Erstellen oder Ändern von VideoResponsiveAdInfo sind die Felder videos, business_name und logo_images erforderlich.
• Markensicherheit und Eignung: Ab v24 wird campaign.video_brand_safety_suitability auf Kampagnenebene entfernt. Mit customer.video_brand_safety_suitability können Sie die Markensicherheit auf Kontoebene abfragen.
• Tests für Videokampagnen: Ab v24 ist experiment.video_experiment verfügbar, um YOUTUBE_CUSTOM-Tests mit Videokampagnen zu konfigurieren.

Alternativen für die Kampagnenverwaltung

Wenn Sie Videokampagnen programmatisch erstellen oder verwalten möchten, haben Sie folgende Möglichkeiten:

• Google Ads-Scripts: Sie können Videokampagnen mit Google Ads-Scripts verwalten. Dadurch ist eine automatisierte Verwaltung über die Google Ads-Benutzeroberfläche möglich.
• Demand Gen-Kampagnen: Wenn Sie Videoanzeigen in Google-Produkten wie YouTube schalten möchten, werden Demand Gen-Kampagnen in der Google Ads API sowohl für die Erstellung als auch für die Verwaltung vollständig unterstützt.

Leistungsdaten abrufen

Sie können Leistungsdaten für Ihre Videokampagnen, Anzeigengruppen und Kriterien mit GoogleAdsService.SearchStream abrufen, indem Sie nach campaign.advertising_channel_type = 'VIDEO' filtern.

Hinweis :Verwenden Sie metrics.video_trueview_views, metrics.video_trueview_view_rate> und metrics.trueview_average_cpv (umbenannt aus den Legacy-Feldern metrics.video_views, metrics.video_view_rate und metrics.average_cpv in v22). Ab v25 können Sie auch segments.ad_sub_format_type (neben segments.ad_format_type) auswählen, um nicht überspringbare In-Stream-Anzeigen nach Dauer aufzuschlüsseln sowie Messwerte für Video-Social-Engagement (metrics.youtube_comments, metrics.youtube_likes und metrics.youtube_shares) zu sehen.

Anzeigengruppen-Leistung

Mit der folgenden Abfrage werden Messwerte für Videokampagnen und ‑anzeigengruppen aus der ad_group-Ressource abgerufen, darunter TrueView-Videoaufrufe und Quartilabschlussraten:

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'

Berichte zur Videoplatzierung und zu Videokriterien

Da ad_group_criterion keine Messwerte oder Segmente direkt unterstützt, verwenden Sie Ressourcen für Kriterienansichten wie managed_placement_view, um Leistungsmesswerte für gezielte YouTube-Videos, YouTube-Kanäle oder andere verwaltete Placements abzurufen:

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