Parte 3 de 3 sobre la depuración de Attribution Reporting. Encuentra instrucciones para usar los informes de depuración.
En este libro de recetas, encontrarás instrucciones para usar los informes de depuración en varios casos de uso que se describen en la Parte 1: Introducción a los informes de depuración.
Glosario
- El origen de los informes es el origen que establece los encabezados de fuente y activador de Attribution Reporting.
Todos los informes que genera el navegador se envían a este origen. En esta guía, usamos
https://adtech.examplecomo origen de informes de ejemplo. - Un informe de atribución (informe para abreviar) es el informe final (a nivel del evento o agregable) que contiene los datos de medición que solicitaste.
- Un informe de depuración contiene datos adicionales sobre un informe de atribución o un evento de fuente o activador. Recibir un informe de depuración no necesariamente significa que algo esté funcionando mal. Hay dos tipos de informes de depuración
- Un informe de depuración de transición es un informe de depuración que requiere que se configure una cookie para generarse y enviarse. Los informes de depuración de transición no estarán disponibles si no se configura una cookie y una vez que las cookies de terceros dejen de estar disponibles. Todos los informes de depuración descritos en esta guía son informes de depuración de transición.
- 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 éxito están disponibles desde Chrome 101 (abril de 2022).
- Los informes de depuración detallados pueden hacer un seguimiento de los informes faltantes y ayudarte a determinar por qué faltan. Indican casos en los que el navegador no registró un evento de fuente o activador (lo que significa que no generará un informe de atribución) y casos en los que un informe de atribución no se puede generar ni enviar por algún motivo.
Los informes de depuración detallados incluyen un campo
typeque describe el motivo por el que no se generó un evento de fuente, evento activador o informe de atribución. Los informes detallados de depuración están disponibles a partir de Chrome 109 (estable en enero de 2023). - Las claves de depuración son identificadores únicos que puedes configurar en el lado de la fuente y del activador. Las claves de depuración te permiten asignar conversiones basadas en cookies y conversiones basadas en atribuciones. Cuando hayas configurado tu sistema para generar informes de depuración y definir claves de depuración, el navegador incluirá estas claves de depuración en todos los informes de atribución y de depuración.
Para conocer más conceptos y términos clave que se usan en toda nuestra documentación, consulta el glosario de Privacy Sandbox.
Instrucciones: Cómo verificar tu integración en tiempo real
- Configura tu sistema para generar informes de depuración de éxito. Consulta cómo hacerlo en la Parte 2: Configura los informes de depuración.
- Cada vez que implementes el código de Attribution Reporting, verifica en tiempo real si recibes algunos informes de depuración correctos en tu extremo. Si es así, la configuración de los informes de atribución funciona correctamente.
- Los informes de depuración de éxito solo se envían cuando se produce una conversión. En cambio, es posible que desees verificar que tu integración esté configurada correctamente, independientemente de las conversiones, es decir, que las fuentes se registren correctamente. Para lograrlo, puedes usar los informes de depuración detallados de registro de fuente correcto. Consulta cómo configurarlos en la Parte 2: Configura informes de depuración.
Instructivo: Analiza la pérdida y soluciona problemas de tu integración
Para comparar los resultados de la medición de conversiones basada en cookies con los informes de Attribution Reporting, usa claves de depuración y asigna las conversiones de cookies a los informes de depuración. Recuerda que los informes de depuración se envían de inmediato a tu extremo.
Descripción general
Usa las claves de depuración (par <source_debug_key, trigger_debug_key>) para asignar las conversiones de cookies a los informes de depuración de éxito.
Para cada conversión de cookie, en el momento de la conversión, ¿recibiste un informe de depuración de éxito correspondiente?
Si la respuesta es sí: Para todos estos informes de depuración de éxito, puedes esperar recibir un informe de atribución más adelante, con algunas excepciones. Consulta el caso de informe de depuración de éxito para obtener más detalles.
Si no es así, significa que la conversión no se registró con Attribution Reporting. Usa el par <source_debug_key, trigger_debug_key> (o la clave de depuración de la fuente si no está presente la clave de depuración del activador) para asignar las conversiones de cookies a informes de depuración detallados. Para cada una de estas conversiones, ¿en algún momento (hora de la fuente o del activador) recibiste un informe de depuración detallado correspondiente?
Si no recibiste un informe de depuración detallado, es posible que se deba al comportamiento del usuario o a un problema de integración. Consulta el caso de no generación de informes de depuración para obtener más detalles.
Si recibiste un informe de depuración detallado, consulta su campo
type.Si su
typeessource-success, significa que la fuente se registró correctamente, pero no el activador. Para determinar el motivo por el que falta el informe de depuración de éxito, busca un informe de depuración detallado correspondiente de cualquier otro tipo. Ese informe indicará un problema en el activador.Si su
typees cualquier otra cosa, significa que no se registró la fuente o el activador.typete explica por qué. Faltará el informe de atribución correspondiente (y el informe de depuración de éxito). Según eltypede un informe de depuración detallado, es posible que solo desees tomar esta información como un punto de datos de análisis de pérdidas (en otras palabras, no tienes que realizar ninguna acción) o que desees registrar un error o solucionar problemas de tu implementación. Consulta la situación del informe de depuración detallado para obtener más información.
Situaciones posibles
Informe de depuración de éxito
Si, para una conversión de cookie determinada, recibiste un informe de depuración de éxito, significa que esta conversión se registró correctamente con el Informe de atribución.
Más adelante, recibirás un informe de atribución para esta conversión, con algunas excepciones:
- Comportamiento del usuario: Borrar datos después de la conversión y antes de que se envíe el informe de atribución, cerrar el navegador, etcétera. Si un usuario cierra el navegador después de generar una conversión y no lo abre durante una semana, el informe no se enviará durante una semana o más. Puedes considerar esta demora como una pérdida.
- Solo se aplica a los informes a nivel del evento: Un informe a nivel del evento se reemplaza por otro informe de mayor prioridad.
- Posibles problemas de red
Informe de depuración detallado de tipo source-success
Si, para la fuente de una conversión de cookie determinada, recibiste un informe de depuración detallado del tipo source-success, significa que el registro de la fuente se realizó correctamente. Según si el registro del activador también se realiza correctamente más adelante, es posible que recibas o no un informe para esa conversión.
Sin embargo, hay una advertencia:
Informe de depuración detallado de cualquier otro tipo
Si, para una conversión de cookie determinada, recibiste un informe de depuración detallado de cualquier otro tipo, no recibirás un informe de depuración de éxito y, por lo tanto, más adelante no recibirás un informe de atribución, ya que un informe detallado significa que se produjo un error que se puede informar. Algo impidió el registro de la fuente, el registro del activador, la generación del informe o el envío del informe. Causas posibles:
- Límites de privacidad
- Límites de almacenamiento
- Reglas personalizadas
- Problema de implementación en tu código
- Error del navegador
Algunos de estos son esperables. La acción que se debe realizar depende del type de cada informe detallado. Revisa la referencia de los informes detallados.
No hay informes de depuración
Si, para una conversión de cookie determinada, solo recibiste un informe de atribución (ni un informe de depuración de éxito ni un informe de depuración detallado), significa que algo impidió que se generaran los informes de depuración. Causas posibles:
- Preferencias del usuario (el usuario desactivó las cookies de terceros)
- Falta la cookie o las claves de depuración (la clave de depuración se borró porque falta la cookie). En
chrome://attribution-internals, abre la pestaña Registros y verifica si se muestra algún problema. - Problemas de red que ocurrieron en el momento de la fuente o del activador, pero no cuando se envió el informe de atribución.
¿Recibes informes de atribución?
Este es un caso secundario de no recibir un informe de depuración: Si, para una conversión de cookie determinada, no recibiste informes de ningún tipo (ni informes de depuración ni informes de atribución), significa que se produjo una falla no registrable. Causas posibles:
- Problema de integración fundamental. Revisa cómo solucionar estos problemas en Cómo corregir problemas fundamentales de integración.
- Posibles problemas de red
- Preferencias del usuario en la configuración del navegador, como Privacy Sandbox desactivado
Referencia de informes de depuración detallados
Cada informe de depuración detallado tiene un campo type que registra el motivo por el que se descartó el informe de atribución correspondiente. Usa la referencia para determinar, para cada type del informe detallado, qué acción debes realizar.
Se registró correctamente la fuente
Se registró correctamente una fuente.
source-success- Detalles y cuerpo del informe
Informes de limitaciones de privacidad
Se esperan estos informes. Indican limitaciones de privacidad para reducir la filtración de la identidad del usuario entre sitios.
source-destination-limit- Detalles y cuerpo del informe
source-noised- Detalles y cuerpo del informe
trigger-attributions-per-source-destination-limit- Detalles y cuerpo del informe
trigger-reporting-origin-limit- Detalles y cuerpo del informe
trigger-event-noise- Detalles y cuerpo del informe
trigger-event-excessive-reports- Este mensaje se genera si el recuento de informes supera el límite. Puedes registrar, como máximo, una conversión para las vistas y tres para los clics. Ten en cuenta que puedes configurar los informes que deseas recibir estableciendo prioridades. Detalles y cuerpo del informe
Informes de limitaciones de almacenamiento
Se esperan estos informes. Indican limitaciones de almacenamiento para evitar el uso excesivo de recursos.
source-storage-limit- Detalles y cuerpo del informe
trigger-event-storage-limit- Detalles y cuerpo del informe
trigger-aggregate-storage-limit- Cuerpo del informe y detalles
Informes de reglas personalizadas
Estos informes son los esperados si utilizas filtros, eliminación de duplicados, prioridades o filtros basados en ventanas. Por si acaso, vuelve a verificar las reglas personalizadas correspondientes para confirmar que el informe correspondiente a ese informe detallado es, de hecho, un informe que deseas descartar. Si es correcto, no es necesario que realices ninguna acción.
trigger-no-matching-filter-data- Detalles y cuerpo del informe
trigger-event-no-matching-configuration- Detalles y cuerpo del informe
trigger-event-deduplicated- Detalles y cuerpo del informe
trigger-aggregate-deduplicated- Detalles y cuerpo del informe
trigger-event-low-priority- Detalles y cuerpo del informe
trigger-event-report-window-passed- Detalles y cuerpo del informe
trigger-aggregate-report-window-passed- Cuerpo del informe y detalles
Otros informes detallados
Estos informes pueden indicar posibles problemas de implementación en tu código.
trigger-no-matching-source- Este puede ser un problema de implementación. Verifica que no haya ningún error de configuración en la configuración de
<reporting origin, destination>. Este también podría ser el comportamiento esperado de la API. Por ejemplo, el usuario borró los datos en algún momento después de interactuar con un anuncio y antes de generar una conversión, o bien generó una conversión sin haber visto nunca un anuncio asociado. Detalles y cuerpo del informe trigger-aggregate-no-contributions- Es probable que este no sea el comportamiento que deseas que tenga tu código. Soluciona problemas relacionados con el código de registro del activador y asegúrate de que la configuración de contribución sea correcta. Detalles y cuerpo del informe
trigger-aggregate-insufficient-budget- Es probable que este no sea el comportamiento que deseas que tenga tu código. Verifica tu código de registro del activador para asegurarte de que la suma de todas las contribuciones no supere el presupuesto de contribución. Detalles y cuerpo del informe
Errores inesperados (posibles errores del navegador)
Estos informes son inesperados. Podrían deberse a un error del navegador. Presenta un error y especifica en la descripción los pasos para reproducirlo.
source-unknown-error- Detalles y cuerpo del informe
trigger-unknown-error- Cuerpo del informe y detalles
Ejemplo de análisis de pérdidas
Paso 1: Configuración y asignación con cookies
Sigue las instrucciones de la Parte 2: Configura informes de depuración para configurar tu sistema de modo que genere informes de depuración de éxito y informes de depuración detallados.
Con esto, puedes usar la información de conversiones basada en cookies para buscar los informes de depuración o los informes de atribución correspondientes.
Paso 2: Identifica los registros exitosos y los informes faltantes
En este ejemplo, supongamos que realizaste un seguimiento de 100 conversiones con tu sistema basado en cookies.
Cada vez que registres una conversión basada en cookies, busca el informe de depuración de éxito (que se envía de inmediato) que tenga el mismo par de <source_debug_key, trigger_debug_key> que esta conversión basada en cookies.
Supongamos que recibiste un informe de depuración exitoso para 70 de estas conversiones por cookie.
- Los informes de éxito significan que la atribución se registró correctamente, por lo que puedes suponer con seguridad que recibirás un informe de atribución que corresponda a cada informe de éxito, con algunas excepciones.
- Puedes decidir supervisar estas excepciones. Para ello, a medida que se envíen informes de atribución a tu endpoint en los próximos días o semanas (según la fecha de vencimiento), busca los informes de atribución que tengan el mismo par de claves de depuración que cada informe de depuración de éxito. Asegúrate de esperar un poco, ya que es posible que los informes no se envíen de inmediato al final de cada período. Supongamos que solo encuentras 60 informes de atribución. Es posible que los 10 informes de atribución faltantes se deban al comportamiento del usuario.
Paso 3: Evaluación breve de la pérdida
Faltan 30 informes de depuración de éxito (100 - 70 = 30). Esto significa que esas 30 conversiones (que se registraron en tu implementación basada en cookies) no se registraron con el Informe de atribución. No recibirás informes de atribución para estos.
Dado que tienes 100 conversiones basadas en cookies y solo 70 conversiones basadas en la atribución, tu pérdida es del 30%. Ahora tienes una breve evaluación de pérdidas.
Paso 4: Analiza las causas
Para investigar por qué faltan estos informes, busca los informes de depuración detallados correspondientes que recibiste en el momento de la conversión (registro del activador) o antes, en el momento del registro de la fuente. Usa las claves de las conversiones basadas en cookies para asignarlas a informes de depuración detallados.
- Supongamos que hay 10 claves para las que no hay un informe de depuración detallado. Comprueba si hay algún problema de integración. De lo contrario, es posible que se deba al comportamiento del usuario.
- Tienes 20 informes de depuración detallados. Ahora puedes definir mejor tu análisis de pérdidas. Analiza el campo
typede cada informe detallado. Por ejemplo, es posible que descubras lo siguiente:- Faltan 10 informes (el 10% en nuestro ejemplo) debido a
pending destination limit - Faltan 5 informes (el 5%) debido a
trigger-aggregate-no-contributions. - Faltan 5 informes (el 5%) debido a
unknown-error.
- Faltan 10 informes (el 10% en nuestro ejemplo) debido a
Paso 5: Toma medidas y soluciona problemas
Ahora que tienes visibilidad sobre por qué faltan informes, puedes tomar medidas en función de estas estadísticas.
La acción que se debe realizar depende del type de cada informe detallado. Revisa la referencia de los informes detallados para obtener más información. Por ejemplo:
pending-destination-limites una protección de la privacidad. No es necesario realizar ninguna acción. Usa este número como un punto de datos para tu propia visibilidad y supervisión.trigger-aggregate-no-contributionspuede ser un signo de un problema de implementación de tu lado. Analiza esto más a fondo. Usa los detalles del cuerpo del informe detallado para solucionar el problema si es necesario.unknown-errorpuede ser un signo de un error del navegador o de la red. Si esto te sucede con frecuencia, informa el error a los desarrolladores del navegador.