Una vez que hayas configurado tu app cliente como se describe en Mi primera app, puedes usar la API de Search Ads 360 para solicitar y descargar informes. Puedes realizar cualquiera de los siguientes tipos de solicitudes:
- Síncrona
Requiere una sola solicitud y muestra el informe en una respuesta con formato JSON. Solicitudes síncronas:
- Solo puede mostrar informes de anunciante y cuenta de motor
- Bloquea a tu cliente hasta que Search Ads 360 genere el informe.
Si solicitas grandes informes de anunciantes o cuentas de motor, te recomendamos el enfoque asíncrono.
- Asíncrono
Requiere que envíes una solicitud inicial que especifique los datos que deseas incluir en el informe. Luego, envía solicitudes adicionales para sondear Search Ads 360. Cuando Search Ads 360 termina de generar el informe, envías solicitudes para descargarlo en uno o más archivos. Solicitudes asíncronas:
- Puede mostrar cualquier tipo de informe.
- Fragmenta los informes muy grandes en varios archivos
- Formatea los informes como CSV o TSV
Modelo de datos: filas y columnas
Search Ads 360 organiza los datos de un informe en filas y columnas. El tipo de informe que solicitas determina las filas que se muestran. Por ejemplo, si solicitas un informe de palabras clave, cada fila contendrá datos sobre una sola palabra clave. Consulta la referencia Tipos de informes para ver una lista de todos los tipos de informes. Para especificar qué columnas quieres incluir en el informe, asigna un nombre a cada una de las columnas de tu solicitud de informe. Consulta la referencia Tipos de informes para ver la lista de las columnas que se pueden mostrar para cada tipo de informe.
Comportamientos de la columna
El comportamiento de una columna depende del tipo de datos que contiene (la referencia Tipos de informes muestra el comportamiento de cada columna):
Columnas de atributos. Una columna de atributo contiene datos que configuran o identifican una entidad en una campaña, como el nombre de la campaña o una oferta de palabra clave. La API de Search Ads 360 siempre muestra el valor actual de una columna de atributo, independientemente de cualquier fecha o período especificado en una solicitud. Por ejemplo, si ayer cambiaste la oferta de una palabra clave de 2.00 a 1.50 y, luego, solicitas un informe de los datos del último mes, el informe mostrará un valor de 1.50 para la oferta de palabra clave.
Columnas de métricas. Una columna de métricas contiene datos sobre el rendimiento de tu campaña, como la cantidad de clics en un anuncio, la cantidad de visitas registradas por una etiqueta de Floodlight o los ingresos. A menos que especifiques un intervalo de tiempo de un solo día, la API muestra un valor agregado para las columnas de métricas. Por ejemplo, si solicitas un informe de los datos del mes pasado, la API mostrará la cantidad total de clics del último mes.
Segmentar las columnas Una columna de segmento divide los datos en filas separadas. Por ejemplo,
datees una columna de segmento que puedes especificar para muchos tipos de informes. Si especificas la columnadateen un informe de palabras clave con un período de 2013-01-07 a 2013-01-07, la API mostrará siete filas para cada palabra clave, cada una correspondiente a un día y mostrará las métricas de ese día. Consulta Informes segmentados.
Monedas
Tu solicitud de informe debe especificar la moneda de los datos monetarios (ambos atributos, como dailyBudget, y métricas, como cost). Puedes especificar una de las siguientes opciones:
- La moneda de la agencia, si el alcance del informe corresponde a una agencia, un anunciante o una cuenta de motor.
- La moneda del anunciante, si el informe se limita a un anunciante o a una cuenta de motor
- La moneda de la cuenta de motor, si el informe se limita a una cuenta de motor.
- USD
Usa la propiedad de solicitud Reports.request.statisticsCurrency para especificar una moneda.
El informe en sí indicará la moneda en la propiedad Reports.statisticsCurrencyCode.
Zona horaria
Las métricas de Search Ads 360 se almacenan en fechas sin zonas horarias. Estas fechas corresponden a la zona horaria de la cuenta de motor para las métricas del motor (como clics, impresiones y visitas), y a la zona horaria de la red de Campaign Manager para las métricas de conversión (como acciones, ingresos y transacciones). Cuando todas las métricas de un informe provienen de la misma zona horaria, se mostrará en la solicitud. De lo contrario, no se mostrará la zona horaria.
Tus solicitudes pueden configurar Reports.request.verifySingleTimeZone: true para que los informes con errores que presenten métricas de más de una zona horaria.
Si todas las métricas presentes en un informe pertenecen a una misma zona horaria, esta se muestra en Reports.statisticsTimeZoneReports.