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.

Ansicht „Ausgewählte Placements“

  • Inhalt: Die managed_placement_view Ressource liefert Leistungsdaten, die nach den Placements aggregiert sind, auf die Sie explizit ausgerichtet haben (ausgewählte Placements). Sie spiegelt die Leistung Ihrer Placement-Kriterien wider.
  • Entsprechung auf der Benutzeroberfläche: Inhalt > Placements
  • Query Builder: In Query Builder ansehen

Beispielanfrage

So rufen Sie Leistungsmesswerte für ausgewählte Placements der letzten 30 Tage ab:

SELECT
  campaign.id,
  ad_group.id,
  managed_placement_view.resource_name,
  ad_group_criterion.placement.url,
  metrics.impressions,
  metrics.clicks,
  metrics.cost_micros
FROM managed_placement_view
WHERE segments.date DURING LAST_30_DAYS

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

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.

TargetingSetting-Optionen

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“).

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 der Google Ads Query Language ausschließen möchten, filtern Sie nach dem Feld target_url oder display_name (z. B. WHERE detail_placement_view.target_url IS NOT NULL), da die Felder placement und resource_name nicht filterbar sind.

Performance Max-Kampagne – Placement-Ansicht

Welche Ansicht soll ich verwenden?

  • 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.