Prácticas recomendadas sobre los informes

Primero, crea informes nuevos en la IU

Los informes están sujetos a una serie de restricciones y requisitos relacionados con los tipos de informes, los filtros, las dimensiones y las métricas. Estas limitaciones se aplican en la API y muestran un error HTTP 400. Para evitar errores cuando crees informes, te recomendamos que primero crees informes nuevos en la IU de Display & Video 360.

Después de compilar tu informe, haz clic en la función"Prueba esta API" en la página de documentos de referencia para realizar una queries.get del recurso Query. Puedes usar el JSON que se muestra para crear informes futuros.

Usa métricas y filtros específicos del tipo de informe

Algunos valores de métricas y filtros son específicos de ciertos tipos de informes. Además de crear tus informes primero en la IU, también puedes identificar las métricas y los filtros que pertenecen a ciertos valores de ReportType por su valor de la API de Bid Manager.

Estas son algunas formas de identificar los valores de filtro y métrica relevantes de la API de Bid Manager. Esta tabla no es una lista exhaustiva de los filtros y las métricas que se pueden usar en estos tipos de informes. No todos los valores se pueden usar juntos en un solo informe.

Guarda y vuelve a usar informes

Te recomendamos que crees y guardes informes para las consultas que ejecutas con regularidad, ya que insertar y borrar el mismo informe varias veces desperdicia recursos. El uso de los valores establecidos de Range, como PREVIOUS_DAY o LAST_7_DAYS, en el campo dataRange hace que los informes sean más reutilizables.

Programar informes

Los informes ad hoc o únicos pueden desperdiciar recursos porque se ejecutan individualmente y pueden ejecutarse en un conjunto de datos incompleto. Los informes programados aprovechan al máximo los recursos de informes, ya que se ejecutan de forma masiva y se garantiza que no se ejecuten hasta que se complete el procesamiento de los datos del día anterior. Consulta los campos de programación disponibles para obtener más detalles.

Combina informes similares

Si generas informes con métricas y períodos idénticos para diferentes anunciantes o socios con frecuencia, te recomendamos que combines los informes para optimizar su volumen.

Para combinar informes similares, agrega los filtros de todos los informes y todos los tipos de filtros como dimensiones. Después de la generación, puedes dividir las filas del informe resultante según los valores de filtro originales para generar los informes originales.

Ten en cuenta las cuotas de informes

El uso responsable de la función de informes de Display & Video 360 se aplica a través de las siguientes cuotas de uso en todo el producto.

Ejecuciones de informes ad hoc por día

Limita la cantidad de informes ad hoc que un usuario puede ejecutar en un período de 24 horas. Para no superar esta cuota, haz lo siguiente:

• Combina informes similares para reducir el volumen de informes.
• Programa informes ad hoc recurrentes para reducir específicamente el volumen de informes ad hoc.
• Desactiva las secuencias de comandos de API innecesarias.

Informes programados activos

Limita la cantidad de informes que un usuario puede programar de forma activa en un momento determinado. Para no superar esta cuota, haz lo siguiente:

• Combina informes programados similares para reducir la cantidad general de informes programados.
• Desactiva los informes programados innecesarios.
• Desactiva las secuencias de comandos de API innecesarias.

Informes simultáneos

Limita la cantidad de informes que un usuario puede ejecutar de forma simultánea. Para no superar esta cuota, haz lo siguiente:

• Programa informes que se ejecuten con regularidad.
• Desactiva las secuencias de comandos de API innecesarias.
• Realiza sondeos con la lógica de retirada exponencial para hacer un seguimiento de cuándo se completan tus informes.

Si optimizaste la implementación de informes y aún superas la cuota asignada, comunícate con el equipo de asistencia de Display & Video 360 mediante el formulario de contacto.

Usa la retirada exponencial cuando sondees el estado del informe

No es posible predecir cuánto tiempo tardará en ejecutarse un informe. La duración puede variar de segundos a horas, según muchos factores, como el período y la cantidad de datos que se procesarán. Tampoco hay correlación entre el tiempo de ejecución del informe y la cantidad de filas que se muestran en él. Por lo tanto, debes recuperar el recurso de informe con frecuencia con el método queries.reports.get y verificar si el campo metadata.status.state del recurso se actualizó a DONE o FAILED para determinar si terminó de ejecutarse. Este es un proceso conocido como "sondeo".

Si bien el sondeo es necesario, una implementación ineficiente puede agotar rápidamente tu cuota cuando se encuentra con un informe de larga duración. Por lo tanto, te recomendamos que uses la retirada exponencial para limitar los reintentos y conservar la cuota.

Retirada exponencial

La retirada exponencial es una estrategia estándar de manejo de errores para aplicaciones de red en la que el cliente reintenta periódicamente una solicitud durante un período creciente. Si se la utiliza de forma correcta, la retirada exponencial aumenta la eficiencia del uso del ancho de banda, reduce la cantidad de solicitudes que se requieren para obtener una respuesta correcta y maximiza la capacidad de procesamiento de las solicitudes en entornos simultáneos.

A continuación, se muestra el flujo para implementar una retirada exponencial simple:

1. Realiza una solicitud queries.reports.get a la API.
2. Recupera el objeto de informe. Si el campo metadata.status.state no es DONE ni FAILED, significa que el informe no terminó de ejecutarse y debe continuar con la sondeo.
3. Esperar 5 segundos + una cantidad aleatoria de milisegundos y reintentar la solicitud
4. Recupera el objeto de informe. Si el campo metadata.status.state no es DONE ni FAILED, significa que el informe no terminó de ejecutarse y debe continuar con la sondeo.
5. Esperar 10 segundos + una cantidad aleatoria de milisegundos y reintentar la solicitud
6. Recupera el objeto de informe. Si el campo metadata.status.state no es DONE ni FAILED, significa que el informe no terminó de ejecutarse y debe continuar con la sondeo.
7. Esperar 20 segundos + una cantidad aleatoria de milisegundos y reintentar la solicitud
8. Recupera el objeto de informe. Si el campo metadata.status.state no es DONE ni FAILED, significa que el informe no terminó de ejecutarse y debe continuar con la sondeo.
9. Esperar 40 segundos + una cantidad aleatoria de milisegundos y reintentar la solicitud
10. Recupera el objeto de informe. Si el campo metadata.status.state no es DONE ni FAILED, significa que el informe no terminó de ejecutarse y debe continuar con la sondeo.
11. Esperar 80 segundos + una cantidad aleatoria de milisegundos y reintentar la solicitud
12. Continúa con este patrón hasta que se actualice el objeto del informe o se alcance un tiempo máximo transcurrido.

Si el informe termina de ejecutarse y finaliza en un estado DONE, puedes recuperar el archivo de informe generado desde Google Cloud Storage en la ruta de acceso que se proporciona en el campo metadata.googleCloudStoragePath.