Migrazione dell’app mobile da SDK v4 ad Adobe Experience Platform SDK sdkv4-migration
Il supporto per gli SDK Adobe Experience Platform Mobile versione 4 è terminato il 31 agosto 2021. Se utilizzi ancora questa versione legacy dell'SDK, devi aggiornare l'implementazione con Adobe Experience Platform SDK prima della fine di giugno 2024. Scopri come migrare all’SDK di Adobe Experience Platform in questo articolo.
Informazioni sulla migrazione di SDK V4
Adobe Campaign Standard elabora le applicazioni mobili utilizzando SDK V4 come applicazioni separate da quelle che utilizzano l’SDK di Adobe Experience Platform.
Dopo aver aggiornato la versione dell’SDK Adobe dalla versione v4 alla versione Adobe Experience Platform, le app mobili devono continuare a utilizzare le campagne e i dati degli abbonati all’applicazione esistenti: è quindi necessaria una migrazione.
Migrare l’app mobile da SDK v4 a Adobe Experience Platform SDK how-to-migrate
Prima di eseguire la migrazione, è necessario tenere conto dei seguenti consigli:
- La migrazione è irreversibile.
- Non eseguire la migrazione di più applicazioni contemporaneamente. È inoltre necessario assicurarsi che la migrazione di una stessa applicazione non venga attivata da più finestre contemporaneamente.
- Prima della migrazione, assicurati di aver assegnato Organizational unit dell'app mobile da migrare e dell'applicazione Adobe Experience Platform utilizzata per la migrazione.
- Dopo la migrazione, l’applicazione diventerà un’applicazione Adobe Experience Platform SDK. Le modifiche verranno collegate al tag corrispondente Mobile Property.
-
Crea un nuovo Mobile property nell'interfaccia utente di Data Collection. Per ulteriori informazioni, consulta la documentazione.
-
In Adobe Campaign Standard, dal menu avanzato, seleziona Administration > Application Settings > Workflows e apri il flusso di lavoro syncWithLaunch. Controlla se il flusso di lavoro è terminato senza errori.
-
Dopo il completamento del flusso di lavoro, dal menu Administration > Channels > Mobile app (Adobe Experience Platform SDK), controlla se l'app mobile è disponibile in Adobe Campaign Standard ed è nello stato Ready to Configure.
-
In Administration > Channels > Mobile app (SDK V4), seleziona l'applicazione SDK V4 di cui vuoi eseguire la migrazione.
-
Seleziona la scheda Mobile application migration to AEP SDK.
-
Dall'elenco a discesa Select AEP SDK mobile application to merge current application with, seleziona l'app mobile Adobe Experience Platform SDK creata in precedenza.
-
Fai clic su Migrate.
-
Dalla finestra Migration application, fare clic su Ok.
-
Viene visualizzata la finestra di completamento, fare clic su Go to Adobe Experience Platform SDK Channel list.
-
Dalla pagina dell'elenco dei canali dell'SDK di Adobe Experience Platform, verifica che l'app mobile V4 precedente sia impostata su Ready To Configure.
-
Seleziona l'app mobile e fai clic su Save per completare la migrazione.
Dopo questa migrazione, gli abbonati raccolti dalla versione V4 dell’app mobile e i nuovi abbonati raccolti dalla versione AEP dell’app mobile saranno disponibili nell’applicazione migrata.
Per distinguere i due diversi tipi di sottoscrittori, è possibile aggiungere un nuovo campo personalizzato di tipo Text durante l'estensione della risorsa personalizzata Subscriptions to an application (appSubscriptionRcp), ad esempio sdkversion
o appVersion
. Per ulteriori informazioni su come estendere una risorsa personalizzata, consulta questa pagina.
Sarà quindi necessario configurare il tag associato Mobile property per inviare il valore del campo personalizzato nella chiamata Raccolta PII e modificare di conseguenza la configurazione dell'app mobile.
Domande frequenti faq
D: nell’app mobile SDK v4, la scheda Migrazione dell’app mobile all’SDK di Adobe Experience Platform non è visibile. tab-not-visible
R: Dal menu avanzato Administration > Application Settings > Options, controllare il valore dell'opzione Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option. Deve essere impostato su 1 e attivato per impostazione predefinita. L'amministratore potrebbe averlo disabilitato manualmente.
D: Dalla scheda Migrazione dell’applicazione mobile all’SDK di Adobe Experience Platform, viene visualizzato il messaggio No data (Nessun dato). no-data
R: Nell'elenco viene visualizzata solo l'applicazione idonea di Organizational unit. Assicurarsi di disporre dell'applicazione Adobe Experience Platform corretta per la migrazione. Property Status dell'applicazione Adobe Experience Platform deve essere impostato su Ready to Configure e Mobile app migration status su Not Migrated.
D: Perché non è possibile utilizzare per la migrazione l’applicazione Adobe Experience Platform SDK con Stato proprietà configurato? property-status
R: Il processo di migrazione mantiene i sottoscrittori e gli attributi dell’SDK v4. Conserva solo le informazioni relative al tag dell’applicazione Adobe Experience Platform SDK. Gli abbonati e altri dati provenienti dall’applicazione Adobe Experience Platform SDK andranno persi. Per evitare perdite di dati, solo le applicazioni Adobe Experience Platform SDK con Ready to Configure Property Status sono idonee per la migrazione.
D: Dopo la migrazione, dove posso trovare la mia precedente app mobile SDK v4? v4-app-not-visible
R: L'app mobile dopo la migrazione sarà visibile dal menu avanzato Administration > Channels > Mobile app (Adobe Experience Platform SDK).
D: Dopo la migrazione, dove posso trovare l’applicazione Adobe Experience Platform SDK appena creata? aep-not-visible
R: L’applicazione Adobe Experience Platform SDK appena creata e utilizzata per la migrazione non esisterà come applicazione separata. Sarà disponibile solo l’applicazione SDK v4 migrata.
D: se l’unità organizzativa dell’applicazione mobile SDK v4 è impostata su A (un elemento secondario dell’unità organizzativa ALL) e l’SDK di Adobe Experience Platform è impostato su ALL. Come posso eseguire la migrazione della mia app mobile? v4-org-unit
R: Gli amministratori di Organizational unit ALL avranno i diritti per gestire entrambe le applicazioni mobili e saranno responsabili della migrazione.
D: se l’unità organizzativa dell’applicazione mobile SDK v4 è impostata su A e l’applicazione Adobe Experience Platform SDK è impostata su B (un elemento di pari livello dell’unità organizzativa A). Come posso eseguire la migrazione della mia app mobile? aep-org-unit
R: l'applicazione Adobe Experience Platform SDK è la risorsa di un elemento di pari livello Organizational unit, pertanto l'applicazione mobile non sarà visibile agli utenti dell'elemento A Organizational unit. L'app mobile sarà disponibile per gli amministratori di Organizational unit ALL, ma si sconsiglia agli amministratori di eseguire la migrazione dell'app mobile.
In questo caso, è necessario spostare le applicazioni mobili nello stesso Organizational unit o in un Organizational unit con un collegamento padre.
Per ulteriori informazioni su Organizational unit, fare riferimento a questa sezione.
D: dalla pagina dell’app mobile Adobe Experience Platform SDK (migrata dall’app mobile v4), sotto il menu a discesa delle impostazioni del canale push, non viene visualizzata alcuna informazione come data/nome caricato per la chiave Android o il certificato iOS no-information-v5
R: Il sistema non memorizza queste informazioni quando viene creata l’app mobile SDK V4. Quando esegui la migrazione dell’app mobile SDK V4 a un’app mobile Adobe Experience Platform SDK, nemmeno l’app mobile migrata disporrà di questo tipo di informazioni. Non appena un utente carica un nuovo certificato iOS o una nuova chiave Android, i diversi dettagli della chiave o del certificato verranno memorizzati e visualizzati correttamente nel menu a discesa Push channel settings.