Häufiges Anwendungsfallbeispiel

In diesem Anwendungsbeispiel wird die Leistung eines Kontos in den letzten 30 Tagen nach Kampagne und Segmentierung 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 stellen, übergeben Sie diese Google Ads Query Language-Anweisung an die GoogleAdsService.SearchStream-Schnittstelle.

HTTP-Anfrage-URL

Die Anfrage besteht aus einem HTTP POST an den Google Ads API-Server unter der folgenden URL:

https://googleads.googleapis.com/v24/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 untergeordnetes Konto abrufen möchten, müssen Sie die ID dieses untergeordneten Kontos verwenden. Wenn Sie eine Abfrage mit der ID eines Verwaltungskontos ausführen, werden nur Daten zurückgegeben, die direkt diesem Verwaltungskonto gehören. Daten aus den zugehörigen Unterkonten sind nicht enthalten.

Beispiel für eine vollständige HTTP-Anfrage

Hier ist ein vollständiges Beispiel für diese Berichtsdefinition, die in einer HTTP-POST-Anfrage enthalten ist.

POST /v24/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 sehen Sie ein Codebeispiel, mit dem nach Kampagnen mit Messwerten der letzten 7 Tage gesucht wird. Dieses Codebeispiel ist in Java geschrieben, der Prozess ist jedoch für alle Sprachen ähnlich.