Tout ce que Personyze fait sur votre site web — bannières ciblées, popups, messages intégrés, tests A/B — peut aussi fonctionner dans votre application native iOS ou Android. Le ciblage est identique : mêmes règles d’audience, mêmes profils de visiteurs, mêmes données. Ce qui change, c’est la diffusion. Il n’y a pas de navigateur dans lequel injecter du HTML : le contenu atteint l’application via le SDK Personyze, et c’est votre application qui l’affiche.
Il s’agit d’une intégration SDK, pas d’une campagne en quelques clics. Un développeur branche le SDK une fois ; ensuite, les campagnes sont créées et ciblées dans le panneau sans aucun code supplémentaire.
Dans le panneau : Nouvelle campagne › App / API › Ciblage et personnalisation pour les applications.
Fonctionnement
- Le SDK est installé une fois dans votre application et initialisé avec votre clé API.
- L’application indique où se trouve l’utilisateur — écrans vus et événements — via des appels au SDK. C’est ce qui construit le profil sur lequel s’exécute le ciblage.
- Personyze décide quoi afficher, en utilisant vos règles d’audience, exactement comme sur le web.
- Votre application affiche le résultat : du HTML dans une WebView, ou du JSON mis en page avec des composants natifs.
Comme le profil est partagé avec le site web, une personne qui a parcouru une catégorie sur votre site est déjà connue lorsqu’elle ouvre l’application.
Installer le SDK
Votre clé API se trouve sur la page Paramètres › Intégrations du panneau — utilisez la clé de la section API complète.
Android
Clonez ou téléchargez le SDK Android de Personyze et placez le répertoire personyzeandroidsdk à la racine de votre projet.
Dans settings.gradle:
include ':app', ':personyzeandroidsdk'Dans app/build.gradle:
implementation project(path: ':personyzeandroidsdk')Dans votre manifeste :
<uses-permission android:name="android.permission.INTERNET" />Puis initialisez-le tôt, dans la classe Application de votre application :
PersonyzeTracker.inst.initialize(this, "YOUR_API_KEY");
PersonyzeTracker.inst.navigate("MainActivity");
PersonyzeTracker.inst.done();iOS
Téléchargez l’archive du SDK iOS de Personyze, extrayez-la, puis faites glisser PersonyzeIosSdk.swift dans le navigateur de projet de Xcode.
do
{ let tracker = try PersonyzeTracker(apiKey: "YOUR_API_KEY")
tracker.navigate(documentName: "ViewController")
tracker.done()
}
catch
{ print(error)
}Vérifier que cela fonctionne
Une fois l’initialisation faite, ouvrez l’application et consultez Visiteurs en temps réel dans le panneau. Si votre session y apparaît, le SDK communique avec Personyze et vous pouvez créer des campagnes. Sinon, rien de ce qui suit ne fonctionnera — corrigez cela avant d’aller plus loin.
La référence complète du SDK, y compris les classes tracker, condition et action, se trouve dans la documentation développeur.
Les étapes de la campagne
Quatre étapes : Configurer, Cibler, Contenu et Performance.
Notez qu’il n’y a pas d’étape QA pour les campagnes d’application. Les outils d’aperçu et de simulation sur site ne peuvent pas piloter une application native : la validation se fait donc dans une build de votre application plutôt que dans le panneau — voir plus bas.
1. Configurer
Confirme que le SDK est installé et renvoie vers les guides par plateforme ci-dessus. Rien à configurer ici, à part avoir réalisé l’intégration.
2. Cibler
Les mêmes règles d’audience que sur le web : comportement, champs de profil et de CRM, centres d’intérêt, géographie, contexte de session. Ce que l’application indique via navigate() et ses appels d’événements est ce que ces règles peuvent voir : la finesse de votre ciblage suit donc la finesse de votre instrumentation.
3. Contenu
Quoi afficher. Pour les applications, c’est généralement l’une de ces deux formes :
- HTML — affiché dans une WebView. Le plus rapide à créer, et les équipes marketing peuvent le modifier sans nouvelle version de l’application.
- JSON — Personyze renvoie des données structurées que vous mettez en page avec des composants natifs. Plus de travail au départ, et un résultat à l’aspect et au comportement natifs.
4. Performance
Les résultats en direct une fois la campagne lancée.
Valider sans étape QA
Comme il n’y a pas de QA dans le panneau, testez dans une build :
- Vérifiez que votre appareil apparaît dans Visiteurs en temps réel.
- Élargissez temporairement l’audience pour qu’elle vous inclue à coup sûr, et vérifiez que le contenu arrive.
- Resserrez de nouveau les règles et vérifiez que le contenu cesse d’arriver.
Cette troisième étape est celle que l’on saute, et c’est celle qui repère une règle qui correspond à tout le monde.