Skip to content

コンテキストとイベントのプロパティ

この記事では、context と event_properties について、それぞれのプロパティを使用するタイミングや動作の違いなどを説明します。

カスタムイベントプロパティ全般については、「カスタムイベントプロパティ」を参照してください。

コンテキストプロパティとイベントプロパティは、キャンバスワークフロー内では機能が異なります。ユーザーがキャンバスに入るトリガーとなるイベントや API 呼び出しのプロパティは、context と呼ばれます。キャンバスジャーニー内でユーザーが移動するときに発生するイベントのプロパティーは、event_properties と呼ばれます。ここでの重要な違いは、context は、API でトリガーされるキャンバスのエントリペイロードのプロパティにもアクセスすることにより、イベント以上のものに焦点を当てていることです。

コンテキストとイベントのプロパティの違いについては、次の表を参照してください。

Original Canvas editor details

元のエディターを使用したキャンバスの作成や複製はできなくなりました。Canvas コンテキストは元のCanvas エディタではサポートされていないため、このセクションは、以前のCanvas ワークフローでCanvas エントリプロパティおよびイベントプロパティを使用する場合に参考にできます。

キャンバスエントリのプロパティ:

  • 永続エントリプロパティがオンになっている必要があります。
  • キャンバスの最初のフルステップでのみ canvas_entry_properties を参照できます。キャンバスは、アクションベースまたは API トリガ－でなければなりません。

エントリプロパティ:

  • キャンバスでアクションベースの配信を使用する任意のフルステップで event_properties を参照できます。
  • アクションベースのキャンバスの最初の完全なステップ以外のスケジュールされた完全なステップでは使用できません。ただし、ユーザーがCanvas コンポーネント を使用している場合、ビヘイビアはevent_properties の現行のキャンバスワークフロールールに従います。

イベントプロパティ:

  • リードメッセージステップでevent_properties を使用できません。代わりに、canvas_entry_properties を使用するか、event_properties を含むメッセージステップの前に、対応するイベントを持つアクションパスステップを追加する必要があります。

知っておくべきこと

  • コンテキストは、Liquid でのみ参照できます。キャンバス内のプロパティをフィルタリングするには、代わりにイベントプロパティのセグメンテーションを使用します。
  • アプリ内メッセージ チャネルs では、キャンバス内のcontext およびevent_properties を参照できます。event_properties は、最初のキャンバスステップにトリガーベースであるため、アクセスできます。
  • event_properties は先頭のメッセージステップで使用できません。代わりに、context を使用するか、対応するイベントbefore でevent_properties を含むメッセージステップにアクションパスステップを追加できます。
  • アクションパスステップに [SMS インバウンドメッセージを送信しました] または [WhatsApp インバウンドメッセージを送信しました] トリガーが含まれている場合、後続のキャンバスステップに SMS または WhatsApp Liquid プロパティを含めることができます。これは、キャンバスでのイベントプロパティの動作を反映します。こうすることで、メッセージを活用して、ユーザープロファイルや会話メッセージに関するファーストパーティデータを保存し、参照することができる。

トリガーのタイムスタンプ

datetime type のタイムスタンプを使用している場合、context を使用して参照されるトリガー アクション ベースのキャンバスのイベントからタイムスタンプが正規化されます。

この動作を考慮して、Braze は、メッセージが preferred timezone とともに送信されることを保証するために、次の例のような Liquid タイムゾーンフィルタを使用することを強くお勧めします。

1

{{context.${timestamp_property} | time_zone: "America/Los_Angeles" | date: "%H:%M" }}

例外

  • キャンバスの最初のステップがメッセージステップの場合、タイムスタンプはUTCに正規化されません。
  • タイムスタンプは、キャンバス内の順序に関係なく、アプリ内メッセージチャネルを使用するメッセージステップではUTCに正規化されません。

ユースケース

行動パス ステップの後に、ウィッシュリストに項目を追加したユーザーの遅延ステップとメッセージステップ、および他のすべてのユーザのパスが続きます。

context とevent_properties の違いをさらに理解するために、ユーザーがカスタムイベント &quot を実行する場合にアクション ベースのキャンバスを入力し、wishlist” に項目を追加するこのシナリオを考えてみましょう。

コンテキストは、キャンバスを作成する入力スケジュールステップで設定され、ユーザーがキャンバスに入ったときに対応します。コンテキストは、どのメッセージステップでも参照できます。

このキャンバスには、ユーザーがウィッシュリストにアイテムを追加したかどうかを判断するアクションパスのステップから始まるユーザージャーニーがあります。ここから、ユーザーがアイテムを追加した場合、メッセージステップからメッセージ”wishlist!”の新規アイテムを受信するまでに遅延が発生します。

アクションパスステップから、ユーザージャーニーの最初のメッセージステップがカスタムevent_properties にアクセスできます。この場合、このメッセージステップにメッセージ内容の一部として {{event_properties.${property_name}}} を含めることができます。ユーザーがウィッシュリストに項目を追加しない場合、Everyone Else パスを経由します。つまり、event_properties は参照できず、不正な設定 s エラーが反映されます。

なお、event_properties にアクセスできるのは、メッセージステップが、アクションパスステップの「その他のユーザー」以外のパスに遡ることができる場合のみです。Message ステップがEveryone Else パスに接続されているが、ユーザージャーニーのAction パス s ステップに遡ることができる場合でも、event_properties にアクセスできます。これらの動作の詳細については、メッセージステップを参照してください。
Github   GitHub でこのページを編集
New Stuff!