Guide d'intégration du plugin Unity V6— Intégration du SDK de base

At a glance: Additional SDK functionalities that are available to implement APIs such as uninstall measurement, user invite attribution, push notifications, and privacy settings. 

 Lectures connexes

For a complete picture of integrating the Unity plugin with your apps, be sure to read these articles: 

Attribution

Mesure des désinstallations

Mesurez le taux de désinstallation des utilisateurs provenant de différentes sources.

Pour configurer les mesures de désinstallation, référez-vous aux instructions du système d'exploitation correspondant.

Android - FirebaseiOS
  1. Téléchargez le SDK Unity Firebase depuis : https://firebase.google.com/docs/unity/setup.
  2. Importez FirebaseMessaging.unitypackage dans le projet.
  3. Importez google-services.json dans le projet (obtenu dans la console de Firebase)

     Note

    Le SDK Unity Firebase ajoute automatiquement des récepteurs de manifeste.

  4. Dans la classe Unity qui gère le code AppsFlyer, ajoutez le code suivant :
    avec Firebase.Messaging;
    avec Firebase.Unity;
  5. Ajoutez à la méthode Start() :
    Firebase.Messaging.FirebaseMessaging.TokenReceived += OnTokenReceived;
  6. Ajoutez la méthode suivante :
    public void OnTokenReceived(object sender, Firebase.Messaging.TokenReceivedEventArgs token)
    {
    #if UNITY_ANDROID
    AppsFlyer.updateServerUninstallToken(token.Token);
    #endif
    }

Guide de désinstallation Android

 Avertissement

Dans le cas : implémentation du SDK Unity Firebase.

Condition : N'ajoutez pas l'appel de méthode suivant pour activer UninstallTracking (« SenderID ») si vous avez ajouté le SDK Firebase Unity à votre projet.

Conséquences si ajouté :

  • Le SDK Firebase Unity obtiendra l'ID de l'expéditeur à partir du fichier google-services.json (qui a été ajouté précédemment).
  • Cela pourrait causer un avertissement de débogage de la part d'Android.

Définition des données personnalisées supplémentaires

L'intégration au niveau SDK avec plusieurs plateformes partenaires externes (dont Segment, Adobe et Urban Airship) nécessite l'utilisation de l'API setAdditionalData.

Utilisez cette API uniquement si l'article d'intégration du partenaire spécifie clairement que l'API setAdditionalData est requise.

Exemple : code setAdditionalData

Dictionary<string, string> CustomDataMap = new Dictionary<string, string>();
CustomDataMap.Add("custom_param_1", "value_of_param_1");

AppsFlyer.setAdditionalData(CustomDataMap);

Sessions

Personnalisation de la durée entre sessions

Par défaut, il doit s'écouler au moins 5 secondes entre deux lancements d'app pour qu'elles soient considérées comme deux sessions distinctes. Définir la durée minimale entre les sessions :

AppsFlyer.setMinTimeBetweenSessions(custom_time_ins_seconds);

Remarque Le fait de définir une durée personnalisée à valeur élevé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).

Plus de détails sur le comptage des sessions d'application .

Sessions d'arrière-plan pour applications utilitaires

Indisponible dans Unity.

Médias propres

Résoudre les URL Deep Link encapsulées

Certains services tiers (tels que les fournisseurs de services de messagerie ) :

  • Encapsulent les liens dans des e-mails en utilisant leurs propres domaines d'enregistrement de clics.
  • Vous permettent 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 éviter ce problème :

  • Appelez l'API setResolveDeepLinkURLs avant d'initialiser le SDK.
  • Utilisez cette API pour obtenir le OneLink des domaines de clic qui lancent l'application. 

Scenario : les domaines de clic redirigent vers votre OneLink sur :https://mysubdomain.onelink.me/abCD.

Solution :

  • Utilisez l'API setResolveDeepLinkURLs pour obtenir le OneLink vers lequel vos domaines de clic redirigent les utilisateurs.
  • Cette méthode API reçoit une liste de domaines que le plug-in vient résoudre.
  • Le code suivant vous permet d'utiliser votre domaine de clic tout en conservant les fonctionnalités de OneLink :

     Exemple

    AppsFlyer.setResolveDeepLinkURLs("example.com", "click.example.com");

Maintenant, utilisez les données de ce OneLink pour deep linker et personnaliser le contenu utilisateur.

Enregistrement des notifications push

Enregistrer les notifications push dans le cadre de campagnes de retargeting.

Pour enregistrer les notifications push :

  • Appelez la méthode sendPushNotificationData.
  • Cette méthode se trouve dans la méthode onCreate de chaque activité lancée à la suite d'un clic sur la notification :
#if UNITY_ANDROID && !UNITY_EDITOR
AppsFlyerAndroid.handlePushNotifications();
#endif

Pour plus d'informations, consultez la mesure des notifications push.

Attribution des invitations utilisateur

Si les utilisateurs de l'app invitent leurs amis et contacts à devenir de nouveaux utilisateurs, ce sera une source de bénéfice.

Attribuez et enregistrez les installations provenant des invitations d'utilisateurs au sein de l'app. Attribution des invitations d'utilisateur

Attribution des promotions croisées

La cross-promotion des apps peut entraîner l'installation de nouvelles applications.

Attribuez et enregistrez les installations provenant d'une campagne de cross-promotion : faites la promotion de l'une de vos apps depuis une autre vous appartenant, et qui a été déjà lancée par un utilisateur. Attribution de la cross-promotion.

User identifiers

Obtenez un ID AppsFlyer

Un identifiant AppsFlyer est créé pour chaque nouvelle installation d'une app. Utilisez l'ID AppsFlyer pour :

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

Pour obtenir l'ID AppsFlyer unique :

string AppsFlyerUID = AppsFlyer.getAppsFlyerId();

Définir l'ID Utilisateur-Client

Définissez votre ID utilisateur client unique (CUID) et recoupez-le avec un ID AppsFlyer unique.

CUID unique : 

  • Apparaît dans les rapports CSV de données brutes d'AppsFlyer.
  • Peut être utilisé dans les API de postback pour les croiser avec vos ID internes.

Pour définir le CUID, utilisez :

AppsFlyer.setCustomerUserId("someId");

Bonnes pratiques !Définissez le CUID au début du flux de l'application — il est associé uniquement aux évènements rapportés après son installation.

Call setCustomerUserId before calling startSDK

  • Les événements enregistrés seront associés au CUID.
  • Les données associées apparaîtront dans les rapports de données brutes pour les installations et les événements.
AppsFlyer.setCustomerUserId("someId");

Obtenir l'ID utilisateur du client

Consultez CUID pour plus d'informations.

Délai d'initialisation du plug-in pour customerUserID

Définissez d'abord l'ID utilisateur client unique (CUID) puis initialisez le SDK. Ceci vous garantit que vos données d'installation et d'événement contiennent bien votre CUID.

Consultez les instructions relatives au système d'exploitation :

  1. Android
  2. iOS

 Avertissement

Ne retardez le réglage du CUID que si cela répond au fonctionnement de votre entreprise. Si vous retardez le réglage du CUID, cela peut augmenter le risque d'écarts de mesure,  et exposer votre app à des tentatives de fraude.

Collecter l'OAID

OAID est l'un des identifiants d'appareil uniques qui permet l'attribution.

Pour collecter l'OAID :

Plug-in Unity V5.4 et ultérieurs Plug-in Unity V5.3 et antérieurs

Par défaut, l'OAID est collecté automatiquement. Pour désactiver la collecte automatique, appelez AppsFlyerAndroid.setCollectOaid(false);.

Confidentialité des utilisateurs

Exclusion

Il exemple différents cas, comme ceux en rapport avec la réglementation légale ou le respect de la vie privée, qui peuvent obliger à désactiver et stopper tout enregistrement (tracking)

Bonnes pratiques Suivez les instructions exactes du scénario qui correspond à votre application.

Pour arrêter le suivi :

  • Appelez stopSDK et définissez-le sur true.
    AppsFlyer.stopSDK(true);
  • Le plug-in cesse de fonctionner et ne communique plus avec les serveurs AppsFlyer.

Pour réactiver le suivi : appelez stopSDK et définissez-le sur false.

Attention

Utilisez l'API stopSDK si vous souhaitez arrêter totalement le suivi d'un utilisateur d'app en particulier. L'utilisation de l'API impacte fortement l'attribution, la collecte des données et les opérations de deep linking.

Anonymisation des données de l'utilisateur

Anonymize specific user identifiers within AppsFlyer analytics to comply with privacy regulations and Meta ads data and privacy policies.

Pour anonymiser un utilisateur d'application :

  1. Définissez l'API lors de l'initialisation du SDK
  2. Appelez anonymizeUseet définissez-le sur true.
    AppsFlyer.anonymizeUser(true);
  3. Les installations, les évènements et les sessions d'un utilisateur sont anonymisés.

Pour redémarrer le suivi : appelez anonymizeUser et définissez-le sur false.

 Avertissement

L'anonymisation des utilisateurs impacte fortement vos informations d'attribution. Utilisez cette option uniquement pour les régions dans lesquelles vous êtes légalement tenu de ne pas collecter les informations de vos utilisateurs.

Exclure les partenaires de l'obtention de données

Dans certains cas, les annonceurs peuvent choisir de cesser le partage de données de niveau utilisateur avec des réseaux publicitaires/partenaires pour certains utilisateurs. Parmi les motifs on retrouve : 

  • Les politiques de confidentialité telles que la CCPA ou le RGPD
  • Les mécanismes de retrait des utilisateurs
  • La concurrence avec certains partenaires (ad networks, tiers)

AppsFlyer fournit deux méthodes d'API pour arrêter le partage de données avec l'ensemble des partenaires ou avec certains d'entre eux :

  • setSharingFilterUsed by advertisers to set some (one or more) networks/integrated partners to exclude from getting data.
  • setSharingFilterForAllPartners: Used by advertisers to exclude all networks/integrated partners from getting data.

Ces méthodes de filtrage sont prises en charge à partir de la version 5.4.1 du SDK.

La méthode de filtrage doit être appelée à chaque fois que le SDK est initialisé et affecte la session entière.  Si un délai est requis pour déterminer si vous devez définir les filtres de partage, mieux vaut retarder l'initialisation du SDK. 

Lorsque la méthode est activée avant le premier appel de startSDK :

  • Les utilisateurs des SRN sont attribués comme organiques, et leurs données ne sont pas partagées avec les partenaires intégrés.
  • Les utilisateurs des réseaux publicitaires par clic (non-SRN) sont attribués correctement dans AppsFlyer, mais ne sont pas partagés avec ceux-ci via postback, API, rapport de données brutes, ou toute autre méthode.

Actuellement, les données de désinstallation ne peuvent pas être filtrées à l'aide de ces méthodes. Vous pouvez toutefois arrêter d'envoyer des événements de désinstallation aux partenaires en utilisant leurs pages de configuration dans AppsFlyer.