Search Ads 360-Abfragesprache

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

Google-Suchdiensten

Mit der Search Ads 360 Query Language können Sie die API mit folgenden Methoden abfragen:

SearchAds360Service

Mit diesem Dienst können Sie Ressourcen und die zugehörigen 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.
  • Falls angefordert, 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 anpassen können, um eigene Abfragen zu erstellen.

Attribute einer Ressource abfragen

Dies ist eine einfache Abfrage für Attribute 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-Element stellt ein campaign-Objekt dar.

  • Die Zeilen werden mit den ausgewählten Feldern (einschließlich der resource_name der angegebenen Kampagne) ausgefüllt.

  • Die Abfrage sortiert die Ergebnisse nach Kampagnen-ID.

campaign enthält weitere verfügbare Felder, die Sie in Ihren Abfragen verwenden können.

Messwerte abfragen

Dies ist eine einfache Abfrage für Messwerte, die sich auf Attribute der Ressource campaign 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.

  • Jedes zurückgegebene SearchAds360Row hat ein Feld metrics, das mit den ausgewählten Messwerten gefüllt ist.

  • Die Abfrage sortiert die Ergebnisse nach Kampagnen-ID.

metrics enthält weitere 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 steht jedes SearchAds360Row für ein Tupel aus einer Kampagne und dem Datumssegment.

  • Die Abfrage sortiert die Ergebnisse nach Kampagnen-ID.

Eine Liste der Segmente, die Sie in Ihren Abfragen verwenden können, finden Sie unter segments. Weitere Informationen zum Segmentieren von Berichten finden Sie unter Segmentierung.

Dies ist eine einfache Abfrage für die Ressource campaign, die Attribute der Ressource bidding_strategy verknüpft, sofern verfügbar. Diese Art von verknüpfter Ressource wird als Attributressource bezeichnet.

SELECT
  campaign.id,
  campaign.name,
  campaign.status,
  bidding_strategy.name
FROM campaign
ORDER BY campaign.id

  • Mit der Abfrage werden Kampagnenattribute und zugehörige Attribute aus jeder ausgewählten Kampagne ausgewählt.

  • Jedes zurückgegebene SearchAds360Row-Element stellt ein campaign-Objekt dar, das mit den ausgewählten Kampagnenattributen sowie dem ausgewählten Attribut für die Gebotsstrategie, bidding_strategy.name, gefüllt ist.

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

Feldmetadaten abfragen

Sie können SearchAds360FieldService verwenden, um Feldmetadaten abzurufen.

Dies 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 RESOURCE OR FIELD 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: