Esempio di caso d'uso comune

Ora diamo un'occhiata a un caso d'uso comune: il riepilogo del rendimento di un account negli ultimi 30 giorni per campagna, segmentato per dispositivo. La query per questo report è la seguente:

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

Per inviare questa richiesta, passa l'istruzione Google Ads Query Language sopra riportata all'interfaccia GoogleAdsService.SearchStream.

URL richiesta HTTP

La richiesta consiste in una richiesta POST HTTP al server API Google Ads al seguente URL:

https://googleads.googleapis.com/v16/customers/{customer_id}/googleAds:searchStream

Esempio di richiesta HTTP completo

Ecco un esempio completo della definizione del report riportata sopra, racchiusa in una richiesta POST HTTP.

POST /v16/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"
}

Esempi di codice

Guarda una presentazione video di un esempio di codice che esegue ricerche in campagne con metriche negli ultimi 7 giorni. L'esempio di codice nel video è scritto in Java, ma il processo è simile per tutti i linguaggi.