Lokalisierte E-Mail-Vorlagen
PlayFab führt Unterstützung für das Speichern lokalisierter Zeichenfolgen im Auftrag von Spieleentwicklern ein. Darüber hinaus fügen wir die erforderliche Logik hinzu, um Ihren Spielern die richtigen Zeichenfolgen für die von ihnen bevorzugte Sprache bereitzustellen.
In diesem Tutorial erfahren Sie, wie Sie lokalisierte E-Mail-Vorlagen verwenden. Mit lokalisierten E-Mail-Vorlagen können Sie mehrere übersetzte Versionen einer E-Mail erstellen und alle mit einer Vorlagen-ID zuordnen.
Notiz
Alle Vorlagen, die vor der Veröffentlichung dieses Features eingeführt wurden, behalten ihr Verhalten bei. Sie können sie jedoch problemlos aktualisieren, um das neue lokalisierte Format zu verwenden, das von neuen E-Mail-Vorlagen verwendet wird.
Voraussetzungen
Dies ist ein erweitertes Tutorial. Stellen Sie sicher, dass alle Anforderungen erfüllt wurden. Andernfalls können Sie dieses Tutorial nicht abschließen.
- Eine Einführung in E-Mail-Vorlagen finden Sie im Tutorial Verwenden von Email Vorlagen zum Senden einer Kontowiederherstellung Email.
- Lesen Sie die Informationen zum Arbeiten mit Standardsprachen für Ihren Titel und die bevorzugten Sprachen für Ihre Spieler im Tutorial Festlegen von Standardsprachen . Sie müssen eine Standardsprache für Titel festgelegt haben, um mit lokalisierten E-Mail-Vorlagen fortzufahren.
Aktualisieren einer vorhandenen E-Mail-Vorlage
Zunächst aktualisieren wir die vorhandene E-Mail-Vorlage für die Kontowiederherstellung, die wir im oben erwähnten Tutorial Verwenden von Email Vorlagen zum Senden einer Kontowiederherstellung Email erstellt haben.
- Wählen Sie im Menü auf der linken Seite Inhalt aus.
- Wechseln Sie zur Registerkarte Email Vorlagen.
- Wechseln Sie zum Feld Vorlagenname , und wählen Sie die Vorlage Kontowiederherstellung aus.
Für dieses Tutorial wird davon ausgegangen, dass Ihre Titel-Standardsprache Englisch ist. Sie sehen, dass Ihre vorhandene Version der Vorlage als Standardsprachversion angezeigt wird.
Das Hinzufügen weiterer Sprachen ist so einfach wie das Auswählen des bereitgestellten Links + SPRACHE hinzufügen , das Anschließende Auswählen der Sprache, die Sie der Vorlage hinzufügen möchten, und das Eingeben der lokalisierten Zeichenfolgen.
In diesem Beispiel fügen wir der vorhandenen Vorlage die folgenden französischen Zeichenfolgen hinzu.
Französischer E-Mail-Betreff:
Réinitialisation du mot de passe demandée
Französischer E-Mail-Text:
<head></head>
<body><p>Vous avez récemment demandé un mot de passe avec nous. </p>
<p>Cliquez <a href="$ConfirmationUrl$">ici</a> s'il vous plaît pour être dirigé vers une page pour réinitialiser votre mot de passe.
Es sollte wie folgt aussehen:
Wenn Sie die Schaltfläche E-Mail-Vorlage speichern auswählen, werden Sie zurück zu der Seite weitergeleitet, die die Liste Ihrer E-Mail-Vorlagen enthält.
Wie Sie sehen können, wurde eine neue Sprachversion hinzugefügt, aber keine neue Vorlage hinzugefügt, da alle Sprachversionen unter derselben Vorlagen-ID gespeichert werden.
Senden lokalisierter E-Mails
Als Nächstes senden wir unsere neue lokalisierte Version der E-Mail. Wie im Tutorial Zum Festlegen von Standardsprachen erwähnt, führt PlayFab die umfangreichen Schritte aus, um die unterstützten Sprachen Ihres Titels mit der bevorzugten Sprache Ihrer Spieler abzugleichen. Alles, was Sie tun müssen, ist uns mitzuteilen, dass die E-Mail gesendet werden soll.
Um dieses Verhalten zu überprüfen, erstellen Sie zwei Testplayer.
Lassen Sie einen der neuen Spieler ohne bevorzugte Sprache. Dadurch wird veranschaulicht, wie PlayFab auf die Standardeinstellung des Titels zurückfällt, wenn keine Sprache angegeben ist oder wenn keine Übereinstimmung zwischen der Sprache des Titels und der Sprache des Spielers besteht.
Legen Sie die Sprache des anderen neuen Spielers mithilfe von Game Manager oder mithilfe der SetProfileLanguage-API fest. In diesem Beispiel haben wir Französisch verwendet.
Notiz
Bei Verwendung der SetProfileLanguage
API muss die Sprachzeichenfolge im ISO 639-1-Format angegeben werden (z. B. "en", "es" oder "ja"). Zum aktuellen Zeitpunkt wird der Code "zh" nicht unterstützt.
Stellen Sie sicher, dass Sie die Kontakt-E-Mail für beide Spieler festgelegt haben, wie in Schritt 2 des Tutorials Verwenden von Email-Vorlagen zum Senden einer Kontowiederherstellung Email erläutert, bevor Sie mit dem nächsten Schritt fortfahren.
Verwenden Sie die SendCustomAccountRecoveryEmail-API einmal pro Player, um diese Vorlage zu senden:
- Einmal in Französisch für den Spieler, dessen bevorzugte Sprache Französisch ist.
- Einmal in der Standardsprache für einen Spieler, der keine bevorzugte Sprache festgelegt hat.
Unten wird eine Beispiel-E-Mail an den Spieler ohne bevorzugte Sprache gezeigt.
Unten sehen Sie eine Beispiel-E-Mail an den Spieler, dessen bevorzugte Sprache Französisch ist .
Abschluss
Wie Sie sehen können, hat PlayFab festgestellt, dass es eine Übereinstimmung zwischen der Unterstützung Ihrer Vorlage für Französisch und der Sprachpräferenz des Spielers gab.
Wenn es keine Übereinstimmung oder keine Einstellung gab, hat der Spieler die Standardsprachzeichenfolgen Ihres Titels erhalten.
Wenn Sie Fragen oder Feedback zu diesem Tutorial haben, kontaktieren Sie uns bitte über unsere Foren oder unseren Slack-Kanal.