Konfigurieren eines mehrsprachigen Versands multilingual-delivery

In der Campaign Web-Benutzeroberfläche können Sie Ihre Sendungen als mehrsprachig einrichten, sodass Sie Nachrichten basierend auf der bevorzugten Sprache eines Profils senden können. Wenn keine Voreinstellung definiert ist, wird die Nachricht in der Standardsprache gesendet.

Bei einem mehrsprachigen Versand basiert die Sprachverwaltung auf Varianten. Jede Variante steht für eine Sprache. Bei der Versanderstellung können Sie entsprechend der Anzahl der erforderlichen Sprachen in Ihrer Nachricht mehrere Sprachvarianten hinzufügen. Sie können die Standardsprache auch jederzeit ändern, nachdem Sie diese Varianten hinzugefügt haben.

Die mehrsprachige Funktion ist derzeit für E-Mails, Push-Benachrichtigungen, Transaktionsnachrichten und SMS verfügbar.

Führen Sie die folgenden Schritte durch, um den mehrsprachigen Versand einzurichten:

  1. Hinzufügen einer Sprachvariante, weitere Informationen
  2. Definieren des Inhalts für jede Variante, weitere Informationen
  3. Verwalten der Sprachvarianten, weitere Informationen

Hinzufügen einer Sprachvariante add-variant

Gehen Sie wie folgt vor, um eine Sprachvariante zu erstellen:

  1. Klicken Sie im Versand-Dashboard auf das Stiftsymbol, um den Bildschirm zur Bearbeitung des Versandinhalts aufzurufen, und klicken Sie dann auf Sprache hinzufügen.

    note important
    IMPORTANT
    Die Schaltfläche Sprache hinzufügen ist nur verfügbar, wenn die Zielgruppendimension das Schema Sprache enthält. Weitere Informationen zu Schemata und Zielgruppendimensionen finden Sie in der ausführlichen Dokumentation.

    {modal="regular"}

  2. Wählen Sie aus der Dropdown-Liste Sprache hinzufügen die gewünschte Sprache aus und bestätigen Sie dann Ihre Auswahl. Für Push-Benachrichtigungen können Sie auch eine CSV-Datei hochladen, um alle Sprachvarianten gleichzeitig zu importieren.

    Die erste hinzugefügte Sprache wird automatisch als Standard festgelegt und der vorhandene Inhalt wird zur Standardversion. Wenn zusätzliche Sprachen hinzugefügt werden, wird deren Inhalt zunächst aus der Standardsprache kopiert.

    {modal="regular"}

    note
    NOTE
    Die in dieser Liste verfügbaren Sprachen hängen von den Werten ab, die durch das Attribut Sprache definiert wurden (Werte wie: „system“, „user“, „dbenum“ usw.). Weitere Informationen zur Auflistungsverwaltung finden Sie in diesem Abschnitt.
  3. Wiederholen Sie diesen Vorgang, um weitere Sprachen hinzuzufügen. Im Panel Sprachen werden auf der linken Seite die Liste der ausgewählten Sprachen, die Anzahl der verschiedenen Sprachen sowie die Standardsprache angezeigt.

    Wenn Sie beispielsweise Englisch, Französisch und Schwedisch ausgewählt haben, können Sie diese 3 Sprachen wie unten angezeigt sehen:

    {modal="regular"}

    Informationen zum Verwalten von Sprachvarianten finden Sie in diesem Abschnitt.

Definieren des Inhalts für jede Variante define-content

Definieren Sie nach dem Festlegen der Sprachen den Versandinhalt für jede Sprache.

  1. Wählen Sie auf dem Bildschirm zur Bearbeitung des Versandinhalts über das Panel Sprachen auf der linken Seite eine Sprache aus.

    {modal="regular"}

  2. Definieren Sie den Inhalt Ihrer Nachricht für diese Sprache. Weitere Informationen finden Sie in diesem Abschnitt.

  3. Wiederholen Sie diesen Vorgang für jede Sprache.

Um eine Vorschau des Versands anzuzeigen, klicken Sie auf die Schaltfläche Inhalte simulieren und wählen Sie „Profile“ aus. Stellen Sie sicher, dass für jedes Profil der richtige Inhalt angezeigt wird.

{modal="regular"}

Verwalten von Sprachvarianten manage-variant

Im linken Panel werden die Informationen zu allen Sprachvarianten angezeigt. Um alle Sprachen zu löschen, klicken Sie auf die Schaltfläche „Erweitern“ und anschließend auf Alle Varianten löschen.

{modal="regular"}

In der Liste der Sprachvarianten können Sie die folgenden Aktionen ausführen:

  • Bearbeiten: die Sprache ändern und gleichzeitig die zugehörigen Inhalte beibehalten.
  • Als Standard festlegen: die Sprache als Standardsprache festlegen. Wenn für ein Profil keine Sprache definiert ist, wird die Nachricht in der Standardsprache gesendet.
  • Duplizieren: den für diese Sprache definierten Inhalt duplizieren und eine andere Variante auswählen.
  • Löschen: die Variante und den zugehörigen Inhalt löschen.

{modal="regular"}

Importieren von Sprachvarianten aus CSV (Push-Benachrichtigungen) csv-upload

Für Push-Benachrichtigungen können Sie jetzt alle Sprachvarianten schnell füllen, indem Sie eine CSV-Datei mit mehrsprachigen Inhalten hochladen. Diese Funktion optimiert die Erstellung mehrsprachiger Kampagnen, da Sie Inhalte offline vorbereiten und in Massen importieren können.

  • Effizienz: Fügen Sie mehrere Sprachen und deren Inhalte in einem Vorgang hinzu
  • Konsistenz: Gewährleisten Sie ein einheitliches Messaging für alle Sprachvarianten
  • Zusammenarbeit: Ermöglichen Sie es Inhalts-Teams, Übersetzungen in vertrauten Tabellenkalkulations-Tools vorzubereiten
  • Massenverwaltung: Verwalten und aktualisieren Sie problemlos eine große Anzahl von Sprachvarianten

Voraussetzungen csv-best-practices

Befolgen Sie die folgenden Best Practices, um einen erfolgreichen CSV-Import sicherzustellen:

  • Verwenden Sie die exakte Spaltenstruktur: Alle 14 Spalten müssen in Ihrer CSV-Datei vorhanden sein, auch wenn Sie einige leer lassen. Fehlende Spalten führen zu einem Importfehler. Sie können eine andere Reihenfolge verwenden, aber alle Spalten müssen vorhanden sein.
  • Gleichen Sie Spaltennamen genau ab: Bei Spaltennamen wird zwischen Groß- und Kleinschreibung unterschieden. Verwenden Sie title und nicht Title, badge und nicht Bbadge, locale und nicht Locale.
  • Verwenden Sie Gebietsschema-Codes in Kleinbuchstaben: Formatieren Sie Gebietsschema-Codes als en_us, fr_fr, de_de (Kleinbuchstaben mit Unterstrich), nicht als en_US oder en-us.
  • Füllen Sie obligatorische Spalten aus: Die Spalten locale und language müssen für jede Zeile Werte enthalten. Leere Werte führen zu einem Importfehler.
  • Nutzen Sie eindeutige Gebietsschemata: Jeder Gebietsschema-Code darf nur einmal in der CSV-Datei vorkommen. Doppelte Gebietsschemata werden abgelehnt.
  • Speichern Sie als UTF-8: Speichern Sie Ihre CSV-Datei immer mit UTF-8-Codierung, um internationale Zeichen korrekt zu unterstützen.
  • Setzen Sie Anführungszeichen bei Inhalten, die Kommas enthalten: Wenn der Titel oder Nachrichtentext Kommas enthält, setzen Sie das gesamte Feld in doppelte Anführungszeichen: "Hello, welcome!".
  • Verwenden Sie numerische Werte korrekt: Verwenden Sie für Flag-Spalten (isContentAvailable, isMutableContent, silentPush) 1 für „wahr“, 0 für „falsch“ oder lassen Sie das Feld leer für die Standardeinstellung.
  • Validieren Sie das JSON-Format: Wenn Sie die Spalte „customFields“ verwenden, stellen Sie sicher, dass Ihr JSON ordnungsgemäß formatiert ist: {"key":"value"} mit korrekten Anführungszeichen und Klammern.
  • Testen Sie zuerst mit minimalen Daten: Beginnen Sie mit einer einfachen CSV-Datei mit 2–3 Sprachen, um Ihr Format zu prüfen, bevor Sie große Dateien erstellen.
NOTE
Die Spaltenstruktur wird in diesem Abschnitt beschrieben.

Importieren der CSV-Datei csv-steps

Gehen Sie wie folgt vor, um Sprachvarianten aus einer CSV-Datei zu importieren:

  1. Klicken Sie im Editor für Versandinhalte auf Sprache hinzufügen.

    Screenshot der Schaltfläche „Sprache hinzufügen“ im Inhalts-Editor für Push-Benachrichtigungen {modal="regular"}

  2. Wählen Sie Ihre CSV-Datei aus, indem Sie sie per Drag-and-Drop in den Upload-Bereich ziehen, oder klicken Sie, um Ihren Computer zu durchsuchen.

    Das System überprüft Ihr Dateiformat und Ihren Inhalt. Wenn die Validierung fehlschlägt, geben Fehlermeldungen an, welche Spalten oder Daten falsch sind. Beheben Sie die Probleme in Ihrer CSV-Datei und laden Sie sie erneut hoch. Weitere Informationen finden Sie in diesem Abschnitt.

    Screenshot einer erfolgreichen CSV-Validierung mit allen importierten Sprachen {modal="regular"}

  3. Überprüfen Sie die importierten Inhalte im Panel „Sprachvarianten“, um zu prüfen, ob alle Übersetzungen korrekt geladen wurden.

    Screenshot der Vorschau importierter mehrsprachiger Inhaltsvarianten {modal="regular"}

Spaltenstruktur csv-columns

Hier finden Sie die korrekte zu verwendende Spaltenstruktur:

NOTE
Sie können eine andere Reihenfolge verwenden, aber alle Spalten müssen vorhanden sein. Weitere Best Practices finden Sie in diesem Abschnitt.
  1. title: Titel der Benachrichtigung (erforderlich)
  2. messageBody: Textkörper der Benachrichtigungsmeldung (erforderlich)
  3. sound: Name der Audiodatei (z. B. default, custom_sound.mp3) – lassen Sie das Feld für die Standardeinstellung leer
  4. badge: Badge-Nummer, die auf dem App-Symbol (iOS) angezeigt wird – verwenden Sie nur Zahlen
  5. deeplinkURI: Deep-Link-URL, die beim Tippen auf eine Benachrichtigung geöffnet werden soll – lassen Sie das Feld leer, wenn nicht verwendet
  6. category: Kennung der Benachrichtigungskategorie für benutzerdefinierte Aktionen (iOS) – lassen Sie das Feld leer, wenn nicht verwendet
  7. iosMediaAttachmentURL: URL des Medienanhangs für iOS-Benachrichtigungen – lassen Sie das Feld leer, wenn nicht verwendet
  8. androidMediaAttachmentURL: URL des Medienanhangs für Android-Benachrichtigungen – lassen Sie das Feld leer, wenn nicht verwendet
  9. isContentAvailable: Flag für verfügbaren Inhalt (iOS) – verwenden Sie 1 für „wahr“, 0 für „falsch“ und lassen Sie das Feld leer für den Standardwert (0)
  10. isMutableContent: Flag für veränderlichen Inhalt (iOS) – verwenden Sie 1 für „wahr“, 0 für „falsch“ und lassen Sie das Feld leer für den Standardwert (0)
  11. customFields: Benutzerdefinierte Daten im JSON-Format (z. B. {"key1":"value1","key2":"value2"}) – lassen Sie das Feld leer, wenn nicht verwendet
  12. locale: Sprach-Code (erforderlich) – z. B. en_us, fr_fr, de_deobligatorisch, muss pro Zeile eindeutig sein
  13. language: Sprachname (erforderlich) – z. B. English-United States, French-Franceobligatorisch
  14. silentPush: Flag für stilles Pushen – verwenden Sie 1 für stilles Pushen, 0 für reguläres Pushen und lassen Sie das Feld leer für den Standardwert (0)

Beispiel einer CSV-Datei csv-examples

Im Folgenden finden Sie ein einfaches Beispiel mit den obligatorischen Feldern:

title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
Welcome!,Thank you for joining us,,,,,,,,,, en_us,English-United States,0
Bienvenue !,Merci de nous avoir rejoint,,,,,,,,,,fr_fr,French-France,0
Willkommen!,Vielen Dank für Ihre Anmeldung,,,,,,,,,, de_de,German-Germany,0
¡Bienvenido!,Gracias por unirte a nosotros,,,,,,,,,, es_es,Spanish-Spain,0

Im Folgenden finden Sie ein Beispiel mit optionalen Feldern:

title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
Welcome!,Thank you for joining us,default,1,,,https://example.com/welcome-en.jpg,https://example.com/welcome-en.jpg,,,, en_us,English-United States,0
Bienvenue !,Merci de nous avoir rejoint,default,1,,,https://example.com/welcome-fr.jpg,https://example.com/welcome-fr.jpg,,,, fr_fr,French-France,0
Willkommen!,Vielen Dank für Ihre Anmeldung,default,1,,,https://example.com/welcome-de.jpg,https://example.com/welcome-de.jpg,,,, de_de,German-Germany,0
¡Bienvenido!,Gracias por unirte a nosotros,default,1,,,https://example.com/welcome-es.jpg,https://example.com/welcome-es.jpg,,,, es_es,Spanish-Spain,0

Im Folgenden finden Sie ein Beispiel mit benutzerdefinierten Feldern

title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
New Collection,Discover our latest products,default,1,,,,,,,"{"campaign":"summer2025","segment":"premium"}",en_us,English-United States,0
Nouvelle Collection,Découvrez nos derniers produits,default,1,,,,,,,"{"campaign":"summer2025","segment":"premium"}",fr_fr,French-France,0
NOTE
Für Rich-Push-Benachrichtigungen mit Karussells oder Aktionsschaltflächen verwendet Campaign eine andere Konfigurationsmethode als den CSV-Import. Konfigurieren Sie Rich-Push-Inhalte direkt im Versand-Editor nach dem Import grundlegender mehrsprachiger Inhalte.

Personalisierung in CSV-Dateien csv-personalization

Um Personalisierungsfelder in Ihren CSV-Inhalten zu verwenden, müssen Sie <span>-Tags verwenden:

title,messageBody,sound,badge,deeplinkURI,category,iosMediaAttachmentURL,androidMediaAttachmentURL,isContentAvailable,isMutableContent,customFields,locale,language,silentPush
"Hello <span class=""nl-dce-field nl-dce-done"" data-nl-expr=""recipient.firstName"">recipient.firstName</span>","Your order has shipped!",,,,,,,,,,en_us,English-United States,0
"Bonjour <span class=""nl-dce-field nl-dce-done"" data-nl-expr=""recipient.firstName"">recipient.firstName</span>","Votre commande a été expédiée !",,,,,,,,,,fr_fr,French-France,0

Während des Versands ersetzt Campaign diese Platzhalter durch die tatsächlichen Empfängerdaten.

Fehlerbehebung csv-troubleshooting

Fehler
Grund
Lösung
Erforderliche Spalten fehlen
CSV-Datei enthält nicht alle 14 Spalten
Stellen Sie sicher, dass Ihre CSV-Datei alle 14 Spalten exakt in der oben gezeigten Reihenfolge enthält. Verwenden Sie leere Werte für nicht verwendete Spalten.
Ungültige Gebietsschema-/Sprachwerte
Gebietsschema- oder Sprachspalten sind leer
Sowohl die Spalten des Gebietsschemas als auch der Sprache müssen Werte für jede Zeile aufweisen
Doppelte Gebietsschemata
Derselbe Gebietsschema-Code wird mehrmals angezeigt
Jeder Gebietsschemawert muss eindeutig sein – entfernen Sie Duplikate
Probleme mit der Datei-Codierung
CSV-Datei verwendet eine inkompatible Codierung
Speichern Sie Ihre CSV-Datei mit der UTF-8-Codierung
Spalte stimmt nicht überein
Zeilen haben eine andere Anzahl von Spalten als die Kopfzeile
Stellen Sie sicher, dass alle Zeilen genau 14 Spalten aufweisen, die mit der Kopfzeile übereinstimmen.
Ungültige numerische Werte
„badge“, „isContentAvailable“, „isMutableContent“ oder „silentPush“ enthalten nicht-numerische Werte
Verwenden Sie nur Zahlen: 0 oder 1 für Flags oder leer lassen für Standard
Fehlerhaftes JSON
Spalte „customFields“ enthält ungültiges JSON
Stellen Sie sicher, dass die JSON-Syntax korrekt ist: {"key":"value"} oder leer lassen
Groß-/Kleinschreibung des Spaltennamens stimmt nicht überein
Spaltennamen stimmen nicht genau überein
Bei Spaltennamen wird zwischen Groß- und Kleinschreibung unterschieden – verwenden Sie die oben aufgeführten exakten Namen (z. B. badge, nicht Badge oder BADGE)

Best Practices sind in diesem Abschnitt aufgeführt. Die Spaltenstruktur wird in diesem Abschnitt beschrieben.

recommendation-more-help
campaign-web-help-v8