SDK Unity

app.traqio.sdk est le SDK Traqio pour Unity (namespace Traqio, classe TraqioSdk). Sur Android, il lit l’Install Referrer de Google Play via AndroidJavaProxy ; sur iOS, un petit plugin natif enregistre les installations auprès de SKAdNetwork. Les événements sont mis en file d’attente dans les PlayerPrefs et envoyés par une coroutine ; les deep links arrivent via Application.deepLinkActivated sans code supplémentaire.

Prérequis#

• Unity 2021.3 ou ultérieur.

Mise en place#

1. Ajoutez le paquet#

   Packages/manifest.json

   // Packages/manifest.json — once the package is published (git URL / OpenUPM)
   "dependencies": {
     "app.traqio.sdk": "0.1.0"
   }

   Le paquet n’est pas encore sur OpenUPM ni sur une URL git publique. D’ici là, utilisez Window → Package Manager → + → Add package from disk, et choisissez le package.json du dossier que nous vous envoyons.

2. Initialisez une seule fois#

   using Traqio;
   using UnityEngine;
   
   public class Bootstrap : MonoBehaviour
   {
       void Awake()
       {
           // Creates its own "Traqio" GameObject (DontDestroyOnLoad); call it once.
           TraqioSdk.Init("YOUR_SDK_KEY", "https://api.traqio.app");
       }
   }

   Le démarrage s’exécute comme une coroutine sur le GameObject propre au SDK : l’installation est signalée, le lien différé résolu, l’ouverture de l’app enregistrée, et la file envoyée à intervalles réguliers et chaque fois que le jeu est mis en pause.

3. Suivez les événements#

   TraqioSdk.SetUserId(player.Id);           // same id as RevenueCat's app_user_id
   TraqioSdk.Track("tutorial_complete");
   TraqioSdk.Track("purchase", 4.99f, "EUR");

   Noms : Noms d’événements. Consentement : TraqioSdk.SetConsent(bool).

Deep links#

var unsubscribe = TraqioSdk.OnDeepLink(link =>
{
    if (link.DeepLink != null) Router.Open(link.DeepLink);
});

TraqioSdk.GetDeferredDeepLink(link => { /* null when the install came from no link */ });

Pas encore dans ce SDK#

Sur iOS, aucune valeur de conversion n’est définie et aucun jeton Apple Ads n’est transmis. Pas d’identifiant de transaction sur les achats, pas de revenus publicitaires AdMob, pas d’effacement depuis l’app — utilisez RevenueCat et l’effacement côté serveur.

Questions fréquentes#

Dois-je ajouter la bibliothèque Install Referrer à mon projet Unity ?

Non. Quand Unity génère le projet Gradle Android, le script Editor du paquet ajoute com.android.installreferrer:installreferrer:2.2, l’entrée <queries> du Play Store qu’exigent Android 11 et suivants, et une règle keep pour les builds minifiés. Aucun template Gradle ni manifest personnalisé n’est nécessaire ; un template qui les déclare déjà est laissé tel quel.

Le SDK Unity de Traqio fonctionne-t-il dans l’Editor ?

Le C# tourne dans l’Editor et envoie les événements, mais les appels Install Referrer et SKAdNetwork ne sont compilés que pour les builds Android et iOS sur appareil. L’attribution ne s’observe que sur un build installé depuis un store sur un appareil.