In diesem Anwendungsfall wird die Leistung eines Kontos in den letzten 30 Tagen nach Kampagne und segmentiert nach Gerät zusammengefasst. Die Abfrage für diesen Bericht sieht so aus:
SELECT
campaign.name,
campaign.status,
segments.device,
metrics.impressions,
metrics.clicks,
metrics.ctr,
metrics.average_cpc,
metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS
Um diese Anfrage zu senden, übergeben Sie diese Google Ads Query Language-Anweisung an die
GoogleAdsService.SearchStream
Schnittstelle.
HTTP-Anfrage-URL
Die Anfrage besteht aus einer HTTP-POST-Anfrage an den Google Ads API-Server unter der folgenden URL:
https://googleads.googleapis.com/v25/customers/{customer_id}/googleAds:searchStream
Ersetzen Sie {customer_id} durch die ID des Google Ads-Kontos, das Sie abfragen möchten. Die ID darf keine Bindestriche enthalten. Wenn Sie Daten für ein Unterkonto abrufen möchten, müssen Sie die ID dieses Unterkontos verwenden. Bei einer Abfrage mit der ID eines Verwaltungskontos werden nur Daten zurückgegeben, die direkt diesem Verwaltungskonto gehören. Daten aus den Unterkonten sind nicht enthalten.
Vollständiges Beispiel für eine HTTP-Anfrage
Hier sehen Sie ein vollständiges Beispiel für diese Berichtsdefinition, eingebettet in eine HTTP-POST-Anfrage.
POST /v25/customers/{customer_id}/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
User-Agent: curl
Content-Type: application/json
Accept: application/json
Authorization: Bearer [Enter OAuth 2.0 access token here]
developer-token: [Enter developerToken here]
Parameters:
{
"query" : "SELECT campaign.name, campaign.status, segments.device,
metrics.impressions, metrics.clicks, metrics.ctr,
metrics.average_cpc, metrics.cost_micros
FROM campaign
WHERE segments.date DURING LAST_30_DAYS"
}
Codebeispiele
In diesem Video wird ein Codebeispiel vorgestellt, mit dem Kampagnen mit Messwerten der letzten 7 Tage gesucht werden. Dieses Codebeispiel ist in Java geschrieben, der Prozess ist aber für alle Sprachen ähnlich.