Esempio di caso d'uso comune

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

URL della richiesta HTTP

La richiesta è costituita da un HTTP POST al server dell'API Google Ads all'URL seguente:

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

Sostituisci {customer_id} con l'ID dell'account Google Ads specifico su cui vuoi eseguire la query. Non includere trattini nell'ID. Se vuoi recuperare i dati di un subaccount, devi utilizzare l'ID di quel subaccount. L'esecuzione di query con l'ID di un 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

Di seguito è riportato un esempio completo della definizione di questo report, racchiuso in una richiesta HTTP POST.

POST /v25/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 procedura dettagliata video di un esempio di codice che cerca le campagne con le metriche degli ultimi 7 giorni. Questo esempio di codice è scritto in Java, ma la procedura è simile per tutti i linguaggi.