Migrer depuis l'ancien SDK mobile
Comment migrer l'ancien SDK de la plateforme (Platform 7) vers la nouvelle plateforme (Platform X)
Pour suivre l'application mobile sur la nouvelle plateforme, vous pouvez soit installer notre nouveau SDK (Android et iOS) ou utiliser notre HTTP tracking API.
Étapes à suivre pour la migration du SDK v4 vers le SDK v5
Créez votre(s) Mobile Source(s)
Dans le Sources Catalog, créez vos nouvelles Sources.
Sources > Overview > Add Source
À la dernière étape de la configuration de la Source, vous obtiendrez une Source Key, requise pour les méthodes d'initialisation de notre SDK
Remplacez les modules du SDK
Les fichiers de notre SDK ont changé. Vous devez remplacer les anciens. Obtenez nos dernières versions :
Android : https://github.com/CommandersAct/AndroidV5#latest-available-versions iOS : https://github.com/CommandersAct/iOSV5#latest-available-versions
Modifiez les méthodes d'initialisation
La façon dont vous initialisez notre SDK est maintenant différente, vos anciennes méthodes ne seront plus reconnues.
Vous n'avez plus besoin d'un container ID, tout est sur le même site ID. Au lieu d'un container ID, vous aurez besoin d'une clé spécifique pour définir la source.
Vous n'avez plus besoin d'insérer une instance TCServerSide dans votre implémentation de Consent.
Vous pourriez avoir besoin d'utiliser la classe TCUser pour transmettre des informations pertinentes sur vos utilisateurs.
Si votre application mobile utilise nos modules SDK uniquement pour la Privacy, votre migration est terminée à ce stade.
Si vous souhaitez bénéficier de tous les avantages du suivi avec des destinations server-side, ou si vous utilisiez des containers server-side v1 pour envoyer des données à vos partenaires, veuillez suivre les étapes suivantes !
Remplacez les appels container par des events
Avec l'ancienne plateforme, vous aviez l'habitude d'envoyer un container call, avec toutes les variables. Ce n'est plus compatible. À la place, vous devez envoyer des events avec des properties.
Voici un exemple de code montrant comment exécuter un event :
let event = TCPageViewEvent(type: "product list")
event?.pageName = "Best sellers"
serverside?.execute(event)Pour la documentation technique sur l'intégration des events, veuillez visiter notre GitHub : https://github.com/CommandersAct/iOSV5/tree/master/TCServerSide#executing-events https://github.com/CommandersAct/AndroidV5/tree/master/TCServerSide#executing-an-event
Mettez à niveau votre data layer
La nouvelle plateforme utilise des propriétés standard, nous recommandons donc de mettre à niveau le data layer de votre application mobile en utilisant nos propriétés standard autant que possible
Créez vos destinations
Vous pouvez maintenant utiliser notre plateforme pour créer de nouvelles destinations et envoyer des données à vos partenaires
Test & validation
Un Test & validation Quality Assurance est fortement recommandé avant le lancement en production ! Voici quelques références pour vous aider sur ce point :
Debugging => liste des méthodes pour afficher les logs dans votre app https://github.com/CommandersAct/AndroidV5/tree/master/TCServerSide#debugging https://github.com/CommandersAct/iosV5/tree/master/TCServerSide#debugging
Votre migration est terminée !
Vous avez peut-être des besoins spécifiques ? N'oubliez pas de consulter la FAQ suivante
FAQ
Mon data layer doit-il être identique pour mon site web et mon application ?
C'est une bonne pratique ! Nous recommandons fortement d'avoir le même data layer pour le web et l'application mobile Avantage principal : configurer une seule destination pour les deux sources ! La configuration de votre destination sera reconnue par le web et le mobile
Comment puis-je obtenir l'IDFA/AAID ?
Notre SDK ne collecte plus automatiquement l'IDFA/AAID, mais nous proposons une méthode simple pour suivre cette information :
Android ServerSideInstance.addAdvertisingIDs());
iOS [ServerSideInstance addAdvertisingIDs];
Puis-je créer des custom events ?
Oui, c'est possible !
Pour plus d'informations, consultez cette partie de notre documentation : https://github.com/CommandersAct/AndroidV5/tree/master/TCServerSide#custom-events https://github.com/CommandersAct/iosV5/tree/master/TCServerSide#custom-events
Puis-je utiliser des paramètres supplémentaires ?
Oui, c'est possible ! Si vous avez besoin d'envoyer plus de données que les properties requises, utilisez simplement la méthode "additional property", comme suit :
TCPageViewEvent pageViewEvent = new TCPageViewEvent("Consent");
pageViewEvent.pageName = "Configuration";
pageViewEvent.addAdditionalProperty("currentConsent", "refused");TCPageViewEvent *pageViewEvent = [[TCPageViewEvent alloc] initWithType: @"Consent"];
pageViewEvent.pageName = @"Configuration";
[pageViewEvent addAdditionalProperty: @"currentConsent" withStringValue: @"refused"];Puis-je ajouter des variables Persisting ?
Oui, c'est possible !
Si vous devez définir une variable persistante, veuillez vous référer à cette doc : https://github.com/CommandersAct/AndroidV5/tree/master/TCServerSide#persisting-variableshttps://github.com/CommandersAct/iosV5/tree/master/TCServerSide#persisting-variables
Dois-je changer/mettre à jour mon fichier Json ?
Ce n'est pas requis ! Votre json actuel est toujours valide pour notre nouveau SDK
Dois-je changer/mettre à jour mes callbacks pour les statistiques de consentement ?
Ce n'est pas requis ! Votre configuration actuelle est toujours valide pour notre nouveau SDK
Mis à jour
Ce contenu vous a-t-il été utile ?