En esta guía, se proporciona una descripción general y las instrucciones de configuración para 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:
Diferenciar los tipos de informes de la API de Attribution Reporting
Pasos para completar la implementación de la API y la generación de informes
Encuentra información de referencia y para solucionar 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 un clic o una vista del anuncio específicos (la fuente) con los datos de conversiones 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 los 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 de usuarios agregados y pueden incluir información de conversiones más detallada con ruido agregado. Se construyen a partir de informes agregados y ofrecen un modelo de datos más completo que los informes a nivel del evento. Los informes de resumen son especialmente útiles para situaciones que requieren estadísticas agregadas, como calcular los valores de conversión o analizar el rendimiento de la campaña en los diferentes 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 y 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:
Registra una fuente: Asocia un clic o una vista del anuncio con la información de atribución. Consulta Cómo registrar 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.
Registra un activador: Registra un evento de conversión y lo vincula a una fuente registrada previamente. Consulta Cómo registrar activadores de atribución para obtener instrucciones.
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 enadtech.jspara ver un ejemplo del métodoPOST. 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
Registra una fuente: Es igual que para los informes a nivel del evento. Consulta Cómo registrar fuentes de atribución y Registro de fuentes de atribución para obtener más detalles.
Registra un activador: Es igual que para los informes a nivel del evento. Consulta Cómo registrar activadores de atribución.
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. Consultaadtech.jspara ver un ejemplo del métodoPOSTy Wikipedia para obtener información sobre.well-known.Genera informes por lotes y envíalos: Genera los 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, es posible que la configuración del navegador del usuario o algún otro factor impidan que se use la API. Debido a consideraciones de privacidad, no hay una forma programática de confirmar de manera definitiva 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.