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 die entsprechenden ad_group_criterion- oder campaign_criterion-Felder angeben, wenn kriterienbezogene Daten abgerufen werden sollen.
Jede Ansicht wird mit der Kriterienressource verknüpft, die ihrer Targeting-Ebene entspricht. Beispielsweise wird keyword_view mit ad_group_criterion verknüpft, während location_view mit campaign_criterion verknüpft wird. Dadurch können Google Ads API-Clients ad_group_criterion- oder campaign_criterion-Felder und die *_view-Ressource in derselben Anfrage an die Methode GoogleAdsService.SearchStream anfordern.
Beispiel für eine Abfrageanfrage
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 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 für keyword_view auswählen, können Sie Felder aus allen folgenden Ressourcen anfordern:
ad_group_criterionad_groupcampaigncustomer
Informationen zu den Ressourcen, die auf diese Weise für eine bestimmte Ressource angefordert werden können, finden Sie auf der Referenzseite in der Zeile Attributierte Ressourcen. Beispiel: Für keyword_view finden Sie die Ressourcen auf der Referenzseite.
Zuordnung zur Benutzeroberfläche
Jeder Kriterienbericht entspricht einer bestimmten Ansicht in der Google Ads-Benutzeroberfläche. Wenn Sie diese zuordnen, können Sie die API-Daten mit den Daten in der Benutzeroberfläche abgleichen. Eine umfangreichere Liste mit Zuordnungen finden Sie unter Berichte in der Benutzeroberfläche.
Im Folgenden finden Sie einige gängige kriterienbasierte Berichte und ihre typischen Speicherorte in der Benutzeroberfläche:
- Kampagnen > Zielgruppen, Keywords und Inhalt > Keywords für Suchanzeigen: Gibt Daten zurück, die
keyword_viewentsprechen. - Kampagnen > Zielgruppen, Keywords und Inhalte > Zielgruppen > Demografische Merkmale:
Gibt Daten zurück, die
age_range_viewundgender_viewentsprechen. - Kampagnen > Standorte: Gibt Daten zurück, die
location_viewentsprechen.