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, a diferencia de los informes a nivel de evento.
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 de la API de Private Aggregate. Un informe de resumen incluye datos agregados del usuario y puede contener datos de conversiones detallados, a los que se agregue ruido. Los informes de resumen se componen de informes agregados.
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 informe a nivel del evento y un informe agregable. En la demostración, se explica el 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:
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.
Registra un activador. Consulta Registra activadores de atribución para obtener instrucciones.
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étodoPOST
y a 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:
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.
Registra un activador. Consulta Registra activadores de atribución para obtener instrucciones.
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étodoPOST
y a Wikipedia para obtener más información sobre.well-known
.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
- Configura filtros (opcional):
- Sigue las instrucciones que se indican en Define reglas personalizadas con filtros.
- Revisa los detalles específicos de los filtros para informes agregables en 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 con la configuración de su 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
- Registra una fuente de atribución
- Registra un activador de atribución
- Cómo priorizar clics, vistas o conversiones específicas
- Cómo depurar Attribution Reporting
- Claves de agregación
Información general
- Informes de atribución con informes a nivel del evento
- Informes de atribución con informes agregables
- Restricciones de los datos de los informes de agregación
- Información sobre el ruido
- Trabajo con ruido
Demostraciones y herramientas
- Demostración de la API de Attribution Reporting
- Laboratorio de ruido
- Validador del encabezado de informes de atribución
Planificación
Si todavía te encuentras en la etapa de planificación, consulta estos documentos: