Kriterienmesswerte

In der Google Ads API wird jeder Kriterienbericht durch eine separate Ressource dargestellt. Sofern nicht anders erforderlich, enthalten *_view-Ressourcen nur ein resource_name-Feld.

Google Ads API-Clients müssen entsprechende ad_group_criterion- oder campaign_criterion-Felder angeben, wenn kriterienbezogene Daten abgerufen werden sollen. So können Google Ads API-Clients ad_group_criterion oder campaign_criterion Felder und die *_view Ressource in derselben Anfrage an die GoogleAdsService.SearchStream Methode anfordern.

Beispielanfrage

SELECT
  ad_group_criterion.keyword.text,
  ad_group.name,
  campaign.name,
  metrics.impressions,
  metrics.clicks,
  metrics.ctr,
  metrics.average_cpc
FROM keyword_view
WHERE segments.date DURING LAST_30_DAYS

Wenn Sie Leistungsdaten (Messwerte) für einen bestimmten Kriterientyp abrufen möchten, geben Sie die entsprechende Ansichtsressource in der FROM-Klausel an. Verwenden Sie beispielsweise keyword_view in der FROM-Klausel und einige metrics-Felder in der SELECT-Klausel, um Keyword-Messwerte abzurufen.

Sie können Felder aus übergeordneten Ressourcen bis hin zu customer aus einer Kriterienansicht auswählen. Wenn Sie beispielsweise FROM die keyword_view auswählen, können Sie Felder aus allen folgenden Ressourcen anfordern:

  • ad_group_criterion
  • ad_group
  • campaign
  • customer

Die Ressourcen, die auf diese Weise für eine bestimmte Ressource angefordert werden können, finden Sie in der Zeile Attributressourcen auf der Referenzseite. Zum Beispiel finden Sie die Ressourcen für keyword_view auf der Referenz seite.

Zuordnung zur Benutzeroberfläche

Jeder Kriterienbericht entspricht einer bestimmten Ansicht in der Google Ads-Benutzeroberfläche. Wenn Sie diese zuordnen, können Sie API-Daten mit den Daten auf der Benutzeroberfläche abgleichen. Eine größere Liste mit Zuordnungen finden Sie unter Berichte auf der Benutzeroberfläche.

Im Folgenden finden Sie einige häufige kriterienbasierte Berichte und die entsprechenden Stellen auf der Benutzeroberfläche:

  • Kampagnen > Zielgruppen, Keywords und Inhalt > Keywords für Suchanzeigen: Gibt Daten zurück, die keyword_view entsprechen.
  • Kampagnen > Zielgruppen, Keywords und Inhalt > Zielgruppen > Demografische Merkmale: Gibt Daten zurück, die age_range_view und gender_view entsprechen.
  • Kampagnen > Standorte: Gibt Daten zurück, die location_view entsprechen.