Messwerte für Kriterien

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

Google Ads API-Clients müssen die entsprechenden ad_group_criterion- oder campaign_criterion-Felder angeben, wenn kriterienspezifische Daten abgerufen werden müssen. Jede Ansicht wird mit der Kriterienressource verknüpft, die ihrem Targeting-Level entspricht (z. B. keyword_view mit ad_group_criterion und location_view mit campaign_criterion). So 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.

Hinweis :Die Kriterien für *_view-Ressourcen basieren auf Leistungsmesswerten. Für Kriterien, die im angegebenen Zeitraum keine Impressionen erzielt haben, sowie für negative Kriterien (z. B. auszuschließende Keywords oder ausgeschlossene Standorte) werden keine Messwerte generiert. Sie sind daher in diesen Ansichten nicht enthalten.

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 im FROM-Abschnitt an. Verwenden Sie beispielsweise keyword_view in der FROM-Klausel und metrics-Felder in der SELECT-Klausel, um Keyword-Messwerte abzurufen.

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

• ad_group_criterion
• ad_group
• campaign
• customer

Wenn Sie herausfinden möchten, welche Ressourcen auf diese Weise für eine bestimmte Ressource angefordert werden können, sehen Sie auf der zugehörigen Referenzseite in der Zeile Attributed resources (Zugeordnete Ressourcen) nach. Die Ressourcen für keyword_view finden Sie beispielsweise 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 API-Daten mit den Daten in der Benutzeroberfläche abgleichen. Eine ausführlichere Liste der Zuordnungen finden Sie unter Berichte in der Benutzeroberfläche.

Im Folgenden finden Sie einige gängige kriterienbasierte Berichte und ihre typischen UI-Standorte:

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