Ora esaminiamo 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 del linguaggio di query Google Ads riportato sopra all'interfaccia GoogleAdsService.SearchStream.
URL della richiesta HTTP
La richiesta consiste in un POST HTTP al server dell'API Google Ads all'URL seguente:
https://googleads.googleapis.com/v19/customers/{customer_id}/googleAds:searchStream
Esempio completo di richiesta HTTP
Ecco un esempio completo della definizione del report riportata sopra, racchiusa in una richiesta HTTP POST.
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"
}
Esempi di codice
Guarda un video walkthrough di un esempio di codice che esegue ricerche nelle campagne con metriche relative agli ultimi 7 giorni. L'esempio di codice nel video è scritto in Java, ma la procedura è simile per tutti i linguaggi.