La API de AdSense Management tiene llamadas para generar informes nuevos y guardados. Pueden contener estadísticas simples, como los ingresos por día, o tablas muy complejas de tasas de clics por canal personalizado por país. En esta guía, se presenta una lista de casos extremos que deben manejarse de forma correcta para lograr una integración sólida con las APIs.
Estructura del informe
Los resultados del informe se muestran como un objeto ReportResult. Consulta la referencia de las respuestas del informe para ver todos los detalles.
Usa dimensiones cronológicas: DATE, WEEK y MONTH
Los informes pueden estar vacíos o tener vacíos
Si no hubo actividad durante el período especificado en la solicitud, no se generarán solicitudes de anuncios y el servicio de informes no mostrará filas para esos períodos. Esto es importante si, por ejemplo, estás dibujando un gráfico.
Consulta la guía para completar fechas para obtener más información.
Solicitando dimensiones de MONTH y WEEK en el mismo informe
Este informe puede tener consecuencias negativas o inesperadas. Si una semana pertenece a dos meses diferentes, se mostrarán dos filas para la misma semana, una para cada mes.
Ejemplo
| Dimensiones | Métricas | Fecha de inicio | Fecha de finalización |
|---|---|---|---|
WEEKMONTH |
CLICKS | 2014-04-28 | 2014-05-03 |
Se muestra lo siguiente:
MONTH | WEEK* | CLICKS |
|---|---|---|
| 2014-04 | 2014-04-27 | 50 |
| 2014-05 | 2014-04-27 | 43 |
* primer día de la semana
Solución
Quita MONTH del informe.
WEEK | CLICKS |
|---|---|
| 2014-04-27 | 93 |
Cómo recopilar valores de dimensión
Cuando se solicitan dimensiones como las relacionadas, por ejemplo, con plataformas (computadoras de escritorio, dispositivos móviles de alta gama, etc.), solo se mostrarán las plataformas con actividad. Si un día, una semana o un mes determinado no tiene visitas desde dispositivos móviles de alta gama, no tendrá información para esa categoría.
Ejemplo
| Dimensiones | Métricas | Fecha de inicio | Fecha de finalización |
|---|---|---|---|
PLATFORM_TYPE_NAMEMONTH |
AD_REQUESTS |
2014-02-01 | 2014-03-31 |
Se muestra lo siguiente:
| MES | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Computadoras | 100 |
| 2014-03 | Dispositivos móviles de alta gama | 5 |
| 2014-04 | Computadoras | 75 |
Solución
Cuando proceses los resultados del informe, supone un valor de cero para cualquier valor de dimensión que no aparezca en los resultados:
| MES | PLATFORM_TYPE_NAME | AD_REQUESTS |
|---|---|---|
| 2014-03 | Computadoras | 100 |
| 2014-03 | Dispositivos móviles de alta gama | 5 |
| 2014-04 | Computadoras | 75 |
| 2014-04 | Dispositivos móviles de alta gama | 0 |
Cómo combinar varios informes contiguos
A veces, un informe es demasiado grande para generarlo de una sola vez y debe agruparse en lotes. Si tu app hace esto, ten en cuenta los siguientes casos:
- Si usas las dimensiones
WEEKoMONTH, y divides el informe a mitad de una semana o de un mes, cada informe tendrá entradas duplicadas con datos diferentes. - Asegúrate de que todos los informes tengan las mismas métricas y dimensiones, ya que es posible que los datos no se puedan combinar con dimensiones diferentes.
Cuentas especiales
Es posible que algunos de tus usuarios tengan cuentas de AdSense con atributos que no esperas o no conoces. Asegúrate de tener en cuenta lo siguiente:
- Publicadores con miles de dominios o sitios
- Publicadores con miles de unidades de anuncios o canales personalizados
- Publicadores que desean generar informes sobre varios clientes de anuncios (AdSense para búsquedas, AdSense para video, etcétera)
Varias cuentas
Los usuarios pueden tener acceso a más de una cuenta de AdSense. Por este motivo, se debe especificar un ID de cuenta para cada llamada a la API. Una llamada a accounts.list recupera una lista de cuentas, y se debería mostrar un diálogo del selector de cuentas al usuario. Se puede omitir si el número de cuentas recuperadas es uno.
Cambios de zona horaria
Los publicadores de AdSense pueden cambiar su zona horaria en cualquier momento, lo que puede generar aumentos o disminuciones repentinas en los informes. Consulta la guía sobre los informes de zona horaria local para obtener más información.