Intégration SDK Android pour développeurs

Il existe deux façons d'ajouter le SDK à votre app :

• En utilisant Gradle (recommandé)
• En ajoutant manuellement le SDK 

Le référent d'installation Android améliore la précision de l'attribution, protège contre les installations frauduleuses et bien plus encore. Il est pris en charge par le SDK Android AppsFlyer version 4.8.6.

Ajoutez le référent d'installation

1. Ajoutez le référent d'installation Android en tant que dépendance. Vous pouvez trouver la dernière version ici.
   

   dependencies {
   //make sure to use the latest SDK version: https://mvnrepository.com/artifact/com.appsflyer/af-android-sdk
   	implementation 'com.appsflyer:af-android-sdk:5.+'
   	implementation 'com.android.installreferrer:installreferrer:1.0'
   }

2. Synchronisez le projet pour récupérer les dépendances. Voir la capture d'écran suivante :
   
   

Si vous utilisez ProGuard et souhaitez utiliser la nouvelle API référent de Google, définissez la règle ProGuard suivante : -dontwarn com.android.installreferrer.

Si vous n'utilisez pas Gradle :

1. Téléchargez le fichier Install Referrer aar
2. Ajoutez-le au projet
3. Ajoutez l'autorisation suivante au manifeste : com.google.android.finsky.permission.BIND_GET_INSTALL_REFERRER_SERVICE

L'ajout d'autorisations permet d'augmenter le taux d'attribution de fingerprinting. Cela permet au SDK d'envoyer plus de données telles que les données de réseau Wi-Fi ou d'opérateurs. Vous pouvez trouver ces données dans les rapports de données brutes et les utiliser pour l'analyse et l'optimisation de campagnes.

Ajoutez les autorisations requises

1. Ajoutez les autorisations suivantes à AndroidManifest.xml :
   

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   <!-- Optional : -->
   <uses-permission android:name="android.permission.READ_PHONE_STATE" />
   

Le BroadcastReceiver obtient des informations de Google Play qu'AppsFlyer utilise pour l'attribution. L'utilisation du BroadcastReceiver augmente le taux d'attribution.

Les deux options suivantes sont disponibles pour mettre en place le récepteur de diffusion du référent d'installation :

<application>


	<receiver android:name="com.appsflyer.SingleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			 <action android:name="com.android.vending.INSTALL_REFERRER" />
		 </intent-filter>
	</receiver>


</application>

<application>


	<receiver android:name="com.appsflyer.MultipleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			<action android:name="com.android.vending.INSTALL_REFERRER" />
		</intent-filter>
	</receiver>


</application>

AppsFlyer utilise la clé dev pour identifier votre compte de manière unique. La clé dev est obligatoire car elle permet au SDK d'envoyer et de récupérer en toute sécurité des données appartenant à votre compte AppsFlyer.

Important : il est essentiel d'utiliser la bonne clé dev lors de l'initialisation du SDK. En utilisant la mauvaise clé dev, ou une clé dev incorrecte, vous impactez tout le trafic envoyé depuis le SDK ce qui génère des problèmes d'attribution et de reporting.

Pour récupérer votre clé dev :

1. Allez au tableau de bord de votre app 
2. Sur le tableau de bord, sous Configuration, cliquez sur Paramètres d'app.
3. Copiez votre clé dev
   
   

   

Nous vous recommandons d'initialiser le SDK dans la classe d'applications globale de l'app. Cela permet au SDK de s'initialiser dans tous les scénarios, y compris le deep linking.

Les étapes ci-dessous sont à effectuer dans la classe d'applications globale de l'app.

1. Dans la classe globale de l'app, importez les bibliothèques suivantes
   

   import android.app.Application;
   import com.appsflyer.AppsFlyerLib;
   import com.appsflyer.AppsFlyerConversionListener;
   import java.util.Map;

2. Dans la classe globale, attribuez votre clé dev à une variable, de préférence nommée AF_DEV_KEY. 
   
   Important : il est essentiel d'utiliser la bonne clé dev lors de l'initialisation du SDK. En utilisant la mauvaise clé dev, ou une clé dev incorrecte, vous impactez tout le trafic envoyé depuis le SDK ce qui génère des problèmes d'attribution et de reporting.
   
   
   Java Kotlin

   public class AFApplication extends Application {
       private static final String AF_DEV_KEY = "qrdZGj123456789";
       
       //...
       
   }
   

   class AFApplication : Application() {
       private val devKey = "qrdZGj123456789";
   
       
       //...
       
   }
   

3. Dans la classe globale, après avoir appelé super.onCreate(), implémentez le code AppsFlyerConversionListener. Consultez le code ci-dessous à l'étape 4.
4. Dans la classe globale, après le ConversionListener, initialisez le SDK et appelez la méthode startTracking
   
   Java Kotlin

   public class AFApplication extends Application {
       private static final String AF_DEV_KEY = "qrdZGj123456789";
       
       @Override
       public void onCreate() {
           super.onCreate();
           AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {
   
   
               @Override
               public void onConversionDataSuccess(Map<String, Object> conversionData) {
               
                       for (String attrName : conversionData.keySet()) {
                       Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                   }
               }
   
               @Override
               public void onConversionDataFail(String errorMessage) {
   		   Log.d("LOG_TAG", "error getting conversion data: " + errorMessage);
               }
   
               @Override
               public void onAppOpenAttribution(Map<String, String> conversionData) {
               
                   for (String attrName : conversionData.keySet()) {
                       Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                   }
   
               }
   
               @Override
               public void onAttributionFailure(String errorMessage) {
                   Log.d("LOG_TAG", "error onAttributionFailure : " + errorMessage);
               }
           };
           
           AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, getApplicationContext());
           AppsFlyerLib.getInstance().startTracking(this);
   
       }
   }
                 

   class AFApplication : Application() {
       private val devKey = "qrdZGj123456789";
   
       override fun onCreate() {
           super.onCreate()
           val conversionDataListener  = object : AppsFlyerConversionListener{
               override fun onConversionDataSuccess(data: MutableMap<String, String>?) {
                   data?.let { cvData ->
                       cvData.map {
                           Log.i(LOG_TAG, "conversion_attribute:  ${it.key} = ${it.value}")
                       }
                   }
               }
   
               override fun onConversionDataFail(error: String?) {
                   Log.e(LOG_TAG, "error onAttributionFailure :  $error")
               }
   
               override fun onAppOpenAttribution(data: MutableMap<String, String>?) {
                   data?.map {
                       Log.d(LOG_TAG, "onAppOpen_attribute: ${it.key} = ${it.value}")
                   }
               }
   
               override fun onAttributionFailure(error: String?) {
                   Log.e(LOG_TAG, "error onAttributionFailure :  $error")
               }
           }
   
           AppsFlyerLib.getInstance().init(devKey, conversionDataListener, applicationContext)
           AppsFlyerLib.getInstance().startTracking(this)
       }
   }
   

Dans le fichier AndroidManifest.xml, à l'intérieure de la balise application, ajoutez la ligne suivante :

android:name="APP.PACKAGE.NAME.AFApplication"

• APP.PACAKGE.NAME - remplacez cette expression par le nom du package de l'app.
• AFApplication - remplacez cette expression par le nom que vous avez défini pour la classe globale de l'app

Cette ligne du fichier manifest.xml indique à l'application quelle est l'application globale. Comme mentionné ci-dessus, cela rend le SDK d'AppsFlyer globalement accessible dans l'ensemble de l'app.

Avant de commencer à tester les installations, mettez en liste blanche l'appareil sur lequel vous allez effectuer le test.

Les installations organiques sont des installations non attribuées qui sont généralement des installations directes à partir des app stores.

Pour simuler une installation organique :

1. Assurez-vous qu'un appareil mobile est connecté à votre ordinateur
2. Dans Android Studio, ouvrez le Logcat.
3. Depuis Android Studio, installez l'application sur l'appareil ou l'émulateur.
4. Attendez que l'application se lance.
5. Dans le Logcat, recherchez le nom du package de votre app.

Vous devriez voir ce qui suit :

La partie en surbrillance dans la capture d'écran indique que le SDK signale une installation organique. Ces données proviennent de la méthode onConversionDataSuccess de la classe AFApplication. L'obtention des données de conversion est mentionnée plus loin dans ce guide.

Remarque : depuis le SDK V5, onConversionDataSuccess est le nom de la méthode d'obtention des données de conversion. Si vous utilisez une version du SDK antérieure à 5.0.0, le nom de la méthode est onInstallConversionDataLoaded. Nous vous recommandons une mise à niveau vers le SDK 5.0.0. Pour en savoir plus, cliquez ici.

Une installation organique doit désormais apparaître sur la page Présentation du tableau de bord de l'application.

Si vous ne voyez pas l'installation sur le tableau de bord de l'app, consultez notre guide de dépannage du SDK.

Une installation non organique est une installation attribuée qui suit généralement un engagement publicitaire. Vous pouvez simuler une installation non organique en utilisant des liens d'attribution.

Pour simuler une installation non organique :

1. Dans le manifeste, recherchez le nom du package de votre app, par exemple, com.company.app.
2. Dans l'URL ci-dessous, remplacez <PACKAGE_NAME> par le nom du package de votre app :
   

   https://app.appsflyer.com/<PACKAGE_NAME>?pid=sdk_test&c=sdk_test
   

   Le paramètre pid représente le nom de la source média. Le paramètre c représente le nom de la campagne.
3. Envoyez cette URL à l'appareil.  Vous pouvez effectuer cette opération via email ou WhatsApp, par exemple. 
4. Sur l'appareil, cliquez sur l'URL.
   • Si l'application est répertoriée dans l'app store, vous serez redirigé vers l'app store. Ne téléchargez et n'installez pas l'app depuis l'app store. Passez à l'étape 5.
   • Si l'app n'est pas répertoriée dans l'app store et est encore en développement, l'écran affiche un message indiquant que l'app n'est pas disponible dans l'app store. Passez à l'étape 5.
5. Dans Android Studio, ouvrez le Logcat.
6. Connectez l'appareil à votre ordinateur à l'aide d'un câble USB.
7. Depuis Android Studio, installez l'app sur l'appareil.
8. Dans le Logcat, recherchez le nom du package de votre app.

Vous devriez voir ce qui suit :

Une installation non organique doit désormais apparaître sur la page Présentation du tableau de bord de l'application.

Le SDK possède deux interfaces liées aux évènements in-app :

• AFInAppEventType - constantes pour les noms d'événements in-app
• AFInAppEventParameterName - constantes pour les noms des paramètres d'évènements in-app

Nous recommandons fortement d'utiliser ces deux interfaces pour les raisons suivantes :

• La dénomination standard permet à AppsFlyer de mapper automatiquement les évènements sur des SRN tels que Facebook, Google, Twitter et Snapchat.
• Rétrocompatibilité - si AppsFlyer décide de modifier le nom ou le paramètre d'un évènement, votre implémentation est compatible avec les version antérieures.

Pour utiliser ces deux interfaces, importez-les :

import com.appsflyer.AFInAppEventParameterName;
import com.appsflyer.AFInAppEventType;

Voici la liste des noms et structures d'évènements recommandés.

Vous pouvez envoyer des revenus avec n'importe quel évènement in-app. Utilisez le paramètre d'évènement af_revenue (AFInAppEventParameterName.REVENUE) pour intégrer le revenu dans l'évènement in-app. Vous pouvez lui affecter n'importe quelle valeur numérique, positive comme négative.

af_revenue est le seul paramètre d’évènement qu'AppsFlyer compte en tant que revenu réel dans les données brutes et le tableau de bord. Pour plus de détails, veuillez cliquer ici.

Lors de l'envoi d'évènements avec revenus, pensez aux éléments suivants :

• Si vous définissez un code de devise (voir exemple ci-dessous), il doit s'agir d'un code ISO 4217 de 3 caractères. (la valeur par défaut est USD).
• Vous pouvez définir le code devise pour tous les événements en appelant la méthode suivante : AppsFlyer.setCurrencyCode("ZZZ") Pour en savoir plus sur les paramètres de devise, l'affichage et la conversion de devise, consultez notre guide sur la devise du revenu.
• The revenue value should not contain comma separators, currency sign, or text. A revenue event should be similar to 1234.56, for example.

Exemple : évènement d'achat d'évènement in-app avec revenus

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,1234.56);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"Shirt");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

val eventValue = HashMap<String, Any>() 
eventValue.put(AFInAppEventParameterName.REVENUE,1234.56)
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"Shirt")
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567")
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD")
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue)

L’événement d’achat ci-dessus a un revenu de 1234,56 USD qui lui est associé et qui apparait comme revenu dans le tableau de bord.

Enregistrement de revenus négatifs

Dans certaines situations, vous voudrez peut-être enregistrer un revenu négatif.

Par exemple, un utilisateur reçoit un remboursement pour des chaussures qu'il a acheté chez vous.

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,-200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"shoes");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"4875");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().trackEvent(getApplicationContext() , "cancel_purchase" , eventValue);

val eventValue = HashMap<String, Any>()
eventValue.put(AFInAppEventParameterName.REVENUE, -200)
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "category_a")
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "1234567")
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD")
AppsFlyerLib.getInstance().trackEvent(applicationContext,  "cancel_purchase", eventValue)

Le SDK d'AppsFlyer fournit une vérification au niveau du serveur pour les achats in-app. Pour valider un achat, appelez la méthode validateAndTrackInAppPurchase.

Cet appel génère automatiquement un évènement in-app af_purchase si l'achat est validé.

public static void validateAndTrackInAppPurchase(Context context, 
String publicKey, String signature, String purchaseData, 
String price, String currency, HashMap<String, String> additionalParameters);

Paramètres de la méthode

• String publicKey - clé publique de la console développeur Google
• String signature – signature de transaction (renvoyée de l'API Google lorsque l'achat est terminé)
• String purchaseData – produit acheté en format JSON (renvoyé de l'API Google lorsque l'achat est terminé)
• String price – in-app event revenue to be reported to AppsFlyer.
• String currency – devise de l'évènement in-app à signaler à AppsFlyer
• HashMap<String, String> additionalParameters – paramètres supplémentaires de l'évènement in-app qui apparaissent dans le champ event_value des données brutes de l'évènement in app.

Rappels de réussite et d'échec de validation d'achat

Lorsque vous voulez savoir si la tentative de validation d'un achat est réussie ou non, implémentez registerValidatorListener dans votre classe d'applications. Ce port d'écoute contient deux blocs de rappel, l'un pour la « réussite » et l'autre pour « l'échec » (quelle qu'en soit la raison, y compris l'échec de validation).

AppsFlyerLib.getInstance().registerValidatorListener(this,new
   AppsFlyerInAppPurchaseValidatorListener() {
     public void onValidateInApp() {
       Log.d(TAG, "Purchase validated successfully");
     }
     public void onValidateInAppFailure(String error) {
       Log.d(TAG, "onValidateInAppFailure called: " + error);
     }
});

AppsFlyerLib.getInstance().registerValidatorListener(this, object : AppsFlyerInAppPurchaseValidatorListener {
    override fun onValidateInApp() {
       	Log.d(LOG_TAG, "Purchase validated successfully")
    }

    override fun onValidateInAppFailure(error: String) {
        Log.d(LOG_TAG, "onValidateInAppFailure called: $error")
   }
})

Exemple de validation d'un achat :

// Purchase object is returned by Google API in onPurchasesUpdated() callback
private void handlePurchase(Purchase purchase) {
    Log.d(LOG_TAG, "Purchase successful!");
    Map<String, String> additional_event_values = new HashMap<>();
    additional_event_values.put("some_parameter", "some_value");
    String price= "10";
    String currency = "USD";
    AppsFlyerLib.getInstance().validateAndTrackInAppPurchase(getApplicationContext(), PUBLIC_KEY, purchase.getSignature(), purchase.getOriginalJson(), revenue, currency, additional_event_values);
}

// Purchase object is returned by Google API in onPurchasesUpdated() callback
private fun handlePurchase(Purchase purchase) {
   Log.d(LOG_TAG, "Purchase successful!");
   val additional_event_values = HashMap<String, String>()
   additional_event_values.put("some_parameter", "some_value");
   val price= "10";
   val currency = "USD";
   AppsFlyerLib.getInstance().validateAndTrackInAppPurchase(this, PUBLIC_KEY, purchase.getSignature(), purchase.getOriginalJson(), revenue, currency, additional_event_values);
}

La validation d'un achat in-app envoie automatiquement un évènement d'achat in-app à AppsFlyer. Vous trouverez ci-dessous un exemple des données transmises dans le paramètre event_value :

{
   "some_parameter":"some_value", // from additional_event_values
   "af_currency":"USD", // from currency
   "af_content_id":"test_id", // from purchase
   "af_revenue":"10", // from revenue
   "af_quantity":"1", // from purchase
   "af_validated":true // flag that AF verified the purchase
}

• Event name: up to 45 characters
• Event value: must not exceed 1000 characters - if longer we may truncate it
• Pricing and revenue: use only digits and decimals, e.g. 5 or 5.2
• Pricing and revenue values can have up to 5 digits after the period, e.g. 5.12345
• Non-English characters are supported, in in-app events,  other SDK APIs, starting from Android SDK V4.8.1.

Vous pouvez enregistrer des évènements in-app en appelant trackEvent avec le nom de l'évènement et les paramètres de valeur. Consultez la documentation Événements in-app pour plus de détails.

Vous trouverez ci-dessous un exemple simple sur la façon d'enregistrer un évènement d'achat. Pour obtenir une liste complète des extraits de code prêts à l'emploi par secteur, consultez notre guide concernant les évènements rich in-app par secteur.

Exemple : évènement d'achat in-app

Map<String,Object> eventValues = new HashMap<>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200);
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY");
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes");
AppsFlyerLib.getInstance().trackEvent(this, AFInAppEventType.PURCHASE, eventValues);

val eventValues = HashMap<String, Any>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200)
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY")
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes")
AppsFlyerLib.getInstance().trackEvent(this, AFInAppEventType.PURCHASE, eventValues)

Si un utilisateur initie un évènement lorsque la connexion Internet est indisponible, Appsflyer est capable de l'enregistrer. Le fonctionnement est le suivant :

1. Le SDK envoie les événements aux serveurs AppsFlyer et attend une réponse.
2. Si le SDK ne reçoit pas une réponse 200, l'événement est stocké dans le cache.
3. Une fois que la réponse 200 suivante est reçue, l'événement stocké est renvoyé au serveur.
4. S'il y a plusieurs événements dans le cache, ils sont envoyés au serveur les uns après les autres.

OneLink détecte le type d'appareil lors du clic et redirige l'utilisateur vers une destination correspondante, par exemple, Google Play, app store iOS, marchés out-of-source ou pages Web.

Le guide sur les redirections OneLink aborde l'implémentation de liens d'attribution multiplate-forme (aucun codage SDK nécessaire). C'est également la base du deep linking.

Le deep linking vous permet d'envoyer les utilisateurs vers des activités spécifiques tout en leur offrant un contenu personnalisé. Cette fonction est particulièrement utile lors de l'exécution de campagnes de retargeting.

Pour configurer le deep linking avec OneLink, un marketeur ayant accès au tableau de bord d'AppsFlyer et un développeur ayant accès à l'app doivent travailler ensemble.

Consultez notre guide de configuration du deep linking avec OneLink.

Le deep linking différé vous permet d'effectuer le deep link des nouveaux utilisateurs et de leur offrir du contenu personnalisé après l'installation de l'app. Il est différent du deep linking habituel pour lequel l'app doit déjà être installée sur l'appareil de l'utilisateur.

Pour configurer le deep linking différé avec OneLink, le développeur doit également avoir accès au tableau de bord d'AppsFlyer.

La configuration du deep linking différé est la même que celle du deep linking. La seule différence est que vous devez implémenter une logique supplémentaire dans l'app de façon à pouvoir effectuer le deep link des utilisateurs et leur offrir du contenu personnalisé après installation et lancement de l'application.

Consultez notre guide sur le deep linking différé pour en savoir plus.

Le SDK vous fournit les données de conversion ou d'engagement après chaque installation ou évènement de deep linking. Vous pouvez utiliser ces données pour personnaliser du contenu et le comportement de l'app par programme.

Consultez notre guide sur les données de deep linking pour en savoir plus.

Avec AppsFlyer, vous pouvez attribuer des installations pour des applications Android out-of-store. Cela vous permet de promouvoir vos applications et de toucher de plus larges audiences sur les marchés où Google Play n'est pas disponible. 

Pour plus de détails sur la façon d'attribuer des installations pour les applications out-of-store, cliquez ici.

Dans les campagnes de pré-installation, les propriétaires d'applications peuvent demander aux fabricants d'appareils de pré-installer leurs applications sur les appareils avant leur départ de l'usine.

Avec AppsFlyer, vous pouvez facilement attribuer les installations d'applications pré-installées. Lorsque les utilisateurs lancent votre application pour la première fois, AppsFlyer attribue l'installation au fabricant en tant que source média.

Pour plus de détails, veuillez cliquer ici.

Pour connaître la façon de configurer la mesure des désinstallations, cliquez ici.

Si vous souhaitez recevoir la confirmation que la demande de suivi a bien été reçue par les serveurs AppsFlyer, implémentez le port d'écoute trackAppLaunchWithCompletionHandler.

La méthode de callback onTrackingRequestSuccess() est appelée toutes les 200 réponses à une demande d'attribution effectuée par le SDK.

La méthode de callback onTrackingRequestFailure(String error) est appelée pour toute autre réponse et renvoie la réponse sous forme de chaîne d'erreur.

Exemple d'implémentation

AppsFlyerLib.getInstance().startTracking(this.getApplication(),"devKey", myListener());
private AppsFlyerTrackingRequestListener myListener() {  
  return new AppsFlyerTrackingRequestListener() { 
    @Override public void onTrackingRequestSuccess() { 
      Log.d("Debug", "Got 200 response from server");  
    }  @Override public void onTrackingRequestFailure(String error) { 
      Log.d("Debug", error); 
      }  
    }; 
  }

AppsFlyerLib.getInstance().startTracking(this,"devKey", myListener())
private fun myListener() : AppsFlyerTrackingRequestListener{
   return object : AppsFlyerTrackingRequestListener{
      override fun onTrackingRequestSuccess() {
      Log.d("Debug", "Got 200 response from server");
   }
   override fun onTrackingRequestFailure(error: String?) {
     Log.d("Debug", error);
   }
  }
}

L'API setAdditionalData est requise pour l'intégration au niveau SDK avec plusieurs plates-formes partenaires externes, dont Segment, Adobe et Urban Airship. Utilisez cette API uniquement si l'article d'intégration de la plate-forme indique spécifiquement que l'API setAdditionalData est requise.

Exemple de code setAdditionalData :

HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("custom_param_1","value_of_param_1");
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

val customDataMap = HashMap<String, Any>()
customDataMap.put("custom_param_1","value_of_param_1")
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)

Par défaut, il doit s'écouler au moins 5 secondes entre deux lancements d'apps pour que cela soit considéré comme deux sessions distinctes (pour en savoir plus sur le comptage de session).

Utilisez l'API suivante pour définir la durée minimale entre les sessions :

AppsFlyerLib.setMinTimeBetweenSessions(int seconds);

Le fait de définir une valeur élevée à la durée personnalisée entre les lancements peut avoir un impact négatif sur les API qui s'appuient sur les données de session, comme le deep linking.

Vous pouvez signaler de nouvelles sessions utilisateur à l'aide de cette méthode de SDK. Par exemple, cela peut être utile pour les applications utilitaires qui s'exécutent en arrière-plan.

Utilisez cette API dans la fonction onCreate() de votre activité :

public void reportTrackSession(Context context);

Exemple d'utilisation :

AppsFlyerLib.getInstance().reportTrackSession(context);

Certains services tiers tels que les prestataires de services de messagerie encapsulent des liens dans des emails avec leurs propres domaines d'enregistrement des clics. Certains vous permettent même de définir vos propres domaines d'enregistrement des clics. Si OneLink est encapsulé dans de tels domaines, il est possible que ses fonctionnalités soient limitées.

Pour résoudre ce problème, vous pouvez utiliser l'API setResolveDeepLinkURLs. Utilisez cette API pour obtenir le OneLink des domaines de clic qui lancent l'application.  Assurez-vous d'appeler cette API avant d'initialiser le SDK.

Par exemple, vous avez trois domaines de clic qui redirigent vers votre OneLink : https://mysubdomain.onelink.me/abCD. Utilisez cette API pour obtenir le OneLink vers lequel vos domaines de clic redirigent.  Cette méthode d'API reçoit une liste de domaines que le SDK résout. Ajoutez le code suivant avant l'initialisation du SDK.

AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "anotherclickdomain.com");

Le code ci-dessus vous permet d'utiliser votre domaine de clic tout en conservant les fonctionnalités de OneLink. Les domaines de clic sont responsables du lancement de l'application. En retour, l'API obtient le OneLink de ces domaines de clic. Vous pouvez ensuite utiliser les données de ce OneLink pour le deep linking et personnaliser le contenu de l'utilisateur.

Avec AppsFlyer, vous pouvez mesurer les notifications push dans le cadre de campagnes de retargeting.

Pour activer cette fonctionnalité, appelez la méthode sendPushNotificationData dans la méthode onCreate de chaque activité lancée à la suite d'un clic sur la notification :

AppsFlyerLib.getInstance().sendPushNotificationData(this);

Pour plus d'informations concernant la mesure des notifications push, veuillez lirececi.

Le fait de permettre à vos utilisateurs existants d'inviter leurs amis et contacts en tant que nouveaux utilisateurs de votre application peut être un facteur de croissance important pour votre application. Avec AppsFlyer, vous pouvez attribuer et enregistrer les installations provenant d'invitations utilisateur au sein de votre app.

Pour obtenir plus d'informations, reportez-vous à l'article concernant l'attribution des invitations utilisateur.

Un ID AppsFlyer est créé pour chaque nouvelle installation d’une application. Vous pouvez utiliser l'ID AppsFlyer à différentes fins :

• Envoyez des événements in-app serveur à serveur.
• Faites correspondre l'ID AppsFlyer et les enregistrements utilisateur dans vos systèmes en arrière-plan.
• Mappez les entrées lors de la fusion des données de l'API Pull et de l'API Push.

Utilisez l’API suivante pour obtenir l’ID AppsFlyer :

public String getAppsFlyerUID(Context context);

Exemple d'utilisation :

String appsFlyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(this);

Pour définir votre ID Utilisateur-Client :

public void setCustomerUserId(String id);

Exemple d'utilisation :

AppsFlyerLib.getInstance().setCustomerUserId("myId");

Nous vous recommandons de définir l'ID utilisateur du client au début du flux de l'app, car il est uniquement associé aux évènements rapportés après son installation :

• Si setCustomerUserId est appelé avant de faire appel à startTracking, l'ID utilisateur du client apparaîtra dans les rapports de données brutes en ce qui concerne les installations et les évènements.
• S'il est défini après, l'ID utilisateur du client est uniquement associé aux évènements enregistrés après la définition de l'ID utilisateur du client.

Obtenir l'ID Utilisateur-Client :

Pour éviter de redéfinir la valeur de l'ID utilisateur du client après le premier lancement et réduire le nombre d'appels à votre serveur afin d'obtenir l'ID utilisateur du client, vous pouvez vérifier si sa valeur est vide ou non en utilisant :

AppsFlyerProperties.getInstance().getString(AppsFlyerProperties.APP_USER_ID)

Pour plus d’informations sur l’ID Utilisateur-Client, cliquez ici.

Retarder l'initialisation du SDK dans l'attente du customerUserID

Il est possible d'attendre que le customerUserID soit défini pour lancer l'initialisation du SDK.

Pour indiquer que le SDK doit retarder l'initialisation dans l'attente de l'ID utilisateur du client, appelez :

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

immédiatement avant la méthode init(). Le reste de l'initialisation du SDK doit rester inchangé.

Une fois le customerUserID fourni, appelez

AppsFlyerLib.getInstance().setCustomerIdAndTrack("customer_id", this);

afin de fournir au SDK l'ID utilisateur du client approprié et de déclencher le SDK.

Le code doit apparaître comme suit :

public class AFApplication extends Application {
  private static final String AF_DEV_KEY = "qrdZGj123456789";
  @Override
  public void onCreate() {
    super.onCreate();
    AppsFlyerConversionListener conversionDataListener = 
    new AppsFlyerConversionListener() {
      ...
    };
    AppsFlyerLib.getInstance().waitForCustomerUserId(true); 
    AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
    AppsFlyerLib.getInstance().startTracking(this);
    // Do your magic to get the customerUserID
    // ...
    // any AppsFlyer SDK code invoked here will be discarded
   //Call the following API once the customerUserID is available:
 AppsFlyerLib.getInstance().setCustomerIdAndTrack("customer_id", this);
  }
}

class AFApplication: Application() {
 private val afDevKey = ""

 override fun onCreate() {
  super.onCreate()
  val conversionDataListener = object: AppsFlyerConversionListener {
   ...
  }
  AppsFlyerLib.getInstance().waitForCustomerUserId(true);
  AppsFlyerLib.getInstance().init(afDevKey, conversionDataListener, this)
  AppsFlyerLib.getInstance().startTracking(this)
  // Do your magic to get the customerUserID
  // ...
  // any AppsFlyer SDK code invoked here will be discarded
  // Call the following API once the customerUserID is available:
  AppsFlyerLib.getInstance().setCustomerIdAndTrack("customer_id", this)
 }
}

Pour en savoir plus sur la façon de retarder l'initialisation du SDK jusqu'à ce que l'ID utilisateur du client soit disponible, cliquez ici.

AppsFlyer collecte automatiquement le google_advertising_id depuis la version 4.8.0 du SDK.

L'obligation de collecte de l'ID Google Advertising s'applique uniquement aux versions 4.7.X et supérieures du SDK.

Un identifiant unique d'appareil au minimum doit être collecté pour activer l'attribution. Les identifiants suivants sont disponibles : GAID, ID Android, IMEI et OAID.

GAID - Google Advertising ID

Recueilli automatiquement dans les apps qui contiennent les services Google Play. Si le GAID est disponible, l'IMEI et l'ID Android ne doivent PAS être collectés par l'app afin d'éviter toute violation de la réglementation Google Play.

Numéro IMEI et ID Android

Désactivé par défaut.Peut être collecté UNIQUEMENT pour les apps qui ne contiennent AUCUN service Google Play.
Remarque : depuis Android 10 (niveau 29 de l'API), sorti fin 2019, l'accès au paramètre IMEI est restreint.

Pour envoyer ces ID à AppsFlyer :

1. Sur l'application ouverte, collectez l'IMEI et / ou l'ID Android de l'appareil.
2. Appelez les API suivantes AVANT d'appeler la méthode startTracking :
   

   AppsFlyerLib.getInstance().setImeiData("IMEI_HERE");
   AppsFlyerLib.getInstance().setAndroidIdData("ANDROID_ID_HERE");

OAID - Open Advertiser Identifier

Désactivé par défaut.À l'heure actuelle, seuls les appareils HUAWEI prennent en charge la collecte d'OAID.
Pour collecter l'OAID : 

1. Implémentez HUAWEI Ads Kit dans votre app.
2. Utilisez l'API suivante AVANT d'appeler la méthode startTracking :

   AppsFlyerLib.getInstance().setCollectOaid(true);

   Ou bien, si vous disposez déjà de l'OAID, vous pouvez utiliser

   AppsFlyerLib.getInstance().setOaidData("OAID_HERE");

Désactiver la collecte d'ID d'appareil

Les développeurs peuvent choisir de ne pas collecter les IMEI, ID Android et OAID en utilisant les API suivantes :

AppsFlyerLib.getInstance().setCollectIMEI(false);
AppsFlyerLib.getInstance().setCollectAndroidID(false);
AppsFlyerLib.getInstance().setCollectOaid(false);

Dans certains cas extrêmes, vous pouvez vouloir arrêter tout suivi SDK en raison de la conformité aux exigences légales et à la vie privée. L'API isStopTracking le permet. Une fois cette API appelée, le SDK cesse de fonctionner et ne communique plus avec les serveurs AppsFlyer.

AppsFlyerLib.getInstance().stopTracking(true, context);

Il existe différents scénarios d'exclusion d'utilisateurs. Nous recommandons vivement de suivre les instructions exactes du scénario qui correspond à votre application.

Dans chaque évènement, le SDK peut être réactivé en appelant la même API, avec la valeur false.

AppsFlyerLib.getInstance().trackAppLaunch(getApplicationContext(), AF_DEV_KEY);

Utilisez cette API lors de l'initialisation du SDK pour anonymiser explicitement les installations, les évènements et les sessions d'un utilisateur :

public void setDeviceTrackingDisabled(boolean isDisabled);

Exemple d'utilisation :

AppsFlyerLib.getInstance().setDeviceTrackingDisabled(true);

Il est possible de reprendre le suivi en appelant deviceTrackingDisabled défini sur false.