Search Ads 360-Abfragesprache

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

Suchdienste

Sie können Search Ads 360 Query Language zur Abfrage der API wie folgt verwenden:

SearchAds360Service

Verwenden Sie diesen Dienst, um Ressourcen und die dazugehörigen Attribute, Segmente, und Metriken. 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 Anfrage enthalten Zeilen Attribute und Messwertfelder.
  • Wenn Sie Segmente anfordern, werden für jedes Segment Segment-Ressourcen-Tupel.

Weitere Informationen finden Sie unter Suchberichte erstellen für erhalten Sie weitere Informationen.

SearchAds360FieldService

Verwenden Sie diesen Dienst, um Metadaten zu verfügbaren Feldern und Ressourcen abzufragen. Der Dienst stellt einen Katalog abfragbarer Felder mit Details zu ihren Kompatibilität und Typ.

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

  • Jedes Feld enthält Details zum angeforderten Feld.

Weitere Informationen finden Sie unter Ressourcenmetadaten abrufen.

Einfache Abfragebeispiele

In den folgenden Abschnitten finden Sie grundlegende Abfragebeispiele, die Sie anpassen können, um Ihre eigenen Abfragen erstellen.

Attribute einer Ressource abfragen

Dies ist eine einfache Abfrage für Attribute der Ressource campaign, die Folgendes zurückgibt: die ID, den Namen und den Status der Kampagne:

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

Unter campaign finden Sie anderen verfügbaren Feldern, die Sie in Ihren Abfragen verwenden können.

Abfrage von Messwerten

Dies ist eine einfache Abfrage für Messwerte, die sich auf Attribute des campaigns beziehen. Ressource:

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 zurück. Impressionen.
  • Für jede zurückgegebene SearchAds360Row ist ein metrics-Feld mit dem ausgewählten Messwerten.
  • Die Abfrage wird nach Kampagnen-ID sortiert.

Weitere Informationen finden Sie unter metrics verfügbaren Messwerten, die Sie in Ihren Abfragen verwenden können.

Segmente abfragen

Dies ist eine einfache Abfrage für Segmente, die sich auf Attribute des campaign Ressource:

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 zurück. Impressionen.
  • Die Daten werden nach Datum segmentiert.
  • Aufgrund der Segmentierung stellt jeder SearchAds360Row ein Tupel von eine Kampagne und das Datumssegment.
  • Die Abfrage wird nach Kampagnen-ID sortiert.

Unter segments finden Sie Liste der Segmente, die Sie in Ihren Abfragen verwenden können, und Segmentierung für weitere Informationen zur Segmentierung Ihrer Berichte.

Dies ist eine einfache Abfrage für die Ressource campaign, die Attribute des bidding_strategy-Ressource, falls verfügbar. Diese Art verwandter Ressource ist als zugeordnete Ressource.

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 den einzelnen Kampagne ausgewählt.
  • Jeder zurückgegebene SearchAds360Row stellt ein campaign-Objekt dar, das mit den ausgewählten Kampagnenattributen sowie mit der ausgewählten Gebotsstrategie bidding_strategy.name.

Weitere Informationen finden Sie unter campaign. um herauszufinden, welche zugeordneten 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 ODER 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 eines Felds finden Sie unter Ressourcenmetadaten abrufen. Metadaten.

Weitere Informationen

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