Comienza a usar Attribution Reporting

Aquí te explicamos cómo comenzar, que incluye la configuración y una breve descripción general.

Elige un tipo de informe

Con la API de Attribution Reporting, puedes generar dos tipos de informes: informes a nivel del evento y de resumen. Los informes a nivel del evento requieren menos configuración que los informes agregables o de resumen, por lo que pueden ser un buen punto de partida. Los informes de resumen requieren integración con el servicio de agregación. los informes a nivel del evento no lo hacen.

Puedes configurar informes a nivel del evento y de resumen. Son complementarios.

Informes a nivel del evento

Los informes a nivel del evento asocian una vista o un clic específico en el anuncio (en el lado del anuncio) con los datos de la conversión. Para preservar la privacidad del usuario mediante la limitación de la identificación de identidades del usuario en diferentes sitios, los datos orientados a las conversiones son muy limitados y los datos son ruidosos.

Resumen de informes

Un informe de resumen es un tipo de informe de la API de Attribution Reporting y la API de Private Aggregation. Un resumen incluye datos agregados del usuario y puede tener datos de conversiones detallados con ruido agregado. Los informes de resumen se componen de informes agregados. Los informes de resumen permiten una mayor flexibilidad y un modelo de datos más rico que los informes a nivel del evento, en particular para algunos casos de uso, como los valores de conversión.

Implementación

Para comenzar, prueba los pasos que se incluyen a continuación.

Ten en cuenta que para una fuente de eventos determinada, es posible generar un a nivel del evento y un informe agregable. El demo te guiará a lo largo del proceso.

Generación de informes a nivel del evento

Estos son los pasos mínimos que se deben seguir para generar informes a nivel del evento:

  1. Registra una fuente. Consulta Cómo registrar fuentes de atribución para obtener las instrucciones. Ten en cuenta que los pasos son diferentes para los clics y las vistas.

  2. Registra un activador. Consulta Registra activadores de atribución para obtener instrucciones.

  3. Configura un extremo con la siguiente URL:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution
    Consulta el código de ejemplo en adtech.js para ver el método POST y consulta Wikipedia para obtener más información sobre .well-known.

Puedes encontrar más detalles en la explicación del informe a nivel del evento.

Generación de informes de resumen

Para generar informes de resumen, sigue estos pasos de alto nivel:

  1. Registra una fuente. Consulta Cómo registrar fuentes de atribución para obtener las instrucciones. Ten en cuenta que los pasos son diferentes para los clics y las vistas. Puedes encontrar detalles adicionales en Registro de la fuente de atribución.

  2. Registra un activador. Consulta Registra activadores de atribución para obtener instrucciones.

  3. Configura un extremo para los informes agregables con la siguiente URL:
    {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution
    Consulta el código de ejemplo en adtech.js para ver el método POST y consulta Wikipedia para obtener más información sobre .well-known.

  4. Agrupa en lotes y envía los informes para su posterior procesamiento por parte del servicio de agregación, que generará informes de resumen. Consulta los informes agregables por lotes.

Puedes encontrar más detalles en la explicación de informes agregables.

Obtén información para configurar informes de depuración en la serie de depuración de informes de atribución.

Conceptos adicionales de los informes de resumen

Además de comprender los pasos de implementación que se indican aquí, los siguientes conceptos te ayudarán a planificar tu estrategia de informes de resumen:

Pasos opcionales

  1. Configura filtros (opcional):
    1. Sigue las instrucciones que se indican en Define reglas personalizadas mediante filtros.
    2. Revisa los detalles específicos de los filtros para informes agregables en a la sección de activadores de la explicación.

No olvides la detección de funciones

Antes de usar la API, usa una política de permisos para detectar si no se bloqueó en la página. Para ello, ejecuta el siguiente código:

if (document.featurePolicy.allowsFeature('attribution-reporting')) {
  // the Attribution Reporting API is enabled
}

Si esta verificación de detección de funciones muestra el valor "true", la API se permite en el contexto (página) en el que se ejecuta la verificación.

Ten en cuenta que esta verificación por sí sola no es una garantía de que la API se pueda usar en esa página. Es posible que el usuario haya inhabilitado la API mediante la configuración del navegador o que tenga otra configuración que impida su uso. Para proteger la privacidad del usuario, no hay forma de verificarlo de manera programática.

Próximos pasos

Si tienes todo listo para comenzar la implementación, consulta estos documentos:

Configuración

Información general

Demostraciones y herramientas

Planificación

Si todavía te encuentras en la etapa de planificación, consulta estos documentos: