Skip to content

メッセージエクストラ Liquid タグ

message_extras Liquid タグを使用して、コネクテッドコンテンツ、カタログ、カスタム属性（言語、国など）、Canvasエントリプロパティ、またはその他のデータソースからのダイナミックなデータで送信イベントにアノテーションを付けます。

message_extras Liquid タグは、Currentsおよび Snowflake データ共有の対応する送信イベントにキーと値のペアを追加します。

ダイナミックなデータまたは追加データをCurrentsまたは Snowflake データ共有の送信イベントに返すには、メッセージ本文に適切な Liquid タグを挿入します。

以下は、message_extras の標準的な Liquid タグ形式の例です：

1

{% message_extras :key test :value 123 %}

これらのタグは、メッセージ本文のキーと値のペアに必要に応じて追加できます。ただし、すべてのキーと値の長さの合計は1,000バイト（1 KB）を超えないようにしてください。Currentsおよび Snowflake データ共有では、送信イベントに message_extras という新しいイベントフィールドが表示されます。これにより、1つのフィールドに JSON シリアライズされた文字列が生成されます。

Currentsを使用したメッセージエクストラデータの送信方法

メッセージエクストラは、送信時に付加されるキーと値のペアです。設定はチャネルによって異なります。メールの場合、ヘッダーを使用して追加されます。iOS プッシュの場合、プッシュペイロードに含まれます。サポートされているすべての送信イベントは、メッセージが送信されると、Currents（および Snowflake）で同じ message_extras フィールドを表示します。

サポートされているチャネル

message_extras タグは、送信イベントを持つすべてのメッセージタイプと、アプリ内メッセージのインプレッションイベントでサポートされています。アプリ内メッセージで message_extras を使用するには、特定の最小 SDK バージョンを満たす必要があります。

message_extras タグの使用方法

  1. チャネルのメッセージ本文に、message_extras Liquid タグを入力します。または、Add Personalization モーダルを使用して、パーソナライゼーションタイプとして Message Extras を選択することもできます。

パーソナライゼーションタイプとして Message Extras が選択された Add Personalization モーダル。

  1. 各 message_extras タグのキーと値のペアを入力します。

メッセージエクストラタグのキーと値のペアの例。タイトルフィールドには「Your New Favorites」と表示されています。メッセージにはメッセージエクストラタグのキーと値のペアと、次の文が表示されています：「We're excited to bring you a side selection of fresh and exciting products that are sure to become your new go-to favorites」

  1. CampaignまたはCanvasが送信された後、Brazeは送信時にCurrentsまたは Snowflake データ共有の送信イベントを通じて、ダイナミックなデータを message_extras フィールドに付加します。

構文の確認

上記のタグ標準に一致しないその他の入力は、Currentsまたは Snowflake に渡されない場合があります。構文やフォーマットに以下のいずれかが含まれていないことを確認してください：

  • 存在しない、空の、または誤入力されたデリミタ
  • 重複するキー（Brazeはデフォルトで最初に検出されたキーと値のペアを送信します）
  • キーまたは値が定義される前の余分なテキスト
  • 順序が正しくないキーと値
    • 例：{% message_extras :value 123 :key test %}

プロモーションコード情報をCurrentsに送信する

message_extrasとプロモーションコードを組み合わせることで、プロモーションコード情報をCurrentsに送信できます。captureタグを使用してプロモーションコードを変数に保存し、その変数をmessage_extrasで参照します。

1
2
3
4
5

{% capture code %}
{% promotion('puttshacktest2') %}
{% endcapture %}
Use {{code}} for an exclusive discount!
{% message_extras :key cardscode :value {{code}} %}

考慮事項

  • 1,000バイト（1 KB）を超えるキーと値は切り捨てられます。
  • 空白は文字数にカウントされます。Brazeは先頭と末尾の空白を省略することに注意してください。
  • 結果の JSON は文字列値のみを出力します。
  • Liquid 変数をキーまたは値として含めることができますが、message_extras 内に追加の Liquid タグをネストすることはできません。
    • 例えば、次の Liquid を使用できます：{% assign value = '123' %} {% assign key = 'test' %} {% message_extras :key {{key}} :value {{value}} %}

よくある質問

送信イベントの message_extras フィールドを、開封やクリックなどのエンゲージメントイベントに関連付けるにはどうすればよいですか？

dispatch_id が生成され、送信イベントに提供されます。これは、特定のクリック、開封、または配信イベントに紐付けるためのユニークな識別子として使用できます。このフィールドはCurrentsまたは Snowflake でクエリできます。詳しくは、Dispatch ID の動作をご覧ください。

アプリ内メッセージで message_extras を使用できますか？

はい、ユーザーのデバイスが以下の最小 SDK バージョンを満たしている限り、アプリ内メッセージで message_extras を使用できます：
New Stuff!