CSV-Datei für mehrsprachige Push-Benachrichtigungen erstellen generating-csv-multilingual-push
Durch das Hochladen einer CSV-Datei zum Generieren von Inhalten für den Versand werden mehrsprachige Push-Benachrichtigungen unterstützt. Das Format der CSV-Datei muss bestimmten Richtlinien entsprechen, damit der Datei-Upload erfolgreich und eine Versanderstellung möglich ist. In den folgenden Abschnitten werden das Dateiformat und die damit verbundenen Überlegungen beschrieben.
Dateiformat file-format
Mehrsprachige Push-Benachrichtigungen erfordern 14 Spalten in der CSV-Datei:
- title
- messageBody
- sound
- badge
- deeplinkURI
- category
- iosMediaAttachmentURL
- androidMediaAttachmentURL
- isContentAvailable
- isMutableContent
- customFields
- locale
- language
- silentPush
Sie können sich das CSV-Beispiel ansehen, indem Sie auf Beispieldatei herunterladen im Fenster Inhaltsvarianten verwalten klicken. Weitere Informationen finden Sie in diesem Abschnitt.
- title, messageBody, sound, badge, deeplinkURI, category, iosMediaAttachmentURL, androidMediaAttachmentURL: Standardmäßige Push-Payload-Inhalte. Sie müssen diese Informationen auf ähnliche Weise bereitstellen wie beim Erstellen von Push-Sendungen.
- Benutzerdefinierte Felder: Verwenden Sie das JSON-Format für die benutzerdefinierten Felder, z. B.
{"key1":"value1","key2":"value2"}. In der obigen Beispieldatei finden Sie ein Beispiel für benutzerdefinierte Felder. - isContentAvailable: Markierung für Prüfung "Inhalt verfügbar", Wert 1 bedeutet "wahr", Wert 0 bedeutet "falsch". Der Standardwert ist 0. Wenn Sie diese Spalte leer lassen, wird der Wert als 0 betrachtet.
- isMutableContent: Markierung für "Veränderlicher Inhalt", Wert 1 bedeutet "wahr", Wert 0 bedeutet "falsch". Der Standardwert ist 0. Wenn Sie diese Spalte leer lassen, wird der Wert 0 angenommen.
- locale: "locale" (Gebietsschema) ist das Feld für Sprachvarianten, z. B. "en_us" für US-Englisch und "fr_fr" für Frankreich-Französisch.
- language: Name der Sprache, die mit dem Gebietsschema verknüpft ist. Wenn das Gebietsschema beispielsweise "en_us" lautet, sollte der Name der Sprache "Englisch – USA" lauten.
- silentPush: Markierung für den Push-Benachrichtigungstyp. Wenn es sich um eine reguläre Push-Benachrichtigung handelt, sollte der Wert 0 betragen. Wenn es sich um stilles Pushen handelt, sollte der Wert 1 betragen. Der Standardwert ist 0. Wenn Sie diese Spalte leer lassen, wird der Wert als 0 betrachtet.
Einschränkungen und Richtlinien für die Erstellung von CSV-Dateien constraints-guideline-csv
Der Name jeder Spalte ist festgesetzt.
Sie sollten die Namen der einzelnen Spalten in der CSV-Datei angeben. Wenn Sie für den Inhalt keine Spalten verwenden, geben Sie nichts an.
Die Spalten "locale" und "language" sind zwingend erforderlich und der Wert ist für jede Zeile eindeutig.
Wenn der Wert in einer dieser Spalte fehlt, tritt beim Hochladen der Datei ein Fehler auf.
Die Reihenfolge der Spalten ist wichtig. Die Reihenfolge der Spalten in der hochgeladenen Datei muss das Format der Beispieldatei aufweisen.
Spalteninhalt in Anführungszeichen setzen. Da es sich um eine CSV-Datei (d. h. Comma-Separated Values) handelt, muss jeder Spalteninhalt, der ein Komma (,) enthält, in Anführungszeichen gesetzt werden. Beispiel: "Hallo, Tom!"
Für internationale Zeichen ist die UTF-8-Kodierung erforderlich.
Wenn Sie die Datei im Klartext generieren, trennen Sie jede Spalte durch ",".
Varianten stimmen nicht überein. Wenn Sie einen Inhaltsbaustein und Ziel-Audiences mit unterschiedlichen Sprachen verwenden, müssen Sie jede Zielsprache in Ihrer CSV-Datei auflisten. Andernfalls wird beim Versand ein Fehler ausgegeben.
Personalisierungsfelder in die CSV-Datei einfügen personalization-field-csv
Wenn Sie Personalisierungsfelder verwenden möchten, sollten Sie den -Tag in die Datei aufnehmen.
Um das Personalisierungsfeld "firstName" in messageBody einzufügen, muss die Nachricht wie folgt lauten:
"Hello <span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>, this is message".
Das Feld "firstName" wird wie folgt dargestellt:
<span class="nl-dce-field nl-dce-done" data-nl-expr="/context/profile/firstName">First name</span>
Im Bereich gibt es zwei obligatorische Attribute:
-
Das erste Attribut ist "class"; es ist statisch. Unabhängig davon, welches Personalisierungsfeld Sie verwenden möchten, gilt immer class="nl-dce-field nl-dce-done".
-
Das zweite Attribut ist "data-nl-expr", der Pfad des Personalisierungsfelds. Wenn Sie z. B. das Personalisierungsfeld "firstName" aus der Benutzeroberfläche einfügen, lautet der Navigationspfad Kontext (context) > Profil (profile) > Vorname (firstname) (wie in der Abbildung unten gezeigt). In diesem Fall lautet der Pfad
code language-none /context/profile/firstName. data-nl-expr="/context/profile/firstName".
Gebietsschema und Sprachnamen locale-language-names
Folgende Sprachen werden unterstützt: