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 sindVideoResponsiveAdInfo-Objekte veränderbar (in früheren Versionen sind sie unveränderlich). Beim Erstellen oder Ändern vonVideoResponsiveAdInfosind die Feldervideos,business_nameundlogo_imageserforderlich.- Markensicherheit und ‑eignung: Ab Version 24 wird
campaign.video_brand_safety_suitabilityauf Kampagnenebene entfernt. Fragen Sie die Markensicherheit und -eignung auf Kontoebene mitcustomer.video_brand_safety_suitabilityab. - Tests für Videokampagnen: Ab v24 ist
experiment.video_experimentfür die Konfiguration vonYOUTUBE_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_plusbismetrics.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 (mitmetrics.unique_users_six_plusbismetrics.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 Ressourcecampaignverfü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 mitsegments.ad_sub_format_type) oder nach Werbenetzwerk (segments.ad_network_type, optional mitsegments.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_typeodersegments.ad_network_type) aus, wenn Sie das zugehörige Untersegment auswählen. Mit dem Segmentsegments.ad_sub_format_typewerden nicht überspringbare In-Stream-Anzeigen nach Dauer aufgeschlüsselt und für andere Anzeigenformate wirdUNSEGMENTEDzurückgegeben. Mit dem Segmentsegments.ad_sub_network_typewerden YouTube-Oberflächen (YOUTUBE_INSTREAM,YOUTUBE_INFEEDundYOUTUBE_SHORTS) nur für Demand Gen-Kampagnen aufgeschlüsselt und für Videokampagnen wirdUNSEGMENTEDzurückgegeben. - Angepasste demografische Segmente: Die Segmente
segments.adjusted_age_rangeundsegments.adjusted_gendersind nur für Konten auf der Zulassungsliste verfügbar, müssen zusammen ausgewählt werden und können nicht mitmetrics.unique_users_*_plus-Messwerten,metrics.unique_users*_info-Feldern oder Werbenetzwerksegmenten kombiniert werden.