Introducción a los informes de depuración de Attribution Reporting

Parte 1 de 3 sobre la depuración de Attribution Reporting. Descubre por qué es importante la depuración y cuándo usar los informes de depuración en las pruebas.

Por qué necesitas informes de depuración

Si estás probando la API de Attribution Reporting, Verifica que tu integración funcione correctamente y comprende las brechas en los resultados de la medición entre tus basada en cookies y tu implementación de Attribution Reporting, así como solucionar problemas relacionados con tu integración.

Se requieren informes de depuración para completar estas tareas. Por lo tanto, te recomendamos que las configures.

Glosario

Aspectos clave de los informes de depuración

Dos tipos de informes de depuración

Hay dos tipos de informes de depuración disponibles. Usa ambas opciones, ya que sirven para distintos casos de uso.

Informes de depuración correcta

Los informes de depuración de éxito hacen un seguimiento de la generación correcta de un informe de atribución. Se relacionan directamente a un informe de atribución.

Los informes de depuración de errores están disponibles desde Chrome 101 (abril de 2022).

Informes de depuración detallados

Los informes de depuración detallados te brindan más visibilidad de los eventos de origen y activador, de modo que puedas asegurarte de que las fuentes se hayan registrado correctamente, o bien hacer un seguimiento de los informes faltantes y determinar por qué faltan (fallas en los eventos de fuente o activador, o errores al enviar o generar el informe). Los informes de depuración detallados indican lo siguiente:

  • Casos en los que el navegador registró correctamente una fuente.
  • Son casos en los que el navegador no registró correctamente una fuente o un evento activador, lo que significa que no generará un informe de atribución.
  • Son casos en los que no se puede generar ni enviar un informe de atribución por algún motivo.

Los informes de depuración detallados incluyen un campo type que describe un registro de fuente exitoso o el motivo por el que no se generó una fuente, un activador o un informe de atribución.

Los informes de depuración detallados están disponibles desde Chrome 109 (enero de 2023), excepto los informes de depuración detallados de éxito del registro de fuentes que se agregaron más adelante en Chrome 112.

Revisa los informes de ejemplo en la Parte 2: Configura informes de depuración.

Para usar los informes de depuración, el origen de los informes debe configurar una cookie.

Si el origen configurado para recibir informes es de un tercero, esta cookie será de terceros. cookie. Esto tiene algunas implicaciones clave:

  • Los informes de depuración solo se generan si se usan cookies de terceros permitidos en el navegador del usuario.
  • Los informes de depuración dejarán de estar disponibles tras la activación de las cookies de terceros. se eliminará gradualmente.

Los informes de depuración se envían de inmediato.

El navegador envía los informes de depuración de inmediato al origen de los informes. Esta es diferente a los informes de atribución, que se envían con un demora.

Los informes de depuración de éxito se generan y se envían en cuanto se genera el informe de atribución correspondiente, es decir, cuando se activa de registro.

Los informes de depuración detallados se envían inmediatamente después de la fuente o el activador de registro.

Los informes de depuración tienen diferentes rutas de acceso de extremos

Al igual que los Informes de atribución, todos los informes de depuración se envían al origen de los informes. Los informes de depuración se envían a tres extremos distintos del origen de los informes:

  • Extremo para informes de depuración exitosos, a nivel del evento
  • Extremo para informes de depuración exitosos, agregable
  • Extremo para informes de depuración detallados, agregables y a nivel del evento.

Obtén más información en la Parte 2: Configura informes de depuración.

Casos de uso

Verificación básica de la integración en tiempo real

Los informes de depuración se envían a tu extremo de inmediato, a diferencia de los informes de atribución. que se retrasan para proteger la privacidad del usuario. Usa los informes de depuración como un indicador en tiempo real de que tu integración con el La API de Attribution Reporting funciona.

Obtén información sobre cómo hacerlo en la Parte 3: Guía de soluciones de depuración.

Análisis de pérdidas

A diferencia de las cookies de terceros, los informes de atribución La API incluye funciones de privacidad de seguridad, que están diseñadas para lograr un equilibrio entre y privacidad. Esto significa que, con la API de Attribution Reporting, es posible que no todos los datos de medición que recopilas actualmente con cookies. No todas las conversiones que puedes seguimiento con cookies de terceros generará un informe de atribución.

Un ejemplo: Para los informes a nivel del evento, puede registrar una conversión como máximo. por impresión. Esto significa que, para una impresión de anuncios determinada, solo obtendrás un informe de atribución, sin importar cuántas veces el usuario genere una conversión.

Usa los informes de depuración para obtener visibilidad de las diferencias entre tus los resultados de la medición basada en cookies y los resultados que obtienes con la atribución API de Reporting Identifique qué conversiones se registran y cuántas conversiones no informados y, específicamente, cuáles y por qué.

Obtén más información sobre cómo ejecutar un análisis de pérdidas en la Parte 3: Guía de soluciones de depuración.

Soluciona problemas

Si bien se espera una pérdida causada por la protección de la privacidad o los recursos, puede ser no deseada. Configuraciones incorrectas en tu implementación o errores en la navegador en sí puede causar la pérdida de informes.

Puedes usar los informes de depuración para detectar y corregir un problema de implementación en tu lado, o para informar un posible error a los equipos de navegadores. Obtén más información sobre cómo hacerlo en Parte 3: Guía de soluciones de depuración.

Verificación de configuración avanzada

Algunas funciones de la API de Attribution Reporting te permiten personalizar las APIs los comportamientos del modelo. Las reglas de filtrado, las de anulación de duplicación y las reglas de prioridad son algunos ejemplos.

Cuando uses estas funciones, usa informes de depuración para verificar que tu lógica conduzca al comportamiento deseado en sin tener que esperar los informes de atribución. Obtén información sobre cómo hacerlo en la Parte 3: Guía de soluciones de depuración.

Pruebas locales con informes agregables

A diferencia de los informes de atribución agregables que están encriptados, los informes de depuración agregables incluyen la carga útil sin encriptar.

Usar informes de depuración agregables para validar el contenido de esos informes. y generar informes de resumen con la herramienta de agregación local para realizar pruebas.

Reprocesa los informes del servicio de agregación

Otra ventaja de usar el modo de depuración es que te permite volver a procesar informes. Por lo tanto, para procesar informes más de una vez, asegúrate de tener habilitados los informes de depuración. Es posible que desee volver a procesar los informes en los siguientes casos:

  • que intenta depurar el servicio de agregación.
  • experimentar con diferentes estrategias de lote.
  • experimentando con diferentes valores de épsilon.

Recuperación de datos

Recomendamos que las tecnologías publicitarias habiliten el modo de depuración para recibir informes de depuración y que puedan recuperar sus datos de informes. Esto es útil en casos de problemas con el servicio de agregación, como los servicios no disponibles o no responsivos que pueden provocar que falle la generación del informe de resumen.

Siguiente

Parte 2: Configura informes de depuración