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.
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeDeviceId", amplitude.getDeviceId())
Lenguaje: Java/Kotlin
Documentación: Referencia del SDK de Android, Amplitude
[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeDeviceId": [[Amplitude instance] getDeviceId]}];
Lenguaje: Objective-C
Documentación: Referencia del SDK de iOS, Amplitude
AppsFlyerLib.shared().customData = ["AmplitudeDeviceId": Amplitude.instance().getDeviceId()]
Lenguaje: Swift
Documentación: Referencia del SDK de iOS, Amplitude
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeDeviceId", Amplitude.getInstance().getDeviceId());
AppsFlyer.setAdditionalData(customData);
Lenguaje: C#
Documentación: Referencia del SDK de Unity
appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()},
(res) => {
//...
}
);
Lenguaje: JavaScript
Documentación: Referencia del SDK de React Native
appsFlyer.setAdditionalData({"AmplitudeDeviceId": amplitude.getDeviceId()});
Lenguaje: JavaScript
Documentación: N/A
var data = {"AmplitudeDeviceId": amplitude.getDeviceId()};
appsFlyerSdk.setAdditionalData(data);
Lenguaje: Dart
Documentación: Referencia del SDK de Flutter
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
AppsFlyerLib.getInstance().setAdditionalData("AmplitudeSessionId", amplitude.getSessionId())
Lenguaje: Java/Kotlin
Documentación: Referencia del SDK de Android
[[AppsFlyerLib shared] setAdditionalData:@{@"AmplitudeSessionId": [[Amplitude instance] getSessionId]}];
Lenguaje: Objective-C
Documentación: Referencia del SDK de iOS
AppsFlyerLib.shared().customData = ["AmplitudeSessionId": Amplitude.instance().getSessionId()]
Lenguaje: Swift
Documentación: Referencia del SDK de iOS
Dictionary<string, string> customData = new Dictionary<string, string>();
customData.Add("AmplitudeSessionId", Amplitude.getInstance().getSessionId());
AppsFlyer.setAdditionalData(customData);
Lenguaje: C#
Documentación: Referencia del SDK de Unity
appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()},
(res) => {
//...
}
);
Lenguaje: JavaScript
Documentación: Referencia del SDK de React Native
appsFlyer.setAdditionalData({"AmplitudeSessionId": amplitude.getSessionId()});
Lenguaje: JavaScript
Documentación: N/A
var data = {"AmplitudeSessionId": amplitude.getSessionId()};
appsFlyerSdk.setAdditionalData(data);
Lenguaje: Dart
Documentación: Referencia del SDK de Flutter
Configura la integración
Para configurar la integración:
- En AppsFlyer, ve a Colaborar > Partner Marketplace.
- Para configurar la integración de Amplitude V1, selecciona Amplitude V1 (partner técnico).
Para configurar la integración de Amplitude V2, selecciona Amplitude V2 (partner técnico).
- Una vez que hayas seleccionado tu versión de Amplitude, haz clic en Configurar integración.
- En la pestaña de Integración:
- Selecciona tu aplicación.
- Activa el interruptor Activar partner.
- 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.
- Accede a tu cuenta de Amplitude.
- Desde la parte superior derecha de la página, haz clic en el icono de configuración > Configuración de la organización.
- Haz clic en Proyectos y selecciona el proyecto desde el que enviarás datos a AppsFlyer.
- Desde la pestaña Proyecto, copia tu clave API.
- 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
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]:
¡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.
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.