# Push-Abonnenten importieren

Wenn Sie von einem anderen Push-Anbieter migrieren, können Sie Ihre bestehende Push-Abonnentenbasis aus einer CSV-Datei in Pushwoosh importieren. Token funktionieren weiterhin, solange die App denselben APNs-Schlüssel, dasselbe Firebase-Projekt oder dieselben HMS-Anmeldeinformationen verwendet. Benutzer müssen die App nicht neu installieren oder die Berechtigung erneut erteilen.

Dieser Import registriert Geräte mit Push-Token. Es wird kein Segment erstellt. Importierte Geräte erhalten ein **CSV-Import**-Tag, mit dem Sie anschließend eines erstellen können. Um stattdessen eine Liste bereits registrierter User IDs oder Hardware IDs in ein Segment zu importieren, siehe [Ein Segment importieren](/de/product/audience-data-and-segmentation/segmentation/create-segments/by-import/).

## Unterstützte Plattformen

Pushwoosh importiert Push-Token nur für die unten aufgeführten Plattformen.

Die Spalte `device_type` akzeptiert zwei verschiedene Formate, je nachdem, woher Ihre Datei stammt:

- Eine Zahl, wenn Ihr Export die plattformeigenen Codes von OneSignal verwendet.
- Ein Wort, wenn es sich um einen Amazon Pinpoint-Export oder eine von Ihnen manuell erstellte Datei handelt.

Mischen Sie die beiden Formate nicht in einer Datei, da dieselbe Zahl in jedem System eine andere Plattform bedeutet. Das Einfügen einer Zahl aus einer Nicht-OneSignal-Quelle kann dazu führen, dass Geräte unbemerkt unter der falschen Plattform importiert werden.

| Plattform | OneSignal `device_type`-Nummer | Akzeptierte Plattformnamen |
| :--- | :--- | :--- |
| iOS | `0` | `ios`, `apns`, `apns_sandbox`, `apns_voip` |
| Android | `1` | `android`, `gcm`, `fcm` |
| Amazon | `2` | `amazon`, `adm`, `fireos` |
| Windows | `6` | `windows`, `wns` |
| macOS | `9` | `macos`, `osx` |
| Huawei (HMS) | `13` | `huawei`, `hms` |

Zeilen mit einem anderen Wert werden übersprungen (siehe [Warum eine Zeile übersprungen wird](#why-a-row-gets-skipped)), einschließlich:

- OneSignals eigene Web-Push-, E-Mail- und SMS-Gerätetypen.
- Plattformen, die Pushwoosh nicht unterstützt, wie das eingestellte Windows Phone oder Baidu Push.

Web-Push-Abonnements können von keinem Anbieter übertragen werden. Diese Benutzer müssen sich über das Pushwoosh SDK auf Ihrer Website erneut anmelden.

## Eine CSV-Datei vorbereiten

Ihre CSV-Datei muss kleiner als 100 MB sein. Benennen Sie die Spalten genau wie unten gezeigt. Die Groß- und Kleinschreibung spielt keine Rolle. Sie können Spalten nicht in der Benutzeroberfläche zuordnen, also benennen Sie alle Kopfzeilen um, die nicht übereinstimmen:

| Kopfzeile | Wird zugeordnet zu |
| :--- | :--- |
| `identifier` | Push-Token (erforderlich) |
| `device_type` | Plattform (erforderlich) |
| `external_id` oder `external_user_id` | User ID |
| `language` | Gerätesprache |
| `tags` | Ein JSON-Objekt mit benutzerdefinierten Tag-Werten |
| `invalid_identifier` | OneSignals Flag für "abgemeldet". Hier markierte Zeilen werden übersprungen |

Eine Zeitzonen-Spalte, falls vorhanden, wird nicht importiert, da ihr Format zwischen den Exportversionen unterschiedlich ist.

### Beispiel-CSV

Hier ist eine `subscribers.csv` mit zwei Geräten, eines verwendet einen Plattformnamen und das andere einen numerischen Code von OneSignal:

| identifier | device_type | external_id | language | tags |
| :--- | :--- | :--- | :--- | :--- |
| `ios-token-0001` | `ios` | `user-1001` | `en` | `{"plan":"pro"}` |
| `android-token-0002` | `1` | `user-1002` | `en` | `{"plan":"free"}` |

Darstellung von `subscribers.csv` im reinen Textformat:

```txt
identifier,device_type,external_id,language,tags
ios-token-0001,ios,user-1001,en,"{""plan"":""pro""}"
android-token-0002,1,user-1002,en,"{""plan"":""free""}"
```

<Aside type="note">
Der `tags`-Wert ist ein JSON-Objekt mit Anführungszeichen darin. Wenn Sie die Datei in Excel oder Google Sheets erstellen, setzen diese Anwendungen die Zelle für Sie in Anführungszeichen. Wenn Sie sie in einem reinen Texteditor bearbeiten, setzen Sie den gesamten Wert in Anführungszeichen und schreiben Sie jedes Anführungszeichen darin als zwei Anführungszeichen (`"` wird zu `""`), wie im obigen Beispiel.
</Aside>

## Wie man importiert

1. Gehen Sie zu **Audience** → **Import CSV** und wählen Sie die Karte **Push-Abonnenten importieren**.

   <img src="/push-notifications-import-push-subscribers-1.webp" alt="Bildschirm 'CSV importieren' mit den Karten 'Tag-Werte aktualisieren', 'Push-Abonnenten importieren' und 'Events importieren'."/>

2. Wählen Sie Ihre CSV-Datei aus.

   <Aside type="caution">
   Pushwoosh prüft die gesamte Datei, sobald Sie sie auswählen. Eine Zeile mit einem nicht geschlossenen Anführungszeichen führt sofort zur Ablehnung der Datei. Eine abweichende Spaltenanzahl wird hier im Gegensatz zu den anderen CSV-Importen toleriert. Eine Toast-Meldung nennt die Zeile und den Grund, zum Beispiel „Row 3: a quote mark isn't closed properly.“ In diesem Fall wird nichts importiert. Korrigieren Sie diese Zeile und wählen Sie die Datei erneut aus.
   </Aside>

   <img src="/push-notifications-import-push-subscribers-malformed-toast.webp" alt="Toast-Meldung mit dem Titel „The file cannot be imported“ und dem Text „Row 3: a quote mark isn't closed properly. Nothing was imported.“"/>

3. Überprüfen Sie die Zusammenfassung:
   - Gesamtanzahl der Zeilen in der Datei und wie viele davon importierbar sind, aufgeschlüsselt nach Plattform.
   - Übersprungene Zeilen, aufgeschlüsselt nach Grund, mit einem Link zum Herunterladen der übersprungenen Zeilen als CSV (Originalspalten plus eine `skip_reason`-Spalte).
   - In der `tags`-Spalte erkannte benutzerdefinierte Tags mit dem von Pushwoosh abgeleiteten Typ (`string`, `integer`, `boolean` oder `date`). Wenn ein Tag-Name bereits in Ihrem Konto mit einem anderen Typ existiert, wird dies als Konflikt markiert. Sie können den Typ ändern oder dieses Tag für diesen Import überspringen.

   <img src="/push-notifications-import-push-subscribers-2.webp" alt="Zusammenfassung des Zuordnungsschritts, die nach Plattform importierte Zeilen und nach Grund übersprungene Zeilen anzeigt."/>

4. Klicken Sie auf **Import starten**.

Wenn der Import abgeschlossen ist, prüfen Sie die Zahlen:

* **Geräte erstellt:** neue Geräte.
* **Geräte aktualisiert:** Geräte, die bereits existierten.
* **Übersprungene Zeilen:** Zeilen, die im Zuordnungsschritt (Schritt 3) ausgelassen wurden, aufgeschlüsselt nach Grund, mit einem Download-Link.

<img src="/push-notifications-import-push-subscribers-3.webp" alt="Bildschirm „Import abgeschlossen“ mit „Geräte erstellt“, „Geräte aktualisiert“ und nach Grund aufgeschlüsselten übersprungenen Zeilen mit einem Download-Link."/>

<Aside type="note">
Ältere Importe zeigen statt **Geräte erstellt** und **Geräte aktualisiert** eine einzelne Anzahl **Geräte importiert**.
</Aside>

<span id="why-a-row-gets-skipped" />

### Warum eine Zeile übersprungen wird

Dies sind die Gründe für das Überspringen, die in der Zuordnungszusammenfassung und in der CSV-Datei der übersprungenen Zeilen angezeigt werden.

| Grund | Ursache |
| :--- | :--- |
| Web-Abonnements | An die Schlüssel eines anderen Anbieters gebunden. Kann nicht übertragen werden |
| Ungültige Token | Bereits von APNs / FCM abgelehnt (OneSignals `invalid_identifier`-Flag) |
| E-Mail-Adressen | Verwenden Sie stattdessen [Kontakte importieren](/de/product/first-steps/start-with-your-project/register-users/import-contacts/) |
| Telefonnummern | Verwenden Sie stattdessen [Kontakte importieren](/de/product/first-steps/start-with-your-project/register-users/import-contacts/) |
| Doppelte Token | Derselbe Push-Token erscheint mehr als einmal in der Datei. Die erste Zeile gewinnt und spätere Zeilen werden übersprungen |
| Nicht unterstützte Plattform | Die Plattform wird von Pushwoosh nicht unterstützt (z. B. Windows Phone, Baidu) |
| Unbekannte Plattform | Der Plattformwert wird überhaupt nicht erkannt |
| Leerer Push-Token | Kein Wert in der Push-Token-Spalte |

## Erneutes Importieren derselben Datei

Pushwoosh generiert die Hardware ID (HWID) jedes importierten Geräts aus seinem Push-Token, und derselbe Token erzeugt immer dieselbe HWID. Wenn Sie also dieselbe Datei erneut importieren, werden diese bestehenden Geräte aktualisiert, anstatt Duplikate zu erstellen. Es ist sicher, einen Import nach der Behebung eines Zuordnungsproblems erneut auszuführen oder die Tag-Werte regelmäßig aus einem neuen Export neu zu synchronisieren.

## Nach dem Import

Importierte Geräte werden mit dem Tag **CSV-Import** versehen, dessen Wert das Datum und die Uhrzeit des Imports ist. Dasselbe Tag wird vom [Segmentimport](/de/product/audience-data-and-segmentation/segmentation/create-segments/by-import/) verwendet. Verwenden Sie es, um ein Segment aus den importierten Geräten zu erstellen oder sie einzeln im [User Explorer](/de/product/audience-data-and-segmentation/user-explorer/) zu finden.