Comienza a usar los informes de atribución

En esta guía, se proporciona una descripción general y las instrucciones de configuración de los informes de atribución a nivel del evento y de resumen con la API de Attribution Reporting.

Para comenzar, aprenderás a hacer lo siguiente:

  • Diferencia entre los tipos de informes de la API de Attribution Reporting

  • Completa los pasos de implementación de la API y generación de informes

  • Encuentra información de referencia y solución de problemas

Elige un tipo de informe

Para medir de manera eficaz el rendimiento de las campañas publicitarias con diferentes niveles de detalle y privacidad, la API de Attribution Reporting proporciona dos tipos de informes distintos:

  • Informes a nivel del evento: Proporcionan datos detallados que vinculan una vista o un clic en el anuncio específicos (la fuente) con los datos de conversión correspondientes (el activador). Los informes a nivel del evento limitan la cantidad de datos de conversiones y agregan ruido a los informes. Son ideales para casos de uso en los que la atribución de eventos individuales es clave, como la medición del alcance de la campaña.

  • Informes de resumen: Ofrecen datos agregados del usuario y pueden incluir información de conversiones más detallada con información irrelevante adicional. Con la API de Attribution Reporting y la API de Private Aggregation, se crean a partir de informes agregados y ofrecen un modelo de datos más rico que los informes a nivel del evento. Los informes de resumen son particularmente útiles en situaciones que requieren estadísticas agregadas, como calcular los valores de conversión o analizar el rendimiento de las campañas en los segmentos de usuarios.

Descripción general de la implementación

En las siguientes secciones, se describen los pasos generales para generar cada tipo de informe. También puedes seguir la demostración de la API de Attribution Reporting para obtener una explicación paso a paso de todo el proceso.

Requisito previo: Tus sitios deben tener certificados SSL/TLS (HTTPS) para que puedas registrar fuentes, activadores y recibir informes.

Generación de informes a nivel del evento

En los siguientes pasos, se describe cómo generar informes a nivel del evento:

  1. Registra una fuente: Asocia un clic o una vista de un anuncio con la información de atribución. Consulta Registra fuentes de atribución y Registro de fuentes de atribución para obtener instrucciones detalladas. Ten en cuenta que el proceso de registro difiere ligeramente para los clics y las vistas.

  2. Registrar un activador: Registra un evento de conversión y lo vincula a una fuente registrada anteriormente. Consulta Registra activadores de atribución para obtener instrucciones.

  3. Configura un extremo de informes: Crea un extremo en tu servidor para recibir informes a nivel del evento. La URL del extremo debe seguir este formato: {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-event-attribution. Consulta el código de ejemplo en adtech.js para ver un ejemplo del método POST. Para obtener más información sobre .well-known, consulta Wikipedia.

Para obtener más información sobre los informes a nivel del evento, consulta la explicación de los informes a nivel del evento.

Generación de informes de resumen

  1. Registra una fuente: Haz lo mismo que para los informes a nivel del evento. Consulta Registra fuentes de atribución y Registro de fuentes de atribución para obtener más detalles.

  2. Registrar un activador: Igual que para los informes a nivel del evento. Consulta Registra activadores de atribución.

  3. Configura un extremo de informes: Crea un extremo para recibir informes agregados. La URL debe ser {REPORTING_ENDPOINT}/.well-known/attribution-reporting/report-aggregate-attribution. Consulta adtech.js para ver un ejemplo del método POST y Wikipedia para obtener información sobre .well-known.

  4. Envía informes por lotes: Genera informes agregados por lotes y envíalos al servicio de agregación para su procesamiento. Luego, el servicio de agregación generará informes de resumen. Consulta Estrategias para el procesamiento por lotes para obtener más información.

Para obtener más información sobre los informes de resumen, consulta la explicación de los informes agregables.

Además de los pasos de implementación, los siguientes temas te ayudarán a planificar tu estrategia de informes de resumen:

Cómo configurar filtros (opcional)

Para obtener un control más detallado sobre los datos de atribución que recibes, puedes configurar filtros.

El filtrado proporciona un análisis de datos refinado que aísla subconjuntos específicos de datos para tu análisis, lo que reduce el ruido. También ayuda a hacer un seguimiento del rendimiento de campañas publicitarias y eventos de conversión específicos para obtener una medición más precisa.

Para configurar el filtrado, consulta Cómo definir reglas personalizadas con filtros y la sección de activadores del registro de activadores de atribución para obtener detalles específicos sobre los informes agregables.

Confirme que la API esté habilitada

Antes de usar la API, verifica si está habilitada con el siguiente código:

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

Esta verificación indica si la API está permitida en el contexto actual. Sin embargo, la configuración del navegador del usuario o algún otro factor podrían impedir que se use la API. Debido a consideraciones de privacidad, no hay una forma programática de confirmar definitivamente la usabilidad de la API.

Próximos pasos

En las siguientes secciones, se proporciona más información para comenzar a usar los informes de atribución.

Implementación

Antecedentes y conceptos

Demostraciones y herramientas

Planificación