Ejemplo de caso de uso común

Ahora, veremos un caso de uso común: resumir el rendimiento de una cuenta durante los últimos 30 días por campaña y segmentar por dispositivo. La consulta para este informe es la siguiente:

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 esta solicitud, pasa la sentencia del lenguaje de consulta de Google Ads anterior a la interfaz de GoogleAdsService.SearchStream.

Punto clave: En este ejemplo, se muestra la solicitud HTTP subyacente solo como método de enseñanza. Te recomendamos que uses una de las bibliotecas cliente para enviar solicitudes en tu propia app.

URL de solicitud HTTP

La solicitud consiste en una POST HTTP al servidor de la API de Google Ads en la siguiente URL:

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

Ejemplo completo de solicitud HTTP

Este es un ejemplo completo de la definición de informe anterior, incluida en una solicitud 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"
}

Muestras de código

Mira una explicación en video de una muestra de código que busca campañas con métricas de los últimos 7 días. La muestra de código del video está escrita en Java, pero el proceso es similar para todos los lenguajes.