Agora vamos analisar um caso de uso comum: resumir o desempenho de uma conta nos últimos 30 dias por campanha e segmentada por dispositivo. A consulta para esse relatório é a seguinte:
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
Para emitir essa solicitação, transmita a instrução da linguagem de consulta do Google Ads acima para a interface GoogleAdsService.SearchStream.
URL de solicitação de HTTP
A solicitação consiste em um HTTP POST para o servidor da API Google Ads no URL a seguir:
https://googleads.googleapis.com/v14/customers/{customer_id}/googleAds:searchStream
Amostra de solicitação HTTP completa
Veja um exemplo completo da definição de relatório acima, incluído em uma solicitação HTTP POST.
POST /v14/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"
}
Exemplos de código
Assista a um tutorial em vídeo de um exemplo de código que pesquisa campanhas com métricas nos últimos sete dias. O exemplo de código no vídeo está escrito em Java, mas o processo é semelhante para todas as linguagens.