Videokampagnen

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

API-Limits

Die Google Ads API unterstützt in erster Linie das Abrufen und Erstellen von Berichten zu vorhandenen Videokampagnen, Anzeigengruppen, Anzeigen und Kriterien. Videokampagnen können nicht mit der Google Ads API erstellt oder geändert werden. Es gelten jedoch die folgenden versionsspezifischen Ausnahmen und Verhaltensweisen:

• VideoResponsiveAdInfo-Veränderlichkeit: Ab v24 sind VideoResponsiveAdInfo-Objekte veränderlich (in früheren Versionen sind sie unveränderlich). Beim Erstellen oder Ändern von VideoResponsiveAdInfo sind die Felder videos, business_name und logo_images erforderlich.
• Markensicherheit und Markeneignung: Ab v24 wird die campaign.video_brand_safety_suitability auf Kampagnenebene entfernt. Mit customer.video_brand_safety_suitability können Sie die Markensicherheit und -eignung auf Kontoebene abfragen.
• Tests für Videokampagnen: Ab v24 ist experiment.video_experiment für die Konfiguration von YOUTUBE_CUSTOM-Tests mit Videokampagnen verfügbar.

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-Oberflä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 für TrueView-Aufruf-Messwerte. 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 das soziale Engagement bei Videos (metrics.youtube_comments, metrics.youtube_likes und metrics.youtube_shares).

Anzeigengruppen-Leistung

Mit der folgenden Abfrage werden Messwerte für Videokampagnen und Anzeigengruppen aus der Ressource ad_group abgerufen, einschließlich TrueView-Videoaufrufen und Quartilsabschlussraten:

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 zu Videoplatzierungen und -kriterien

Da ad_group_criterion Messwerte oder Segmente nicht direkt unterstützt, müssen Sie Ressourcen für die Kriterienansicht wie managed_placement_view verwenden, um Leistungsmesswerte für YouTube-Videos, YouTube-Kanäle oder andere ausgewählte 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

Berichte zu Reichweite und Häufigkeit von Kampagnen

Bei Videokampagnen können Sie Unique Reach-Messwerte in der Ressource campaign abfragen, um die Anzahl der einzelnen Nutzer zu ermitteln, denen Ihre Anzeigen mit bestimmten Impressionshäufigkeiten präsentiert wurden.

Mit den folgenden Messwerten für einzelne Nutzer wird die Zielgruppenreichweite über Häufigkeitsgruppen hinweg gemessen:

• metrics.unique_users: Die Anzahl der einzelnen Nutzer, die Ihre Anzeige im ausgewählten Zeitraum (bis zu 92 Tage) mindestens einmal gesehen haben. Er kann nicht über Zeilen hinweg aggregiert werden.
• metrics.unique_users_two_plus bis metrics.unique_users_ten_plus: Die Anzahl der einzelnen Nutzer, die Ihre Anzeige mindestens 2 bis 10 Mal gesehen haben, für Zeiträume von bis zu 31 Tagen (mit metrics.unique_users_six_plus bis metrics.unique_users_nine_plus, um die Gruppe von 2+ bis 10+ in v26 und höher zu vervollständigen).
• metrics.average_impression_frequency_per_user: Die durchschnittliche Häufigkeit, mit der ein einzelner Nutzer Ihre Anzeige im angeforderten Zeitraum (bis zu 92 Tage) gesehen hat. Sie kann nicht über Zeilen hinweg aggregiert werden und hat kein zugehöriges _info-Feld.

In v26 und höher hat jeder Reichweiten-Messwert ein zugehöriges Metadatenfeld vom Typ ReachMetricInfo: metrics.unique_users_info und metrics.unique_users_two_plus_info bis metrics.unique_users_ten_plus_info.

In der Google Ads Query Language (GAQL) sind Felder für die Companion-Reichweite MESSAGE-Messwerte, die direkt in der SELECT-Klausel ausgewählt werden (z. B. metrics.unique_users_info). Hängen Sie .reach_metric_states nicht in der SELECT-Klausel an, da die Auswahl verschachtelter Nachrichtenfelder in GAQL mit UNRECOGNIZED_FIELD fehlschlägt. Stattdessen wird bei Auswahl von metrics.unique_users_info eine ReachMetricInfo-Nachricht zurückgegeben, die das wiederholte Enum-Feld reach_metric_states vom Typ ReachMetricState enthält, das angibt, ob der Messwert unterdrückt wurde oder vollständig ist.

Wenn ein Reichweiten-Messwert unterdrückt wird oder außerhalb des Aufbewahrungszeitraums (PRIVACY_SUPPRESSION, QUALITY_SUPPRESSION oder DATE_RANGE_BEYOND_RETENTION) liegt, wird das Feld optional int64 für Metrics nicht festgelegt (was zu 0 führt, wenn das Vorhandensein des Felds nicht geprüft wird). LOW_QUALITY füllt den numerischen Messwert jedoch weiterhin aus.

Die ReachMetricState-Enum-Werte geben den Status der Reichweitendaten an:

• COMPLETE: Der Reichweiten-Messwert ist vollständig und wurde nicht aufgrund von Datenschutz-, Qualitäts- oder anderen Einschränkungen unterdrückt.
• PRIVACY_SUPPRESSION: Reichweitendaten wurden aus Datenschutzgründen unterdrückt (z. B. wenn das Zielgruppenvolumen die Schwellenwerte für k-Anonymität nicht erreicht).
• QUALITY_SUPPRESSION: Reichweitendaten wurden aufgrund von Anforderungen an die Datenqualität unterdrückt.
• LOW_QUALITY: Der Reichweiten-Messwert wurde berechnet, aber als von geringer Qualität gekennzeichnet.
• DATE_RANGE_BEYOND_RETENTION: Die Messwerte für die Reichweite sind nicht verfügbar, da der ausgewählte Zeitraum die 3-jährige Datenaufbewahrungsdauer für Reichweitendaten überschreitet.

Mit der folgenden Abfrage werden Reichweitenmesswerte und ihre Unterdrückungsstatus für eine Videokampagne abgerufen:

SELECT
  campaign.id,
  campaign.name,
  segments.date,
  segments.device,
  metrics.unique_users,
  metrics.unique_users_info,
  metrics.average_impression_frequency_per_user,
  metrics.unique_users_two_plus,
  metrics.unique_users_two_plus_info,
  metrics.unique_users_three_plus,
  metrics.unique_users_three_plus_info,
  metrics.unique_users_four_plus,
  metrics.unique_users_four_plus_info,
  metrics.unique_users_five_plus,
  metrics.unique_users_five_plus_info,
  metrics.unique_users_six_plus,
  metrics.unique_users_six_plus_info,
  metrics.unique_users_seven_plus,
  metrics.unique_users_seven_plus_info,
  metrics.unique_users_eight_plus,
  metrics.unique_users_eight_plus_info,
  metrics.unique_users_nine_plus,
  metrics.unique_users_nine_plus_info,
  metrics.unique_users_ten_plus,
  metrics.unique_users_ten_plus_info
FROM campaign
WHERE campaign.advertising_channel_type = 'VIDEO'
  AND segments.date BETWEEN '2026-01-01' AND '2026-01-31'

Hinweis : Messwerte zu Reichweite und Häufigkeit können nicht zeilenübergreifend aggregiert werden. metrics.unique_users und metrics.average_impression_frequency_per_user unterstützen Zeiträume von bis zu 92 Tagen und können nach segments.date, segments.device, segments.adjusted_age_range und segments.adjusted_gender segmentiert werden. Die Messwerte für die Häufigkeitsgruppe unique_users_*_plus (bis zu 31 Tage) und alle zugehörigen metrics.unique_users*_info-Felder unterstützen jedoch nur segments.date und segments.device. Außerdem sind die zugehörigen metrics.unique_users*_info-Felder MESSAGE-Messwerte mit filterable: false und sortable: false und können daher nicht in WHERE- oder ORDER BY-Klauseln verwendet werden. Weitere Informationen zum Umgang mit unterdrückten Reichweiten-Messwerten in Berichten finden Sie unter Unterdrückung von Reichweiten-Messwerten und Nullwerte.