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, debes verificar que tu integración funcione correctamente, comprender las brechas en los resultados de la medición entre la implementación basada en cookies y la implementación de Attribution Reporting, y solucionar cualquier problema 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 ambos, 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 con 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 la fuente o los activadores, o fallas 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.
Los informes de depuración se basan en cookies.
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 lo será. Esto tiene algunas implicaciones clave:
- Los informes de depuración solo se generan si se permiten las cookies de terceros en el navegador del usuario.
- Los informes de depuración dejarán de estar disponibles después de que se eliminen las cookies de terceros.
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. A diferencia de los informes de atribución, que se envían con un retraso.
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, durante el registro del activador.
Los informes de depuración detallados se envían inmediatamente después de que se registra la fuente o el activador.
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 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, la API de Attribution Reporting incluye protecciones de privacidad integradas, que están diseñadas para lograr un equilibrio entre utilidad y privacidad. Esto significa que, con la API de Attribution Reporting, es posible que no puedas recopilar todos los datos de medición que recopilas actualmente con cookies. No todas las conversiones a las que puedas hacer un seguimiento con cookies de terceros generarán un informe de atribución.
Un ejemplo: para los informes a nivel del evento, puedes registrar una conversión por impresión como máximo. 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 los resultados de tu medición basada en cookies y los resultados que obtienes con la API de Attribution Reporting. Identifica qué conversiones se informan, cuántas conversiones no se informan, 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.
Solución de problemas
Si bien se espera una pérdida causada por la protección de la privacidad o los recursos, otras pérdidas pueden ser no deseadas. Los errores de configuración en tu implementación o los errores en el navegador pueden 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 información sobre cómo hacerlo en la 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 los comportamientos de la API. Las reglas de filtrado, las de anulación de duplicación y las reglas de prioridad son algunos ejemplos.
Cuando uses estas funciones, usa los informes de depuración para verificar que tu lógica conduzca al comportamiento deseado en la producción, sin esperar 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.
Usa informes de depuración agregables para validar el contenido de los informes agregables y generar informes de resumen con la herramienta de agregación local para 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.