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_criterionad_groupcampaigncustomer
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_viewentsprechen. - Kampagnen > Zielgruppen, Keywords und Inhalt > Zielgruppen > Demografische Merkmale:
Gibt Daten zurück, die
age_range_viewundgender_viewentsprechen. - Kampagnen > Standorte: Gibt Daten zurück, die
location_viewentsprechen.