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

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

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シリアライズされた文字列が生成されます。

注

メールエクストラはメールサービスプロバイダー（ESP）にメタデータを送信するもので、CurrentsやSnowflakeには公開されません。CurrentsやSnowflakeの送信イベントにメタデータやダイナミックな値を追加するには、message_extras Liquidタグを使用してください。

メッセージエクストラデータがCurrentsを使用して送信される仕組み

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

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

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

message_extrasタグの使い方

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

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

3. キャンペーンまたはキャンバスが送信された後、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でクエリできます。詳細については、ディスパッチIDの動作を参照してください。

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

はい、ユーザーのデバイスが以下の最小SDKバージョン以上であれば、アプリ内メッセージでmessage_extrasを使用できます。