AppsFlyer

AppsFlyer es una plataforma líder de atribución móvil y analítica de marketing. Es un servicio de terceros que recopila y organiza datos de campañas de marketing, lo que permite a las empresas ver el rendimiento de sus campañas en un solo lugar. Adapty proporciona un conjunto completo de datos que te permite rastrear eventos de suscripción desde los stores en un solo lugar. Con Adapty, puedes ver fácilmente cómo se comportan tus suscriptores, conocer sus preferencias y utilizar esa información para comunicarte con ellos de manera dirigida y efectiva. Por eso, esta integración te permite rastrear eventos de suscripción en AppsFlyer y analizar con precisión cuántos ingresos generan tus campañas.

La integración entre Adapty y AppsFlyer funciona de dos maneras principales.

1. Recibir datos de atribución de AppsFlyer Una vez que hayas configurado el envío de la atribución de AppsFlyer a Adapty en el código de tu app, Adapty comenzará a recibir datos de atribución de AppsFlyer. Puedes acceder a estos datos fácilmente y consultarlos en la página del perfil del usuario.

2. Envío de eventos de suscripción a AppsFlyer Adapty puede enviar a AppsFlyer todos los eventos de suscripción configurados en tu integración. Así podrás hacer seguimiento de esos eventos desde el dashboard de AppsFlyer, lo que resulta muy útil para evaluar la efectividad de tus campañas publicitarias.

Configurar la integración

Conectar Adapty con AppsFlyer

Para configurar la integración con AppsFlyer:

1. Abre Integrations -> AppsFlyer en el Adapty Dashboard.

2. Activa el interruptor para habilitar la integración.

3. El siguiente paso es configurar las credenciales. Para iOS, encuentra el App ID copiando el Apple ID en App Store Connect (para hacerlo, abre la página de tu app en App Store Connect, ve a la página App Information en la sección General y busca el Apple ID en la parte inferior izquierda de la pantalla).

3.2. Pega el Apple ID copiado en el campo iOS App ID del Adapty Dashboard.

5. Para iOS y Android, abre el sitio de AppsFlyer e inicia sesión.
6. Haz clic en Your account name -> Security Center en la esquina superior derecha del dashboard.

7. En la ventana Manage your account security, haz clic en el botón Manage your AppsFlyer API and S2S tokens.
8. Si ya tienes un token S2S, ve al paso 12. Si no lo tienes, haz clic en el botón New token.

9. En la ventana New token, introduce el nombre del token. Este nombre es solo para tu referencia.

10. Elige S2S en la lista Choose type.

11. Haz clic en el botón Create new token para guardar el nuevo token.

12. En la ventana Tokens, copia el token S2S.

13. En el Adapty Dashboard, pega la clave S2S copiada en los campos Dev key for iOS y Dev key for Android.

14. Haz clic en el botón Save para guardar los cambios.

AppsFlyer no tiene modo Sandbox para la integración server2server. Por eso necesitas una aplicación/cuenta diferente en AppsFlyer para el Sandbox Dev Key. Si quieres enviar eventos de sandbox a la misma app, simplemente usa la misma clave para producción y sandbox. :::

Por defecto, Adapty mapea algunos eventos a los eventos estándar de AppsFlyer. Con esta configuración, AppsFlyer puede reenviar los eventos a cada red publicitaria que uses sin configuración adicional. Otro punto importante es que AppsFlyer no admite eventos con más de 26 horas de antigüedad. Por eso, si tienes un evento con más de 26 horas, Adapty lo enviará a AppsFlyer, pero la fecha y hora del evento se reemplazarán por la marca de tiempo actual.

Configurar eventos y etiquetas

Debajo de las credenciales encontrarás tres grupos de eventos que puedes enviar a AppsFlyer desde Adapty. Activa los que necesites. Consulta la lista completa de eventos que ofrece Adapty aquí.

Recomendamos usar los nombres de eventos predeterminados que ofrece Adapty, aunque puedes cambiarlos según tus necesidades.

Adapty enviará los eventos de suscripción a AppsFlyer mediante una integración servidor a servidor, lo que te permitirá ver todos los eventos de suscripción en tu dashboard de AppsFlyer y vincularlos a tus campañas de adquisición.

Conecta tu app con AppsFlyer

Una vez completados los pasos anteriores, llama al método updateAttribution para guardar los datos de atribución y usa Adapty.setIntegrationIdentifier() para establecer el identificador de integración.

Inicializa el SDK de AppsFlyer y espera su callback de UID antes de identificar usuarios en Adapty. De lo contrario, el appsflyer_id se asocia a un perfil anónimo temporal de Adapty creado durante la activación, y no siempre se transfiere al perfil identificado. Cuando esto ocurre, el reenvío de ingresos de AppsFlyer falla silenciosamente.

class YourAppsFlyerLibDelegateImplementation {
    // Find your implementation of AppsFlyerLibDelegate 
    // and update onConversionDataSuccess method:
    func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
        let uid = AppsFlyerLib.shared().getAppsFlyerUID()
        Adapty.setIntegrationIdentifier(key: "appsflyer_id", value: uid)
        Adapty.updateAttribution(conversionInfo, source: "appsflyer")
    }
}

val conversionListener: AppsFlyerConversionListener = object : AppsFlyerConversionListener {
    override fun onConversionDataSuccess(conversionData: Map<String, Any>) {
        val uid = AppsFlyerLib.getInstance().getAppsFlyerUID(context)
        Adapty.setIntegrationIdentifier("appsflyer_id", uid) { error ->
            if (error != null) {
                // handle the error
            }
        }
        Adapty.updateAttribution(conversionData, "appsflyer") { error ->
            if (error != null) {
                //handle the error
            }
        }
    }
}

appsFlyer.onInstallConversionData(installData => {
    appsFlyer.getAppsFlyerUID((error, networkUserId) => {
        if (error) {
            // handle the error
        }
        try {
            adapty.updateAttribution(installData, AttributionSource.AppsFlyer, networkUserId);
        } catch (error) {
            // handle the error
        }
    });
});

// ...
appsFlyer.initSdk(/*...*/);

AppsflyerSdk appsflyerSdk = AppsflyerSdk(<YOUR_OPTIONS>);

appsflyerSdk.onInstallConversionData((data) async {
    try {
        final appsFlyerUID = await appsFlyerSdk.getAppsFlyerUID();
        
        await Adapty().setIntegrationIdentifier(
          key: "appsflyer_id", 
          value: appsFlyerUID,
        );
        
        await Adapty().updateAttribution(data, source: "appsflyer");
    } on AdaptyError catch (adaptyError) {
        // handle the error
    } catch (e) {
        // handle the error
    }
});

appsflyerSdk.initSdk(
    registerConversionDataCallback: true,
    registerOnAppOpenAttributionCallback: true,
    registerOnDeepLinkingCallback: true,
);

using AdaptySDK;
using AppsFlyerSDK;

// before SDK initialization
AppsFlyer.getConversionData(this.name);

// in your IAppsFlyerConversionData
void onConversionDataSuccess(string conversionData) {
    string appsFlyerId = AppsFlyer.getAppsFlyerId();
    
    Adapty.SetIntegrationIdentifier(
      "appsflyer_id", 
      appsFlyerId, 
      (error) => {
        // handle the error
    });
    
    Adapty.UpdateAttribution(
      conversionData, 
      "appsflyer",
      (error) => {
        // handle the error
    });
}

Estructura del evento

Adapty envía los eventos seleccionados a AppsFlyer mediante una solicitud POST con cuerpo JSON a:

• API v2: https://api2.appsflyer.com/inappevent/{app_id}
• API v3: https://api3.appsflyer.com/inappevent/{app_id} (recomendado)

Cada evento tiene la siguiente estructura:

{
  "appsflyer_id": "1699887556000-6192770",
  "eventName": "subscription_renewed",
  "eventTime": "2024-03-01 12:00:00",
  "eventValue": "{\"af_content_id\":\"yearly.premium.6999\",\"af_order_id\":\"GPA.3383-4699-1373-07113\",\"store_country\":\"US\",\"profile_country\":\"US\",\"af_content_type\":\"in_app\",\"af_revenue\":\"9.9900\",\"af_currency\":\"USD\",\"af_quantity\":\"1\"}",
  "os": "17.0.1",
  "bundleIdentifier": "com.example.app",
  "customer_user_id": "user_12345",
  "eventCurrency": "USD",
  "ip": "192.168.100.1",
  "advertising_id": "00000000-0000-0000-0000-000000000000",
  "idfa": "00000000-0000-0000-0000-000000000000",
  "idfv": "00000000-0000-0000-0000-000000000000",
  "att": "3"
}

It looks like your message was cut off. Could you please share the MDX documentation you’d like me to translate from English to Spanish (es-ES)?

Solución de problemas

Discrepancia en los ingresos

Si hay una discrepancia en los ingresos entre Adapty y AppsFlyer, puede deberse a que no todos tus usuarios utilizan la versión de la app que incluye el SDK de Adapty. Para garantizar la coherencia de los datos, puedes obligar a tus usuarios a actualizar a una versión de la app que incluya el SDK de Adapty.

Datos de integración faltantes

Si el envío de eventos falla, generalmente se debe a datos de integración faltantes. Para resolver este problema, asegúrate de lo siguiente:

• Tu app tiene instalado el SDK de AppsFlyer.
• Estás llamando al método getAppsFlyerUID.

Fallo de autenticación

Si recibes el error Failed to authenticate en la consola, puede deberse a una incompatibilidad entre la versión de AppsFlyer y la versión de las credenciales.

Consulta la guía de migración o reemplaza las credenciales por las válidas desde aquí.