Hinweis: Für diesen Artikel sind keine älteren Dokumentationen verfügbar, daher sehen Sie die aktuelle Dokumentation.
Sie können Ihre iOS- und Android-App-Push-Abonnenten von OneSignal auf PushEngage verschieben, indem Sie dieselben Apple- und Firebase-Anmeldeinformationen wiederverwenden, die Ihre App bereits verwendet. Da die Gerätezertifikate von Apple und Google und nicht von OneSignal ausgestellt werden, bleiben Ihre Zertifikate nach dem Wechsel weiterhin gültig. Dieses Handbuch erklärt, wie die Migration funktioniert und welche Schritte zur Einrichtung erforderlich sind. Die Migration ist ein Backend-Prozess, der gemeinsam mit unserem Team durchgeführt wird.
Bevor Sie beginnen
- Erstellen Sie ein Konto bei PushEngage.
- Halten Sie Ihre Apple Push-Anmeldeinformationen bereit, insbesondere Ihre App Push ID und das p12-Zertifikat aus Ihrem Apple Developer-Konto, dieselben, die Sie in OneSignal verwendet haben.
- Halten Sie Ihre Android Firebase Sender ID bereit, dieselbe, die Sie in OneSignal verwendet haben.
- Haben Sie Zugriff auf Ihr OneSignal-Konto, um Abonnentendaten zu exportieren.
Wie die App-Migration funktioniert
Gerätezertifikate für App-Push stammen vom Apple Push Notification Service (APNs) und Firebase Cloud Messaging (FCM), nicht von OneSignal. Wenn Sie PushEngage mit denselben APNs- und FCM-Anmeldeinformationen konfigurieren, bleiben Ihre Zertifikate gültig und die Migration erfolgt im Backend. Die Benachrichtigungsberechtigung wird ebenfalls übernommen, sodass ein Benutzer, der die Berechtigung bereits erteilt hat, diese nicht erneut erteilen muss.
Schritte zur Migration
Schritt 1: Exportieren Sie Ihre Abonnenten aus OneSignal
Exportieren Sie Ihre Abonnentendaten mit einer der folgenden Methoden:
- API-Export unter Verwendung Ihrer OneSignal App ID und App API Key.
- CSV-Export mit einer Datei, die
identifier,device_type,languageund alle anderen relevanten Felder enthält.
Schritt 2: Konfigurieren Sie Android FCM in PushEngage
- Melden Sie sich beim PushEngage-Dashboard an.
- Gehen Sie zu Einstellungen » Installation » Android SDK.
- Konfigurieren Sie die Google Android FCM-Einstellungen mit derselben Firebase Sender ID, die Sie in OneSignal verwendet haben.
Schritt 3: Konfigurieren Sie iOS APNs in PushEngage
- Gehen Sie zu Einstellungen » Installation » iOS SDK.
- Konfigurieren Sie die Apple iOS APNs-Einstellungen mit derselben App Push ID aus Ihrer OneSignal-Einrichtung.
- Laden Sie das p12-Zertifikat aus Ihrem Apple Developer-Konto hoch, dasselbe, das Sie in OneSignal verwendet haben.
Wichtige Hinweise zur Umstellung der App-Version
Die Migration von App-Push hängt davon ab, welche Version Ihrer App ein Abonnent verwendet. Planen Sie daher Ihre Release-Umstellung sorgfältig.
- Ältere App-Versionen mit dem OneSignal SDK. Nach der Migration erhalten Abonnenten, die noch ältere App-Versionen verwenden, keine Benachrichtigungen von PushEngage, da die PushEngage-Nutzlast vom OneSignal SDK nicht dekodiert werden kann.
- Neue App-Versionen mit dem PushEngage SDK. Wenn Sie nach der Migration vom OneSignal-Dashboard senden, werden diese Benachrichtigungen auf neuen App-Versionen nicht angezeigt, da die OneSignal-Nutzlast vom PushEngage SDK nicht dekodiert werden kann.
Senden Sie von PushEngage für Benutzer der neuen App-Version und erwarten Sie, dass Benutzer, die nicht aktualisiert haben, beim Upgrade der App wechseln.
Häufig gestellte Fragen
Müssen meine App-Benutzer die Benachrichtigungsberechtigung erneut erteilen?
Nein. Wenn die Berechtigung bereits in Ihrer App erteilt wurde, wird sie übernommen und muss nach der Migration nicht erneut erteilt werden.
Erhält jeder Abonnent direkt nach der Migration Benachrichtigungen?
Nutzer der neuen App-Version mit dem PushEngage SDK werden dies tun. Nutzer, die noch eine ältere App-Version mit dem OneSignal SDK verwenden, erhalten keine PushEngage-Benachrichtigungen, bis sie die App aktualisieren.
Warum verwende ich dieselben APNs- und Firebase-Anmeldeinformationen wieder?
Da Geräte-Token an diese Anmeldeinformationen gebunden sind. Die Wiederverwendung derselben App Push ID, desselben p12-Zertifikats und derselben Firebase Sender ID behält Ihre vorhandenen Token bei, was die Migration ohne erneute Registrierung der Nutzer ermöglicht.
Welche Daten muss ich aus OneSignal exportieren?
Entweder einen API-Export mit Ihrer OneSignal App ID und Ihrem App API Key oder eine CSV-Datei, die mindestens identifier, device_type und language sowie alle anderen relevanten Felder enthält.
Wenn Sie auf Probleme stoßen, können Sie uns gerne kontaktieren, indem Sie hier klicken. Unser Support-Team wird Ihnen helfen können.