Observera: Det finns ingen äldre dokumentation tillgänglig för det här objektet, så du ser den aktuella dokumentationen.
Du kan flytta dina iOS- och Android-app-push-prenumeranter från OneSignal till PushEngage genom att återanvända samma Apple- och Firebase-uppgifter som din app redan använder. Eftersom enhetstokens utfärdas av Apple och Google snarare än av OneSignal, låter behållandet av dessa uppgifter dina tokens fortsätta fungera efter bytet. Den här guiden förklarar hur migreringen fungerar och stegen för att ställa in den. Migrering är en backend-process som hanteras tillsammans med vårt team.
Innan du börjar
- Skapa ett konto hos PushEngage.
- Ha dina Apple push-uppgifter redo, specifikt ditt App Push ID och p12-certifikatet från ditt Apple Developer-konto, samma som används i OneSignal.
- Ha ditt Android Firebase Sender ID, samma som används i OneSignal.
- Ha tillgång till ditt OneSignal-konto för att exportera prenumerantdata.
Hur appmigrering fungerar
Enhetstokens för app-push kommer från Apple Push Notification service (APNs) och Firebase Cloud Messaging (FCM), inte från OneSignal. Om du konfigurerar PushEngage med samma APNs- och FCM-uppgifter förblir dina tokens giltiga och migreringen sker på backend. Aviseringsbehörighet förs också över, så en användare som redan har gett behörighet behöver inte ge den igen.
Steg för att migrera
Steg 1: Exportera dina prenumeranter från OneSignal
Exportera din prenumerantdata med någon av metoderna:
- API-export, med ditt OneSignal App ID och App API Key.
- CSV-export, med en fil som inkluderar
identifier,device_type,languageoch andra relevanta fält.
Steg 2: Konfigurera Android FCM i PushEngage
- Logga in på PushEngage-instrumentpanelen.
- Gå till Inställningar » Installation » Android SDK.
- Konfigurera Google Android FCM-inställningarna med samma Firebase Sender ID som du använde i OneSignal.
Steg 3: Konfigurera iOS APNs i PushEngage
- Gå till Inställningar » Installation » iOS SDK.
- Konfigurera Apple iOS APNs-inställningarna med samma App Push ID från din OneSignal-konfiguration.
- Ladda upp p12-certifikatet från ditt Apple Developer-konto, samma som du använde i OneSignal.
Viktiga anmärkningar om appversionsbytet
Appspushmigrering beror på vilken version av din app en prenumerant kör, så planera ditt versionsbyte noggrant.
- Äldre appversioner med OneSignal SDK. Efter migrering kommer prenumeranter som fortfarande använder äldre appversioner inte att ta emot aviseringar som skickas från PushEngage, eftersom PushEngage-nyttolasten inte kan avkodas av OneSignal SDK.
- Nya appversioner med PushEngage SDK. Om du skickar från OneSignal-instrumentpanelen efter migrering kommer dessa aviseringar inte att visas i nya appversioner, eftersom OneSignal-nyttolasten inte kan avkodas av PushEngage SDK.
Skicka från PushEngage för användare av den nya appversionen, och förvänta dig att användare som inte har uppdaterat flyttar över när de uppgraderar appen.
Vanliga frågor
Måste mina appanvändare ge aviseringstillstånd igen?
Nej. Om tillstånd redan har getts i din app, förs det över och behöver inte ges igen efter migrering.
Kommer varje prenumerant att få aviseringar direkt efter migrering?
Användare på den nya appversionen med PushEngage SDK kommer att göra det. Användare som fortfarande använder en äldre appversion med OneSignal SDK kommer inte att ta emot PushEngage-notiser förrän de uppdaterar appen.
Varför återanvänder jag samma APNs- och Firebase-uppgifter?
Eftersom enhetstoken är knutna till dessa uppgifter. Återanvändning av samma App Push ID, p12-certifikat och Firebase Sender ID håller dina befintliga token giltiga, vilket är vad som gör migreringen möjlig utan att be användare att registrera sig igen.
Vilken data behöver jag exportera från OneSignal?
Antingen en API-export med ditt OneSignal App ID och App API Key, eller en CSV som inkluderar minst identifier, device_type och language, plus eventuella andra relevanta fält.
Om du stöter på några problem är du välkommen att kontakta oss genom att klicka här. Vårt supportteam kommer att kunna hjälpa dig.