Search Ads 360-Abfragesprache

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

Suchdienste

Sie können die Search Ads 360 Query Language verwenden, um die API wie folgt abzufragen:

SearchAds360Service

Verwenden Sie diesen Dienst, um Ressourcen und die zugehörigen Attribute, Segmente und Messwerte abzufragen. Es gibt zwei Methoden: Search und SearchStream.

Bei SearchAds360Service-Abfragen wird eine Liste mit SearchAds360Row-Instanzen zurückgegeben:

  • Jede Zeile steht für eine Ressource.
  • Falls angefordert, enthalten die Zeilen Attribute und Messwertfelder.
  • Wenn Sie Segmente anfordern, werden zusätzliche Zeilen für jedes Tupel der Segmentressourcen eingeschlossen.

Weitere Informationen finden Sie unter Suchberichte erstellen.

SearchAds360FieldService

Verwenden Sie diesen Dienst, um Metadaten zu verfügbaren Feldern und Ressourcen abzufragen. Der Dienst bietet einen Katalog abfragbarer Felder mit Angaben zu ihrer Kompatibilität und ihrem Typ.

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

  • Jedes Feld enthält Details zum angeforderten Feld.

Weitere Informationen finden Sie unter Ressourcenmetadaten abrufen.

Einfache Abfragebeispiele

Die folgenden Abschnitte enthalten grundlegende Abfragebeispiele, die Sie für Ihre eigenen Abfragen anpassen können.

Attribute einer Ressource abfragen

Dies ist eine einfache Abfrage von 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
  • Jedes zurückgegebene SearchAds360Row-Objekt steht für ein campaign-Objekt.
  • Die Zeilen werden mit den ausgewählten Feldern gefüllt (einschließlich resource_name der angegebenen Kampagne).
  • Die Abfrage sortiert nach Kampagnen-ID.

Unter campaign finden Sie andere verfügbare Felder, die Sie in Ihren Abfragen verwenden können.

Messwerte abfragen

Dies ist eine einfache Abfrage von Messwerten, die mit Attributen der campaign-Ressource zusammenhängen:

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.
  • Für jedes zurückgegebene SearchAds360Row-Objekt wird ein metrics-Feld mit den ausgewählten Messwerten verwendet.
  • Die Abfrage sortiert nach Kampagnen-ID.

Unter metrics finden Sie andere verfügbare Messwerte, die Sie in Ihren Abfragen verwenden können.

Segmente abfragen

Dies 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.
  • Aufgrund der Segmentierung stellt jeder SearchAds360Row ein Tupel einer Kampagne und des Datumssegments dar.
  • Die Abfrage sortiert nach Kampagnen-ID.

Unter segments finden Sie eine Liste der Segmente, die Sie in Ihren Abfragen verwenden können. Segmentierung finden Sie weitere Informationen zum Segmentieren von Berichten.

Dies ist eine einfache Abfrage der Ressource campaign, mit der Attribute der Ressource bidding_strategy zusammengeführt werden, sofern verfügbar. Diese Art von verwandter Ressource wird als zugeordnete Ressource bezeichnet.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id
  • Mit der Abfrage werden die Kampagnenattribute und zugehörigen Attribute aus jeder ausgewählten Kampagne ausgewählt.
  • Jedes zurückgegebene SearchAds360Row-Objekt steht für ein campaign-Objekt mit den ausgewählten Kampagnenattributen und dem ausgewählten Gebotsstrategieattribut (bidding_strategy.name).

Unter campaign finden Sie Informationen dazu, welche zugeordneten Ressourcen für Kampagnenabfragen verfügbar sind.

Feldmetadaten abfragen

Mit SearchAds360FieldService können Sie Feldmetadaten abrufen.

Dies ist eine einfache Abfrage von Feldmetadaten:

SELECT
  name,
  category,
  selectable,
  filterable,
  sortable,
  selectable_with,
  data_type,
  is_repeated
WHERE name = RESOURCE/FIELD
  • Ersetzen Sie RESOURCE ODER FELD entweder 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: