Nota: Non è disponibile alcuna documentazione legacy per questo elemento, pertanto viene visualizzata la documentazione corrente.
Puoi spostare gli iscritti alle notifiche push delle tue app iOS e Android da OneSignal a PushEngage riutilizzando le stesse credenziali Apple e Firebase che la tua app utilizza già. Poiché i token dei dispositivi sono emessi da Apple e Google anziché da OneSignal, il mantenimento di tali credenziali consente ai tuoi token di continuare a funzionare dopo il passaggio. Questa guida spiega come funziona la migrazione e i passaggi per impostarla. La migrazione è un processo backend gestito insieme al nostro team.
Prima di iniziare
- Crea un account con PushEngage.
- Tieni pronte le credenziali push di Apple, in particolare il tuo ID push dell'app e il certificato p12 dal tuo account sviluppatore Apple, le stesse utilizzate in OneSignal.
- Tieni pronto l'ID mittente Firebase di Android, lo stesso utilizzato in OneSignal.
- Accedi al tuo account OneSignal per esportare i dati degli iscritti.
Come funziona la migrazione delle app
I token dei dispositivi per le notifiche push delle app provengono da Apple Push Notification service (APNs) e Firebase Cloud Messaging (FCM), non da OneSignal. Se configuri PushEngage con le stesse credenziali APNs e FCM, i tuoi token rimangono validi e la migrazione avviene sul backend. Anche l'autorizzazione alle notifiche viene trasferita, quindi un utente che ha già concesso l'autorizzazione non dovrà concederla di nuovo.
Passaggi per la migrazione
Passaggio 1: Esporta i tuoi iscritti da OneSignal
Esporta i dati dei tuoi iscritti utilizzando uno dei due metodi:
- Esportazione API, utilizzando il tuo ID app OneSignal e la chiave API dell'app.
- Esportazione CSV, con un file che include
identifier,device_type,languagee altri campi pertinenti.
Passaggio 2: Configura FCM Android in PushEngage
- Accedi alla dashboard di PushEngage.
- Vai su Impostazioni » Installazione » SDK Android.
- Configura le impostazioni FCM di Google Android utilizzando lo stesso ID mittente Firebase che hai utilizzato in OneSignal.
Passaggio 3: Configura APNs iOS in PushEngage
- Vai su Impostazioni » Installazione » SDK iOS.
- Configura le impostazioni APNs di Apple iOS utilizzando lo stesso ID push dell'app della tua configurazione OneSignal.
- Carica il certificato p12 dal tuo account sviluppatore Apple, lo stesso che hai utilizzato in OneSignal.
[Screenshot: l'SDK Android e l'SDK iOS configurati in Impostazioni » Installazione.]
Note importanti sul passaggio di versione dell'app
La migrazione delle notifiche push delle app dipende dalla versione dell'app in uso da parte di un iscritto, quindi pianifica attentamente il passaggio di rilascio.
- Versioni precedenti dell'app con l'SDK OneSignal. Dopo la migrazione, gli iscritti che utilizzano ancora versioni precedenti dell'app non riceveranno le notifiche inviate da PushEngage, poiché il payload di PushEngage non può essere decodificato dall'SDK OneSignal.
- Nuove versioni dell'app con l'SDK PushEngage. Se invii dal dashboard OneSignal dopo la migrazione, tali notifiche non appariranno sulle nuove versioni dell'app, poiché il payload di OneSignal non può essere decodificato dall'SDK PushEngage.
Invia da PushEngage per gli utenti sulla nuova versione dell'app e attenditi che gli utenti che non hanno aggiornato vengano trasferiti man mano che aggiornano l'app.
Domande Frequenti
I miei utenti dell'app devono concedere nuovamente l'autorizzazione alle notifiche?
No. Se l'autorizzazione è già stata concessa nella tua app, viene trasferita e non è necessario concederla di nuovo dopo la migrazione.
Ogni iscritto riceverà le notifiche subito dopo la migrazione?
Gli utenti sulla nuova versione dell'app con l'SDK PushEngage lo riceveranno. Gli utenti ancora su una versione precedente dell'app con l'SDK OneSignal non riceveranno notifiche PushEngage finché non aggiorneranno l'app.
Perché riutilizzo le stesse credenziali APNs e Firebase?
Perché i token del dispositivo sono legati a tali credenziali. Riutilizzare lo stesso ID Push dell'app, certificato p12 e ID mittente Firebase mantiene validi i token esistenti, il che rende possibile la migrazione senza chiedere agli utenti di registrarsi nuovamente.
Quali dati devo esportare da OneSignal?
Un'esportazione API utilizzando il tuo ID App OneSignal e la Chiave API App, oppure un CSV che includa almeno identifier, device_type e language, più altri campi pertinenti.
Se riscontri problemi, non esitare a contattarci cliccando qui. Il nostro team di supporto sarà in grado di aiutarti.
