Comment migrer votre application mobile du SDK v4 vers le SDK Adobe Experience Platform

IMPORTANT

Le processus de migration est irréversible.

Veuillez lire attentivement ce document avant de commencer la migration de votre application mobile SDK V4 vers le SDK Adobe Experience Platform.

À propos de la migration du SDK V4

Adobe Campaign Standard traite les applications mobiles à l’aide du SDK V4 en tant qu’applications distinctes de celles qui utilisent le SDK Adobe Experience Platform.
Après la mise à niveau du SDK Adobe de la version v4 vers Adobe Experience Platform, les applications mobiles doivent continuer à utiliser les campagnes et données d’abonnés d’applications existantes. Une migration est donc nécessaire.

REMARQUE

Cette page documente la migration d’une application mobile SDK v4 vers une nouvelle application SDK Adobe Experience Platform. Vos applications mobiles SDK v4 ne seront pas fusionnées avec une application mobile SDK Adobe Experience Platform dotée du Statut de propriété Configuré.

Ce qui ne change pas après la migration
La migration n’a aucun effet sur les diffusions et campagnes existantes utilisant l’application SDK V4 migrée.
Le nom de l’application mobile reste identique.
Les informations d’identification de la plateforme pour iOS et Android sont conservées.
Tous les abonnés de l'application et leurs données sont conservés.
L’application mobile SDK v4 existante continue à envoyer des données (données PII, informations d’abonné et de jeton) à Adobe Campaign Standard.
L'entité organisationnelle de l'application mobile reste la même.
Ce qui change après la migration
L’application mobile est disponible dans Administration > Canaux > Application mobile (SDK Adobe Experience Platform). Avant la migration, elle était disponible dans Administration > Canaux > Application mobile (SDK v4).
Le point d'entrée pour la collecte des PII de l’application change. L'ancien point d'entrée pour la collecte des PII continue de fonctionner. Les données envoyées ne sont donc pas perdues.
L'application est liée à une propriété mobile Adobe Experience Platform Launch. Elle est traitée en tant qu’application mobile nouvellement créée.
L’application SDK Adobe Experience Platform d’origine utilisée dans la migration n’existe pas en tant qu’application distincte. Seule l’application SDK v4 migrée est disponible.

Migration de votre application mobile du SDK v4 vers le SDK Adobe Experience Platform

Avant de procéder à la migration, tenez compte des recommandations suivantes :

  • Le processus de migration est irréversible.
  • Vous ne devez pas exécuter simultanément la migration de plusieurs applications. Vous devez également vous assurer que la migration d’une même application n’est pas déclenchée par plusieurs fenêtres en même temps.
  • Avant la migration, assurez-vous d’avoir affecté l’entité organisationnelle de l’application mobile à migrer et de l’application Adobe Experience Platform que vous utilisez pour la migration.
  • Après la migration, l’application devient une application SDK Adobe Experience Platform. Ses modifications sont liées à la Propriété mobile Launch correspondante.
  1. Créez une propriété Mobile dans Adobe Experience Platform Launch. Pour plus d’informations, consultez la documentation d'Adobe Experience Platform Launch.

  2. Dans Adobe Campaign Standard, dans le menu avancé, sélectionnez Administration > Paramètres de l’application > Workflows et ouvrez le workflow syncWithLaunch. Vérifiez si le workflow s’est terminé sans erreur.

  3. Une fois le processus terminé, dans le menu Administration > Canaux > Application mobile (SDK Adobe Experience Platform), vérifiez si l’application mobile est disponible dans Adobe Campaign Standard et si elle a le statut Prêt pour configuration.

  4. Dans Administration > Canaux > Application mobile (SDK v4), sélectionnez l’application SDK v4 à migrer.

  5. Sélectionnez l'onglet Migration de l’application mobile vers le SDK AEP.

  6. Dans la liste déroulante Sélectionner l’application mobile SDK AEP avec laquelle fusionner l’application actuelle, sélectionnez l’application mobile SDK Adobe Experience Platform précédemment créée.

  7. Cliquez sur Migrer.

  8. Dans la fenêtre Application de migration, cliquez sur OK.

  9. La fenêtre d’achèvement réussi s’affiche, cliquez sur Accéder à la liste des canaux du SDK Adobe Experience Platform.

  10. Dans la page de la liste des canaux du SDK Adobe Experience Platform, vérifiez que votre application mobile V4 précédente est définie sur Prêt pour configuration.

  11. Sélectionnez votre application mobile et cliquez sur Enregistrer pour terminer la migration.

Après cette migration, les abonnés collectés par la version V4 de l’application mobile et les nouveaux abonnés collectés par la version AEP de l’application mobile seront disponibles dans l’application migrée.

Pour faire la distinction entre les deux types d'abonnés, vous pouvez ajouter un nouveau champ personnalisé de type Texte lors de l'extension de la ressource personnalisée Abonnements à une application (appSubscriptionRcp) en tant que sdkversion ou appVersion par exemple. Pour plus d’informations sur l'extension d'une ressource personnalisée, consultez cette page.
Vous devrez ensuite configurer la Propriété mobile Launch associée pour envoyer cette valeur de champ personnalisé dans l’appel de collecte PII et modifier la configuration de votre application mobile en conséquence.

FAQ

Q : Dans l’application mobile SDK v4, l’onglet Migration de l’application mobile vers le SDK Adobe Experience Platform n’est pas visible.

R : Dans le menu avancé Administration > Paramètres de l’application > Options, vérifiez la valeur de l’option Activer la migration de l’application mobile du SDK v4 vers le SDK Adobe Experience Platform. Elle doit être définie sur 1 et activée par défaut. L’administrateur peut l’avoir désactivée manuellement.

Q : Dans l’onglet Migration de l’application mobile vers le SDK Adobe Experience Platform, le message Aucune donnée s’affiche.

R : Seule l'application éligible de votre entité organisationnelle est affichée dans la liste. Vérifiez que vous disposez de l'application Adobe Experience Platform appropriée pour la migration. Le Statut de propriété de votre application Adobe Experience Platform doit être Prêt pour configuration Le statut de migration de l'application mobile doit quant à lui être défini sur Non migré.

Q : Pourquoi l’application SDK Adobe Experience Platform avec le statut de propriété Configuré ne peut-elle pas être utilisée pour la migration ?

R : Le processus de migration conserve les abonnés et les attributs du SDK v4. Il conserve uniquement les informations liées à Launch provenant de l’application SDK Adobe Experience Platform. Les abonnés et autres données provenant de l’application SDK Adobe Experience Platform sont perdus. Pour éviter toute perte de données, seules les applications SDK Adobe Experience Platform dotées du statut de propriété Prêt pour configuration peuvent être migrées.

Q : Après la migration, où puis-je trouver mon ancienne application mobile SDK v4 ?

R : L’application mobile après la migration est visible depuis le menu avancé Administration > Canaux > Application mobile (SDK Adobe Experience Platform).

Q : Après la migration, où puis-je trouver mon application SDK Adobe Experience Platform nouvellement créée ?

R : L’application SDK Adobe Experience Platform nouvellement créée utilisée pour la migration n’existe pas en tant qu’application distincte. Seule l’application SDK v4 migrée est disponible.

Q : Si l’entité organisationnelle de l’application mobile SDK v4 est définie sur A (fille de l’entité organisationnelle TOUS) et que le SDK Adobe Experience Platform est défini sur TOUS, Comment puis-je migrer mon application mobile ?

R : Les administrateurs de l'entité organisationnelle TOUS disposent des droits pour gérer les deux applications mobiles et sont chargés de la migration.

Q : Si l’entité organisationnelle de l’application mobile SDK v4 est définie sur A et que l’application SDK Adobe Experience Platform est définie sur B (sœur de l’entité organisationnelle A), Comment puis-je migrer mon application mobile ?

R : L’application SDK Adobe Experience Platform étant la ressource d’une entité organisationnelle sœur, l’application mobile n'est pas visible pour les utilisateurs de l’entité organisationnelle A. L’application mobile est disponible pour les administrateurs de l’entité organisationnelle TOUS, mais nous ne recommandons pas à ces administrateurs de migrer l’application mobile.
ans ce cas, vous devez déplacer vos applications mobiles vers la même entité organisationnelle ou dans une entité organisationnelle avec un lien parent.
Pour plus d'informations sur les entités organisationnelles, veuillez consulter cette section.

Q : Dans la page Application mobile SDK Adobe Experience Platform (migrée depuis votre application mobile v4), sous la liste déroulante Paramètres du canal push, aucune information comme le nom/la date de téléchargement n’est affichée pour la clé Android ou le certificat iOS

R : Le système ne stocke pas ces informations lorsque l’application mobile SDK V4 est créée. Lors de la migration de votre application mobile SDK V4 vers une application mobile SDK Adobe Experience Platform, votre application mobile migrée ne dispose pas non plus de ce type d’information. Dès qu’un utilisateur télécharge un nouveau certificat iOS ou une nouvelle clé Android, les différents détails de la clé ou du certificat sont stockés et affichés correctement sous la liste déroulante Paramètres du canal push.

Sur cette page