AppsFlyer

AppsFlyer est une plateforme de référence pour l’attribution mobile et l’analyse marketing. C’est un service tiers qui collecte et organise les données issues des campagnes marketing, permettant aux entreprises de suivre leurs performances au même endroit.

Adapty fournit un ensemble complet de données vous permettant de suivre les événements d’abonnement depuis les stores en un seul endroit. Avec Adapty, vous pouvez facilement observer le comportement de vos abonnés, comprendre leurs préférences et utiliser ces informations pour communiquer avec eux de manière ciblée et efficace. Cette intégration vous permet donc de suivre les événements d’abonnement dans AppsFlyer et d’analyser précisément les revenus générés par vos campagnes.

L’intégration entre Adapty et AppsFlyer fonctionne de deux façons principales.

1. Réception des données d’attribution depuis AppsFlyer Une fois que vous avez configuré l’envoi de l’attribution AppsFlyer à Adapty dans le code de votre application, Adapty commencera à recevoir les données d’attribution d’AppsFlyer. Vous pouvez facilement consulter ces données sur la page du profil de l’utilisateur.

2. Envoi des événements d’abonnement à AppsFlyer Adapty peut envoyer tous les événements d’abonnement configurés dans votre intégration à AppsFlyer. Vous pourrez ainsi suivre ces événements depuis le tableau de bord AppsFlyer. Cette intégration est utile pour évaluer l’efficacité de vos campagnes publicitaires.

Configurer la configuration

Connecter Adapty à AppsFlyer

Pour configurer l’intégration avec AppsFlyer :

1. Ouvrez Integrations -> AppsFlyer dans l’Adapty Dashboard.

2. Activez le bouton pour activer l’intégration.

3. L’étape suivante consiste à renseigner les identifiants. Pour iOS, trouvez l’App ID en copiant l’Apple ID dans App Store Connect (pour ce faire, ouvrez la page de votre application dans App Store Connect, accédez à la page App Information dans la section General, et repérez l’Apple ID en bas à gauche de l’écran).

3.2. Collez l’Apple ID copié dans le champ iOS App ID de l’Adapty Dashboard.

5. Pour iOS et Android, ouvrez le site AppsFlyer et connectez-vous.

6. Cliquez sur Your account name -> Security Center dans le coin supérieur droit du tableau de bord.

7. Dans la fenêtre Manage your account security, cliquez sur le bouton Manage your AppsFlyer API and S2S tokens.

8. Si vous disposez déjà d’un token S2S, passez directement à l’étape 12. Sinon, cliquez sur le bouton New token.

9. Dans la fenêtre New token, saisissez le nom du token. Ce nom est uniquement destiné à votre usage personnel.

10. Sélectionnez S2S dans la liste Choose type.

11. Cliquez sur le bouton Create new token pour enregistrer le nouveau token.

12. Dans la fenêtre Tokens, copiez le token S2S.

13. Dans l’Adapty Dashboard, collez la clé S2S copiée dans les champs Dev key for iOS et Dev key for Android.

14. Cliquez sur le bouton Save pour enregistrer les modifications.

AppsFlyer ne dispose pas de mode Sandbox pour l’intégration server2server. Vous avez donc besoin d’une application/d’un compte différent dans AppsFlyer pour la Sandbox Dev Key. Si vous souhaitez envoyer des événements sandbox vers la même application, utilisez simplement la même clé pour la production et le sandbox. :::

Par défaut, Adapty associe certains événements aux événements standard d’AppsFlyer. Avec cette configuration, AppsFlyer peut ensuite transmettre les événements à chaque réseau publicitaire que vous utilisez sans configuration supplémentaire.

Une autre chose importante à noter : AppsFlyer ne prend pas en charge les événements datant de plus de 26 heures. Ainsi, si un événement a plus de 26 heures, Adapty l’enverra quand même à AppsFlyer, mais la date et l’heure de l’événement seront remplacées par l’horodatage actuel.

Configurer les événements et les tags

En dessous des identifiants, vous trouverez trois groupes d’événements que vous pouvez envoyer à AppsFlyer depuis Adapty. Activez simplement ceux dont vous avez besoin. Consultez la liste complète des événements proposés par Adapty ici.

Nous vous recommandons d’utiliser les noms d’événements par défaut fournis par Adapty. Vous pouvez toutefois les modifier selon vos besoins.

Adapty enverra les événements d’abonnement à AppsFlyer via une intégration serveur à serveur, vous permettant de consulter tous les événements d’abonnement dans votre tableau de bord AppsFlyer et de les associer à vos campagnes d’acquisition.

Connectez votre application à AppsFlyer

Une fois les étapes décrites ci-dessus terminées, appelez la méthode updateAttribution pour enregistrer les données d’attribution, et utilisez Adapty.setIntegrationIdentifier() pour définir l’identifiant d’intégration.

Initialisez le SDK AppsFlyer et attendez son callback UID avant d’identifier les utilisateurs dans Adapty. Sinon, appsflyer_id sera associé à un profil Adapty anonyme temporaire créé lors de l’activation, et ne sera pas toujours transféré vers le profil identifié. Dans ce cas, le transfert des revenus AppsFlyer échoue silencieusement.

class YourAppsFlyerLibDelegateImplementation {
    // Find your implementation of AppsFlyerLibDelegate 
    // and update onConversionDataSuccess method:
    func onConversionDataSuccess(_ conversionInfo: [AnyHashable : Any]) {
        let uid = AppsFlyerLib.shared().getAppsFlyerUID()
        // Adapty SDK 4.x
        Adapty.setIntegrationIdentifier(.appsflyerId(uid))
        Adapty.updateAttribution(conversionInfo, source: .appsflyer)
        // Adapty SDK 3.x
        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
    });
}

Structure des événements

Adapty envoie les événements sélectionnés à AppsFlyer via une requête POST avec un corps JSON vers :

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

Chaque événement est structuré comme suit :

{
  "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"
}

Where:

Le paramètre eventValue est une chaîne encodée en JSON contenant les champs suivants :

Dépannage

Écart de revenus

Si vous constatez un écart de revenus entre Adapty et AppsFlyer, cela peut être dû au fait que tous vos utilisateurs n’utilisent pas la version de l’application intégrant le SDK Adapty. Pour garantir la cohérence des données, vous pouvez forcer vos utilisateurs à mettre à jour l’application vers une version incluant le SDK Adapty.

Données d’intégration manquantes

Si l’envoi d’événements échoue, c’est généralement dû à des données d’intégration manquantes. Pour résoudre ce problème, vérifiez les points suivants :

• Votre application a le SDK AppsFlyer installé.
• Vous appelez la méthode getAppsFlyerUID.

Échec d’authentification

Si vous obtenez l’erreur Failed to authenticate dans la console, cela peut être dû à une incompatibilité entre la version d’AppsFlyer et la version des identifiants.

Consultez le guide de migration ou remplacez les identifiants par des identifiants valides disponibles ici.

access_level_updated apparaît comme échoué dans le flux d’événements

access_level_updated est un événement réservé aux webhooks. Adapty ne l’envoie jamais à cette intégration. Mais Adapty enregistre un résultat pour chaque intégration activée, et un événement non pris en charge est affiché comme un échec.