API de Attribution Reporting: guía de integración

La API de Attribution Reporting está diseñada para brindar una mayor privacidad del usuario, ya que quita la dependencia de los identificadores de usuario entre varias partes y admite casos de uso clave para la medición de atribución y conversión en apps. Este documento incluye lineamientos que te ayudarán a prepararte para la integración de la API Attribution Reporting.

En esta guía, se intenta proporcionar una vista completa, que puede incluir funciones que aún no se implementaron en la etapa actual de Privacy Sandbox en la Vista previa para desarrolladores de Android. En estos casos, los detalles relacionados se marcarán como aún no implementados.

Objetivos de integración

En esta etapa de la Vista previa para desarrolladores de Privacy Sandbox, se incluyen los siguientes objetivos de integración:

Asistencia actual y futura

Entre los casos de uso y las funciones compatibles en la versión más reciente de la Vista previa para desarrolladores, se incluyen los siguientes:

  • Priorización de la fuente, atribución de último punto y atribución posterior a la instalación
  • Registrar las fuentes de atribución y los activadores de aplicaciones
  • Recibir informes a nivel del evento
  • Recibir informes agregables no encriptados

En los próximos lanzamientos de la Vista previa para desarrolladores, se agregará compatibilidad con los siguientes casos de uso y funciones técnicas adicionales. A medida que estas funciones estén disponibles, se actualizará esta guía para reflejar los detalles relevantes.

  • Inscripción a la plataforma de tecnología publicitaria
  • Compatibilidad de depuración, para ayudar a los desarrolladores a comparar informes agregados con los de mecanismos existentes
  • Registrar fuentes de atribución web y activadores web para admitir la atribución de las apps a la Web
  • Recibir informes agregables encriptados de la API y enviar lotes al servicio de agregación
  • Recibir informes de resumen del servicio de agregación
  • El uso de la API requerirá un nuevo permiso normal

Público objetivo de la tecnología publicitaria

Para recibir un informe de la API de Attribution Reporting, una plataforma de tecnología publicitaria debe registrar la fuente de atribución y el activador. Como mínimo, para habilitar una prueba completa de extremo a extremo, los socios de tecnología publicitaria y de medición para dispositivos móviles deben trabajar juntos a fin de llamar a la API para el mismo anunciante y es posible que necesiten usar redireccionamientos en las llamadas de registro. Es posible que también debas trabajar con la app del publicador o del anunciante.

Para el registro de la fuente de atribución, el SDK de tecnología publicitaria suele iniciar la llamada a la API que se utiliza para publicar anuncios en la app del publicador, aunque la app también puede llamar a la API directamente.

Por lo general, para el registro del activador, el SDK del socio de medición para dispositivos móviles iniciará la llamada a la API en la app del anunciante o en sí misma.

Requisitos previos

Pasos para la integración

A fin de prepararte para integrar la API de Attribution Reporting en su solución, completa los pasos que se describen en las siguientes secciones.

Verifica la corrección técnica en el entorno de pruebas

  • Crea una aplicación de prueba para familiarizarte con Privacy Sandbox en la API de Attribution Reporting de Android. En esta etapa, también puedes comenzar con la app de ejemplo en GitHub.
  • Configura extremos de servidor simulados o usa nuestro servidor de ejemplo para familiarizarte con las firmas de la API de REST que usan las API de cliente de Informes de atribución.
  • Registrar eventos, incluidos los eventos de vista, clic y conversión (activador).
  • Con el fin de realizar pruebas, fuerza los trabajos de informes de ejecución mediante los comandos de ADB adecuados a fin de reducir el horizonte de tiempo para recibir datos de informes, tanto para informes a nivel de evento como para agregados.
  • Evalúa la aplicabilidad de las firmas de API para tu pila tecnológica actual. Se incluyen los parámetros de entrada y los valores que se muestran. Identifica brechas en el flujo de datos y las mitigaciones.

Verifica la compatibilidad con la infraestructura técnica existente.

  • Base de código y entorno de desarrollo del cliente:
    • Después de la Vista previa para desarrolladores, Privacy Sandbox en Android requerirá un nivel mínimo de API objetivo de 33. Identifica una ruta de migración para la base de código existente. Evalúa la compatibilidad de la app o el SDK con otros cambios introducidos en Android 13.
  • Del servidor:
    • Agrega extremos de stub de la API a la infraestructura técnica existente para encontrar y verificar las limitaciones técnicas.
    • Agrega devoluciones de llamada para aceptar informes de la infraestructura técnica existente.

Define y verifica los requisitos de integración

  • Verifica (en registros o datos del servidor) que los informes contengan datos de las vistas, los clics y las conversiones.
  • Verifica los informes a nivel del evento y a nivel agregado.