Migration von OneSignal zu Pushwoosh

OneSignal deckelt seinen Free-Plan hart. In Kürze sind mobile Push-Benachrichtigungen und In-App-Nachrichten oberhalb von 1.000 monatlich aktiven Nutzern (MAU) nicht mehr kostenlos. Neue Accounts trifft es ab dem 1. September 2026, Bestandskonten ab dem 1. Oktober. Hat Ihre App mehr als tausend aktive Nutzer im Monat, haben Sie jetzt drei Optionen: bleiben und zahlen, die Zielgruppe verkleinern, oder wechseln.

Was sich ändert und wann

Source: OneSignal

• Der Free-Plan funktioniert weiterhin unterhalb von 1.000 MAU. Darüber wechseln mobile Push-Benachrichtigungen und In-App-Nachrichten in einen kostenpflichtigen Tarif.
• Die Termine: Das Limit gilt für neue Accounts ab dem 1. September 2026 und für Bestandskonten ab dem 1. Oktober 2026, laut OneSignals Billing-FAQ.
• Die Schwelle: Weniger als 1.000 MAU für mobilen Push und In-App bleibt alles wie gehabt. Wird die Schwelle überschritten, stoppen diese Kanäle den Versand, bis ein Upgrade erfolgt.
• Was unverändert bleibt: Web-Push, E-Mail und SMS funktionieren weiterhin innerhalb derselben Plan-Grenzen wie bisher. Die Änderung betrifft ausschließlich Mobile.
• Auch Journeys sind betroffen: Jeder Journey-Schritt, der eine Push-Benachrichtigung oder eine In-App-Nachricht versendet, überspringt mobile Abonnements einfach.
• Abonnenten zu löschen ist kein Ausweg. Löschen Sie mobile Abonnements, die in den letzten 30 Tagen aktiv waren, kann Ihr Plan erst 30 Tage nach der Löschung wieder aktiviert werden — und nur, wenn Sie während dieser gesamten Zeit unter der Grenze bleiben.

So funktioniert die Migration

Haben Sie sich für den Wechsel entschieden, ändert das Folgende Ihre Planung grundlegend: Wir führen die Migration für Sie durch. Ihr Anteil an der Arbeit besteht aus drei Punkten: einer Exportdatei, Ihren Push-Credentials und dem Austausch des SDKs im nächsten App-Release. Alles andere — Daten bereinigen, Plattformen zuordnen, Tags neu anlegen, die Zielgruppe importieren, die Zustellbarkeit verifizieren — übernehmen wir.

Der Wechsel läuft auf zwei Schienen gleichzeitig. Ein einmaliger Import überträgt Ihre bestehende Basis, sodass Ihre Zielgruppe ab Tag eins erreichbar bleibt, noch bevor ein einziger Nutzer die App aktualisiert hat. Das SDK übernimmt anschließend jedes Gerät, sobald dessen Besitzer den neuen Build installiert. Sie brauchen beides, und keins blockiert das andere.

1. Was wir migrieren können und was nicht

Diese Prüfung müssen Sie nicht selbst vornehmen. Hier ist das vollständige Bild im Voraus, damit Sie mitten in der Migration nichts überrascht.

Wie lange es dauert

Der SDK-Austausch und ein sauberer Test-Versand sind für einen Entwickler ein Tagewerk. Der Import läuft parallel auf unserer Seite und ist genau das, was Ihre Reichweite von Tag eins an intakt hält: importierte Geräte sind zustellbar, bevor irgendjemand die App aktualisiert. Die eigentliche Zielgruppe Ihrer App wechselt dann im Tempo, in dem Ihre Nutzer den neuen Build installieren, auf das Pushwoosh SDK — das dauert Wochen und erreicht nie restlos jedes Gerät. Genau deshalb gibt es den Import.

Die Reihenfolge ist wichtig:

1. Exportieren Sie Ihre Zielgruppe. Schicken Sie uns Ihre OneSignal app_id und einen App-API-Key, dann ziehen wir den Export selbst, oder exportieren Sie die CSV selbst. Details weiter unten.
2. Schicken Sie uns Ihre Push-Credentials. Dieselben Schlüssel, mit denen OneSignal bereits versendet. Wir laden sie vor dem Import hoch, damit jedes importierte Gerät zustellbar ist.
3. Tauschen Sie das SDK aus. Entfernen Sie das OneSignal SDK, fügen Sie das Pushwoosh SDK hinzu und initialisieren Sie es mit Ihrem Pushwoosh Application Code und Device API Token. Die plattformspezifischen Schritte stehen in den Versionen A bis C.
4. Verifizieren Sie die Zustellung. Registrieren Sie ein Testgerät und schicken Sie sich selbst eine Push-Benachrichtigung, bevor Sie den Produktivtraffic anfassen.
5. Prüfen Sie das Tag-Sheet. Wir erstellen es aus Ihrem Export; Sie streichen tote Tags und markieren Multi-Value-Tags. Wir importieren und bauen Ihre Segmente neu auf.
6. Stellen Sie den Versand um. Sobald der Testversand sauber läuft und der Import bestätigt ist, richten Sie Ihre Kampagnen auf Pushwoosh aus und stoppen den Versand aus OneSignal.

2. Exportieren Sie Ihre Zielgruppe

Option A (empfohlen): Wir übernehmen es für Sie. Schicken Sie uns Ihre OneSignal app_id und einen App-API-Key, dann ziehen wir den Export selbst. Ihr Anteil endet hier.

Option B: Sie machen es selbst. Gehen Sie in OneSignal zu Audience > Subscriptions und exportieren Sie die CSV, oder rufen Sie den Export-Endpoint auf:

curl -X POST 'https://api.onesignal.com/players/csv_export?app_id=YOUR_APP_ID' \
  -H 'Authorization: Key YOUR_APP_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"extra_fields":["external_user_id","timezone_id","notification_types"]}'

Die Antwort liefert csv_file_url, eine gzip-komprimierte CSV, die drei Tage lang herunterladbar bleibt.

Source: OneSignal

Diese Spalten müssen in der Datei enthalten sein. Alles andere ist optional, wir ignorieren es.

Hinweis: external_user_id und timezone_id sind nicht Teil des Standard-Exports. Fordern Sie sie explizit über den oben gezeigten extra_fields-Parameter an, oder über den Column Picker im Dashboard.

3. Schicken Sie uns Ihre Push-Credentials

Das sind dieselben Credentials, mit denen OneSignal bereits in Ihrem Namen versendet — es muss also nichts Neues angelegt werden. Wir können sie nicht selbst aus OneSignal ziehen: Ein hochgeladener Schlüssel ist danach nie wieder herunterladbar, deshalb liegt dieser Schritt bei Ihnen.

Wir laden die Credentials vor Beginn des Imports in Ihre Pushwoosh-Anwendung hoch. Diese Reihenfolge ist wichtig: Ein Import ohne Credentials erzeugt eine Datenbank voller Geräte, an die nichts zugestellt werden kann.

4. Prüfen Sie Ihre Tags und Segmente

Source: OneSignal

Tags werden migriert, und Sie müssen sie nicht selbst inventarisieren. In OneSignal ist ein Tag ein reiner Key/Value-String ohne deklarierten Typ. In Pushwoosh wird jeder Tag einmal pro Anwendung mit einem Typ deklariert (String, Integer, Boolean, Date, List oder Price) und erst dann mit Werten befüllt.

Sobald wir Ihren Export haben, schicken wir Ihnen ein Tag-Review-Sheet, das direkt aus der Datei erstellt wird. Es listet jeden gefundenen Tag mit den Daten dazu auf: Beispielwerte, wie viele Geräte einen Wert tragen, und den von uns vorgeschlagenen Typ. Ihr Anteil sind zwei Spalten: Tags streichen, die Sie nicht mehr nutzen, und solche markieren, die mehrere Werte gleichzeitig halten können. Alles andere ist ein Vorschlag, den Sie unverändert übernehmen können.

Warum wir nachfragen, statt zu raten: Der Typ eines Tags ist nach der Erstellung fest, ein Multi-Value-Tag, das wir als reinen String anlegen, muss also gelöscht und neu importiert werden. Ein Tag, das im Export einwertig aussieht, ist genau der Fall, den wir aus den Daten nicht erkennen können. Bekommen wir keine Antwort, importieren wir jeden Tag mit dem von uns abgeleiteten Typ und sagen Ihnen, wo wir geraten haben.

Segmente werden neu aufgebaut. OneSignals API kann einen Export nach Segment filtern und Ihre Segmentnamen auflisten, liefert aber nicht die dahinterliegenden Filter — es gibt also nichts zu importieren. Zwei Wege stehen offen:

1. Bedingungen neu aufbauen (empfohlen). Schicken Sie uns Ihre Segmentliste mit den jeweiligen Filtern; Screenshots reichen. Wir bauen sie über den importierten Tags neu auf. Neu aufgebaute Segmente sind dynamisch: Sie aktualisieren sich weiter, wenn sich Ihre Zielgruppe ändert.
2. Mitgliedschaft einfrieren. Wir nehmen einen Export pro Segment und versehen jede Datei mit einem Marker-Tag, zum Beispiel os_segment = vip_users. Schnell, aber das Ergebnis ist eine Momentaufnahme, die sich nicht selbst aktualisiert.

Segmente, die auf OneSignals eigenen Verhaltensdaten basieren (Session-Zahlen, Spielzeit, „Active Users”, „Engaged Users”), können beim Import nicht reproduziert werden, weil diese Historie in OneSignal verbleibt. Ihre Pushwoosh-Entsprechungen füllen sich, sobald unser SDK in Ihrer App ausgeliefert wird.

5. Was wir auf unserer Seite erledigen

1. Ihre Pushwoosh-Anwendung anlegen und konfigurieren und die Credentials aus Schritt 3 hochladen.
2. Den Export bereinigen: abgemeldete Zeilen und Zeilen mit leerem Token entfernen, OneSignal-Plattformcodes auf unsere abbilden, Tags konvertieren und Ihre external_user_id auf unsere User ID abbilden.
3. Das Tag-Schema anlegen, dann die Zielgruppe in Batches importieren und jeden Batch verifizieren.
4. Einen Test-Push an eine kleine Kontrollgruppe senden und das Ergebnis mit der Erwartung abgleichen.
5. Zurückmelden: wie viele Abonnements in der Datei waren, wie viele importiert wurden, und den Grund für jede übersprungene Zeile.

6. Liefern Sie das Pushwoosh SDK mit Ihrem nächsten App-Release aus

Der Import macht Ihre bestehende Zielgruppe sofort erreichbar, ist aber eine Brücke, nicht das Ziel. Nur das Pushwoosh SDK in Ihrer App kann einen neuen Token übernehmen, wenn das Betriebssystem ihn rotiert (Neuinstallation, Wiederherstellung, OS-Upgrade), Nutzer registrieren, die nach der Migration installieren, und Opens, In-App-Nachrichten und Deinstallationen melden.

Entfernen Sie das OneSignal SDK im selben Release. Zwei Push-SDKs in einem Build konkurrieren um dieselben Notification-Callbacks, und wir testen diese Kombination nicht. Dass OneSignal während des Rollouts des neuen Builds weiter versendet, ist völlig in Ordnung und zu erwarten; dass beide SDKs innerhalb eines Builds laufen, ist es nicht. Die plattformspezifischen Schritte stehen unten in den Versionen A bis C.

7. Web-Push: Wie Ihre Abonnenten zurückkommen

Web-Push lässt sich nicht importieren, und das ist eine harte technische Grenze, keine Entscheidung von Pushwoosh. Ein Web-Push-Abonnement wird mit dem VAPID-Schlüsselpaar dessen signiert, der es erstellt hat, und OneSignals privater Schlüssel verlässt OneSignal nie — die eigene Dokumentation weist die Web-Subscription-Keys als ausschließlich für OneSignal-SDKs verfügbar aus. Kein Anbieter kann die Web-Abonnements eines anderen Anbieters importieren. Was stattdessen funktioniert, ist die stille Re-Subscription:

1. Entfernen Sie das OneSignal-Snippet und deregistrieren Sie dessen Service Worker explizit. Lassen Sie den alten Worker stehen, konkurrieren zwei Worker auf derselben Domain.
2. Installieren Sie das Pushwoosh Web Push SDK mit unserem Service Worker im Root Ihrer Domain.
3. Initialisieren Sie es mit Ihrem Application Code und Ihrem Device API Token (apiToken), und aktivieren Sie dann die automatische Subscription (autoSubscribe: true, oder rufen Sie Pushwoosh.subscribe() auf). Ohne den Token kommen die Aufrufe des SDKs als 401 zurück.

Ein wiederkehrender Besucher wird dann still erneut abonniert. Die Notification-Berechtigung, die der Browser speichert, gehört Ihrer Domain, nicht Ihrem vorherigen Anbieter — es erscheint also kein zweiter Prompt, und der Nutzer bemerkt nichts. Wie schnell sich Ihre Basis erholt, hängt davon ab, wie schnell die Nutzer zurückkehren: Der Großteil der Zielgruppe kommt typischerweise innerhalb einer Woche zurück, mit einem Ausläufer über den folgenden Monat.

Drei Fälle, auf die Sie achten sollten:

• Besucher, die Benachrichtigungen blockiert haben, können nicht erneut abonniert werden. Der Browser verweigert das und fragt sie nicht erneut. Sie bleiben draußen, was das korrekte Ergebnis ist.
• Besucher, die sich auf Ihrer Seite abgemeldet haben, während die Browser-Berechtigung bestehen blieb, würden still erneut abonniert. Technisch korrekt, bringt aber Nutzer zurück, die bewusst gegangen sind. Haben Sie eine Suppression-Liste (nach eigener User-ID oder E-Mail), schicken Sie sie uns, und wir schließen diese Nutzer aus jeder Kampagne aus. Falls nicht, empfehlen wir, die Subscription über einen expliziten Klick (eine Glocke oder einen Prompt) statt automatisch auszulösen.
• Lief Ihr Web-Push auf einer von Ihrem vorherigen Anbieter bereitgestellten Subdomain statt auf Ihrer eigenen Domain, gehört die Berechtigung dieser Subdomain. Diese Abonnenten können nicht zurückgewonnen werden und müssen sich auf Ihrer Seite erneut anmelden. Prüfen Sie, welches Setup Sie haben, bevor Sie den Wechsel planen.

8. Was Sie nach dem Import erwarten können

• Ein Gerät kann eine Weile doppelt erscheinen. Der importierte Datensatz trägt den OneSignal-Identifier; sobald unser SDK auf demselben Gerät läuft, registriert es sich mit seinem eigenen Identifier. Der veraltete Datensatz wird durch Uninstall-Tracking oder die automatische 90-Tage-Inaktivitätsbereinigung entfernt. Die Angabe von external_user_id hält in der Zwischenzeit beide Datensätze unter einem Nutzerprofil zusammen.
• Tote Tokens verschwinden bei Ihrer ersten Kampagne. Apple und Google zeigen erst beim tatsächlichen Versand, dass ein Token ungültig ist — der erste Versand nach der Migration bereinigt also gleichzeitig Ihre Basis.
• Ihre importierte Zahl liegt niedriger als Ihr OneSignal-Zähler. Abgemeldete Zeilen, Zeilen mit leerem Token und Web-Push-Zeilen sind bewusst ausgeschlossen. Unser Bericht zeigt Ihnen genau, wie viele in welche Gruppe fielen.

9. Wo Sie klicken müssen

Exakte Pfade für die Aufgaben auf Ihrer Seite, damit niemand Dashboards durchsuchen muss.

Checkliste vor dem 1. Oktober

Halten Sie diese Liste während der Migration offen. Nichts davon erfordert ein Formular zum Herunterladen.

Version A: natives iOS und Android

iOS. Fügen Sie das Pushwoosh iOS SDK hinzu und setzen Sie dann zwei Keys in Info.plist: Pushwoosh_APPID mit Ihrem Pushwoosh Application Code und PW_API_TOKEN mit Ihrem Device API Token. Rufen Sie registerForPushNotifications() dort auf, wo Sie aktuell den OneSignal-Prompt auslösen, und folgen Sie dem iOS Quick Start für das genaue Initialisierungs-Snippet Ihrer SDK-Version. Entfernen Sie das OneSignal SDK und dessen Registrierungsaufruf, damit nicht beide Tokens anfordern.

Android. Fügen Sie die com.pushwoosh:pushwoosh-firebase-Dependency hinzu und ergänzen Sie zwei Meta-Data-Einträge innerhalb des <application>-Tags in AndroidManifest.xml: com.pushwoosh.appid mit Ihrem Application Code und com.pushwoosh.apitoken mit Ihrem Device API Token. Rufen Sie Pushwoosh.getInstance().registerForPushNotifications() in Ihrer Initialisierungslogik auf. Ihre Firebase-Konfiguration bleibt unverändert, mit google-services.json im Projekt; die FCM-Credentials gehören ins Control Panel unter Ihrer Android-Plattformkonfiguration.

Setzen Sie Ihre Tags mit setTags() und Ihren User-Identifier mit setUserId() an denselben Stellen, an denen Sie zuvor die OneSignal-Entsprechungen aufgerufen haben, damit die Segmentierung nach dem Austausch weiterfunktioniert.

Version B: Flutter und FlutterFlow

FlutterFlow kapselt das Pushwoosh Flutter SDK, die Migration ist deshalb überwiegend Konfiguration statt Code.

1. Fügen Sie das Pushwoosh Flutter Package als Custom Dependency in Ihrem Projekt hinzu.
2. Initialisieren Sie das SDK in einer Custom Action mit Ihrem Application Code und registrieren Sie für Push-Benachrichtigungen, gemäß dem Flutter Quick Start für die aktuelle Initialisierungs-API.
3. Setzen Sie die nativen Credentials wie in jeder Flutter-App: Pushwoosh_APPID und PW_API_TOKEN in Info.plist für iOS, com.pushwoosh.appid und com.pushwoosh.apitoken in AndroidManifest.xml für Android.
4. Entfernen Sie die OneSignal-Integration, damit nicht beide SDKs gleichzeitig registrieren.
5. Bilden Sie Tags und User-ID mit setTags() und setUserId() in Ihren Custom Actions ab.

Version C: React Native

1. Installieren Sie das Plugin: npm install pushwoosh-react-native-plugin --save, dann pod install für iOS.
2. Initialisieren und registrieren Sie in Ihrer Root-Komponente:

import Pushwoosh from 'pushwoosh-react-native-plugin';

Pushwoosh.init({ pw_appid: "YOUR_APPLICATION_CODE" });
Pushwoosh.register();

3. Fügen Sie den Device API Token nativ hinzu: PW_API_TOKEN in Info.plist für iOS, com.pushwoosh.apitoken als Meta-Data in AndroidManifest.xml für Android. Behalten Sie unter Android google-services.json im Projekt — die FCM-Credentials selbst liegen im Control Panel.
4. Entfernen Sie das OneSignal React-Native-Package und dessen Init-Aufruf.
5. Übertragen Sie Ihre Tags und User-ID mit setTags() und setUserId() aus der Plugin-API.

FAQ

Fragen zu jedem Zeitpunkt gehen an Ihren Onboarding-Kontakt bei Pushwoosh. Wir beantworten lieber vorab, als hinterher Zahlen abzugleichen.