Sendgrid-nodejs: 多言語サポートのためにテンプレートバージョンを利用する方法

こんにちは@ ifndefdeadmau5 、

ここではこの機能のAPIドキュメントです。 ここではそのAPI呼び出しを行うために、このSDKを使用する方法です。

お役に立てば幸いです。

敬具、

エルマー

@thinkingseriousに戻ってきてくれて

「特定のテンプレートバージョンをアクティブ化する」を実際にどのように使用できるかはまだわかりません。
私は、英語とスペイン語など、2つ以上の言語で書かれた2つのバージョンのテンプレートがあるというシナリオを考えていました。

次に、ユーザーの言語と一致する特定のテンプレートバージョンを使用してメッセージ送信API呼び出しを行います

export function sendSendGridEmail()
{
  sgMail.setApiKey(config.get('sendgrid.API_KEY'));
  sgMail.setSubstitutionWrappers('{{', '}}');
  const msg = {
    to: '[email protected]',
    from: '[email protected]',
    subject: 'Sending with SendGrid is Fun',
    text: 'and easy to do anywhere, even with Node.js',
    html: '<strong>and easy to do anywhere, even with Node.js</strong>',
    templateId: isUserLocaleEnglish ? ENGLISH_TEMPLATE_ID : SPANISH_TEMPLATE_ID, // This line!
    substitutions: {
      name: 'Some One',
      city: 'Denver',
    },
  };
  sgMail.send(msg);
}

ただし、上記の例では、異なるバージョンの1つのテンプレートではなく、2つの別個のテンプレートが必要です。 これにより、個別のテンプレートが生成される可能性がありますが、コンテンツは関連しています。
ここで何が欠けていますか？ 教えてください。
よろしくお願いいたします。ご連絡をお待ちしております。

こんにちは@ ifndefdeadmau5 、

テンプレートごとに複数のバージョンを持つことができます。 次に、SDKを使用して特定のバージョンをアクティブ化できます。

まず、テンプレートの複数のバージョンを作成します。 次に、上記の呼び出しを行う前に、目的のバージョンをアクティブ化します。

敬具、

エルマー

おはよう@thinkingserious 、

迅速な対応に感謝しますが、そのような回避策は想像できません。
これでその方法は理解できましたが、1つの質問は、最初にすべてのテンプレートバージョンをアクティブ化してから、ユーザーがアクティブ化/非アクティブ化を気にせずに使用できるようにすることです。

私の懸念は、異なる言語を使用している2人以上のユーザーが同時に（まったく同じ）いくつかのアクションを実行する場合、サーバーが2つのリクエストに同時に対処する必要がある場合はどうなるかということです。 次に、どのテンプレートバージョンがアクティブ化されますか？

以下はサーバーコードの一部で、私の状況をお知らせします

export async function sendSendGridEmail() {
  const locale = 'ko';
  const isEnglishUser = locale === 'en';
  const PASSWORD_RESET_TEMPLATE_ID = '2096abb7-a9f8-413f-96a1-b9df0644b313';

  const { versions } = await getTemplate(PASSWORD_RESET_TEMPLATE_ID);
  const KO_VER = _.find(versions, { name: 'Korean' }).id;
  const EN_VER = _.find(versions, { name: 'English' }).id;

  await activateVersion(PASSWORD_RESET_TEMPLATE_ID, isEnglishUser ? EN_VER : KO_VER);

  sgMail.setSubstitutionWrappers('{{', '}}');
  const msg = {
    to: '[email protected]',
    from: '[email protected]',
    templateId: PASSWORD_RESET_TEMPLATE_ID,
    substitutions: {
      username: 'Test Username',
    },
  };
  sgMail.send(msg);
}

こんにちは@ ifndefdeadmau5 、

それは有効な懸念事項です。

本当に必要なのは、新しい（ベータ版の）テンプレートシステムのようです。 ベータ版に参加するには、 ben @ sendgrid.comにメールでお。

敬具、

エルマー

こんにちは@thinkingserious 、

メールで[email protected]にリクエストし

また、トランザクションテンプレートを調べて、ロケール固有のさまざまな電子メールにテンプレートバージョンを使用する方法を確認しました。
同意します。使用する前に特定のテンプレートバージョンをアクティブ化する必要があるのは奇妙に思えます。 これは、トランザクションの多いソフトウェアに最適なソリューションではありません。 POST /mail/sendリクエストで使用するバージョンを指定できると思います。

ねえ@ andyblack19
導入した新しいテンプレートでバージョン管理する必要はありません。 アカウントに、「トランザクション」テンプレートのオプションが表示されます。 そこで、多くの言語に対応する1つのテンプレートを作成できます。 こちらのドキュメントとご覧ください。

私はそのページを読みました..しかし、多言語セクションを完全に見逃しました！ ご協力いただきありがとうございます

上記のハンドルバー戦略では、「デザインエディター」モードのテンプレートを使用できないようです。 少なくとも2つの異なる言語で異なるユースケースの複数のテンプレートが必要な場合、一般的なレイアウトが変更されたときに、テンプレートコードを各テンプレートにコピーして貼り付けることになっていますか？ トップレベルの共有可能なレイアウトを作成する方法がないのはなぜですか？

また、各言語のテンプレート本文をすでに設定しているテンプレートコンテンツではなく、サーバー側で電子メールの件名をローカライズする必要があるように思われますか？ このように主題と身体を分離することは意味がありません。 それとも私は何かを見落としましたか？

こんにちは@raine

上記のハンドルバー戦略では、「デザインエディター」モードのテンプレートを使用できないようです。

ここにある言語テンプレートの特定のデザインは、「デザインエディター」モードで動作するように設計されていません。 コードモジュールを使用して、「デザインエディタ」で同様のものを作成することもできます。

少なくとも2つの異なる言語で異なるユースケースの複数のテンプレートが必要な場合、一般的なレイアウトが変更されたときに、テンプレートコードを各テンプレートにコピーして貼り付けることになっていますか？ トップレベルの共有可能なレイアウトを作成する方法がないのはなぜですか？

これは実際に私たちのエンジニアに持ち込まれたものです。 アカウントにログインしているときにフィードバックボタンを使用して、これが必要であることをエンジニアに知らせることをお勧めします。 そのようなフィードバックを送信する人が多いほど、そのような改善が見られる可能性が高くなります。 フィードバックボタンは、コードライブラリ以外のことに関して、エンジニアに直接フィードバックを得る最良の方法の1つです。 私は個人的にあなたが探しているものに似たものに投票しました。

また、各言語のテンプレート本文をすでに設定しているテンプレートコンテンツではなく、サーバー側で電子メールの件名をローカライズする必要があるように思われますか？ このように主題と身体を分離することは意味がありません。 それとも私は何かを見落としましたか？

あなたは何かを見落としていると思います。 私自身の個人的なテストから、ハンドルバーがテンプレートの件名を設定する際に機能することがわかっています。 私はあなたの言葉遣いを正しく理解していないかもしれませんが。 件名がこれをサポートするように視覚的に設計されていないことはわかっているので、テキストエディタなどでコードとコンテンツを作成し、後で件名フィールドに貼り付けるのが最善です。 これは、フィードバックボタンの使用が推奨されるもう1つの領域です。 これを行うためのより良い方法だと思うことを自由に提案してください。

私が間違えたものはすべて訂正し、理解を深めるために詳細を教えてください。

カイル

複数の言語の例では、電子メールの件名の翻訳にどのように対応していますか？

@esiqveland

テンプレートの件名には、次のようなものを使用します。

{{#if english}}
Hello
{{else if spanish}}
Hola
{{else if french}}
Bonjour
{{/if}}

基本的に、HTMLコンテンツと同じ構造を使用します。 ご不明な点がございましたら、お気軽にお問い合わせください。

こんにちは@kylearoberts 、条件付きの変数値をチェックする方法はありますか？ したがって、 englishやspanishような複数の変数をチェックする代わりに、 language変数がenまたはesと等しいかどうかをチェックします。 これはテンプレート自体には大きな違いはありませんが、言語コード変数を動的テンプレートデータ内の特別な名前の変数に変換する必要があるバックエンドでは違いがあります。

ハンドルバーを簡単にチェックしましたが、デフォルトではサポートされていないようです。 ただし、SendGridにはカスタムヘルパーが組み込まれている可能性があります。

@tlinhart

素晴らしい質問をありがとう。 現在のところ、システムはそのようには機能しませんが、後でそのようなことを可能にする何かがあるでしょう。 このような変更を行う場合、トランザクションテンプレートの使用方法に関するドキュメントと例を更新する可能性があります。

こんにちは、
現在、多言語のメールに新しいテンプレートシステムを使用しています。 主な問題は、サブジェクトフィールドの長さが制限されていることです。 基本的に、私の主題の内容は次のようなものです。

{{#if英語}}
こんにちは何とか何とか...
{{スペイン語の場合はそうでない}}
こんにちは何とか何とか...
{{フランス語の場合はそれ以外}}
こんにちは何とか何とか...
{{/ if}}

しかし、いくつかの問題があります。

1. 件名フィールドの長さは、いくつかの言語以上では十分ではありません。 制限内にとどまるために、テキストと変数名を削減する必要がありました。 しかし、新しい言語を追加する必要がある場合、これは明らかに機能しません。
2. エディタには、テンプレートサブジェクトの操作に適さないサブジェクトを入力するための1行のフィールドが表示されます。
3. エディターの件名フィールドは、貼り付けから入力されたテキストを喜んで削減します。 テンプレートスクリプトコードが削除されたために構文が間違っているため、これはテンプレートエラーにつながります

@bragma

私はあなたと同じ問題に遭遇しました。 これを聞いたのもこれが初めてではありません。 製品の改善に役立つため、このようなフィードバックを得るのが大好きです。 エンジニアリングチームにフィードバックをお寄せください。これは、エンジニアリングチームが改善したいと考えている分野の1つです。 彼らが改善に取り組む機会を得たとき、これはそれらの1つである可能性が高いです。 フィードバックありがとうございます。

@ thinkingserious + 1ローカリゼーション機能が必要です

@thinkingseriousこの機能の巨大な+1。
同じテンプレート内で電子メールのすべての言語を処理できるという本当に素晴らしい機能ですが、前述のように、件名の制限のために使用できません。

この機能の@thinkingseriousメガ+

以下はさらに良いでしょう：

1-デフォルトバージョンを設定する機能（バージョンが選択されていない場合、または無効なバージョンが提供されている場合、デフォルトバージョンが引き継ぎます）
2-バージョンを追加するためにPOST /mail/send APIに追加のパラメーターを追加するだけです

私たちは12以上の言語とカウントを備えたプラットフォームを持っているので（はい、私たちは挑戦が好きです）、異なる言語の特定のマーケティング担当者が必要です。彼らはそれほど単純なテンプレートをコーディングしません。 また、大量のユーザーを計画しているため、最初に必要なテンプレートをアクティブに設定してからメールを送信すると、間違ったテンプレートが選択される同時実行の問題が発生します。

本当にありがとう、

この問題に貢献してくれた皆さん、こんにちは。

SendGridを使用して送信されたメールのローカライズ/翻訳の問題を解決するための最善の方法を理解するために、お客様といくつかの調査を行っています。 時間があれば、これを正しく構築する方法を検討する際に、フィードバックをお待ちしています。

今日の翻訳とローカリゼーションの処理方法について、私と私のチームと話すスロットにサインアップするためのリンクは次のとおりです： https ：

どうもありがとうございました！

@ ben-gridはカレンダーをチェックしたばかりですが、時間がうまくいかないので、何が素晴らしいかについて簡単に説明します。

サンドボックスと本番アカウントを備えたeコマースシステムがあります。 そして、テンプレートを承認すると、それを本番環境にエクスポートしてインポートします（これは、プロモーションパイプラインを備えたサンドボックスと本番環境のテンプレートがあるため、すばらしい機能でもあります）

とにかく...現在2つの言語がありますが、当面のタスクは5つの言語に移行することです。 現在、11個のテンプレートがあります。 私たちが今していることは{{iflang.en}}こんにちは{{else}} Hallo {{/ if}}これだけが5つの言語（近い将来20の言語）で動作しないので、今から作成します言語ごとに個別のテンプレートを作成し、11ではなく55のテンプレートを作成します（ひどい）

なんて素晴らしいことでしょう！

オプション1：
APIに「バージョン」パラメータを追加し、提供されたバージョンを送信するだけです。 これで、少なくとも特定のバージョンを書記言語で送信できます（バージョンはテンプレートの翻訳バージョンである可能性があり、フォールバックがアクティブなバージョンになります）

オプション2
ローカライズされたパラメーターをテンプレートに追加します。 このように、パラメーターを翻訳するだけで、複数の言語のテンプレートを使用できます。 このアプローチの欠点は、一部の文の構成が各言語で機能しないことです。そのため、おそらくより柔軟に対応したいと考えています。

*オプション3金色の涙のユニコーン*
基本的に、ドロップインするモジュールごとに翻訳タブがあります。したがって、このようなモジュールを挿入すると、
このモジュールには複数のロケールがあります。 基本的に、異なる言語のオリジナルのクローン。 テンプレートの言語を設定できる必要があります（すべてのモジュールを件名とプリヘッダーを含む特定の言語に設定します）。モジュールがまだ入力されていない場合は、モジュールを赤に着色する可能性があります。

私の2セントだけです。これについてのフィードバックをお待ちしています。メールをご希望の場合は、 rene @ wetelilng.comまでご

@renewetelingどうもありがとう、それはとても役に立ちます。 私たちはおそらく1よりもオプション2と3に似たプロトタイプに取り組んでいます。フィードバックを得る価値のあるものがあれば、メールで連絡します。 ご意見ありがとうございます！

@renewetelingオプション1または2で

@ ben-grid＆@ a-tonchev大変な努力をありがとう！ 私にとっては、これはもう関係ありません。 良い仕事を続けてください！

これに関するニュースはありますか？ 件名の長さの制限は、件名もローカライズする必要があることを考えると問題です。新しいエディターでは、件名の長さがさらに短くなり、件名に約110文字を含めることができると思います。

IMO、より実用的な解決策は、すべてのテキストサーバー側を生成し、それをチャンク化された段落としてテンプレートに挿入することだと思われます。

企業が複数の言語をサポートしている場合、そのWebサイトには、サーバー側（XML /データベースから言語をロードする）である必要があるこれに対するソリューションがすでにあります。 私の意見では、同じプロジェクトに関連するすべての電子メールにも、これらの言語ファイルにテキストを保存する必要があります。

必要な段落/テキストは、ユーザーの言語に応じてこれらのファイルから取得し、テンプレート変数としてsendgridに渡すことができます。 Sendgridは単なる包括的なテンプレート（フッターなど-スタイルと画像のみ）であり、一部のスタイルでさえ、具体的にどの単語を太字にするかなど、言語ファイル自体に保持する必要があり

したがって、テンプレートは次のようになります。 subject HelloLine welcomeparagraph helpparagraph footerslogan 。 以上です。

IMO、より実用的な解決策は、すべてのテキストサーバー側を生成し、それをチャンク化された段落としてテンプレートに挿入することだと思われます。

企業が複数の言語をサポートしている場合、そのWebサイトには、サーバー側（XML /データベースから言語をロードする）である必要があるこれに対するソリューションがすでにあります。 私の意見では、同じプロジェクトに関連するすべての電子メールにも、これらの言語ファイルにテキストを保存する必要があります。

必要な段落/テキストは、ユーザーの言語に応じてこれらのファイルから取得し、テンプレート変数としてsendgridに渡すことができます。 Sendgridは単なる包括的なテンプレート（フッターなど-スタイルと画像のみ）であり、一部のスタイルでさえ、具体的にどの単語を太字にするかなど、言語ファイル自体に保持する必要があり

したがって、テンプレートは次のようになります。 subject HelloLine welcomeparagraph helpparagraph footerslogan 。 以上です。

コピーライティングを変更するたびにメールサービスを再デプロイする必要があるため、これは管理できません。 また、一部の企業では、メールの内容は開発者の責任ではなく、マーケティング/コピーライターの責任です。 それを編集できるようにするには、別のUIを再デプロイする必要がありますが、それでもSendgridに支払います。

1つのプロジェクトでは、ヘッドレスCMSを使用して、各言語の電子メールテンプレートを編集および作成します。 サーバーは実行時にこれらの口ひげテンプレートを読み取り、Sendgridに送信される電子メール本文を生成します。 Sendgridテンプレート編集UXはまったく役に立たないので、これを使用することにしました。

@cecchisandronesendgridの方が良いかもしれないことに同意します。 彼らは適切な言語管理を追加し、それをパラメータにする必要があります。 しかし、私が言ったように、私たちがそれらに送信するいくつかの変数は、たとえば日付/時刻形式のように、とにかくローカライズする必要があります。

@ corneliu-gavriloviciが述べたように
今でも価値があります。 最近のアップデートでは、件名の長さがさらに短くなりました。 現在、使用している言語は2つだけで、以下の件名フィールドで使用しています。

{{#if english}}
Hello blah blah...
{{else if french}}
Hello blah blah...
{{/if}}

なぜこれが更新されたのかわかりませんが、私たちが使用できた製品は、この問題のために使用できなくなりました。 あなたは多言語テンプレートを扱う方法についてあなたのドキュメンテーションで話しますが、それは適切に使用できません。 @ ben-grid
https://sendgrid.com/docs/for-developers/sending-email/using-handlebars/#multiple -languages

IMO、より実用的な解決策は、すべてのテキストサーバー側を生成し、それをチャンク化された段落としてテンプレートに挿入することだと思われます。
..。
必要な段落/テキストは、ユーザーの言語に応じてこれらのファイルから取得し、テンプレート変数としてsendgridに渡すことができます。 Sendgridは単なる包括的なテンプレート（フッターなど-スタイルと画像のみ）であり、一部のスタイルでさえ、具体的にどの単語を太字にするかなど、言語ファイル自体に保持する必要があり

したがって、テンプレートは次のようになります。 subject HelloLine welcomeparagraph helpparagraph footerslogan 。 以上です。
サーバーサイドJSを使用してSalesForceでこれを実行しました。 jsonオブジェクトはテンプレート内にありますが、コンパイル中にサーバー上で実行されます。 これは、実際のローカリゼーション機能を備えていることに似ており、ecomm環境での開発公開に依存しません。
@ ben-gridが言及しているように、SGチームが何を思いついたのかを楽しみにしています。

+1ローカライズ機能。 複数の言語がある場合、それはいくつかの多くのif / elseで混乱します。