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 se muestra 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 crear el 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 compilar informes futuros.

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

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

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

ReportType Filtros y métricas relevantes
INVENTORY_AVAILABILITY
  • Filtros con el prefijo FILTER_TRUEVIEW_IAR.
YOUTUBE
  • Filtra con el prefijo FILTER_TRUEVIEW, excepto aquellos que tienen el prefijo FILTER_TRUEVIEW_IAR.
  • Métricas con el prefijo METRIC_TRUEVIEW.
GRP
  • Métricas con el prefijo METRIC_GRP.
YOUTUBE_PROGRAMMATIC_GUARANTEED
  • Filtros con el prefijo FILTER_YOUTUBE_PROGRAMMATIC_GUARANTEED.
  • Métricas con el prefijo METRIC_PROGRAMMATIC_GUARANTEED.
REACH
  • Métricas con el prefijo METRIC_UNIQUE_REACH.
UNIQUE_REACH_AUDIENCE
  • Métricas con el prefijo METRIC_UNIQUE_REACH.

Cómo guardar y reutilizar informes

Te recomendamos crear y guardar informes para las consultas que ejecutas con regularidad, ya que insertar y borrar el mismo informe varias veces consume recursos. Usar los valores Range establecidos, 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 de forma individual y pueden ejecutarse en un conjunto de datos incompleto. Los informes programados hacen el mejor uso de los recursos de informes porque se ejecutan de forma masiva y se garantiza que no se ejecutarán hasta que los datos del día anterior terminen de procesarse. Consulta los campos de programación disponibles para obtener más detalles.

Combinar informes similares

Si generas informes con métricas y períodos idénticos para diferentes anunciantes o socios con regularidad, te recomendamos que combines los informes a fin de optimizar el volumen de informes.

Puedes combinar informes similares si agregas los filtros de todos los informes y todos los tipos de filtro como dimensiones. Después de la generación, puedes dividir las filas del informe resultante junto con los valores del filtro original para producir los informes originales.

Considera las cuotas de informes

El uso responsable de la función de informes de Display & Video 360 se aplica mediante 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 puede ejecutar un usuario en un período de 24 horas. Sigue estos pasos para no superar esta cuota:

Informes programados activos

Limita la cantidad de informes que un usuario puede programar de forma activa en un momento determinado. Sigue estos pasos para no superar esta cuota:

  • 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 simultáneamente. Sigue estos pasos para no superar esta cuota:

  • Programa informes que se ejecuten con regularidad.
  • Desactiva las secuencias de comandos de API innecesarias.
  • Realiza un seguimiento de cuándo tus informes están listos mediante un sondeo con la lógica de retirada exponencial.

Si optimizaste la implementación de informes y aún superas la cuota indicada, 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 existe una correlación entre el tiempo de ejecución del informe y la cantidad de filas que se muestran en el informe. Por lo tanto, debes recuperar con regularidad el recurso de informe 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 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 vuelve a intentar la solicitud de forma periódica 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 necesarias para obtener una respuesta correcta y maximiza la capacidad de procesamiento de 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, esto indica que no se terminó de ejecutar el informe, se debería continuar con el 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, esto indica que no se terminó de ejecutar el informe, se debería continuar con el 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, esto indica que no se terminó de ejecutar el informe, se debería continuar con el 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, esto indica que no se terminó de ejecutar el informe, se debería continuar con el 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, esto indica que no se terminó de ejecutar el informe, se debería continuar con el sondeo.
  11. Esperar 80 segundos + una cantidad aleatoria de milisegundos y reintentar la solicitud
  12. Continúa este patrón hasta que se actualice el objeto de informe o se alcance un tiempo máximo.

Si el informe termina de ejecutarse y finaliza en un estado DONE, podrás recuperar el archivo de informe generado de Google Cloud Storage en la ruta proporcionada en el campo metadata.googleCloudStoragePath.