Integración de Amplitude con AppsFlyer

En resumen: Integra AppsFlyer con Amplitude para compartir datos de atribución de usuarios y análisis de eventos para obtener mejores insights sobre engagement, retención e ingresos de los usuarios. Elige entre dos versiones de integración—V1 o V2—dependiendo de tu caso de uso y necesidades de análisis.

Sobre la integración

Amplitude, un partner integrado de AppsFlyer, es una plataforma de análisis de productos utilizada por equipos de producto, crecimiento y marketing para comprender el comportamiento del usuario en dispositivos móviles y web. La integración permite que AppsFlyer envíe datos clave de eventos a Amplitude después de la instalación, lo que permite un análisis integral a nivel de usuario.

Hay dos versiones de integración de Amplitude:

  • Amplitude V1:
    Esta versión utiliza la API de atribución de Amplitude. AppsFlyer envía datos de instalación recopilados después de que se completa la integración. Amplitude utiliza el ID de anuncio como identificador y descarta los datos si no se registra ningún evento de usuario coincidente dentro de las 72 horas. Saber más
  • Amplitude V2 :
    Esta versión utiliza la API HTTP V2 de Amplitude. AppsFlyer envía tanto datos de instalaciones como de eventos in-app después de que se completa la integración. Los identificadores tienen prioridad (user_id y device_id), y si la coincidencia falla, se registra un nuevo usuario. Saber más

 

Versiones de integración:

Versión API utilizada Identificadores utilizados Cobertura de eventos
V1 API de atribución ID de publicidad (AdID) Solo instalaciones
V2 HTTP V2 API user_id, device_id (lógica de respaldo) Instalaciones y eventos in-app

¡Importante!

  • Elige la integración Amplitude V1 o V2. No uses ambos simultáneamente. Usar ambas versiones al mismo tiempo puede resultar en eventos duplicados enviados a Amplitude.
  • Algunas fuentes de medios restringen el intercambio de datos con terceros. Los postbacks para eventos restringidos no se enviarán a este partner, incluso si están configurados.

Requisitos previos

Antes de empezar:

  • Contacta a Amplitude para crear una cuenta si aún no tienes una.
  • Decide si configurarás la integración Amplitude V1 o V2.
  • Asegúrate de evitar enviar los mismos eventos desde el SDK de Amplitude y AppsFlyer para prevenir duplicaciones.
  • Consulta el requisito adicional para la integración Amplitude V2.

Requisitos adicionales para la integración Amplitude V2

La integración V2 requiere la configuración de:

ID de dispositivo de Amplitude

Para habilitar la atribución a nivel de usuario, debes pasar el ID de dispositivo de Amplitude al SDK de AppsFlyer. Este valor se envía con cada postback.

Android iOS (Objective-C) iOS (Swift) Unity React Native Cordova Flutter
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeDeviceId", amplitude.getDeviceId())

Lenguaje: Java/Kotlin

Documentación:  Referencia del SDK de Android, Amplitude

ID de usuario del cliente

Configura el ID de usuario de cliente (CUID).  Este es un identificador único que generalmente se genera y se establece
por el propietario de la aplicación durante el registro del usuario. Saber más

ID de sesión de Amplitude

Configura el ID de sesión de Amplitude y pásalo a AppsFlyer (opcional). Saber más

Android iOS (Objective-C) iOS (Swift) Unity React Native Cordova Flutter
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeSessionId", amplitude.getSessionId())

Lenguaje: Java/Kotlin

Documentación: Referencia del SDK de Android

Configura la integración

Para configurar la integración:

  1. En AppsFlyer, ve a Colaborar > Partner Marketplace.
  2. Para configurar la integración de Amplitude V1, selecciona Amplitude V1 (partner técnico).

    Select Amplitude V1 doctored.png


    Para configurar la integración de Amplitude V2, selecciona Amplitude V2 (partner técnico). 

    Select Amplitude V2.png

     
  3. Una vez que hayas seleccionado tu versión de Amplitude, haz clic en Configurar integración.

    Click set up integration.png
     
  4. En la pestaña de Integración:
    • Selecciona tu aplicación.
    • Activa el interruptor Activar partner.

      Activate partner blurred.png

       
  5. Completa la configuración en las pestañas restantes:

Pestaña integración

La pestaña Integración está dividida en distintas secciones, tal como se describe a continuación.

Activar partner

En la primera visita, deberás hacer clic en Activar partner para habilitar la configuración de los parámetros de la pestaña de integración. El selector debe estar activado mientras trabajes con el partner.
Aprende más sobre la activación de partners.

Configuración general

Intercambio avanzado de datos

Para compartir información adicional sobre instalaciones con Amplitude, activa el Uso compartido de datos avanzado. Cuando se activa, Amplitude recibe los siguientes datos sobre las instalaciones (no eventos in-app) asignadas a la propiedad Amplitude indicada en la lista:

Propiedad de Amplitude Punto de datos de AppsFlyer
sub_publisher af_siteid
network_name pid
adgroup_name af_adset
creative_name af_ad_id
installed_at install_timestamp
search_term af_keywords
channel af_channel
user_id af_customer_user_id
af_sub1 af_sub1
af_sub2 af_sub2
af_sub3 af_sub3
af_sub4 af_sub4
af_sub5 af_sub5
app_version app_version

Centro de Datos de Amplitude en la UE

Cuando el Centro de Datos de Amplitude en la UE está desactivado, los postbacks de instalación se envían al centro de datos de Estados Unidos.
Para enviar postbacks de instalación al Centro de Datos de Amplitude en la UE, activa el Centro de Datos de Amplitude de la UE.

Clave API

Amplitude se conecta con AppsFlyer a través de una clave de API única. Si aún no la tienes, debes obtenerla de Amplitude para continuar con la integración o seguir los pasos que se indican a continuación.

Obtención de la clave API de Amplitude

Nota: Solo los usuarios que tienen el rol de administrador o gerente en Amplitude pueden acceder a la clave API.

  1. Accede a tu cuenta de Amplitude.
  2. Desde la parte superior derecha de la página, haz clic en el icono de configuración > Configuración de la organización.
    Amplitude
  3. Haz clic en Proyectos y selecciona el proyecto desde el que enviarás datos a AppsFlyer.  
    Amplitude
  4. Desde la pestaña Proyecto, copia tu clave API.
    Amplitude
  5. Continúa para configurar Amplitude en el dashboard de AppsFlyer.

Postbacks predeterminados

AppsFlyer puede enviar postbacks automáticos a Amplitude tras las instalaciones de los usuarios. Utiliza esta sección para definir la fuente de los usuarios a los cuales se envían los postbacks de cada evento. Saber más sobre los postbacks por defecto.

Configuración de eventos in-app

  • Introduce la clave API.
  • Cuando Amplitude Data Center está desactivado, los postbacks de eventos in-app se envían al centro de datos de Estados Unidos.
    Para enviar postbacks de eventos in-app al centro de datos de Amplitude en la UE, activa Amplitude Data Center.

Una vez guardada la configuración, AppsFlyer envía los siguientes datos a Amplitude:

  • ID de dispositivo (IDFV/ID de publicidad de Google)
  • Fuente de medios
  • Nombre de la campaña

El envío del IDFA para dispositivos iOS está sujeto al consentimiento de la ATT por parte del usuario y a la configuración de privacidad avanzada.

Postbacks de eventos in-app

Configura el envío de postbacks de eventos in-app a Amplitude.

Pestaña de enlace de atribución

Los enlaces de atribución no están disponibles para Amplitude.

Pestaña de costo

Los datos de costos no son compatibles con la integración con este partner.

Pestaña de ingresos por publicidad

Los ingresos por publicidad no se admiten en la integración con este partner.

Pestaña de permisos

Los permisos no están disponibles para Amplitude.

Visualización de datos de atribución en la consola de Amplitude

Los datos de atribución enviados desde AppsFlyer a Amplitude se muestran en tus dashboards como eventos y propiedades prefijados con [AppsFlyer]:

amplitude-properties.png

 ¡Importante!

En algunos casos, Amplitude muestra los datos procedentes de AppsFlyer como "Blocked". Si no puedes ver los datos de AppsFlyer en Amplitude, verifica si está definido como un evento bloqueado.amplitude-blocked-data.png

Enviando eventos de Amplitude a AppsFlyer

La integración también permite enviar tus eventos de Amplitude a AppsFlyer a través de una API de servidor a servidor. Consulta la documentación de Amplitude sobre cómo hacer esto.