Parte 1 de 3 sobre la depuración de Attribution Reporting. Aprende por qué es importante la depuración y cuándo usar 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 la implementación basada en cookies y la 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 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, ya que permiten distintos casos de uso.
Informes de depuración de éxito
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 correcta 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 activador, de modo que puedas asegurarte de que las fuentes se registraron correctamente, o bien hacer un seguimiento de los informes faltantes y determinar por qué faltan (fallas en los eventos de fuente o activador, 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 los 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 correcto 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 para los informes de depuración detallados de éxito del registro de la fuente 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 un tercero, esta cookie será de terceros. 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 ya no estarán disponibles después de que se eliminen gradualmente 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. Esto difiere 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, 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 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 separados del origen de informes:
- Extremo para informes de depuración success, a nivel del evento
- Extremo para informes de depuración success, 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 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 de inmediato a tu extremo, 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: 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 de las que puedes realizar 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 anuncios determinada, solo recibirás un informe de atribución, sin importar cuántas veces el usuario genere una conversión.
Utiliza los informes de depuración para obtener visibilidad de las diferencias entre los resultados de medición basados en cookies y los que obtienes con la API de Attribution Reporting. Identifica qué conversiones se registran, cuántas conversiones no se registran y cuáles y por qué.
Aprende a 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 protecciones de la privacidad o los recursos, otras pérdidas pueden ser no deseadas. Los errores en la implementación o en el navegador pueden causar la pérdida de informes.
Puedes usar los informes de depuración para detectar y solucionar un problema de implementación por tu lado o para informar un posible error a los equipos de navegadores. Obtén más 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 filtro, 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 conduzca al comportamiento previsto en producción, sin esperar a que lleguen los informes de atribución. Obtén más información para 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 no encriptada.
Usa informes de depuración agregables para validar el contenido de estos informes y generar informes de resumen con la herramienta de agregación local para realizar pruebas.
Volver 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 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 las siguientes situaciones:
- que intentan depurar el servicio de agregación.
- y experimentar con distintas estrategias de lotes.
- experimentando con diferentes valores de épsilon.
Recuperación de datos
Recomendamos que las plataformas de tecnología publicitaria habiliten el modo de depuración para recibir informes de depuración y recuperar sus datos de informes. Esto es útil en casos de problemas con el servicio de agregación, como servicios no disponibles o sin respuesta que pueden causar que falle la generación de informes de resumen.