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

message_extras Liquid タグを使用すると、コネクテッドコンテンツ、カタログ、カスタム属性（言語、国など）、キャンバスエントリプロパティ、その他のデータソースからのダイナミックなデータで送信イベントに注釈を付けることができます。

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

動的または追加のデータをCurrentsまたはSnowflake Data Sharing送信イベントに送信するには、適切なLiquidタグをメッセージ本文に挿入します。

以下はmessage_extrasの標準Liquidタグ形式の例です:

1
{% message_extras :key test :value 123 %}

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

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

message_extrasタグは、送信イベントを伴うすべてのメッセージタイプ、およびアプリ内メッセージインプレッションイベントに対応しています。インアプリメッセージでmessage_extrasを使用するには、特定の最低SDKバージョンを満たす必要があります。

使い方

1. チャネルのメッセージ本文にmessage_extras Liquidタグを入力します。または、パーソナライゼーションを追加モーダルを使用して、パーソナライゼーションタイプとしてメッセージエクストラを選択できます。
   
2. 各message_extrasタグのキーと値のペアを入力してください。
   
3. キャンペーンまたはキャンバスが送信された後、Brazeは送信時にダイナミックなデータをCurrentsまたはSnowflake Data Sharingの送信イベントを介してmessage_extrasフィールドに添付します。

構文の確認

それ以外の入力は、Currents または Snowflake に渡されない可能性があります。次のいずれかが含まれていないことを確認してください: あなたの構文または書式設定

• 存在しない、空の、または誤って入力された区切り文字
• 重複キー（Brazeは最初に見つかったキーと値のペアをデフォルトで送信します）
• キーや値が定義される前の余分なテキスト
• 順不同のキーと値
  • 例えば、{% message_extras :value 123 :key test %}

考慮事項

• キー値が1KBを超える場合、切り捨てられます。
• 空白は文字数にカウントされます。Brazeは前後の空白を省略します。
• 結果のJSONは文字列値のみを出力します。
• Liquid変数はキーまたは値として含めることができますが、Liquidタグは直接サポートされていません。
  • 例えば、{% assign value = '123' %} {% assign key = 'test' %} {% message_extras :key {{key}} :value {{value}} %}

よくある質問

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

dispatch_id が生成され、送信イベントに提供されます。これを使用して、特定のクリック、開封、または配信イベントに結び付けるための一意の識別子として使用できます。CurrentsまたはSnowflakeでこのフィールドを利用およびクエリできます。dispatch_id 行動 について詳しく学びます。

メッセージエクストラをアプリ内メッセージで使用できますか？

はい、ユーザーのデバイスが次の最小SDKバージョンにある限り、message_extrasをアプリ内メッセージで使用できます。