Zum Inhalt springen

Sprache und Gebietsschema von Nutzer:innen einrichten

Entscheiden Sie, welches Signal die Sprache bestimmt, die Verbraucher:innen erhalten, und legen Sie diesen Wert dann im Nutzerprofil fest, damit lokalisierte Campaigns und Canvases die richtige Zielgruppe erreichen.

Über dieses Beispiel

UponVoyage, eine fiktive Reisemarke, personalisiert Nachrichten für Verbraucher:innen in zwölf Märkten. Das Marketing leitet die Sprache aus einem angepassten Attribut market ab, das auf das Land gesetzt ist, von dem aus Verbraucher:innen ausgehende Reisen buchen. Dieses Attribut bildet eine Region und keine Sprache ab. Deshalb können Verbraucher:innen, die aus einem mehrsprachigen Land – oder aus einem anderen als ihrem eigenen Land – buchen, die falsche Sprache erhalten.

Dieses Beispiel vergleicht drei Signale für die Sprache von Verbraucher:innen und zeigt, wie Sie jedes davon im Profil festlegen:

  • Vom SDK erfasste Sprache: Das Standardattribut language, das aus dem Gebietsschema des Geräts oder Browsers erfasst wird
  • Explizite Sprachpräferenz: Ein Wert, den Verbraucher:innen in Ihrer App oder auf Ihrer Website wählen und der über das SDK oder die REST API festgelegt wird
  • Angepasstes Markt- oder Regionsattribut: Ein geschäftliches Attribut wie market, das Sie verwenden, wenn Ihre Inhalte nach Region statt nach Sprache variieren

language und country sind in Braze separate Standardattribute. Wenn regionale Varianten wichtig sind (zum Beispiel europäisches Spanisch im Vergleich zu lateinamerikanischem Spanisch), sollten Sie beide Attribute für das Targeting nutzen, statt einen kombinierten Gebietsschema-String zu speichern.

Dieses Beispiel zeigt, wie Sie ein Sprachsignal auswählen und im Profil festlegen. Informationen zum Speichern und Versenden übersetzter Texte finden Sie unter Übersetzungsansätze vergleichen.

Überlegungen

  • Das Land stammt zuerst aus der IP-Geolocation. Braze ermittelt country anhand der Geolocation der IP-Adresse. Ist keine Geolocation verfügbar, ermittelt Braze country anhand des Gebietsschemas des Geräts. Behandeln Sie country nicht als vom Gerät gemeldeten Wert. Weitere Informationen finden Sie unter SDK-Datenerfassung.
  • Die Spracherfassung ist optional und kann deaktiviert werden. language gehört zu den optionalen Daten, die standardmäßig erfasst werden. Eine minimale Integration oder eine Allowlist für Geräteeigenschaften kann sie daher ausschließen. Prüfen Sie, ob Ihre Integration sie weiterhin erfasst, bevor Sie sich darauf verlassen. Weitere Informationen finden Sie unter Speicher.
  • Das letzte Geräte-Gebietsschema kann fehlen. Nicht alle Verbraucher:innen haben einen Wert. Planen Sie daher eine Fallback-Sprache für Nachrichten ein, die diesen Wert verwenden.
  • Ein explizit festgelegter Wert beendet die automatische Erfassung. Nachdem Sie language oder country über das SDK, die REST API oder einen CSV-Import festgelegt haben, aktualisiert Braze dieses Feld für die betreffende Person nicht mehr automatisch. Planen Sie, wie Verbraucher:innen ihre Präferenz später ändern können.
  • Explizite Werte verbrauchen Datenpunkte. Attribut-Updates über SDK und API protokollieren Datenpunkte, die automatische Erfassung dagegen nicht. Weitere Informationen finden Sie unter Datenpunkte.
  • language muss ein ISO-639-1-Code sein. Verwenden Sie zweistellige Codes wie en oder nl. Die unterstützten Codes finden Sie unter Sprachcodes. country verwendet ISO-3166-1-Alpha-2-Codes wie GB oder BE.
  • Eine Änderung Ihres Sprachmodells wirkt sich auf bestehende Assets aus. Wenn Sie von einem angepassten Attribut auf Standardattribute umsteigen, überprüfen Sie die Campaigns, Canvases, Segments und Liquid-Inhalte, die auf das alte Attribut verweisen, bevor Sie es außer Betrieb nehmen.

Einrichtung

Schritt 1: Das Signal auswählen, das die Sprache bestimmt

Signal Verwenden, wenn Nachteil
Vom SDK erfasstes language Sie eine Abdeckung für alle Verbraucher:innen mit einer SDK-Sitzung wünschen, ohne Entwicklungsaufwand über die bestehende Integration hinaus Spiegelt die Geräteeinstellung wider, die von der Sprache abweichen kann, in der Verbraucher:innen Marketing erhalten möchten
Explizite Sprachpräferenz Verbraucher:innen eine Sprache in Ihrer App, auf Ihrer Website oder auf einer Seite mit Kontoeinstellungen wählen können Erfordert eine Schnittstelle für die Auswahl und einen Aufruf an Braze, wenn sie sich ändert
Angepasstes Markt- oder Regionsattribut Inhalte, Preise oder rechtliche Texte nach Markt statt nach Sprache variieren Ein market-Attribut lässt sich nur dann einer Sprache zuordnen, wenn jeder Markt genau eine Sprache hat

Wenn Sie eine explizite Präferenz erfassen können, verwenden Sie diese als primäres Signal und greifen Sie als Fallback auf das vom SDK erfasste language zurück. Ein market-Attribut ist ein schlechter Ersatz, um die Sprache in mehrsprachigen Ländern wie Belgien, Kanada und der Schweiz abzuleiten.

Schritt 2: Prüfen, was Ihre Integration bereits erfasst

  1. Gehen Sie zu Zielgruppe > Nutzersuche, öffnen Sie ein Kundenprofil und prüfen Sie die Felder Sprache und Land.
  2. Wenn Sprache in allen Profilen leer ist, prüfen Sie, ob Ihre SDK-Integration das Feld von der Erfassung der Geräteeigenschaften ausschließt.
  3. Achten Sie darauf, ob Letztes Geräte-Gebietsschema befüllt ist. Nutzen Sie es zur Diagnose und verwenden Sie es nicht ohne Fallback für das Targeting.

Schritt 3: Eine explizite Sprachpräferenz festlegen

Führen Sie diesen Schritt nur aus, wenn Sie sich in Schritt 1 für eine explizite Sprachpräferenz entschieden haben. Für das vom SDK erfasste language bestätigen Sie die Erfassung in Schritt 2 und fahren direkt mit dem Targeting fort. Für ein angepasstes market- oder Regionsattribut legen Sie dieses Attribut über das SDK oder die REST API fest und fahren dann nach Bedarf mit den Schritten 4 bis 6 fort.

Wenn Verbraucher:innen eine Sprache wählen, senden Sie diese Auswahl an Braze, damit sie Vorrang vor der automatischen Erfassung hat.

Legen Sie den Wert über das SDK fest, wenn die Auswahl in Ihrer App oder auf Ihrer Website erfolgt. Die Methodennamen für die einzelnen Plattformen finden Sie unter Nutzerattribute festlegen.

Für Präferenzen, die in Ihren eigenen Systemen gespeichert sind, senden Sie die Standardattribute über den Endpunkt /users/track:

{
  "attributes": [
    {
      "external_id": "{YOUR_EXTERNAL_ID}",
      "language": "nl",
      "country": "BE"
    }
  ]
}

Ersetzen Sie YOUR_EXTERNAL_ID durch den Bezeichner der Person, deren Präferenz sich geändert hat.

Schritt 4: Das Land festlegen, wenn Verbraucher:innen eine Region angeben

Legen Sie country explizit fest, wenn Verbraucher:innen Ihnen ihre Region mitteilen – zum Beispiel, wenn sie eine länderspezifische Website besuchen oder bei der Registrierung einen Markt auswählen. Verwenden Sie dieselbe /users/track-Anfrage oder SDK-Methode wie im vorherigen Schritt.

Wenn das IP-basierte Land weiterhin aktualisiert werden soll, legen Sie country nicht explizit fest. Wählen Sie pro Person eine Quelle und wenden Sie sie konsequent an.

Schritt 5: Nachrichten auf Sprache und Land ausrichten

  1. Erstellen Sie Segments mit den Filtern Sprache und Land statt mit einem kombinierten Gebietsschema-Attribut.
  2. Für Nachrichten, die innerhalb einer Sprache nach Region variieren, filtern Sie nach beiden Attributen – zum Beispiel language ist es und country ist ES.
  3. Um eine Nachricht zu versenden, die je nach Gebietsschema dargestellt wird, fügen Sie Gebietsschemata hinzu, indem Sie die Standardattribute für Sprache und Land verwenden. Lesen Sie anschließend Mehrsprachige Nachrichten.
  4. Wenn Sie ein market-Attribut für regionale Inhalte beibehalten, fügen Sie ein Gebietsschema auf Basis angepasster Attribute hinzu, statt dieses Attribut einer Sprache zuzuordnen.

Schritt 6: Von einem marktbasierten Sprachmodell migrieren

  1. Durchsuchen Sie Ihren Workspace nach Campaigns, Canvases, Segments und Content Blocks, die auf das Attribut market verweisen.
  2. Füllen Sie language für bestehende Profile per CSV-Import oder über die API nach, wenn Sie die Präferenz der jeweiligen Person bereits kennen.
  3. Aktualisieren Sie Assets so, dass sie nach Sprache filtern, und behalten Sie das Attribut market nur dort bei, wo Inhalte nach Region variieren.
  4. Prüfen Sie mit Nachricht als Nutzer:in in der Vorschau anzeigen, ob jedes Gebietsschema wie erwartet dargestellt wird, bevor Sie das alte Attribut außer Betrieb nehmen.
New Stuff!