Search Ads 360-Abfragesprache

Mit der Search Ads 360-Abfragesprache können Sie Suchanfragen erstellen, um Berichtsdaten und Ressourcenmetadaten mithilfe der Search Ads 360 Reporting API abzurufen.

Suchdienste

Sie können die Search Ads 360-Abfragesprache verwenden, um die API mit folgenden Methoden abzufragen:

SearchAds360Service

Mit diesem Dienst können Sie Ressourcen und zugehörige Attribute, Segmente und Messwerte abfragen. Es gibt zwei Methoden: Search und SearchStream.

SearchAds360Service-Abfragen geben eine Liste von SearchAds360Row-Instanzen zurück:

  • Jede Zeile steht für eine Ressource.
  • Auf Wunsch enthalten Zeilen Attribute und Messwertfelder.
  • Wenn Sie Segmente anfordern, werden für jedes Segment/Ressourcen-Tupel zusätzliche Zeilen eingefügt.

Weitere Informationen finden Sie unter Suchberichte erstellen.

SearchAds360FieldService

Mit diesem Dienst können Sie Metadaten zu verfügbaren Feldern und Ressourcen abfragen. Der Dienst bietet einen Katalog mit abfragbaren Feldern mit Details zu ihrer Kompatibilität und ihrem Typ.

SearchAds360FieldService gibt eine Liste von SearchAds360Field-Instanzen zurück:

  • Jedes Feld enthält Details zum angeforderten Feld.

Weitere Informationen finden Sie unter Ressourcenmetadaten abrufen.

Einfache Abfragebeispiele

In den folgenden Abschnitten finden Sie einfache Abfragebeispiele, die Sie an Ihre eigenen Anforderungen anpassen können.

Attribute einer Ressource abfragen

Dies ist eine einfache Abfrage nach Attributen der campaign-Ressource, die die Kampagnen-ID, den Namen und den Status zurückgibt:

SELECT
  campaign.id,
  campaign.name,
  campaign.status
FROM campaign
ORDER BY campaign.id
  • Jede zurückgegebene SearchAds360Row steht für ein campaign-Objekt.
  • Die Zeilen werden mit den ausgewählten Feldern ausgefüllt, einschließlich der resource_name der jeweiligen Kampagne.
  • Die Abfrage wird nach Kampagnen-ID sortiert.

Unter campaign finden Sie weitere Felder, die Sie in Ihren Abfragen verwenden können.

Messwerte abfragen

Das ist eine einfache Abfrage für Messwerte, die sich auf Attribute der campaign-Ressource beziehen:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
ORDER BY campaign.id
  • Die Abfrage gibt Kampagnen mit dem Status PAUSED und mehr als 1.000 Impressionen zurück.
  • Jede zurückgegebene SearchAds360Row enthält ein Feld metrics, das mit den ausgewählten Messwerten ausgefüllt ist.
  • Die Abfrage wird nach Kampagnen-ID sortiert.

Unter metrics finden Sie weitere Messwerte, die Sie in Ihren Abfragen verwenden können.

Segmente abfragen

Das ist eine einfache Abfrage für Segmente, die sich auf Attribute der campaign-Ressource beziehen:

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.impressions,
  segments.date,
FROM campaign
WHERE campaign.status = 'PAUSED'
  AND metrics.impressions > 1000
  AND segments.date during LAST_30_DAYS
ORDER BY campaign.id
  • Die Abfrage gibt Kampagnen mit dem Status PAUSED und mehr als 1.000 Impressionen zurück.
  • Die Daten werden nach Datum segmentiert.
  • Durch die Segmentierung stellt jede SearchAds360Row ein Tupel aus einer Kampagne und dem Datumssegment dar.
  • Die Abfrage wird nach Kampagnen-ID sortiert.

Unter segments finden Sie eine Liste der Segmente, die Sie in Ihren Abfragen verwenden können. Weitere Informationen zur Segmentierung Ihrer Berichte finden Sie unter Segmentierung.

Dies ist eine einfache Abfrage auf der campaign-Ressource, bei der Attribute der bidding_strategy-Ressource zusammengeführt werden, sofern verfügbar. Diese Art von zugehöriger Ressource wird als zugeordnete Ressource bezeichnet.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • In der Abfrage werden Kampagnenattribute und zugehörige Attribute aus jeder ausgewählten Kampagne ausgewählt.
  • Jede zurückgegebene SearchAds360Row stellt ein campaign-Objekt dar, das mit den ausgewählten Kampagnenattributen sowie dem ausgewählten Gebotsstrategieattribut bidding_strategy.name ausgefüllt ist.

Unter campaign sehen Sie, welche zugeordneten Ressourcen für Kampagnenabfragen verfügbar sind.

Feldmetadaten abfragen

Mit SearchAds360FieldService können Sie Feldmetadaten abrufen.

Das ist eine einfache Abfrage für Feldmetadaten:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Ersetzen Sie RESSOURCE ODER FELD durch eine Ressource (z. B. customer oder campaign) oder ein Feld (z. B. campaign.id, metrics.impressions oder ad_group.id).

Weitere Informationen zum Abrufen von Feldmetadaten finden Sie unter Ressourcenmetadaten abrufen.

Weitere Informationen

Weitere Informationen zum Erstellen von Abfragen in der Search Ads 360 Reporting API: