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 la integración funcione correctamente, comprender las brechas en los resultados de medición entre la implementación basada en cookies y la implementación de Attribution Reporting, y solucionar cualquier problema con la 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 cumplen diferentes casos de uso.
Informes de depuración correctos
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 correctos 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 la fuente y los eventos de activación, de modo que puedas asegurarte de que las fuentes se hayan registrado correctamente o hacer un seguimiento de los informes que faltan y determinar por qué no se encuentran (falla en la fuente o en los eventos de activación, falla cuando se envía o genera 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 una fuente o un evento activador, lo que significa que no se generará un informe de atribución.
- Casos en los que un informe de atribución no se puede generar o enviar 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 registro de fuente correcto que se agregaron más adelante en Chrome 112.
Revisa los ejemplos de informes 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 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. Esto es diferente de los informes de atribución, que se envían con retraso.
Los informes de depuración correctos 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.
Los informes de depuración tienen diferentes rutas de acceso a los 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 separados del origen de los informes:
- Extremo para los informes de depuración de éxito a nivel del evento
- Extremo para informes de depuración correctos, agregables
- Extremo para informes de depuración detallados, a nivel del evento y agregables.
Obtén más información en la Parte 2: Configura los informes de depuración.
Casos de uso
Verificación básica de 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 para hacerlo en la Parte 3: Libro de recetas 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 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 de las 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 obtendrás un informe de atribución, independientemente de la cantidad de veces que el usuario genere una conversión.
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. Determina qué conversiones se registran, cuántas no se registran y, específicamente, cuáles y por qué.
Obtén información para ejecutar un análisis de pérdidas en la Parte 3: Guía de depuración.
Solución de problemas
Si bien se espera que se produzcan pérdidas por la protección de la privacidad o de los recursos, es posible que otras pérdidas sean no intencionales. Los errores de configuración en tu implementación o los errores en el navegador pueden hacer que se pierdan los informes.
Puedes usar los informes de depuración para detectar y corregir un problema de implementación de tu parte o para informar un posible error a los equipos de navegadores. Obtén información para hacerlo en la Parte 3: Libro de recetas 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 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 genere el comportamiento deseado en producción, sin esperar a los informes de atribución. Obtén información para hacerlo en la Parte 3: Libro de recetas 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 no encriptada.
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 los informes. Por lo tanto, para procesar informes más de una vez, asegúrate de tener habilitados los informes de depuración. Te recomendamos que vuelvas a procesar los informes en los siguientes casos:
- intenta depurar el servicio de agregación.
- experimenta con diferentes estrategias de 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 poder recuperar sus datos de informes. Esto es útil en casos de problemas con el servicio de agregación, como servicios no disponibles o que no responden, que pueden provocar que falle la generación de informes de resumen.