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
undSearchStream
.Bei
SearchAds360Service
-Abfragen wird eine Liste mitSearchAds360Row
-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 mitSearchAds360Field
-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 eincampaign
-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 einmetrics
-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.
Abfrage von Attributen einer zugehörigen Ressource
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 eincampaign
-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
odercampaign
) oder ein Feld (z. B.campaign.id
,metrics.impressions
oderad_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: