Häufiges Anwendungsfallbeispiel

Sehen wir uns nun einen häufigen Anwendungsfall an: die Leistung eines Kontos in den letzten 30 Tagen nach Kampagne und nach Gerät segmentiert. 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

Geben Sie dazu die obige Google Ads Query Language-Anweisung in die GoogleAdsService.SearchStream-Benutzeroberfläche ein.

Wichtig: In diesem Beispiel wird die zugrunde liegende HTTP-Anfrage nur zu Lehrzwecken gezeigt. Wir empfehlen Ihnen dringend, eine der Clientbibliotheken zu verwenden, um Anfragen in Ihrer eigenen App zu senden.

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/v19/customers/{customer_id}/googleAds:searchStream

Vollständiges Beispiel für eine HTTP-Anfrage

Hier ist ein vollständiges Beispiel für die Berichtsdefinition oben, eingebettet in eine HTTP-POST-Anfrage.

POST /v19/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 veranschaulicht, mit dem Kampagnen anhand von Messwerten der letzten 7 Tage durchsucht werden. Das Codebeispiel im Video ist in Java geschrieben, der Vorgang ist jedoch für alle Sprachen ähnlich.