CSV-Import

Erfahren Sie, wie Sie Nutzerattribute und angepasste Events mithilfe des CSV-Imports erfassen und aktualisieren können.

Über den CSV-Import

Sie können den CSV-Import verwenden, um die folgenden Nutzerattribute und angepassten Events zu erfassen und zu aktualisieren. Braze akzeptiert diese Daten als Standard-CSV-Dateien innerhalb der in der folgenden Tabelle angegebenen maximalen Dateigrößen.

CSV-Import verwenden

1. Schritt: CSV-Template herunterladen

Um den CSV-Import zu öffnen, gehen Sie zu Audiences > Import Users. Dort finden Sie eine Tabelle mit Details zu den letzten Importen, wie z. B. das Upload-Datum, den Namen der hochladenden Person, den Dateinamen, die Targeting-Verfügbarkeit, die Anzahl der importierten Zeilen und den Status des Imports.

Um zu beginnen, wählen Sie Attributes oder Events und laden Sie dann das entsprechende Template herunter, das Ihnen beim Erstellen Ihrer CSV-Datei für den Upload hilft.

2. Schritt: Bezeichner auswählen

Die CSV-Datei, die Sie importieren, benötigt einen dedizierten Bezeichner. Wählen Sie einen der folgenden Bezeichnertypen für Ihren Import:

• externe id
• nutzer-alias
• braze-id
• e-mail-adresse und telefonnummern

Beim Import Ihrer Kundendaten können Sie eine external_id als eindeutigen Bezeichner für jede:n Kund:in verwenden. Wenn Sie in Ihrem Import eine external_id angeben, aktualisiert Braze alle bestehenden Nutzer:innen mit derselben external_id oder erstellt eine:n neu identifizierte:n Nutzer:in mit dieser external_id, falls keine Übereinstimmung gefunden wird.

• Download: CSV-Attribut-Import-Template: Externe ID
• Download: CSV-Event-Import-Template: Externe ID

Hinweis

Wenn Sie eine Mischung aus Nutzer:innen mit einer external_id und Nutzer:innen ohne hochladen, müssen Sie für jeden Import eine separate CSV-Datei erstellen. Eine CSV-Datei kann nicht gleichzeitig external_ids und Nutzer-Aliase enthalten.

Um Nutzer:innen anzusprechen, die keine external_id haben, können Sie eine Liste von Nutzer:innen mit Nutzer-Aliasen importieren. Ein Alias dient als alternativer eindeutiger Nutzerbezeichner und kann hilfreich sein, wenn Sie versuchen, anonyme Nutzer:innen anzusprechen, die sich noch nicht registriert oder ein Konto in Ihrer App erstellt haben.

Wenn Sie Nutzerprofile hochladen oder aktualisieren, die nur einen Alias haben, müssen die folgenden zwei Spalten in Ihrer CSV-Datei vorhanden sein:

• user_alias_name: Ein eindeutiger Nutzerbezeichner; eine Alternative zur external_id
• user_alias_label: Ein gemeinsames Label, um Nutzer-Aliase zu gruppieren

user_alias_name	user_alias_label	last_name	email	sample_attribute
182736485	my_alt_identifier	Smith	[email protected]	TRUE
182736486	my_alt_identifier	Nguyen	[email protected]	FALSE

Wenn Sie sowohl einen user_alias_name als auch ein user_alias_label in Ihrem Import angeben, aktualisiert Braze alle bestehenden Nutzer:innen mit demselben user_alias_name und user_alias_label. Wenn keine Übereinstimmung gefunden wird, erstellt Braze eine:n neu identifizierte:n Nutzer:in mit diesem user_alias_name.

Wichtig

Sie können keinen CSV-Import verwenden, um bestehende Nutzer:innen mit einem user_alias_name zu aktualisieren, wenn diese bereits eine external_id haben. Stattdessen wird ein neues Nutzerprofil mit dem zugehörigen user_alias_name erstellt. Um eine:n Nutzer:in, die/der nur einen Alias hat, mit einer external_id zu verknüpfen, verwenden Sie den Endpunkt „Nutzer:innen identifizieren“.

Download: CSV-Attribut-Import-Template: Nutzer-Alias

Um bestehende Nutzerprofile in Braze mithilfe eines internen Braze-ID-Werts anstelle einer external_id oder eines user_alias_name- und user_alias_label-Werts zu aktualisieren, geben Sie braze_id als Spaltenüberschrift an.

Dies kann hilfreich sein, wenn Sie Nutzerdaten über unsere CSV-Exportoption innerhalb der Segmentierung aus Braze exportiert haben und diesen bestehenden Nutzer:innen ein neues angepasstes Attribut hinzufügen möchten.

Wichtig

Sie können keinen CSV-Import verwenden, um neue Nutzer:innen mit einer braze_id zu erstellen. Diese Methode kann nur verwendet werden, um bereits bestehende Nutzer:innen innerhalb der Braze-Plattform zu aktualisieren.

Tipp

Der braze_id-Wert kann in CSV-Exporten aus dem Braze-Dashboard als Appboy ID bezeichnet sein. Diese ID ist identisch mit der braze_id einer/eines Nutzers/Nutzerin, sodass Sie diese Spalte beim erneuten Import der CSV-Datei in braze_id umbenennen können.

Sie können auf eine externe ID oder einen Nutzer-Alias verzichten und stattdessen entweder eine E-Mail-Adresse oder eine Telefonnummer verwenden, um Nutzer:innen zu importieren. Bevor Sie eine CSV-Datei mit E-Mail-Adressen oder Telefonnummern importieren, prüfen Sie Folgendes:

• Stellen Sie sicher, dass in Ihrer CSV-Datei keine externen IDs oder Nutzer-Aliase für diese Profile vorhanden sind. Falls doch, priorisiert Braze die externe ID oder den Nutzer-Alias vor der E-Mail-Adresse zur Identifizierung von Profilen.
• Bestätigen Sie, dass Ihre CSV-Datei korrekt formatiert ist.

Hinweis

Wenn Sie sowohl E-Mail-Adressen als auch Telefonnummern in Ihrer CSV-Datei angeben, wird die E-Mail-Adresse bei der Profilsuche gegenüber der Telefonnummer priorisiert.

Wenn ein bestehendes Profil diese E-Mail-Adresse oder Telefonnummer hat, wird dieses Profil aktualisiert, und Braze erstellt kein neues Profil. Wenn es mehrere Profile mit derselben E-Mail-Adresse gibt, verwendet Braze dieselbe Logik wie der /users/track-Endpunkt, wobei das zuletzt aktualisierte Profil aktualisiert wird.

Wenn kein Profil mit dieser E-Mail-Adresse oder Telefonnummer existiert, erstellt Braze ein neues Profil mit diesem Bezeichner. Sie können den /users/identify-Endpunkt verwenden, um dieses Profil später zu identifizieren. Um ein Nutzerprofil zu löschen, können Sie auch den /users/delete-Endpunkt verwenden.

3. Schritt: CSV-Datei erstellen

Sie können einen der folgenden Datentypen als einzelne CSV-Datei hochladen. Um mehr als einen Datentyp hochzuladen, laden Sie mehrere CSV-Dateien hoch.

• Nutzerattribute: Dies umfasst sowohl Standard- als auch angepasste Nutzerattribute. Standardattribute sind reservierte Schlüssel in Braze (wie first_name oder email), und angepasste Attribute sind Nutzerattribute, die für Ihr Unternehmen spezifisch sind (wie last_destination_searched).
• Angepasste Events: Diese sind für Ihr Unternehmen spezifisch und spiegeln Aktionen wider, die Nutzer:innen durchgeführt haben, wie z. B. trip_booked für eine Reisebuchungs-App.

Wenn Sie bereit sind, Ihre CSV-Datei zu erstellen, beachten Sie die folgenden Informationen:

• nutzerattribute
• angepasste events

Erforderliche Bezeichner

Obwohl external_id nicht erforderlich ist, muss Ihre CSV-Datei einen Nutzerbezeichner enthalten, der einem der folgenden Bezeichner zugeordnet werden kann. Details zu jedem einzelnen finden Sie unter Bezeichner auswählen.

• external_id
• braze_id
• user_alias_name und user_alias_label
• email
• phone

Angepasste Attribute

Die folgenden Datentypen können als angepasste Attribute für den CSV-Import verwendet werden. Spaltenüberschriften, die nicht exakt einem Standardattribut entsprechen, werden als angepasste Attribute in Braze importiert, sofern sie nicht während des Zuordnungsschritts geändert werden.

Datentyp	Beschreibung
Datetime	Muss im ISO-8601-Format gespeichert werden.
Boolescher Wert	Akzeptiert true oder false.
Zahl	Muss eine Ganzzahl oder Gleitkommazahl ohne Leerzeichen oder Kommas sein. Gleitkommazahlen müssen einen Punkt (.) als Dezimaltrennzeichen verwenden.
String	Kann Kommas enthalten, wenn der Wert in doppelte Anführungszeichen ("") eingeschlossen ist.
Leer	Leere Werte überschreiben keine bestehenden Werte im Nutzerprofil, und Sie müssen nicht alle bestehenden Nutzerattribute in Ihrer CSV-Datei angeben.

Wichtig

Arrays, Push-Token und angepasste Event-Datentypen werden beim Nutzerimport nicht unterstützt, da Kommas in Ihrer CSV-Datei als Spaltentrennzeichen interpretiert werden und beim Parsen Ihrer Datei Fehler verursachen.

Um diese Art von Werten hochzuladen, verwenden Sie stattdessen den /users/track-Endpunkt oder die Cloud-Datenaufnahme.

Standardattribute

Wichtig

Beim Import von Standardattributen müssen die verwendeten Spaltenüberschriften exakt der Schreibweise und Groß-/Kleinschreibung der Standard-Nutzerattribute entsprechen. Andernfalls erkennt Braze diese als angepasste Attribute.

Tipp

Die vollständige Liste der von Braze erkannten Standardattribute (über SDK, API, CSV und Cloud-Datenaufnahme) finden Sie unter Standardattribute. Die folgende Tabelle enthält nur die Teilmenge, die über den CSV-Import festgelegt werden kann.

Die folgenden Standardattribute stehen für den Nutzerimport zur Verfügung.

Nutzerprofilfeld	Datentyp	Beschreibung	Erforderlich?
external_id	String	Ein eindeutiger Nutzerbezeichner für Ihre Kund:innen.	Bedingt. Siehe Erforderliche Bezeichner.
user_alias_name	String	Ein eindeutiger Nutzerbezeichner für anonyme Nutzer:innen als Alternative zur external_id. Muss zusammen mit user_alias_label verwendet werden.	Bedingt. Siehe Erforderliche Bezeichner.
user_alias_label	String	Ein gemeinsames Label, um Nutzer-Aliase zu gruppieren. Muss zusammen mit user_alias_name verwendet werden.	Bedingt. Siehe Erforderliche Bezeichner.
first_name	String	Der Vorname Ihrer Nutzer:innen, wie von ihnen angegeben (z. B. Jane).	Nein
last_name	String	Der Nachname Ihrer Nutzer:innen, wie von ihnen angegeben (z. B. Doe).	Nein
email	String	Die E-Mail-Adresse Ihrer Nutzer:innen, wie von ihnen angegeben (z. B. [email protected]).	Nein
country	String	Ländercodes müssen im ISO-3166-1-Alpha-2-Standard an Braze übergeben werden (z. B. GB).	Nein
dob	String	Muss im Format „YYYY-MM-DD“ übergeben werden (z. B. 1980-12-21). Damit wird das Geburtsdatum Ihrer Nutzer:innen importiert und Sie können Nutzer:innen ansprechen, deren Geburtstag „heute“ ist.	Nein
gender	String	„M“, „F“, „O“ (andere), „N“ (nicht zutreffend), „P“ (möchte nicht angeben) oder nil (unbekannt).	Nein
home_city	String	Der Wohnort Ihrer Nutzer:innen, wie von ihnen angegeben (z. B. London).	Nein
language	String	Die Sprache muss im ISO-639-1-Standard an Braze übergeben werden (z. B. en). Weitere Informationen finden Sie in unserer Liste der akzeptierten Sprachen.	Nein
phone	String	Eine Telefonnummer, wie von Ihren Nutzer:innen angegeben, im E.164-Format (z. B. +442071838750). Formatierungshinweise finden Sie unter Nutzer-Telefonnummern.	Nein
email_open_tracking_disabled	Boolescher Wert	Akzeptiert true oder false. Setzen Sie den Wert auf true, um zu verhindern, dass das Öffnungs-Tracking-Pixel zu allen zukünftigen E-Mails an diese:n Nutzer:in hinzugefügt wird. Nur für SparkPost und SendGrid verfügbar.	Nein
email_click_tracking_disabled	Boolescher Wert	Akzeptiert true oder false. Setzen Sie den Wert auf true, um das Klick-Tracking für alle Links in zukünftigen E-Mails an diese:n Nutzer:in zu deaktivieren. Nur für SparkPost und SendGrid verfügbar.	Nein
email_subscribe	String	Verfügbare Werte sind opted_in (explizit für den Empfang von E-Mail-Nachrichten registriert), unsubscribed (explizit vom Empfang von E-Mail-Nachrichten abgemeldet) und subscribed (weder angemeldet noch abgemeldet).	Nein
push_subscribe	String	Verfügbare Werte sind opted_in (explizit für den Empfang von Push-Nachrichten registriert), unsubscribed (explizit vom Empfang von Push-Nachrichten abgemeldet) und subscribed (weder angemeldet noch abgemeldet).	Nein
time_zone	String	Die Zeitzone muss im selben Format wie die IANA-Zeitzonendatenbank an Braze übergeben werden (z. B. America/New_York oder Eastern Time (US & Canada)).	Nein
date_of_first_session date_of_last_session	String	Kann in einem der folgenden ISO-8601-Formate übergeben werden: „YYYY-MM-DD“ „YYYY-MM-DDTHH:MM:SS+00:00“ „YYYY-MM-DDTHH:MM:SSZ“ „YYYY-MM-DDTHH:MM:SS“ (z. B. 2019-11-20T18:38:57)	Nein
subscription_group_id	String	Die id Ihrer Abo-Gruppe. Dieser Bezeichner ist auf der Abo-Gruppenseite Ihres Dashboards zu finden.	Nein
subscription_state	String	Der Abo-Status für die durch subscription_group_id angegebene Abo-Gruppe. Zulässige Werte sind unsubscribed (nicht in der Abo-Gruppe) oder subscribed (in der Abo-Gruppe).	Nein, aber dringend empfohlen, wenn subscription_group_id verwendet wird

Abo-Gruppenstatus aktualisieren (optional)

Zusätzlich können Sie Nutzer:innen über den Nutzerimport zu E-Mail- oder SMS-Abo-Gruppen hinzufügen. Dies ist besonders für SMS nützlich, da Nutzer:innen in eine SMS-Abo-Gruppe eingetragen sein müssen, um über den SMS-Kanal Nachrichten zu erhalten. Weitere Informationen finden Sie unter SMS-Abo-Gruppen.

Wenn Sie Abo-Gruppenstatus aktualisieren, müssen die folgenden zwei Spalten in Ihrer CSV-Datei vorhanden sein:

• subscription_group_id: Die id der Abo-Gruppe.
• subscription_state: Verfügbare Werte sind unsubscribed (nicht in der Abo-Gruppe) oder subscribed (in der Abo-Gruppe).

external_id	first_name	subscription_group_id	subscription_state
A8i3mkd99	Colby	6ff593d7-cf69-448b-aca9-abf7d7b8c273	subscribed
k2LNhj8Ks	Tom	aea02307-a91e-4bc0-abad-1c0bee817dfa	subscribed

Hinweis

Pro Zeile im Nutzerimport kann nur eine einzige subscription_group_id festgelegt werden. Verschiedene Zeilen können unterschiedliche subscription_group_id-Werte haben. Wenn Sie jedoch dieselben Nutzer:innen in mehrere Abo-Gruppen eintragen müssen, sind mehrere Importe erforderlich.

Erforderliche Bezeichner

Obwohl external_id nicht erforderlich ist, müssen Sie einen der folgenden Bezeichner als Überschrift in Ihrer CSV-Datei angeben. Details zu jedem einzelnen finden Sie unter Bezeichner auswählen.

• external_id
• braze_id
• user_alias_name und user_alias_label
• email
• phone

Felder für angepasste Events

Zusätzlich zu den folgenden Feldern kann Ihre CSV-Datei auch weitere Spaltenüberschriften für Event-Eigenschaften enthalten. Diese Eigenschaften sollten eine Spaltenüberschrift im Format <event_name>.properties.<property name>. haben.

Zum Beispiel könnte das angepasste Event trip_booked die Eigenschaften destination und duration haben. Diese können importiert werden, indem die Spaltenüberschriften trip_booked.properties.destination und trip_booked.properties.duration verwendet werden.

Nutzerprofilfeld	Datentyp	Information	Erforderlich?
external_id	String	Ein eindeutiger Nutzerbezeichner für Ihre:n Nutzer:in.	Bedingt. Siehe Erforderliche Bezeichner.
braze_id	String	Ein von Braze zugewiesener Bezeichner für Ihre:n Nutzer:in.	Bedingt. Siehe Erforderliche Bezeichner.
user_alias_name	String	Ein eindeutiger Nutzerbezeichner für anonyme Nutzer:innen als Alternative zur external_id. Muss zusammen mit user_alias_label verwendet werden.	Bedingt. Siehe Erforderliche Bezeichner.
user_alias_label	String	Ein gemeinsames Label, um Nutzer-Aliase zu gruppieren. Muss zusammen mit user_alias_name verwendet werden.	Bedingt. Siehe Erforderliche Bezeichner.
email	String	Die E-Mail-Adresse Ihrer Nutzer:innen, wie von ihnen angegeben (z. B. [email protected]).	Nein, und kann nur verwendet werden, wenn keine anderen Bezeichner vorhanden sind. Siehe den folgenden Hinweis.
phone	String	Eine Telefonnummer, wie von Ihren Nutzer:innen angegeben, im E.164-Format (z. B. +442071838750). Formatierungshinweise finden Sie unter Nutzer-Telefonnummern.	Nein, und kann nur verwendet werden, wenn keine anderen Bezeichner vorhanden sind. Siehe den folgenden Hinweis.
name	String	Ein angepasstes Event Ihrer Nutzer:innen.	Ja
time	String	Der Zeitpunkt des Events. Kann in einem der folgenden ISO-8601-Formate übergeben werden: „YYYY-MM-DD“ „YYYY-MM-DDTHH:MM:SS+00:00“ „YYYY-MM-DDTHH:MM:SSZ“ „YYYY-MM-DDTHH:MM:SS“ (z. B. 2019-11-20T18:38:57)	Ja
<event name>.properties.<property name>	Mehrere	Eine Event-Eigenschaft, die mit einem angepassten Event verknüpft ist. Ein Beispiel ist trip_booked.properties.destination	Nein

Formatierungsanforderungen für angepasste Events

Beim Import angepasster Events über CSV müssen Sie Ihre Datei gemäß den folgenden Anforderungen formatieren, um einen erfolgreichen Datenimport zu gewährleisten.

Formatierung angepasster Events verstehen

Es ist wichtig, Ihre CSV-Datei für angepasste Events korrekt mit Punktnotation zu formatieren, damit jede Eigenschaft dem richtigen Event zugeordnet wird. Wenn das Format nicht korrekt ist, können Eigenschaften verworfen werden oder der Import kann fehlschlagen, insbesondere wenn mehrere Event-Typen in einer Datei enthalten sind.

Punktnotation für Event-Eigenschaften verwenden

Die Punktnotation wird verwendet, um die hierarchische Beziehung zwischen einem angepassten Event und seinen Eigenschaften zu definieren. Diese Formatierungskonvention ermöglicht es Ihnen, strukturierte Event-Daten zu importieren, die spezifische Attribute für jedes Event enthalten.

Das Format der Punktnotation folgt dieser Struktur: event_name.properties.property_name

Die Punktnotation funktioniert in der folgenden Reihenfolge:

1. Zuerst kommt der Event-Name
2. Gefolgt von .properties., um anzuzeigen, dass das Folgende eine Event-Eigenschaft ist
3. Schließlich der spezifische Eigenschaftsname

Beispiel:

Für ein angepasstes Event namens rented_movie mit den Eigenschaften movie_name und genre wären Ihre CSV-Spaltenüberschriften:

• rented_movie.properties.movie_name
• rented_movie.properties.genre

Diese Notation weist Braze an, ein angepasstes Event namens rented_movie zu erstellen und die Eigenschaften movie_name und genre dieser spezifischen Event-Instanz zuzuordnen.

Ein Event pro Zeile

Jede Zeile in Ihrer CSV-Datei repräsentiert ein einzelnes angepasstes Event für eine:n einzelne:n Nutzer:in. Wenn eine:r Nutzer:in mehrere Events hat, müssen Sie für jedes Event eine separate Zeile einfügen, auch wenn sie denselben Nutzerbezeichner teilen.

Wichtig

Wenn eine Zeile Daten für ein bestimmtes Event enthält, füllen Sie nur die Spalten für die Eigenschaften dieses Events aus. Lassen Sie die Spalten für andere Events leer.

Beispiel-CSV-Struktur

Die folgende Tabelle zeigt die korrekte Formatierung für den Import angepasster Events mit Eigenschaften. Dieses Beispiel zeigt zwei Nutzer:innen, die jeweils unterschiedliche Events durchgeführt haben: Eine:r hat einen Film ausgeliehen und eine:r hat einen Film gekauft.

external_id	name	time	rented_movie.properties.movie_name	rented_movie.properties.genre	bought_movie.properties.movie_name	bought_movie.properties.genre
123	rented_movie	2024-06-10T12:00:00Z	Ghostbusters	Action
456	bought_movie	2024-06-12T12:00:00Z			Ghostbusters	Action

In diesem Beispiel:

• Nutzer:in 123 hat das Event rented_movie mit den Eigenschaften movie_name (Ghostbusters) und genre (Action) ausgelöst
• Nutzer:in 456 hat das Event bought_movie mit den Eigenschaften movie_name (Ghostbusters) und genre (Action) ausgelöst
• Jedes Event füllt nur seine relevanten Eigenschaftsspalten aus, während die Eigenschaftsspalten anderer Events leer bleiben

4. Schritt: Datei hochladen

Um Ihre Datei hochzuladen, wählen Sie Attributes oder Events, klicken Sie auf Browse Files und laden Sie Ihre CSV-Datei hoch. Braze zeigt eine Vorschau der ersten Zeilen und eine Zusammenfassung der erkannten Felder an.

Bei großen Dateien (bis zu 500 MB für Standardattribute und angepasste Attribute oder 50 MB für angepasste Events) kann das Dashboard vorübergehend nicht reagieren, während die Datei hochgeladen wird und Braze den Import berechnet. Diese Uploads und Berechnungen können länger dauern als bei kleineren Dateien. Lassen Sie diesen Schritt abschließen. Weitere Informationen zu Dateigrößenlimits und Zeitangaben finden Sie unter CSV-Datei erstellen.

Im Feld Import name können Sie Ihren Import umbenennen. Standardmäßig wird der Dateiname verwendet.

Hinweis

Die Dateivorschau zeigt nur die ersten Zeilen Ihrer Datei. Um jede Zeile vor dem Import zu prüfen, verwenden Sie die Dateivalidierung.

5. Schritt: Felder zuordnen (für Attribute)

Nach der Vorschau können Sie Ihre CSV-Überschriften Braze-Attributen zuordnen. Braze ordnet Felder in Ihrer CSV-Datei automatisch Attributen mit identischen Namen zu und erstellt bei Bedarf neue Attribute. Sie haben außerdem die Möglichkeit, Vorschläge manuell anzupassen oder andere Attribute für beliebige Spalten auszuwählen.

Zuordnungsstatus

Die Spalte „Zuordnungsstatus“ zeigt die Aktion an, die beim Import Ihrer CSV-Datei ausgeführt wird, und kann einen der folgenden Werte haben.

Neue Attribute bearbeiten

Wenn ein passendes Attribut in Ihrem Workspace nicht existiert, versucht Braze, beim Import ein neues Attribut mit dem Namen des CSV-Felds und dem erkannten Datentyp zu erstellen. Sie können dieses neue Attribut vor dem Import bearbeiten, indem Sie den Button Edit new attribute neben dem Zuordnungsstatus auswählen.

Hinweis

Sie können den Zuordnungsschritt erst fortsetzen, wenn ein Bezeichner zugeordnet ist. Braze ordnet nach Möglichkeit automatisch einen Bezeichner zu. Im Abschnitt Required fields können Sie prüfen, ob ein Bezeichner zugeordnet ist.

6. Schritt: Targeting-Einstellungen wählen

Nach der Zuordnung können Sie auf der Seite „Import-Einstellungen“ aus den folgenden Targeting-Einstellungen wählen. Wenn Sie keinen neuen Targeting-Filter oder kein neues Segment aus Ihrem Import erstellen müssen, wählen Sie Do not make this list available as a targeting filter.

7. Schritt: Datei validieren (optional)

Bevor Sie Ihren Import starten, können Sie eine Dateivalidierung durchführen, um jede Zeile auf Fehler und Warnungen zu prüfen. Um Ihre Datei zu validieren, wählen Sie Validate file before importing auf der Seite „Import-Einstellungen“ und klicken Sie dann auf Next.

Die Validierung kann bei Dateien mit der maximal zulässigen Größe bis zu 2 Minuten dauern. Während die Validierung läuft, können Sie Skip validation auswählen, um sie zu überspringen und sofort fortzufahren.

Validierungsergebnisse

Wenn die Validierung abgeschlossen ist, wird eines der folgenden Ergebnisse angezeigt.

Den Fehlerbericht verstehen

Der Fehlerbericht ist eine CSV-Datei, die jede markierte Zeile zusammen mit ihren Originaldaten und einer Beschreibung des Problems enthält.

Nach der Überprüfung des Berichts können Sie die Probleme in Ihrer Originaldatei korrigieren und erneut hochladen oder mit dem Import fortfahren und die Teilergebnisse akzeptieren.

8. Schritt: CSV-Import starten

Wenn Sie bereit sind, wählen Sie Start Import. Sie können den aktuellen Fortschritt auf der Seite Import Users verfolgen, die sich automatisch alle 5 Sekunden aktualisiert. Die Verarbeitung kann je nach Größe Ihrer CSV-Datei von wenigen Minuten bis zu mehreren Stunden dauern. Während dieser Zeit kann das Dashboard nicht reagieren oder langsam antworten, aber der Import läuft weiter.

Hinweis

Sie können mehr als eine CSV-Datei gleichzeitig importieren. CSV-Importe laufen parallel, sodass die Reihenfolge der Aktualisierungen nicht garantiert seriell ist. Wenn Sie CSV-Importe nacheinander ausführen müssen, warten Sie, bis ein CSV-Import abgeschlossen ist, bevor Sie einen zweiten hochladen.

Importstatus

Nach dem Start Ihres Imports können Sie den Status auf der Seite Import Users überprüfen.

Der Fehlerbericht nach dem Import enthält Zeilen, die aus Gründen fehlgeschlagen sind, die die Validierung nicht abdeckt, z. B. wenn eine:r Nutzer:in in Braze nicht existiert.

Wichtig

Zuvor hochgeladene CSV-Dateien können 14 Tage nach dem Upload-Datum von der Seite Import Users heruntergeladen werden. Nach 14 Tagen wird die Datei dauerhaft gelöscht und ist nicht mehr zugänglich.

Überlegungen zu Datenpunkten

Jedes importierte Kundendatum aus einer CSV-Datei überschreibt den bestehenden Wert in Nutzerprofilen und protokolliert einen Datenpunkt, mit Ausnahme von externen IDs und leeren Werten. Bei Fragen zu den Feinheiten der Braze-Datenpunkte kann Ihr Braze Account Manager diese beantworten.

Wichtig

Das Setzen von language oder country für eine:n Nutzer:in über CSV-Import oder API verhindert, dass Braze diese Informationen automatisch über das SDK erfasst.

Fehlerbehebung

Wenn Sie die Dateivalidierung verwendet haben, beginnen Sie mit dem Fehlerbericht, da dieser das spezifische Problem für jede markierte Zeile und eine Beschreibung zur Behebung enthält. Für Zeilen, die während des Imports und nicht während der Validierung fehlgeschlagen sind, laden Sie den Fehlerbericht herunter, indem Sie auf der Seite Import Users mit der Maus über die Zeile fahren und den -Button auswählen.

Zur Fehlerbehebung beim CSV-Import lesen Sie die folgenden häufigen Probleme.

E-Mail als external_id verwenden

Braze empfiehlt nicht, eine E-Mail-Adresse als external_id zu verwenden. Wenn Sie E-Mail als external_id verwenden, fügen Sie sowohl die Spalte external_id als auch die Spalte email in Ihre CSV-Datei ein, damit Nutzer:innen weiterhin über den E-Mail-Kanal ansprechbar bleiben. Verwenden Sie ein Komma (,) als Spaltentrennzeichen – keinen Doppelpunkt (:).

Anführungszeichen in external_id-Werten

Wenn eine external_id-Zelle ein doppeltes Anführungszeichen enthält, escapen Sie es durch Verdopplung des Zeichens (""), wie unter Nicht-escapte oder unausgeglichene doppelte Anführungszeichen beschrieben. Der CSV-Import verwendet kein Backslash-Escaping.

CSV-Import ist nicht als Segment-Filter verfügbar

Sie können einen CSV-Import nur dann als Segment-Filter verwenden, wenn Sie während des Uploads eine Targeting-Einstellung aktiviert haben.

Um zu prüfen, ob die Targeting-Verfügbarkeit für einen bestehenden Import aktiviert ist:

1. Suchen Sie auf der Seite Import Users Ihren CSV-Import.
2. Prüfen Sie, ob Go to Segment für diesen Import angezeigt wird.
3. Wenn Go to Segment angezeigt wird, ist Ihre CSV-Datei im Segment-Filter Updated/Imported from CSV verfügbar.
4. Wenn Go to Segment nicht angezeigt wird, wurde die Targeting-Verfügbarkeit für diesen Import nicht aktiviert.

Sie können die Targeting-Verfügbarkeit nach Abschluss eines CSV-Uploads nicht mehr aktivieren. Um diese CSV-Datei als Segment-Filter zu verwenden, laden Sie die Datei erneut hoch und wählen Sie in Schritt 6: Targeting-Einstellungen wählen die Option Create targeting filter oder Create targeting filter and add to new segment.

Wenn Ihr Ziel darin besteht, ein Segment zu erstellen, ohne Profildaten zu aktualisieren, laden Sie eine CSV-Datei hoch, die nur Bezeichnerspalten enthält (z. B. external_id oder Alias-Bezeichnerspalten), und wählen Sie dann Create targeting filter and add to new segment.

Probleme mit der Dateiformatierung

Fehlerhafte Zeile

Wenn Ihr Upload mit Fehlern abgeschlossen wurde, kann es eine fehlerhafte Zeile in Ihrer CSV-Datei geben.

Für einen korrekten Datenimport muss eine Kopfzeile vorhanden sein. Jede Zeile muss die gleiche Anzahl an Zellen wie die Kopfzeile haben. Zeilen mit mehr oder weniger Werten als die Kopfzeile werden vom Import ausgeschlossen. Kommas in einem Wert werden als Trennzeichen interpretiert und können zu diesem Fehler führen.

Außerdem müssen alle Daten UTF-8-kodiert sein. Wenn die Datei mit einer veralteten Kodierung gespeichert wurde (z. B. einige Excel-Standardeinstellungen), können Sonderzeichen und URLs in Zellen beschädigt werden und als Fragezeichen (?) in Braze oder in gesendeten Nachrichten erscheinen.

Wenn Ihre CSV-Datei leere Zeilen enthält und weniger Zeilen importiert als die Gesamtzahl der Zeilen in der CSV-Datei, muss dies nicht unbedingt auf ein Problem mit dem Import hinweisen, da die leeren Zeilen nicht importiert werden müssen. Überprüfen Sie die Anzahl der korrekt importierten Zeilen und stellen Sie sicher, dass sie mit der Anzahl der Nutzer:innen übereinstimmt, die Sie importieren möchten.

Fehlende Zeile

Es gibt einige Gründe, warum die Anzahl der importierten Nutzer:innen nicht mit der Gesamtzahl der Zeilen in Ihrer CSV-Datei übereinstimmen kann:

String-Anführungszeichen

Werte, die in einfache ('') oder doppelte ("") Anführungszeichen eingeschlossen sind, werden beim Import als Strings gelesen.

Falsch formatierte Datumsangaben

Datumsangaben, die nicht im ISO-8601-Format vorliegen, werden beim Import nicht als datetimes gelesen.

Probleme mit der Datenstruktur

Ungültige E-Mail-Adressen

Wenn Ihr Upload mit Fehlern abgeschlossen wurde, kann es eine oder mehrere ungültige verschlüsselte E-Mail-Adressen geben. Bestätigen Sie, dass alle E-Mail-Adressen korrekt verschlüsselt sind, bevor Sie sie in Braze importieren.

• Beim Aktualisieren oder Importieren von E-Mail-Adressen in Braze verwenden Sie den gehashten E-Mail-Wert überall dort, wo eine E-Mail enthalten ist. Diese gehashten E-Mail-Werte werden von Ihrem internen Team bereitgestellt.
• Beim Erstellen neuer Nutzer:innen müssen Sie email_encrypted mit dem verschlüsselten E-Mail-Wert der/des Nutzers/Nutzerin hinzufügen. Andernfalls erstellt Braze die/den Nutzer:in nicht. Ebenso müssen Sie, wenn Sie einer/einem bestehenden Nutzer:in ohne E-Mail eine E-Mail-Adresse hinzufügen, email_encrypted hinzufügen. Andernfalls aktualisiert Braze die/den Nutzer:in nicht.

Daten als angepasstes Attribut importiert

Wenn ein Standard-Nutzerdatum (wie email oder first_name) als angepasstes Attribut importiert wird, überprüfen Sie die Groß-/Kleinschreibung und die Abstände in Ihrer CSV-Datei. Zum Beispiel wird First_name als angepasstes Attribut importiert, während first_name korrekt in das Feld „Vorname“ im Nutzerprofil importiert wird.

Datentyp eines angepassten Attributs ändern

Wenn Sie den Datentyp eines bestehenden angepassten Attributs ändern müssen (z. B. von String zu Boolescher Wert), aktualisieren Sie den Datentyp auf der Seite Angepasste Attribute im Dashboard, bevor Sie Ihre CSV-Datei importieren. Wenn der Datentyp in Ihrer CSV-Datei nicht mit dem aktuell definierten Datentyp des Attributs übereinstimmt, schlägt der Import mit einem Fehler fehl.

Mehrere Datentypen

Braze erwartet, dass jeder Wert in einer Spalte denselben Datentyp hat. Werte, die nicht dem Datentyp ihres Attributs entsprechen, verursachen Fehler bei der Segmentierung.

Außerdem kann das Beginnen eines Zahlenattributs mit einer Null Probleme verursachen, da Zahlen, die mit Nullen beginnen, als Strings betrachtet werden. Wenn Braze diesen String konvertiert, kann er als Oktalwert behandelt werden (der Ziffern von null bis sieben verwendet), was bedeutet, dass er in seinen entsprechenden Dezimalwert umgewandelt wird. Wenn der Wert in der CSV-Datei beispielsweise 0130 ist, zeigt das Braze-Profil 88 an. Um dieses Problem zu vermeiden, verwenden Sie Attribute mit String-Datentypen. Dieser Datentyp ist jedoch nicht im Segmentierungs-Zahlenvergleich verfügbar.

Standardattributtypen

Einige Standardattribute akzeptieren möglicherweise nur bestimmte Werte als gültig für Nutzeraktualisierungen. Hinweise finden Sie unter CSV-Datei erstellen.

Nachgestellte Leerzeichen und Unterschiede in der Groß-/Kleinschreibung können dazu führen, dass ein Wert als ungültig interpretiert wird. In der folgenden CSV-Datei wird beispielsweise nur die/der Nutzer:in in der ersten Zeile (brazetest1) erfolgreich mit dem E-Mail- und Push-Status aktualisiert, da die akzeptierten Werte unsubscribed, subscribed und opted_in sind.

1
2
3
external_id,email,email_subscribe,push_subscribe
brazetest1,[email protected],unsubscribed,unsubscribed
brazetest2,[email protected],Unsubscribed,Unsubscribed

„CSV-Datei auswählen“ funktioniert nicht

Es gibt mehrere Gründe, warum der Button Select CSV File möglicherweise nicht funktioniert: