DocumentazioneDocumentazione di Campaign Standard

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

Last update: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Creato per:

  • Experienced
  • Admin

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.

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

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.

NOTE
Questa pagina documenta la migrazione di un’app mobile SDK v4 a un’applicazione Adobe Experience Platform SDK di nuova creazione. Le tue app mobili SDK v4 non verranno unite a un’app mobile SDK per Adobe Experience Platform con un Configured Property status.
Cosa non cambierà dopo la migrazione
Non vi 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 abbonato e token) ad Adobe Campaign Standard.
Il 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).
Il Collect PII Endpoint dell’applicazione cambierà. Il più vecchio Collect PII Endpoint continuerà a funzionare, i dati inviati non andranno persi.
L’applicazione verrà associata a un tag Mobile Property. Verrà elaborata come app mobile appena creata.
L’applicazione Adobe Experience Platform SDK originale utilizzata nella migrazione non esiste come applicazione separata. Sarà disponibile solo l’applicazione SDK v4 migrata.

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 di cui desideri eseguire la migrazione e dell’applicazione Adobe Experience Platform di cui stai utilizzando la migrazione.
  • Dopo la migrazione, l’applicazione diventerà un’applicazione Adobe Experience Platform SDK. Le modifiche verranno collegate al tag corrispondente Mobile Property.

  1. Crea un nuovo Mobile property nell’interfaccia utente di Data Collection. Per ulteriori informazioni, consulta documentazione.

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

  3. Dopo il completamento del flusso di lavoro, da 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 entrata Administration > Channels > Mobile app (SDK V4), seleziona l’applicazione SDK V4 di cui vuoi eseguire la migrazione.

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

  6. Dalla sezione Select AEP SDK mobile application to merge current application with a discesa, seleziona l’app mobile Adobe Experience Platform SDK creata in precedenza.

  7. Fai clic su Migrate.

  8. Dalla sezione 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 dell’SDK di Adobe Experience Platform, verifica che l’app mobile V4 precedente sia impostata su Ready To Configure.

  11. Seleziona la tua 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 abbonati, puoi aggiungere un nuovo campo personalizzato di Text digita quando estendi la risorsa personalizzata Subscriptions to an application (appSubscriptionRcp) as sdkversion o appVersion ad esempio. Per ulteriori informazioni su come estendere una risorsa personalizzata, consulta questa pagina.
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 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, controlla il valore di Enable migration of mobile app from SDK v4 to Adobe Experience Platform SDK option opzione. 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: Solo applicazione idonea del tuo Organizational unit viene visualizzato nell'elenco. Assicurarsi di disporre dell'applicazione Adobe Experience Platform corretta per la migrazione. Il Property Status dell’applicazione Adobe Experience Platform deve essere impostato su Ready to Configure e Mobile app migration status imposta 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 SDK Adobe Experience Platform con Ready to Configure Property Status sono idonei 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: Amministratori di Organizational unit ALL avrà i diritti per gestire entrambe le applicazioni mobili e sarà responsabile 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

A: l’applicazione Adobe Experience Platform SDK è la risorsa di un elemento di pari livello Organizational unit, l’app mobile non sarà visibile agli utenti di Organizational unit A. L’app mobile sarà disponibile per gli amministratori del Organizational unit TUTTI 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 in un Organizational unit con un collegamento principale.
Per ulteriori informazioni su Organizational unit, fare riferimento a questo 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 vengono memorizzati e visualizzati correttamente in Push channel settings a discesa.

recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff