Parte 3 de 3 sobre la depuración de Attribution Reporting. Encuentra instrucciones para usar los informes de depuración.
En esta guía de soluciones, encontrarás instrucciones sobre cómo usar los informes de depuración para 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.example
como 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
type
que 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: Verifica 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 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 de éxito en tu extremo. Si es así, la configuración de Attribution Reporting funciona correctamente.
- Los informes de depuración de éxito solo se envían cuando se produce una conversión. En cambio, te recomendamos que verifiques que la integración esté configurada correctamente, independientemente de las conversiones, es decir, que verifiques que las fuentes se hayan registrado correctamente. Para lograrlo, puedes confiar en que el registro de la fuente sea exitoso informes de depuración detallados. Consulta cómo configurarlos en la Parte 2: Configura informes de depuración.
Instructivo: Analiza las pérdidas y soluciona los problemas de tu integración
Para comparar los resultados de la medición de conversiones basadas en cookies con los informes de 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
![Pasos para un análisis de pérdidas](https://developers-dot-devsite-v2-prod.appspot.com/static/privacy-sandbox/assets/images/steps-a-loss-analysis-92c05fa7a306c.png?authuser=4&hl=es)
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, al momento de la conversión, ¿recibiste un informe de depuración de éxito correspondiente?
Si es así, para todos estos informes de depuración de errores, es posible que recibas un informe de atribución más adelante, con algunas excepciones. Revisa la situación del informe de depuración de éxito para obtener más detalles.
Si no lo hizo, significa que no se registró la conversión en Attribution Reporting. Usa el par <source_debug_key, trigger_debug_key>
(o la clave de depuración de origen si falta la clave de depuración del activador) para asignar las conversiones de cookies a los informes de depuración detallados. ¿Recibiste en algún momento el informe de depuración detallado correspondiente a cada una de estas conversiones?
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 de informe sin depuración para obtener más detalles.
Si recibiste un informe de depuración detallado, consulta su campo
type
.Si su
type
essource-success
, significa que la fuente se registró correctamente, pero el activador no. Para limitar el motivo por el que falta el informe de depuración de éxito, busca el informe de depuración detallado correspondiente de cualquier otro tipo⏤, ese informe indicará un problema en el lado del activador.Si su
type
es cualquier otra cosa, significa que la fuente o el activador no se registraron.type
te explica por qué. Falta el informe de atribución correspondiente (y el informe de depuración de éxito). Según eltype
de un informe de depuración detallado, tal vez quieras tomar esta información como un dato del análisis de pérdida (en otras palabras, no hacer nada) o puedes informar un error o solucionar problemas de tu implementación. Revisa la situación del informe de depuración detallado para obtener más detalles.
Situaciones posibles
Informe de depuración de éxito
Si recibiste un informe de depuración de éxito para una conversión de cookie determinada, significa que esta conversión se registró correctamente en Attribution Reporting.
Recibirás un informe de atribución de esta conversión más adelante⏤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, cierre del 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 aplicable 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 de tipo source-success
, significa que el registro de la fuente se realizó correctamente. En función de 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.
Ten en cuenta lo siguiente:
Informe de depuración detallado de cualquier otro tipo
Si, en el caso de 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, no recibirás un informe de atribución⏤porque un informe detallado significa que se produjo un error que se puede informar. Hubo un problema que impidió el registro de la fuente, el registro del activador, la generación de informes 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
Algunas de estas son previsibles. 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, en el caso de una conversión de cookie determinada, solo recibiste un informe de atribución (no hay 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)
- Faltan cookies o claves de depuración (se borró la clave de depuración debido a que falta una cookie). En
chrome://attribution-internals
, abre la pestaña Registros y verifica si aparece 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 en el que no se recibió un informe de depuración: si, para una conversión de cookie determinada, no recibiste informes de ningún tipo (ningún informe de depuración de ningún tipo ni informe de atribución), significa que se produjo un error que no se puede informar. Causas posibles:
- Problema de integración fundamental. Consulta cómo solucionarlos en Cómo solucionar problemas fundamentales de integración.
- Posibles problemas de red.
- Se desactivaron las preferencias del usuario en la configuración del navegador, como Privacy Sandbox.
Referencia de 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 averiguar qué acción debes realizar para cada type
de informe detallado.
El registro de la fuente se realizó correctamente
Se registró correctamente una fuente.
source-success
- Detalles y cuerpo del informe
Informes de limitaciones de privacidad
Estos informes son los esperados. Indican que hay limitaciones de privacidad para reducir la filtración de identidad 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 registro del informe 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 establecer las prioridades para configurar qué informes deseas recibir. Cuerpo del informe y detalles
Informes de limitaciones de almacenamiento
Estos informes son los esperados. 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
Estos informes son esperables si usas filtros, anulación de duplicación, prioridades o filtrado basado en ventanas. Por si acaso, vuelve a verificar las reglas personalizadas correspondientes para confirmar que el informe correspondiente a ese informe detallado realmente sea el que deseas eliminar. 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
- Esto puede ser un problema de implementación. Verifica que no haya una configuración incorrecta en tu configuración de
<reporting origin, destination>
. Este también puede 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 ver nunca un anuncio asociado. Cuerpo del informe y detalles trigger-aggregate-no-contributions
- Es probable que este no sea el comportamiento que deseas que tenga tu código. Soluciona los problemas del código de registro del activador. Asegúrate de que la configuración de contribución sea correcta. Cuerpo del informe y detalles
trigger-aggregate-insufficient-budget
- Es probable que este no sea el comportamiento que deseas que tenga tu código. Verifica el código de registro del activador para asegurarte de que la suma de todas las contribuciones no supere el presupuesto de contribuciones. Cuerpo del informe y detalles
Errores inesperados (posibles errores del navegador)
Estos informes son inesperados. Podría deberse a un error del navegador. Informa un error y especifica en tu 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 informes de depuración para configurar tu sistema a fin de generar informes de depuración correctos y también informes de depuración detallados.
De esta forma, puedes utilizar información de conversión basada en cookies para buscar los informes de depuración o de atribución correspondientes.
Paso 2: Identifica los registros exitosos y los informes faltantes
En este ejemplo, supongamos que ha realizado un seguimiento de 100 conversiones con su 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 de éxito de 70 de estas conversiones de cookies.
- Los informes de éxito indican que la atribución se registró correctamente, por lo que puedes suponer con seguridad que obtendrás un informe de atribución correspondiente a cada informe de éxito, con algunas excepciones.
- Puedes decidir supervisar estas excepciones. Para ello, dado que los informes de atribución se envían a su extremo durante los próximos días o semanas (según el vencimiento), busque 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, ya que es posible que los informes no se envíen inmediatamente al final de cada ventana. Supongamos que solo ves 60 informes de atribución. Los 10 informes de atribución faltantes pueden deberse al comportamiento del usuario.
Paso 3: Evaluación breve de pérdida
Faltan 100-70 = 30 informes de depuración de éxito. Esto significa que estas 30 conversiones (de las que se hizo un seguimiento en su implementación basada en cookies) no se registraron con Attribution Reporting. No recibirás informes de atribución sobre estos temas.
Como tienes 100 conversiones basadas en cookies y solo 70 conversiones basadas en atribuciones, tu pérdida es del 30%. Ahora tienes una breve evaluación de pérdidas.
Paso 4: Analizar las causas
Para investigar por qué faltan estos informes, busca los informes de depuración detallados correspondientes que recibiste al momento de la conversión (registro del activador) o antes al momento del registro de la fuente. Utiliza las claves de las conversiones basadas en cookies para asignarlas a los 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, esto puede deberse al comportamiento del usuario.
- Tienes 20 informes de depuración detallados. Ahora puedes definir mejor tu análisis de pérdida. Analiza el campo
type
de cada informe detallado. Por ejemplo, es posible que observes 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 los problemas
Ahora que sabes por qué faltan los 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 detalles. Por ejemplo:
pending-destination-limit
es 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-contributions
puede ser la señal de un problema de implementación por tu parte. Analiza esto más a fondo. Usa los detalles del cuerpo del informe detallado para solucionar el problema y, si es necesario.unknown-error
podría indicar un error del navegador o de red. Si encuentras esto repetidamente, informa un error a los desarrolladores de navegadores.