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 medición entre tu implementación basada en cookies y tu 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 los 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, ya que satisfacen diferentes casos de uso.
Informes de depuración de éxito
Los informes de depuración de éxito hacen un seguimiento de la generación exitosa de un informe de atribución. Se relacionan directamente con un informe de atribución.
Los informes de depuración de éxito 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 fuente y de activación, por lo que puedes asegurarte de que las fuentes se hayan registrado correctamente o hacer un seguimiento de los informes faltantes y determinar por qué faltan (falla en los eventos de fuente o de activación, falla 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.
- Casos en los que el navegador no registró correctamente un evento de fuente o de activador, lo que significa que no generará un informe de atribución.
- 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ó un informe de fuente, activador o atribución.
Los informes de depuración detallados están disponibles desde Chrome 109 (enero de 2023), excepto los informes de depuración detallados sobre el registro exitoso de la fuente, que se agregaron más tarde 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 del informe debe establecer una cookie.
Si el origen configurado para recibir informes es un tercero, esta cookie será una cookie de terceros. Esto significa que 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 se envían de inmediato
El navegador envía los informes de depuración de inmediato al origen de informes. A diferencia de los informes de atribución, que se envían con una demora.
Los informes de depuración de éxito se generan y envían en cuanto se genera el informe de atribución correspondiente, es decir, en el registro del activador.
Los informes de depuración detallados se envían inmediatamente después del registro de la fuente o del activador.
Las rutas de acceso de los extremos de los informes de depuración son diferentes
Al igual que los informes de atribución, todos los informes de depuración se envían al origen de informes. Los informes de depuración se envían a tres extremos separados del origen de informes:
- Es el extremo para los informes de depuración de éxito a nivel del evento.
- Es el extremo para los informes de depuración de éxito, que son agregables.
- Es el extremo para los informes de depuración detallados, tanto a nivel del evento como agregables.
Obtén más información en 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 más información para hacerlo en la Parte 3: Recetario 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, diseñadas para lograr un equilibrio entre la utilidad y la privacidad. Esto significa que, con la API de Attribution Reporting, es posible que no puedas recopilar todos los datos de medición que podrías recopilar con las cookies. No todas las conversiones que puedes hacer un seguimiento con cookies de terceros generarán un informe de atribución.
Un ejemplo: En el caso de los informes a nivel del evento, puedes registrar, como máximo, una conversión por impresión. Esto significa que, para una impresión de anuncio determinada, solo recibirás un informe de atribución, sin importar cuántas veces genere conversiones el usuario.
Usa los informes de depuración para obtener visibilidad sobre las diferencias entre los resultados de medición basados en cookies y los resultados que obtienes con la API de Attribution Reporting. Identifica con precisión qué conversiones se registran, cuántas no se registran y, específicamente, cuáles y por qué.
Obtén más información para realizar un análisis de pérdidas en la Parte 3: Guía de soluciones.
Solución de problemas
Si bien se espera que haya pérdidas debido a las protecciones de privacidad o de recursos, otras pérdidas pueden ser no deseadas. Las configuraciones incorrectas en tu implementación o los errores en el navegador pueden provocar que falten informes.
Puedes usar los informes de depuración para detectar y corregir un problema de implementación de tu lado, o bien para informar un posible error a los equipos de navegadores. Obtén más información para hacerlo en la Parte 3: Recetario 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 reglas de eliminación de duplicados y las reglas de prioridad son algunos ejemplos.
Cuando uses estas funciones, usa informes de depuración para verificar que tu lógica genere el comportamiento previsto en producción, sin esperar los informes de atribución. Obtén más información para hacerlo en la Parte 3: Recetario 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 realizar pruebas.
Vuelve a procesar 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 los informes más de una vez, asegúrate de tener habilitados los informes de depuración. Es posible que desees volver a procesar los informes en los siguientes casos:
- Intentar depurar el Servicio de agregación
- Experimenta con diferentes estrategias de procesamiento por lotes.
- Experimenta con diferentes valores de epsilon.
Recuperación de datos
Recomendamos que las tecnologías publicitarias habiliten el modo de depuración para recibir informes de depuración y, así, puedan recuperar sus datos de informes. Esto es útil en casos de problemas del Servicio de agregación, como servicios no disponibles o que no responden, que pueden provocar que falle la generación de informes de resumen.
A continuación
Parte 2: Configura informes de depuración