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änderbarkeit: Ab v24 sind VideoResponsiveAdInfo-Objekte veränderbar (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 ‑eignung: Ab Version 24 wird campaign.video_brand_safety_suitability auf Kampagnenebene entfernt. Fragen Sie die Markensicherheit und -eignung auf Kontoebene mit customer.video_brand_safety_suitability ab.
  • 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 auf der 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 vollständig unterstützt, sowohl für die Erstellung als auch für die Verwaltung.

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.

Anzeigengruppen-Leistung

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

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 Kriterienansichten 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

Bei Videokampagnen können Sie Unique Reach-Messwerte über die Ressourcen campaign und customer (ab v26) 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. Sie können nicht zeilenübergreifend 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. Dieser Messwert ist nur für die Ressource campaign verfügbar, kann nicht über Zeilen hinweg aggregiert werden und hat kein zugehöriges _info-Feld.

In v26 und höher hat jeder Messwert für die Reichweite einzelner Nutzer 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 Companion-metrics.unique_users*_info-Felder MESSAGE-Messwerte mit filterable: false und sortable: false. Sie können sie daher nicht in WHERE- oder ORDER BY-Klauseln verwenden. Wählen Sie diese Felder direkt in der SELECT-Klausel aus (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 durch die 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 beschreibt, 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 in Metrics nicht festgelegt (was zu 0 führt, wenn das Vorhandensein des Felds nicht geprüft wird). In LOW_QUALITY wird der numerische Messwert jedoch weiterhin ausgefüllt.

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: Die 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 Aufbewahrungsdauer für Reichweitendaten überschreitet.

Mit der folgenden Abfrage werden die Messwerte für die deduplizierte Reichweite über 30 Tage und die entsprechenden Unterdrückungsstatus für Videokampagnen abgerufen, segmentiert nach Gerät und Anzeigenformat. Lassen Sie das Segment segments.date aus der SELECT-Klausel weg, damit die Messwerte für Reichweite und N+ Häufigkeit über den gesamten Zeitraum und nicht pro Tag dedupliziert werden:

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

Unterstützte Ressourcen, Zeiträume und Segmente

Für Abfragen zu Reichweite und Häufigkeit ist ein endlicher segments.date-Filter innerhalb des maximalen Zeitraums des Messwerts erforderlich. Bei Abfragen ohne Datumsfilter oder bei Abfragen, die das Zeitfenster überschreiten, werden nicht festgelegte Reichweitenfelder zurückgegeben:

Messwert Ressourcen Max. Zeitraum Kompatible Segmente
metrics.unique_users campaign, customer (v26 und höher) 92 Tage segments.date, segments.device, Segmente für Anzeigenformate (v26 und höher), Segmente für Werbenetzwerke (v26 und höher) und angepasste demografische Segmente
metrics.average_impression_frequency_per_user campaign 92 Tage segments.date, segments.device und angepasste demografische Segmente
metrics.unique_users_two_plus bis metrics.unique_users_ten_plus campaign, customer (v26 und höher) 31 Tage segments.date, segments.device, Segmente für Anzeigenformate (v26 und höher) und Segmente für Werbenetzwerke (v26 und höher)
metrics.unique_users*_info (v26 und höher) campaign, customer Entspricht dem Basismesswert segments.date, segments.device, Anzeigenformatsegmente und Werbenetzwerksegmente

Wenden Sie beim Segmentieren von Reichweitenabfragen die folgenden gemeinsamen Segmentbeschränkungen an:

  • Segmente für Anzeigenformat im Vergleich zu Werbenetzwerk: Sie können nach Anzeigenformat (segments.ad_format_type, optional mit segments.ad_sub_format_type) oder nach Werbenetzwerk (segments.ad_network_type, optional mit segments.ad_sub_network_type) segmentieren. Sie können jedoch nicht Segmente für Anzeigenformat und Werbenetzwerk in derselben Abfrage kombinieren. Wählen Sie immer das übergeordnete Segment (segments.ad_format_type oder segments.ad_network_type) aus, wenn Sie das zugehörige Untersegment auswählen. Mit dem Segment segments.ad_sub_format_type werden nicht überspringbare In-Stream-Anzeigen nach Dauer aufgeschlüsselt und für andere Anzeigenformate wird UNSEGMENTED zurückgegeben. Mit dem Segment segments.ad_sub_network_type werden YouTube-Oberflächen (YOUTUBE_INSTREAM, YOUTUBE_INFEED und YOUTUBE_SHORTS) nur für Demand Gen-Kampagnen aufgeschlüsselt und für Videokampagnen wird UNSEGMENTED zurückgegeben.
  • Angepasste demografische Segmente: Die Segmente segments.adjusted_age_range und segments.adjusted_gender sind nur für Konten auf der Zulassungsliste verfügbar, müssen zusammen ausgewählt werden und können nicht mit metrics.unique_users_*_plus-Messwerten, metrics.unique_users*_info-Feldern oder Werbenetzwerksegmenten kombiniert werden.