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

Téléchargez le dernier plugin Unity sur GitHub.

Use one of the following installation methods.

Pour accorder les autorisations Android nécessaires :

Définissez les autorisations suivantes dans 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" />

Apps targeting API level 31 (Android 12) should add the following permission to AndroidManifest.xml to access the Android Advertising Identifier:

<uses-permission android:name="com.google.android.gms.permission.AD_ID" />

• La clé est unique et permet d'identifier le compte. Dans certains cas, il peut exister une clé au niveau de l'app.
• La clé dev est obligatoire.

Pour obtenir la clé dev :

1. Dans AppsFlyer, rendez-vous dans Configuration > Paramètres de l'app.
2. Récupérez la clé dev.

Pour envoyer des événements :

• Indiquez le nom et les paramètres de l'événement.
• Voir les listes associées : 
  • Liste des noms et structures d'événements recommandés
  • Liste trouvée dans la classe AFInAppEvents.

[Méthode conseillée] Utilisez les noms et paramètres des événements pour les cas suivants :

• Dénomination standard : AppsFlyer peut mapper automatiquement les événements sur les SRN tels que Facebook, Google et Twitter.
• Rétrocompatibilité : aucun conflit si AppsFlyer décide de modifier le nom ou le paramètre d'un évènement. L'implémentation sera compatible avec les versions antérieures.

Incluez les rapports de revenus en ajoutant le paramètre af_revenue aux événements in-app.

• Renseignez af_revenue à l'aide de chiffres. Les valeurs négatives sont autorisées. 
• Le paramètre af_revenue permet de comptabiliser les revenus et il intervient dans les champs de données brutes d'AppsFlyer. Ce qui permet aux marketeurs de visualiser les revenus directement dans le tableau de bord.
• Les revenus peuvent être envoyés avec des paramètres différents, mais la plate-forme AppsFlyer ne les considèrera pas comme des revenus.
  Cliquez ici pour plus de détails. 
• Les valeurs des revenus ne doivent contenir ni virgule, ni symbole monétaire, ni texte.
  Exemple d'événement de revenus : 1234,56

Conseil :obtenez plus d'infos sur  les paramètres de devise, l'affichage et la conversion des devises.

Règles à suive concernant le code de devise pour l'envoi d'événements générateurs de revenus.

• La devise par défaut est USD.
• Utilisez un code ISO 4217 à 3 caractères (cf exemple suivant).
• Définissez le code de devise en appelant l'API :
  

  AppsFlyer.setCurrencyCode("ZZZ")

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

Cet événement d'achat correspond à 200,12 euros. Pour que les revenus apparaissent dans le tableau de bord, utilisez les éléments suivants.

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.Dictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "EUR");
purchaseEvent.Add(AFInAppEvents.REVENUE, "200.12");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "1");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a",);
AppsFlyer.sendEvent ("af_purchase", purchaseEvent);

Enregistrer des revenus négatifs

Enregistrez les revenus négatifs à l'aide du signe -.

• La valeur de revenu est précédée du signe moins.
• Le nom de l'événement a la valeur unique "cancel_purchase". Cela vous permet d'identifier les événements de revenus négatifs dans le tableau de bord et les rapports de données brutes.

Exemple : l'utilisateur de l'application reçoit un remboursement ou annule un abonnement.

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.Dictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "USD");
purchaseEvent.Add(AFInAppEvents.REVENUE, "-200");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "1");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a");
AppsFlyer.sendEvent ("cancel_purchase", purchaseEvent);

Le plug-in effectue une vérification au niveau du serveur pour les achats in-app.

Pour valider un achat, suivez les instructions spécifiques au système d'exploitation :

#if UNITY_ANDROID && !UNITY_EDITOR
 AppsFlyerAndroid.validateAndSendInAppPurchase(
 "publicKey", 
 "signature", 
 "purchaseData", 
 "price", 
 "currency", 
 null, 
 this);
#endif

#if UNITY_IOS && !UNITY_EDITOR
 AppsFlyeriOS.validateAndSendInAppPurchase(
 "productIdentifier", 
 "price", 
 "currency", 
 "transactionId", 
 null, 
 this);
#endif

Paramètres de la méthode

• Nom de l'événement : 45 caractères maximum
• Valeur de l'événement : 1000 caractères maximum, si elle dépasse nous pourrons la tronquer
• Prend en charge les caractères hors alphabet anglais pour les événements in-app (et autres API)
• Tarifs et revenus :
  • Utilisez uniquement des nombres et des décimales tels que 5 ou 5.2
  • Jusqu'à 5 chiffres après la virgule acceptés. Par exemple 5,12345

Enregistrez les événements in-app en appelant sendEvent et incluez le nom de l'événement et les paramètres de valeur.
Consultez l'article Évènements in-app pour en savoir plus.

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

For a comprehensive list of ready-made code snippets per vertical, see our guides for rich in-app events per verticals.

System.Collections.Generic.Dictionary<string, string> purchaseEvent = new 
System.Collections.Generic.Dictionary<string, string> ();
purchaseEvent.Add(AFInAppEvents.CURRENCY, "USD");
purchaseEvent.Add(AFInAppEvents.REVENUE, "200");
purchaseEvent.Add(AFInAppEvents.QUANTITY, "2");
purchaseEvent.Add(AFInAppEvents.CONTENT_TYPE, "category_a");
purchaseEvent.Add(AFInAppEvents.CONTENT_ID, "092");
AppsFlyer.sendEvent (AFInAppEvents.PURCHASE, purchaseEvent);

Parfois, les utilisateurs génèrent des événements in-app, alors qu'ils n'ont pas de connexion Internet. AppsFlyer met l'événement en cache et le rapporte dès que la possibilité se présente.

• Le plug-in envoie les événements aux serveurs AppsFlyer et attend la réponse.
• Si le plug-in n'obtient pas une réponse 200, l'événement est stocké en cache.
• Une fois que la réponse 200 suivante est reçue, l'événement en cache est renvoyé au serveur.
• 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 (Android et iOS, ordinateur, etc.) lorsqu'un utilisateur effectue un clic, puis
• redirige l'utilisateur vers la destination correspondante : Google Play, app store iOS, marchés hors store ou pages web.

Pour implémenter les liens d'attribution multiplate-forme et découvrir les notions élémentaires du deep linking, veuillez parcourir le guide de la redirection OneLink.

Le deep linking vous permet d'envoyer les utilisateurs existants vers des activités spécifiques et du contenu personnalisé.

Le marketeur et le développeur doivent travailler ensemble pour configurer le deep link avec OneLink :

• Le marketeur doit accéder au tableau de bord AppsFlyer
• Le développeur doit accéder à l'application

Consultez notre guide de configuration du deep linking avec OneLink.

Le deferred deep linking vous permet de deep linker les nouveaux utilisateurs vers des activités spécifiques ou du contenu personnalisé dès la première ouverture qui suit l'installation d'une app.

Le deep link standard dirige également les utilisateurs vers des activités spécifiques et du contenu personnalisé, mais une application doit déjà être installée sur l'appareil de l'utilisateur .

Pour configurer un deep link différé avec OneLink :

• Le développeur doit accéder à la plate-forme AppsFlyer.
• La configuration de la plate-forme AppsFlyer pour le deep linking différé et standard est la même.
• Vous devez simplement implémenter une logique supplémentaire dans l'app pour pouvoir deep linker les utilisateurs et leur offrir un contenu personnalisé après l'installation et le lancement de l'app.

Consultez le deep link différé pour plus d'informations.

Le plug-in fournit des données de conversion ou d'engagement après chaque installation ou chaque événement de deep-linking. Utilisez ces données pour personnaliser le contenu ou le programme de comportement de l'app.

Pour recevoir les données du deep link :

• Implémentez le callback onAppOpenAttribution (qui figure dans la classe IAppsFlyerConversionData ); il est appelé par le plug-in AppsFlyer.
• Les paramètres Onelink/lien d'attribution renvoyés déclenchent l'ouverture de l'app.
• Analysez ensuite les valeurs, et appliquez la logique pour déclencher la page appropriée de l'app.

public void onAppOpenAttribution(string attributionData)
 {
 AppsFlyer.AFLog("onAppOpenAttribution", attributionData);
 Dictionary<string, object> attributionDataDictionary = AppsFlyer.CallbackStringToDictionary(attributionData);
 // add direct deeplink logic here
 }

Consultez les données de deep linking pour plus d'informations.

Pour obtenir les données de conversion d'AppsFlyer :

1. Implémentez le code IAppsFlyerConversionDatabase.
2. Appelez la méthode initSDK en l'utilisant comme paramètre final.
3. Utilisez la méthode onConversionDataSuccess pour rediriger l'utilisateur.

Voir la référence d'API pour onConversionDataSuccess.

using AppsFlyerSDK;

public class AppsFlyerObjectScript : MonoBehaviour , IAppsFlyerConversionData
{
    void Start()
    {
        /* AppsFlyer.setDebugLog(true); */
        AppsFlyer.initSDK("devkey", "appID", this);
        AppsFlyer.startSDK();
    }

    public void onConversionDataSuccess(string conversionData)
    {
        AppsFlyer.AFLog("onConversionDataSuccess", conversionData);
        Dictionary<string, object> conversionDataDictionary = AppsFlyer.CallbackStringToDictionary(conversionData);
        // add deferred deeplink logic here
    }

    public void onConversionDataFail(string error)
    {
        AppsFlyer.AFLog("onConversionDataFail", error);
    }

    public void onAppOpenAttribution(string attributionData)
    {
        AppsFlyer.AFLog("onAppOpenAttribution", attributionData);
        Dictionary<string, object> attributionDataDictionary = AppsFlyer.CallbackStringToDictionary(attributionData);
        // add direct deeplink logic here
    }

    public void onAppOpenAttributionFailure(string error)
    {
        AppsFlyer.AFLog("onAppOpenAttributionFailure", error);
    }
}

Mettre sur liste autorisée l'appareil de test.

Simuler des installations organiques et non organiques.

Simuler une installation organique

Les installations organiques sont des installations non attribuées, elles résultent en général des installations effectuées directement depuis des app stores. Pour simuler une installation organique, veuillez suivre ces instructions.

Simuler une installation non organique

Les installations non organiques sont des installations attribuées, elles découlent en général d'un engagement avec une publicité.  Pour simuler une installation non organique, veuillez suivre ces instructions.