Parte 3 de 3 sobre la depuración de Attribution Reporting. Obtén 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.
Instructivo: Cómo verificar tu integración en tiempo real
- Configura tu sistema para que genere informes de depuración exitosos. Consulta cómo hacerlo en la Parte 2: Configura los informes de depuración.
- Cada vez que implementes el código de los informes de atribución, verifica en tiempo real si recibes algunos informes de depuración correctos en tu extremo. Si es así, significa que la configuración de los informes de atribución funciona.
- Los informes de depuración correctos solo se envían cuando se produce una conversión. En su lugar, te recomendamos que verifiques que tu integración esté configurada correctamente, independientemente de las conversiones, es decir, que las fuentes se hayan registrado 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 los informes de depuración.
Instructivo: Cómo analizar las pérdidas y solucionar problemas de tu integración
Para comparar los resultados de la medición de conversiones basadas en cookies con los informes de atribución, usa claves de depuración y asigna las conversiones de cookies con 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 correctos.
Para cada conversión de cookie, ¿recibiste un informe de depuración correcto en el momento de la conversión?
Si es así, para todos estos informes de depuración correctos, es posible que recibas un informe de atribución más adelante, con algunas excepciones. Revisa el caso de éxito del informe de depuración para obtener más información.
De lo contrario, significa que la conversión no se registró en los informes de atribución. Usa el par <source_debug_key, trigger_debug_key> (o la clave de depuración de la fuente si no hay una clave de depuración del activador) para asignar las conversiones de cookies a informes de depuración detallados. Para cada una de estas conversiones, ¿recibiste en algún momento (fuente o tiempo de activación) 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. Revisa la situación sin informe 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 acotar el motivo por el que falta el informe de depuración correcto, busca un informe de depuración detallado correspondiente de cualquier otro tipo. Ese informe indicará un problema en el activador.Si su
typees cualquier otro valor, significa que no se registró la fuente o el activador.typete indica el motivo. Faltará el informe de atribución correspondiente (y el informe de depuración de atribución correcta). Según eltypede un informe de depuración detallado, es posible que desees tomar esta información como un dato de análisis de pérdidas (en otras palabras, no debes realizar ninguna acción) o que desees informar un error o solucionar problemas relacionados con tu implementación. Revisa la situación del informe de depuración detallado para obtener más información.
Situaciones posibles
Informe de depuración correcto
Si, para una conversión de cookie determinada, recibiste un informe de depuración correcto, significa que esta conversión se registró correctamente en los Informes de atribución.
Es posible que recibas más adelante un informe de atribución para esta conversión⏤, con algunas excepciones:
- Comportamiento del usuario: Borra los datos después de la conversión y antes de que se envíe el informe de atribución, cierra 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 prioridad más alta.
- 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 de 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 de esa conversión.
Hay una salvedad:
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 correcto y, por lo tanto, más adelante, no recibirás un informe de atribución⏤porque un informe detallado significa que se produjo un error que se puede informar. Se produjo un error que impidió el registro de la fuente, el registro del activador, la generación o el envío de informes. 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 informes detallados.
No hay informes de depuración
Si, para una conversión de cookie determinada, solo recibiste un informe de atribución (sin informe de depuración correcto ni 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ó debido a que falta la cookie). En
chrome://attribution-internals, abre la pestaña Registros y verifica si aparece algún problema. - Problemas de red que se produjeron en la fuente o en el momento del activador, pero no cuando se envió el informe de atribución.
¿Recibes informes de atribución?
Este es un subcaso 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 que no se puede informar. Causas posibles:
- Problema de integración fundamental. Revisa cómo solucionar estos problemas en Cómo solucionar problemas de integración fundamentales.
- Posibles problemas de red.
- Las preferencias del usuario en la configuración del navegador, como Privacy Sandbox, están desactivadas.
Referencia de los informes de depuración detallados
Cada informe de depuración detallado tiene un campo type que captura 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
Estos informes son esperables. Indican limitaciones de privacidad para reducir la filtración de identidades de los usuarios 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- Se genera si el recuento del informe supera el límite. Puedes registrar una conversión como máximo para las vistas y tres para los clics. Ten en cuenta que puedes configurar qué informes recibir estableciendo prioridades. Detalles y cuerpo del informe
Informes de limitaciones de almacenamiento
Estos informes son esperables. 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- Detalles y cuerpo del informe
Informes de reglas personalizadas
Se esperan estos informes si usas filtros, anulación de duplicación, 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 realmente un informe que deseas descartar. Si esto 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- Detalles y cuerpo del informe
Otros informes detallados
Estos informes pueden indicar posibles problemas de implementación en tu código.
trigger-no-matching-source- Es posible que se trate de un problema de implementación. Verifica que no haya una configuración incorrecta en la configuración de
<reporting origin, destination>. Esto también puede ser un 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 ver 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 los 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. Vuelve a verificar el código de registro del activador para asegurarte de que la suma de todas las contribuciones no supere el presupuesto de contribuciones. Detalles y cuerpo del informe
Errores inesperados (posibles errores del navegador)
Estos informes son inesperados. Podrían deberse a un error del navegador. Informa un error y especifica en la descripción los pasos para reproducirlo.
source-unknown-error- Detalles y cuerpo del informe
trigger-unknown-error- Detalles y cuerpo del informe
Ejemplo de análisis de pérdidas
Paso 1: Configuración y asignación con cookies
Sigue las instrucciones de la Parte 2: Configura los informes de depuración para configurar tu sistema de modo que genere informes de depuración correctos 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 de atribución correspondientes.
Paso 2: Identifica los registros correctos 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 <source_debug_key, trigger_debug_key> que esta conversión basada en cookies.
Supongamos que recibiste un informe de depuración correcto para 70 de estas conversiones de cookies.
- Los informes de éxito indican que la atribución se registró correctamente, por lo que puedes suponer que recibirás un informe de atribución que corresponde a cada informe de éxito, con algunas excepciones.
- Puedes supervisar estas excepciones. Para ello, a medida que los informes de atribución se envíen a tu extremo en los próximos días o semanas (según el vencimiento), busca los informes de atribución que tengan el mismo par de claves de depuración que cada informe de depuración correcto. Asegúrate de esperar un poco: 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 de los usuarios.
Paso 3: Evaluación breve de la pérdida
Faltan 100-70 = 30 informes de depuración de atribución correcta. Esto significa que estas 30 conversiones (a las que se les hizo un seguimiento en tu implementación basada en cookies) no se registraron en los informes de atribución. No recibirás informes de atribución para ellos.
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 notes lo siguiente:- Faltan 10 informes (= 10% en nuestro ejemplo) debido a
pending destination limit. - Faltan 5 informes (= 5%) debido a
trigger-aggregate-no-contributions. - Faltan 5 informes (= 5%) debido a
unknown-error.
- Faltan 10 informes (= 10% en nuestro ejemplo) debido a
Paso 5: Toma medidas y soluciona problemas
Ahora que sabes por qué faltan informes, puedes actuar en función de estas estadísticas.
La acción que se debe realizar depende del type de cada informe detallado. Consulta la referencia de informes detallados para obtener más información. Por ejemplo:
pending-destination-limites una protección de la privacidad. No es necesario que realices ninguna acción. Usa este número como dato para tu propia visibilidad y supervisión.trigger-aggregate-no-contributionspuede ser un signo de un problema de implementación de tu parte. 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 error de navegador o de red. Si esto sucede de forma reiterada, informa un error a los desarrolladores del navegador.