Se usó la API de Cloud Translation para traducir esta página.

Guía de soluciones de depuración de Attribution Reporting

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 la fuente y los encabezados del 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 (también conocido como informe) 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 sobre una fuente o un evento activador. Recibir un informe de depuración no significa necesariamente que algo esté funcionando de forma incorrecta. Existen dos tipos de informes de depuración
Un informe de depuración de transición es aquel que requiere que se configure una cookie para que se pueda generar y enviar. Los informes de depuración transitorios 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 que se describen en esta guía son informes de depuración transitorios.
Los informes de depuración de errores realizan 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).
Los informes de depuración detallados pueden hacer un seguimiento de los informes faltantes y ayudarte a determinar por qué no aparecen. Indican casos en los que el navegador no registró una fuente o un evento activador (lo que significa que no generará un informe de atribución) y casos en los que, por algún motivo, no se puede generar ni enviar un informe de atribución. Los informes de depuración detallados incluyen un campo type que describe el motivo por el que no se generó un evento de fuente, un evento de activador o un informe de atribución. Los informes de depuración detallados están disponibles a partir de la versión 109 de Chrome (estable a partir de enero de 2023).
Las claves de depuración son identificadores únicos que puedes configurar en el lado del código fuente y en el 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 establecer 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 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

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 es source-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 el type 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.

Nota: Si el type de un informe detallado comienza con trigger-event, solo se puede generar para los eventos de fuente o activador que estén asociados con informes a nivel del evento. Si el type de un informe detallado comienza con trigger-aggregate, solo se puede generar para los eventos de fuente o activador que estén asociados con informes agregables. En todos los demás casos, es para un informe a nivel del evento o con agregación.

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.

Nota: Es posible que tengas informes de atribución a nivel del evento que no estén asignados a una conversión basada en cookies. Lo más probable es que se trate de informes ruidosos que la API generó de forma aleatoria. Para confirmarlo, busca informes detallados de depuración de tipo source-noised que tengan la misma clave de depuración de fuente que el informe a nivel del evento.

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.

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.