Kontakte importieren

Registrieren Sie Kontakte für E-Mail, SMS, WhatsApp und Viber aus einer einzigen CSV-Datei. Eine Spalte mit Telefonnummern kann einen Kontakt sowohl für SMS als auch für WhatsApp registrieren, sodass Sie keine separate Datei pro Kanal benötigen.

Bereiten Sie Ihre CSV-Datei vor

Dateiformat

Die erste Zeile muss Spaltenüberschriften enthalten, die die Daten in jeder Spalte beschreiben.
Jede nachfolgende Zeile stellt einen einzelnen Kontakt dar, mit Werten, die den Überschriften entsprechen.
Die Werte müssen durch Kommas getrennt sein.
Speichern Sie die Datei in UTF-8-Kodierung, um eine korrekte Zeichenanzeige zu gewährleisten.
Die maximale Dateigröße beträgt 100 MB.

Kontaktspalten

Fügen Sie mindestens eine der folgenden Spalten hinzu, je nachdem, für welche Kanäle Sie Kontakte registrieren möchten:

E-Mail: die E-Mail-Adresse des Empfängers.
Telefonnummer (für SMS, WhatsApp und Viber): im internationalen Format, beginnend mit + und der Landesvorwahl, zum Beispiel +120XXXXX234. Geben Sie die reine Nummer ohne das Präfix whatsapp: oder viber: ein. Pushwoosh fügt das Präfix hinzu, wenn Sie die Spalte diesem Kanal zuordnen.

Ist eine Telefonnummer nicht in einem gültigen internationalen Format, wird sie für diesen Kanal übersprungen. Der Rest der Zeile wird trotzdem importiert.

Optionale Spalten

User ID: eine eindeutige Kennung für den Benutzer (z. B. Name oder E-Mail). Nicht erforderlich, aber empfohlen, damit die Kanäle des Kontakts ein gemeinsames Benutzerprofil anstelle von mehreren haben.
Jede andere Spalte kann einem System-Tag für Segmentierung und Personalisierung zugeordnet werden, zum Beispiel Standort, Geburtstag, Sprache oder Kundentyp.

Beispiel-CSV-Datei

Email,Mobile,User ID,Name,Location
john.smith@email.com,+120XXXXX234,john.smith@email.com,John Smith,New York
jane.smith@email.com,+131XXXXX890,jane.smith@email.com,Jane Smith,Los Angeles

CSV-Datei hochladen und zuordnen

Gehen Sie zu Audience → Import CSV → Import Contacts.
Klicken Sie auf CSV hochladen und wählen Sie Ihre Datei aus. Um sie zu ersetzen, klicken Sie auf Weitere CSV hochladen.

Pushwoosh prüft beim Hochladen die gesamte Datei. Eine Zeile, die nicht geparst werden kann (ihre Spaltenanzahl stimmt nicht mit der Kopfzeile überein oder ein in Anführungszeichen gesetzter Wert ist nicht geschlossen), führt sofort zur Ablehnung der Datei. Eine Toast-Benachrichtigung nennt die Zeile und den Grund, zum Beispiel „Row 42: the number of values does not match the header.“ In diesem Fall wird nichts importiert. Korrigieren Sie diese Zeile und laden Sie die Datei erneut hoch.
Geben Sie einen Segment name für die importierten Kontakte ein.
Wählen Sie unter Contact column in CSV eine Spalte aus und wählen Sie daneben den Channel, den sie registriert (Email, SMS, WhatsApp oder Viber). Klicken Sie auf + Add channel, um eine weitere Spalte zuzuordnen oder dieselbe Spalte einem zusätzlichen Kanal zuzuordnen.
Wählen Sie unter UserId column in CSV die Spalte mit den eindeutigen Benutzerkennungen aus, falls Ihre Datei eine solche enthält.
Um zusätzliche Daten für die Segmentierung einzubeziehen, wählen Sie einen Column Name aus Ihrer CSV-Datei und weisen Sie ihm ein Tag zu. Klicken Sie auf + Add Column, um weitere Attribute zuzuordnen.
Klicken Sie auf Import starten.

Nach dem Import sind die Kontakte für Kampagnen auf den von Ihnen zugeordneten Kanälen verfügbar. Sie erscheinen als neues Segment in der Segmentliste und können auch über den User Explorer aufgerufen werden.

Der Abschlussbildschirm zeigt zwei Zählwerte:

Created: Kanalregistrierungen, die für die App neu sind.
Updated: Kanalregistrierungen, die bereits existierten, auch wenn sich dieselbe Adresse oder Nummer unter einer anderen User ID oder auf einer anderen Geräteplattform erneut registriert.

Beide zählen Kanalregistrierungen, nicht Kontakte oder CSV-Zeilen. Ein Kontakt, der zwei Kanälen zugeordnet ist, zum Beispiel SMS und WhatsApp, erhöht den Wert um 2.

Bei einem aktualisierten Kontakt ändern sich nur die in Schritt 6 zugeordneten Tags. Ihre Werte werden mit den Werten aus der CSV-Datei überschrieben. Andere Tags, die bereits für den Kontakt gesetzt sind, bleiben unverändert.

Während des Imports übersprungene Zeilen

Der Abschlussbildschirm gruppiert übersprungene Zeilen nach Grund:

E-Mail-Adresse ist ungültig
Telefonnummer ist ungültig
Keine Kontaktadresse in der Zeile: jede zugeordnete Spalte war leer

Eine Zeile kann teilweise importiert werden und trotzdem in dieser Aufschlüsselung erscheinen. Zum Beispiel ist die E-Mail-Spalte erfolgreich, aber die Telefonspalte besteht die Validierung nicht.

Klicken Sie auf Download skipped rows, um eine CSV-Datei nur mit diesen Zeilen zu erhalten. Die Datei fügt den Grund für das Überspringen als zusätzliche Spalte hinzu, sodass Sie die Zeilen korrigieren und erneut hochladen können.

Zeilen, die beim Import nicht registriert werden konnten

Einige Zeilen sehen in der Datei korrekt aus, werden aber trotzdem nicht verarbeitet. Zum Beispiel kann eine E-Mail-Adresse korrekt geschrieben sein und dennoch abgelehnt werden, weil sie zu einer Wegwerf- oder Bounced-Domain gehört. Pushwoosh zählt solche Zeilen als Failed, getrennt von Created, Updated oder Skipped.

Fehlgeschlagene Zeilen werden nicht nach Grund aufgeschlüsselt und sind nicht im Download der übersprungenen Zeilen enthalten. Um sie zu finden, vergleichen Sie Ihre ursprüngliche CSV-Datei mit dem importierten Segment. Korrigieren Sie die fehlenden Adressen (entfernen Sie zum Beispiel eine Wegwerf- oder Bounced-Domain) und laden Sie dann nur diese Zeilen in einem neuen Import erneut hoch.