Esempio di caso d'uso comune

Questo caso d'uso riepiloga il 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 emettere questa richiesta, trasmetti questa istruzione del linguaggio di query Google Ads all'interfaccia GoogleAdsService.SearchStream.

URL della richiesta HTTP

La richiesta consiste in un HTTP POST al server dell'API Google Ads al seguente URL:

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

Sostituisci {customer_id} con l'ID dell'account Google Ads specifico per cui vuoi eseguire la query. Non includere trattini nell'ID. Se vuoi recuperare i dati di un account secondario, devi utilizzare l'ID di questo account. L'esecuzione di query con un ID account amministratore restituisce solo i dati di proprietà diretta di quell'account amministratore e non include i dati dei relativi subaccount.

Esempio di richiesta HTTP completa

Ecco un esempio completo di questa definizione di report, racchiusa in una richiesta HTTP POST.

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"
}

Esempi di codice

Guarda un video esplicativo di un esempio di codice che cerca campagne con metriche negli ultimi 7 giorni. Questo esempio di codice è scritto in Java, ma la procedura è simile per tutti i linguaggi.