Migrazione dell’app mobile da SDK v4 ad Adobe Experience Platform SDK

IMPORTANTE

Il processo di migrazione è irreversibile.

Leggi attentamente il documento prima di avviare la migrazione dell’app mobile SDK V4 all’SDK di Adobe Experience Platform.

Informazioni sulla migrazione SDK V4

Adobe Campaign Standard elabora le applicazioni mobili utilizzando l’SDK V4 come applicazioni separate da quelle che utilizzano l’SDK Adobe Experience Platform.
Dopo aver aggiornato la versione SDK di Adobe dalla versione v4 a Adobe Experience Platform, le applicazioni mobili devono continuare a utilizzare i dati e le campagne degli abbonati alle applicazioni esistenti: è pertanto necessaria una migrazione.

NOTA

Questa pagina documenta la migrazione di un’app mobile SDK v4 a una nuova applicazione SDK Adobe Experience Platform. Le applicazioni mobili SDK v4 non verranno unite a un’app mobile Adobe Experience Platform SDK con un Configured Property status.

Cosa non cambierà dopo la migrazione
Non ci sarà alcun effetto sulle consegne e campagne esistenti che utilizzano l’applicazione SDK V4 migrata.
Il nome dell’app mobile rimarrà invariato.
Le credenziali della piattaforma per iOS e Android verranno mantenute.
Tutti gli abbonati all'applicazione e i loro dati saranno conservati.
L’app mobile SDK v4 esistente continuerà a inviare dati (dati PII, informazioni del sottoscrittore e del token) ad Adobe Campaign Standard.
La Organizational unit dell’app mobile rimarrà invariata.
Cosa cambierà dopo la migrazione
L’app mobile sarà disponibile in Administration > Channels > Mobile app (Adobe Experience Platform SDK). Prima della migrazione, era disponibile in Administration > Channels > Mobile app (SDK V4).
La Collect PII Endpoint dell'applicazione cambierà. Più vecchio Collect PII Endpoint continuerà a funzionare, i dati inviati non andranno persi.
L’applicazione verrà associata a un tag Mobile Property. Sarà elaborato come nuova app mobile creata.
L'applicazione Adobe Experience Platform SDK originale utilizzata nella migrazione non esisterà come applicazione separata. Sarà disponibile solo l’applicazione SDK v4 migrata.

Migrazione dell’app mobile dall’SDK v4 a Adobe Experience Platform SDK

Prima di eseguire la migrazione, è necessario tenere conto dei seguenti consigli:

  • Il processo di migrazione è irreversibile.
  • Non è consigliabile eseguire la migrazione di più applicazioni contemporaneamente. È inoltre necessario assicurarsi che la migrazione di una stessa applicazione non venga attivata contemporaneamente da più finestre.
  • Prima della migrazione, accertati di aver assegnato il Organizational unit dell’app mobile da migrare e dell’applicazione Adobe Experience Platform che si sta utilizzando per la migrazione.
  • Dopo la migrazione, l’applicazione diventerà un’applicazione Adobe Experience Platform SDK. Le modifiche apportate verranno collegate al tag corrispondente Mobile Property.
  1. Crea un nuovo Mobile property nell’interfaccia utente di raccolta dati. Per ulteriori informazioni, consulta la documentazione.

  2. In Adobe Campaign Standard, dal menu avanzato, seleziona Administration > Application Settings > Workflows e aprire syncWithLaunch workflow. Controlla se il flusso di lavoro è terminato senza errori.

  3. Dopo il completamento del flusso di lavoro, dal Administration > Channels > Mobile app (Adobe Experience Platform SDK) controlla se l’app mobile è disponibile in Adobe Campaign Standard ed è in Ready to Configure stato.

  4. In Administration > Channels > Mobile app (SDK V4), seleziona l’applicazione SDK V4 da migrare.

  5. Seleziona la scheda Mobile application migration to AEP SDK.

  6. Da Select AEP SDK mobile application to merge current application with seleziona l’app mobile Adobe Experience Platform SDK creata in precedenza.

  7. Fai clic su Migrate.

  8. Da Migration application finestra, fai clic su Ok.

  9. Viene visualizzata la finestra di completamento, fare clic su Go to Adobe Experience Platform SDK Channel list.

  10. Dalla pagina dell’elenco dei canali SDK per Adobe Experience Platform , controlla che la tua precedente app mobile V4 sia impostata su Ready To Configure.

  11. Seleziona l’app mobile e fai clic su Save per completare la migrazione.

Dopo questa migrazione, gli abbonati raccolti dalla versione V4 dell'applicazione mobile e i nuovi abbonati raccolti dalla versione AEP dell'applicazione mobile saranno disponibili nell'applicazione migrata.

Per distinguere i due diversi tipi di abbonati, puoi aggiungere un nuovo campo personalizzato di Text digita durante l’estensione della risorsa personalizzata Subscriptions to an application (appSubscriptionRcp) come sdkversion o appVersion ad esempio. Per ulteriori informazioni su come estendere una risorsa personalizzata, consulta page.
Sarà quindi necessario configurare il tag associato Mobile property per inviare questo valore di campo personalizzato nella chiamata Raccogli PII e modificare di conseguenza la configurazione dell’app mobile.

Domande frequenti

D: Nell’app mobile SDK v4, la scheda Migrazione dell’applicazione mobile all’SDK Adobe Experience Platform non è visibile.

R: Dal menu avanzato Administration > Application Settings > Options, controlla il valore del Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option opzione . Deve essere impostato su 1 e abilitato 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 Nessun dato.

R: Solo applicazione idonea Organizational unit viene visualizzato nell’elenco. Assicurati di disporre dell’applicazione Adobe Experience Platform corretta per la migrazione. La Property Status dell’applicazione Adobe Experience Platform deve essere impostato su Ready to Configure e Mobile app migration status impostato su Not Migrated.

D: Perché l’applicazione Adobe Experience Platform SDK con lo stato della proprietà configurata non può essere utilizzata per la migrazione?

R: Il processo di migrazione mantiene gli abbonati e gli attributi SDK v4. Mantiene solo le informazioni relative ai tag dall'applicazione SDK di Adobe Experience Platform. Gli abbonati e altri dati dell’applicazione SDK Adobe Experience Platform andranno persi. Per evitare perdite di dati, solo le applicazioni SDK Adobe Experience Platform con Ready to Configure Property Status sono ammissibili alla migrazione.

D: Dopo la migrazione, dove posso trovare la mia precedente app mobile SDK v4?

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 la mia nuova applicazione SDK Adobe Experience Platform?

R: L'applicazione Adobe Experience Platform SDK appena creata 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 figlio dell'unità organizzativa ALL) e l'SDK Adobe Experience Platform è impostato su ALL. Come posso eseguire la migrazione della mia app mobile?

R: Amministratori del Organizational unit TUTTI avranno i diritti di 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 SDK Adobe Experience Platform è impostata su B (un livello di pari livello dell'unità organizzativa A). Come posso eseguire la migrazione della mia app mobile?

R: Applicazione SDK Adobe Experience Platform come risorsa di pari livello Organizational unit, l’app mobile non sarà visibile agli utenti del Organizational unit A. L’app mobile sarà disponibile per gli amministratori del Organizational unit TUTTO ma non consigliamo a questi amministratori di eseguire la migrazione dell’app mobile.
In questo caso, è necessario spostare le applicazioni mobili nello stesso Organizational unit o Organizational unit con un collegamento principale.
Per ulteriori informazioni su Organizational unit fai riferimento a questo sezione.

D: Dalla pagina dell’app mobile Adobe Experience Platform SDK (migrata dall’app mobile v4), nel menu a discesa delle impostazioni del canale push , non vengono visualizzate informazioni come data/nome caricati per la chiave Android o il certificato iOS

R: Il sistema non memorizza queste informazioni quando viene creata l'applicazione mobile SDK V4. Durante la migrazione dell’app mobile SDK V4 a un’app mobile Adobe Experience Platform SDK, l’app mobile migrata non avrà 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 Push channel settings a discesa.

In questa pagina