Algunas tecnologías de Privacy Sandbox se están descontinuando.

Consulta nuestra Actualización sobre los planes para las tecnologías de Privacy Sandbox.

Estado de las funciones de Privacy Sandbox proporciona más información sobre el estado de las APIs y las funciones de la plataforma individuales.

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

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

Pasos para realizar un análisis de pérdidas — Pasos para 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 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 type es source-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 type es cualquier otra cosa, significa que no se registró la fuente o el activador. type te explica por qué. Faltará 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, 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.

Nota: Si el type de un informe detallado comienza con trigger-event, solo se puede generar para eventos de fuente o de activación 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 eventos de fuente o de activador que estén asociados con informes agregables. En todos los demás casos, se trata de un informe a nivel del evento o agregable.

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.

Nota: Es posible que tengas informes de atribución a nivel del evento que no se asignen a una conversión basada en cookies. Es muy probable que se trate de informes ruidosos que la API generó de forma aleatoria. Para confirmar esto, busca informes detallados de depuración de tipo source-noised que tengan la misma clave de depuración de la fuente que tu informe a nivel del evento.

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

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-limit es 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-contributions puede 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-error puede 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.