Let op: Er is geen bestaande documentatie beschikbaar voor dit item, dus u ziet de huidige documentatie.
U kunt uw iOS- en Android-app push-abonnees verplaatsen van OneSignal naar PushEngage door dezelfde Apple- en Firebase-referenties te hergebruiken die uw app al gebruikt. Omdat apparaattoekens worden uitgegeven door Apple en Google in plaats van door OneSignal, blijven uw tokens werken na de overstap als u die referenties behoudt. Deze handleiding legt uit hoe de migratie werkt en de stappen om deze in te stellen. Migratie is een backend-proces dat samen met ons team wordt afgehandeld.
Voordat u begint
- Maak een account aan bij PushEngage.
- Houd uw Apple push-referenties gereed, met name uw App Push ID en het p12-certificaat van uw Apple Developer-account, dezelfde die in OneSignal werden gebruikt.
- Houd uw Android Firebase Sender ID gereed, dezelfde die in OneSignal werd gebruikt.
- Heb toegang tot uw OneSignal-account om abonneedgegevens te exporteren.
Hoe App-migratie werkt
Apparaattoekens voor app push komen van Apple Push Notification service (APNs) en Firebase Cloud Messaging (FCM), niet van OneSignal. Als u PushEngage configureert met dezelfde APNs- en FCM-referenties, blijven uw tokens geldig en vindt de migratie plaats op de backend. Apparaattoestemming wordt ook overgedragen, dus een gebruiker die al toestemming heeft verleend, hoeft deze niet opnieuw te verlenen.
Stappen om te migreren
Stap 1: Exporteer uw abonnees uit OneSignal
Exporteer uw abonneedgegevens met een van de volgende methoden:
- API-export, met uw OneSignal App ID en App API Key.
- CSV-export, met een bestand dat
identifier,device_type,languageen andere relevante velden bevat.
Stap 2: Configureer Android FCM in PushEngage
- Log in op het PushEngage-dashboard.
- Ga naar Instellingen » Installatie » Android SDK.
- Configureer de Google Android FCM-instellingen met dezelfde Firebase Sender ID die u in OneSignal gebruikte.
Stap 3: Configureer iOS APNs in PushEngage
- Ga naar Instellingen » Installatie » iOS SDK.
- Configureer de Apple iOS APNs-instellingen met dezelfde App Push ID van uw OneSignal-installatie.
- Upload het p12-certificaat van uw Apple Developer-account, hetzelfde dat u in OneSignal gebruikte.
[Screenshot: de Android SDK- en iOS SDK-configuratie onder Instellingen » Installatie.]
Belangrijke opmerkingen over de overgang van app-versies
App-pushmigratie is afhankelijk van de versie van uw app waarop een abonnee actief is, dus plan uw release-overgang zorgvuldig.
- Oudere app-versies met de OneSignal SDK. Na migratie ontvangen abonnees die nog steeds oudere app-versies gebruiken geen meldingen die vanuit PushEngage worden verzonden, omdat de PushEngage-payload niet kan worden gedecodeerd door de OneSignal SDK.
- Nieuwe app-versies met de PushEngage SDK. Als u na migratie vanuit het OneSignal-dashboard verzendt, verschijnen die meldingen niet op nieuwe app-versies, omdat de OneSignal-payload niet kan worden gedecodeerd door de PushEngage SDK.
Verzend vanuit PushEngage voor gebruikers van de nieuwe app-versie, en verwacht dat gebruikers die niet hebben bijgewerkt zullen overstappen naarmate ze de app upgraden.
Veelgestelde vragen
Moeten mijn app-gebruikers opnieuw toestemming voor meldingen geven?
Nee. Als toestemming al was verleend in uw app, wordt deze overgedragen en hoeft deze na migratie niet opnieuw te worden verleend.
Ontvangt elke abonnee direct na de migratie meldingen?
Gebruikers op de nieuwe appversie met de PushEngage SDK zullen dit wel ontvangen. Gebruikers die nog op een oudere appversie met de OneSignal SDK zitten, ontvangen geen PushEngage-meldingen totdat ze de app updaten.
Waarom hergebruik ik dezelfde APNs- en Firebase-referenties?
Omdat apparaat-tokens gekoppeld zijn aan die referenties. Het hergebruiken van dezelfde App Push ID, p12-certificaat en Firebase Sender ID houdt uw bestaande tokens geldig, waardoor de migratie mogelijk is zonder dat gebruikers zich opnieuw hoeven te registreren.
Welke gegevens moet ik exporteren uit OneSignal?
Ofwel een API-export met uw OneSignal App ID en App API Key, ofwel een CSV met minimaal identifier, device_type en language, plus alle andere relevante velden.
Als u problemen ondervindt, neem dan gerust contact met ons op door hier te klikken. Ons ondersteuningsteam zal u kunnen helpen.
