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

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

  • The reporting origin is the origin that sets the Attribution Reporting source and trigger headers. All reports generated by the browser are sent to this origin. In this guidance, we use https://adtech.example as the example reporting origin.
  • An attribution report (report for short) is the final report (event-level or aggregatable) that contains the measurement data you've requested.
  • A debug report contains additional data about an attribution report, or about a source or trigger event. Receiving a debug report does not necessarily mean that something is working incorrectly! There are two types of debug reports
  • A transitional debug report is a debug report that requires a cookie to be set in order to be generated and sent. Transitional debug reports will be unavailable if a cookie is not set, and once third-party cookies are deprecated. All debug reports described in this guide are transitional debug reports.
  • Success debug reports track successful generation of an attribution report. They relate directly to an attribution report. Success debug reports have been available since Chrome 101 (April 2022).
  • Verbose debug reports can track missing reports and help you determine why they're missing. They indicate cases where the browser did not record a source or trigger event, (which means it will not generate an attribution report), and cases where an attribution report can't be generated or sent for some reason. Verbose debug reports include a type field that describes the reason why a source event, trigger event or attribution report was not generated. Verbose debug reports are available starting in Chrome 109 (Stable in January 2023).
  • Debug keys are unique identifiers you can set on both the source side and the trigger side. Debug keys enable you to map cookie-based conversions and attribution-based conversions. When you've set up your system to generate debug reports and set debug keys, the browser will include these debug keys in all attribution reports and debug reports.

For more concepts and key terms used throughout our documentation, refer to the Privacy Sandbox glossary.

Instructivo: Cómo verificar tu integración en tiempo real

  1. 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.
  2. 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.
  3. 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

Pasos para realizar un análisis de pérdidas

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 type es source-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 type es cualquier otro valor, significa que no se registró la fuente o el activador. type te indica el motivo. Faltará el informe de atribución correspondiente (y el informe de depuración de atribución correcta). Según el type de 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:

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 type de 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.

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-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 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-error puede ser un error de navegador o de red. Si esto sucede de forma reiterada, informa un error a los desarrolladores del navegador.