Anzeigen-Placement und ‑Leistung erfassen

Die Google Ads API bietet mehrere Ansichten, mit denen Sie analysieren können, wo Ihre Anzeigen ausgeliefert wurden und wie sie abschneiden: managed_placement_view, group_placement_view, detail_placement_view und performance_max_placement_view. Jede Ansicht bietet eine andere Perspektive auf Ihre Placement-Daten. Im Query Cookbook finden Sie sofort ausführbare GAQL- (Google Ads Query Language) und curl-Abfragen, mit denen Sie die Placement-Bildschirme in der Google Ads-Benutzeroberfläche nachbilden können.

Ansicht „Ausgewählte Placements“

  • Inhalt: Die Ressource managed_placement_view liefert Leistungsdaten, die nach den positiven Placement-Kriterien aggregiert sind, auf die Sie in Ihren Anzeigengruppen ausgerichtet sind. Diese Ansicht umfasst alle fünf Kriterientypen, die in der Google Ads-Benutzeroberfläche unter Inhalt > Placements verwaltet werden: Websites, YouTube-Kanäle, YouTube-Videos, mobile Apps und App-Kategorien.
  • Entsprechung auf der Benutzeroberfläche: Inhalt > Placements
  • Query Builder: In Query Builder ansehen

Kriteriumstypen für ausgewählte Placements

In jeder Zeile der Ressource managed_placement_view wird das Feld AdGroupCriterion ausgefüllt, das dem Wert ad_group_criterion.type entspricht. Die anderen Platzierungsfelder bleiben leer:

Platzierungstyp auf der Benutzeroberfläche ad_group_criterion.type Wert Felder für Kriteriumsdetails Hinweise
Websites PLACEMENT ad_group_criterion.placement.url URL der Zielwebsite oder ‑domain.
YouTube-Kanäle YOUTUBE_CHANNEL ad_group_criterion.youtube_channel.channel_id YouTube-Kanal-ID. Das Feld ad_group_criterion.display_name gibt den Kanalnamen zurück.
YouTube-Videos YOUTUBE_VIDEO ad_group_criterion.youtube_video.video_id YouTube-Video-ID. Das Feld ad_group_criterion.display_name gibt den Videotitel zurück.
Apps MOBILE_APPLICATION ad_group_criterion.mobile_application.app_id, ad_group_criterion.mobile_application.name App-ID im Format {platform}-{platform_native_id} (1- für iOS, 2- für Android) und App-Name.
App-Kategorien MOBILE_APP_CATEGORY ad_group_criterion.mobile_app_category.mobile_app_category_constant Ressourcenname im Format mobileAppCategoryConstants/{mobile_app_category_id}. Siehe Namen und Hierarchie von App-Kategorien.

Beispielanfrage

Wenn Sie Leistungsmesswerte für alle ausgewählten Placement-Typen der letzten 30 Tage abrufen möchten, wählen Sie das Feld ad_group_criterion.type zusammen mit den typspezifischen Feldern aus:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.criterion_id,
  ad_group_criterion.type,
  ad_group_criterion.display_name,
  ad_group_criterion.placement.url,
  ad_group_criterion.youtube_channel.channel_id,
  ad_group_criterion.youtube_video.video_id,
  ad_group_criterion.mobile_application.app_id,
  ad_group_criterion.mobile_application.name,
  ad_group_criterion.mobile_app_category.mobile_app_category_constant,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

Namen und Hierarchie von App-Kategorien

In der Google Ads-Benutzeroberfläche wird für die ausgewählten App-Kategorien der vollständige Store-Pfad angezeigt, z. B. App-Kategorien > Apple App Store > Bildung. Beachten Sie beim Abfragen der Google Ads API Folgendes:

  • Konstanten für App-Kategorien zuordnen: Die Ressource mobile_app_category_constant ist keine zugeordnete Ressource der Ressource managed_placement_view. Wählen Sie stattdessen das Feld ad_group_criterion.mobile_app_category.mobile_app_category_constant aus (z. B. mobileAppCategoryConstants/60503) oder fragen Sie die Ressource ad_group_criterion ab, wenn Sie keine Messwerte benötigen.
  • Anzeigenamen nur für Blätter: In den Feldern ad_group_criterion.display_name und mobile_app_category_constant.name wird nur der Name der Blattkategorie zurückgegeben, z. B. "Education" oder "Games". Keines der Felder enthält den übergeordneten App-Shop-Pfad.
  • App-Shop-Pfad auflösen: Google Play und der Apple App Store verwenden für unterschiedliche Kriterien-IDs dieselben Namen für die untersten Kategorien. Beispiel: Für die Kriterien-IDs 60005 (/All Apps/Google Play/Education), 60060 (/All Apps/Google Play/Family/Education) und 60503 (/All Apps/Apple App Store/Education) wird in den Feldern name und display_name jeweils "Education" zurückgegeben. Extrahieren Sie das Suffix {mobile_app_category_id} aus dem Ressourcennamen und suchen Sie den vollständigen Hierarchiepfad in der Tabelle oder CSV-Datei Mobile app categories.

Ansicht für Gruppen-Placement

  • Inhalt: Die Ressource group_placement_view zeigt, wo Ihre Anzeigen im Displaynetzwerk und auf YouTube tatsächlich ausgeliefert wurden, unabhängig davon, ob die Placements explizit ausgerichtet oder automatisch vom Google-System erkannt wurden. Dazu gehören Websites, YouTube-Kanäle oder -Videos und Apps.
  • Entsprechung auf der Benutzeroberfläche: Inhalt > Wo Anzeigen ausgeliefert wurden
  • Query Builder: In Query Builder ansehen

Beispielanfrage

Mit der folgenden Abfrage werden Leistungsmesswerte für Domains, mobile Apps und YouTube-Kanäle abgerufen, in denen in den letzten 30 Tagen Anzeigen ausgeliefert wurden:

SELECT
  campaign.id,
  ad_group.id,
  group_placement_view.display_name,
  group_placement_view.target_url,
  group_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM group_placement_view
WHERE segments.date DURING LAST_30_DAYS

Zeile „Gesamt: Sonstige“

Um die Berichterstellung zu beschleunigen, werden in den Ressourcen group_placement_view und detail_placement_view einzelne Placements ausgeschlossen, die einen Mindestaktivitätsschwellenwert für Impressionen oder Interaktionen nicht erreichen.

  • In der Google Ads-Benutzeroberfläche: Placements, die diesen Aktivitätsschwellenwert nicht erreichen, werden in einer Zusammenfassungszeile mit der Bezeichnung Gesamt: Sonstige zusammengefasst.
  • In der Google Ads API: Placements, die den Aktivitätsgrenzwert nicht erreichen, werden in den Berichtsergebnissen nicht berücksichtigt. Außerdem wird keine Zusammenfassungszeile zurückgegeben, in der das Feld group_placement_view.placement oder detail_placement_view.placement den Wert "Other" hat.

Daher ist die Summe der einzelnen Placement-Zeilen in den Ressourcen group_placement_view und detail_placement_view möglicherweise niedriger als die Gesamtmesswerte für die Anzeigengruppe oder Kampagne. Weitere Informationen finden Sie unter Bericht „Wo Anzeigen ausgeliefert wurden“. Weitere Informationen dazu, wie sich Grenzwerte und fehlende Metadaten auf Vergleiche zwischen Ansichten auswirken, finden Sie unter Messwertunterschiede zwischen Platzierungsansichten und Zeilen mit nicht verfügbaren Platzierungsdetails.

Einstellungen für das Placement-Targeting

Das Verhalten und der Nutzen von group_placement_view werden durch die TargetingSetting für die Dimension PLACEMENT auf Anzeigengruppenebene beeinflusst. Diese Einstellung enthält eine Liste von target_restrictions, jeweils mit einem booleschen Feld bid_only, das festlegt, ob Ihre Anzeigen nur auf ausgewählten Placements oder auch auf anderen Placements ausgeliefert werden. Weitere Informationen zu den Einstellungen „Ausrichtung“ und „Beobachtung“

  • bid_only = false: Dieser Wert entspricht Ausrichtung in der Google Ads-Benutzeroberfläche für Placements. Wenn für Ihre Anzeigengruppe „Ausrichtung“ festgelegt ist, werden Ihre Anzeigen nur auf den Placements ausgeliefert, die Sie explizit als Kriterien hinzugefügt haben. Sie können Gebotsanpassungen für diese Placements festlegen. In diesem Szenario entspricht group_placement_view weitgehend managed_placement_view, unterliegt aber weiterhin den Mindestaktivitätsschwellenwerten.
  • bid_only = true: Dieser Wert entspricht Beobachtung in der Google Ads-Benutzeroberfläche für Placements. Wenn für Ihre Anzeigengruppe „Beobachtung“ festgelegt ist, können Ihre Anzeigen auf allen infrage kommenden Placements im Displaynetzwerk und auf YouTube ausgeliefert werden. Sie können auch Gebotsanpassungen für alle Placements anwenden, auf die Sie Ihre Anzeigen ausgerichtet haben. In diesem Fall ist group_placement_view entscheidend, um neue Placements zu finden, in denen Ihre Anzeigen ausgeliefert werden. Diese können Sie dann als ausgewählte Placements oder Ausschlüsse hinzufügen.

Detailansicht für Placements

  • Inhalt: Die Ressource detail_placement_view bietet eine detailliertere Aufschlüsselung der Placements, die über die Domain- oder Kanalebene hinausgeht. Beispielsweise können bestimmte URLs oder YouTube-Video-IDs angezeigt werden, bei denen Ihre Anzeigen ausgeliefert wurden.
  • Entsprechung in der Benutzeroberfläche: Entspricht der Auswahl von Zeilen unter Inhalte > Wo Anzeigen ausgeliefert wurden und dem anschließenden Klicken auf Details ansehen.
  • Query Builder: In Query Builder ansehen
  • Wichtige Hinweise: Ähnlich wie bei der Ressource group_placement_view werden in dieser Ansicht Placements mit geringer Aktivität, die die Mindestaktivitätsschwellen nicht erreichen, weggelassen (siehe Abschnitt Zeile „Gesamt: Sonstige“).

Beispielanfrage

Um die Anzahl der Ergebnisse zu begrenzen, werden mit der folgenden Abfrage Placement-Messwerte auf URL- und Videoebene für einen Zeitraum von 7 Tagen abgerufen. Bei großen Konten können Sie weiter nach dem Feld campaign.id oder ad_group.id filtern:

SELECT
  campaign.id,
  ad_group.id,
  detail_placement_view.display_name,
  detail_placement_view.target_url,
  detail_placement_view.group_placement_target_url,
  detail_placement_view.placement_type,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM detail_placement_view
WHERE segments.date DURING LAST_7_DAYS

Wenn Sie Zeilen ausschließen möchten, für die keine Platzierungsmetadaten verfügbar sind, fügen Sie AND detail_placement_view.target_url IS NOT NULL hinzu (siehe Zeilen mit nicht verfügbaren Platzierungsdetails). Wenn Sie keine zurückgegebenen resource_name-Felder benötigen, hängen Sie die PARAMETERS omit_unselected_resource_names = true-Klausel an.

Messwertunterschiede zwischen Placement-Ansichten

Der Mindestaktivitätsschwellenwert wird auf jeder Granularitätsebene unabhängig ausgewertet:

  • Die Ressource group_placement_view wertet den Grenzwert für die aggregierte Domain, mobile App oder den YouTube-Kanal aus.
  • Die Ressource detail_placement_view wertet den Grenzwert für jede einzelne Seiten-URL oder jedes YouTube-Video separat aus.

In der Ressource detail_placement_view werden einzelne Seiten-URLs oder YouTube-Videos, die den Grenzwert nicht erreichen, weggelassen. Wenn Sie also detail_placement_view-Zeilen für eine Domain oder einen YouTube-Kanal (gefiltert nach dem Feld detail_placement_view.group_placement_target_url) addieren, kann das zu weniger Impressionen führen als die entsprechende group_placement_view-Zeile.

Zeilen mit nicht verfügbaren Placement-Details

Eine Abfrage der Ressource group_placement_view oder detail_placement_view kann mehrere Zeilen in derselben Anzeigengruppe mit nicht festgelegten Feldern placement, display_name und target_url und einem identischen resource_name-Wert (z. B. mit der Endung ~MTRf) zurückgeben.

Dieses Verhalten tritt aus folgenden Gründen auf:

  • Interne Placement-Gruppierung: In beiden Ansichten werden Leistungsmesswerte nach einer eindeutigen internen Placement-ID gruppiert, nicht nach den Stringfeldern resource_name oder placement.
  • Nicht verfügbare Placement-Metadaten: In der Google Ads-Benutzeroberfläche werden Placements ohne Metadaten in Backend-Suchtabellen als Unbekannt, Kanal nicht mehr verfügbar oder Video nicht mehr verfügbar angezeigt. In der API wird für jede eindeutige Placement-ID weiterhin eine Messwertzeile zurückgegeben, wobei die Felder placement, display_name und target_url nicht festgelegt sind.
  • Synthetisierte Ressourcennamen: Das Suffix {base64_placement} im Feld resource_name ist Base64-codiert aus {type_id}_{placement}, wobei {type_id} eine interne Kennung für den Platzierungstyp und nicht die Enum-Nummer PlacementType ist. Wenn das Feld placement_type den Wert WEBSITE (interne ID 14) hat und das Feld placement nicht festgelegt ist, wird der String "14_" als MTRf codiert. Entsprechend wird MOBILE_APPLICATION als "55_" zu NTVf, YOUTUBE_VIDEO als "89_" zu ODlf und YOUTUBE_CHANNEL als "90_" zu OTBf codiert. Mehrere Placements desselben Typs mit nicht verfügbaren Metadaten in derselben Anzeigengruppe haben daher denselben resource_name-Wert, während separate Messwertzeilen gemeldet werden.

Wenn Sie group_placement_view- oder detail_placement_view-Ergebnisse im Clientcode verarbeiten, sollten Sie Zeilen nicht nur anhand des Felds resource_name deduplizieren. Andernfalls können Messwerte für verschiedene Placements mit nicht verfügbaren Metadaten überschrieben werden. Wenn Sie Zeilen mit nicht verfügbaren Metadaten in GAQL ausschließen möchten, filtern Sie nach dem Feld target_url oder display_name, da die Felder placement und resource_name nicht filterbar sind. Verwenden Sie zum Beispiel WHERE group_placement_view.target_url IS NOT NULL oder WHERE detail_placement_view.target_url IS NOT NULL.

Performance Max-Kampagne – Placement-Ansicht

  • Inhalt: Die Ressource performance_max_placement_view liefert Impressionsdaten (metrics.impressions) für Placements, auf denen Anzeigen aus Performance Max-Kampagnen ausgeliefert wurden. In v24 und höher können Sie performance_max_placement_view nach segments.ad_network_type segmentieren (in v23 nicht unterstützt).
  • Entsprechung in der Benutzeroberfläche: Statistiken und Berichte > Berichtseditor > Placement der Performance Max-Kampagnen
  • Query Builder: In Query Builder ansehen

Beispielanfrage

Mit der folgenden Abfrage werden Placement-Impressionen für Performance Max-Kampagnen der letzten 30 Tage abgerufen, segmentiert nach Werbenetzwerktyp:

SELECT
  campaign.id,
  performance_max_placement_view.display_name,
  performance_max_placement_view.target_url,
  performance_max_placement_view.placement_type,
  segments.ad_network_type,
  metrics.impressions
FROM performance_max_placement_view
WHERE segments.date DURING LAST_30_DAYS

Placement-Ansicht auswählen

  • Mit managed_placement_view können Sie die Leistung von Placements bewerten, auf die Sie aktiv ausgerichtet sind und auf die Sie Gebote abgeben.
  • Verwenden Sie group_placement_view, um sich einen Überblick darüber zu verschaffen, wo Ihre Anzeigen ausgeliefert werden. Das ist besonders nützlich, wenn Sie die Einstellung „Beobachtung“ verwenden, um neue Targeting-Möglichkeiten oder Ausschlüsse zu finden.
  • Mit detail_placement_view erhalten Sie die detailliertesten Informationen zu bestimmten URLs oder Videos, in denen Ihre Anzeigen ausgeliefert wurden. Diese Option wird häufig verwendet, nachdem eine relevante Domain oder ein relevanter Kanal in group_placement_view identifiziert wurde.
  • Verwenden Sie performance_max_placement_view, um die Placement-Impressionen für Performance Max-Kampagnen zu prüfen.