コンテキスト

コンテキストステップを使用すると、ユーザーがキャンバスを進む際に、1つ以上の変数を作成・更新できます。たとえば、季節割引を管理するキャンバスがある場合、コンテキスト変数を使用して、ユーザーがキャンバスに入るたびに異なる割引コードを保存できます。

仕組み

コンテキストステップを使用すると、特定のキャンバスにおけるユーザーのジャーニー中に一時的なデータを作成して使用できます。このデータはそのキャンバスジャーニー内にのみ存在し、異なるキャンバスやセッション外には保持されません。

コンテキスト変数は、その特定のキャンバスジャーニーにのみ存在します。ユーザーのプロファイルを永続的に変更することはなく、他のキャンバスにも表示されません。そのため、特定のキャンペーンやワークフローにのみ関連する一時的な情報に最適です。

コンテキストステップ内では、最大10個のコンテキスト変数を定義または更新できます。これらの変数は、遅延のパーソナライズ、ユーザーのダイナミックなセグメント化、キャンバス全体でのメッセージングの充実に使用できます。たとえば、ユーザーの予定フライト時刻のコンテキスト変数を作成し、それを使用してパーソナライズされた遅延を設定してリマインダーを送信できます。

コンテキスト変数は2つの方法で設定できます：

• キャンバスエントリ時：カスタムイベントまたはAPIトリガーからのプロパティが、コンテキスト変数として自動的に入力されます。
• コンテキストステップ内：コンテキストステップを追加して、コンテキスト変数を手動で定義または更新します。

各コンテキスト変数には、名前、データタイプ、および値（Liquidまたはパーソナライゼーションの追加ツールを使用して設定）が必要です。定義すると、{{context.${flight_time}}}のようにLiquidを使用してキャンバス全体でコンテキスト変数を参照できます。コンテキスト変数名フィールドでは、コンテキスト変数名を入力するか、ステップエディターのドロップダウンから選択することもできます。詳細については、コンテキスト変数リファレンスを参照してください。

キャンバスへのエントリごとに、最新のエントリデータとキャンバス設定に基づいてコンテキスト変数が再定義されるため、ユーザーはそれぞれ独自のコンテキストを持つ複数のアクティブなジャーニーを持つことができます。たとえば、顧客に2つの今後のフライトがある場合、2つの別々のジャーニー状態が同時に実行されます—それぞれが出発時刻や目的地などの独自のフライト固有のコンテキスト変数を持ちます。これにより、ニューヨーク行きの午後2時のフライトに関するパーソナライズされたリマインダーを送信しながら、明日のロサンゼルス行きの午前8時のフライトに関する別の更新を送信でき、各メッセージが特定の予約に関連したものになります。

ユーザー処理とバッチ処理

コンテキストステップは、パフォーマンスを最適化するためにユーザーをバッチで処理します。ユーザーがコンテキストステップに入ると、Brazeはデフォルトで1,000ユーザーのバッチで処理します。これらのバッチは並列で処理されますが、各バッチ内ではユーザーは順次処理されます。

つまり：

例：3,500人のユーザーが、ユーザーあたり650msかかるコネクテッドコンテンツを含むコンテキストステップに入った場合：

• Brazeは4つのバッチを作成します（この例では1,000、1,000、1,000、500ユーザー）。
• 各バッチはユーザーを順次処理するため、1,000ユーザーのバッチは約10.8分（650秒、1,000 × 650ms）かかります。
• バッチは異なるタイミングで完了するため、バッチが完了するにつれてユーザーは次のステップに順次進みます。
• バッチサイズとコネクテッドコンテンツの応答時間に応じて、最初のユーザーは最後のユーザーよりも数分早く次のステップに到達する場合があります。

コネクテッドコンテンツがない場合、外部APIコールを待つ必要がないため、コンテキストステップの処理ははるかに高速になります。

考慮事項

• コンテキストステップごとに最大10個のコンテキスト変数を定義できます。
• 各変数にはユニークな名前が必要です（文字、数字、アンダースコアのみ、最大100文字）。
• ステップ内のすべての変数の合計サイズは50 KBを超えることはできません。
• APIトリガーで渡された変数は、コンテキストステップで作成された変数と同じ名前空間を共有します。コンテキストステップで変数を再定義すると、API値が上書きされます。

詳細と高度な使用方法については、コンテキスト変数リファレンスを参照してください。

コンテキストステップの作成

ステップ 1: ステップを追加する

キャンバスにステップを追加し、サイドバーからコンポーネントをドラッグ＆ドロップするか、プラスボタンを選択してコンテキストを選択します。

ステップ 2: 変数を定義する

コンテキスト変数を定義するには：

1. コンテキスト変数に名前を付けます。
2. データタイプを選択します。
3. Liquid式を手動で記述するか、パーソナライゼーションの追加を使用して既存の属性からLiquidスニペットを作成します。
4. プレビューを選択して、コンテキスト変数の値を確認します。
5. （オプション）追加の変数を追加するには、コンテキスト変数を追加を選択してステップ1〜4を繰り返します。
6. 完了したら、完了を選択します。

これで、メッセージステップやユーザーの更新ステップなど、Liquidを使用するあらゆる場所でパーソナライゼーションの追加を選択してコンテキスト変数を使用できます。コンテキスト変数名フィールドでは、コンテキスト変数名を入力するか、ステップエディターのドロップダウンから選択することもできます。完全なウォークスルーについては、コンテキスト変数リファレンスを参照してください。

コンテキスト変数フィルター

オーディエンスパスおよび条件分岐ステップで、コンテキスト変数を使用してフィルターを作成できます。フィルターの設定、比較ロジック、高度な例については、コンテキスト変数リファレンスを参照してください。

ユーザーパスのプレビュー

メッセージが適切なオーディエンスに送信され、コンテキスト変数が期待どおりの結果に評価されることを確認するために、テストとユーザーパスのプレビューをお勧めします。

無効なコンテキスト変数を作成する一般的なシナリオに注意してください。ユーザーパスをプレビューすると、コンテキスト変数を使用したパーソナライズされた遅延ステップの結果や、ユーザーをコンテキスト変数に一致させるオーディエンスまたは条件分岐ステップの比較を確認できます。

コンテキスト変数が有効な場合、キャンバス全体で変数を参照できます。ただし、コンテキスト変数が正しく作成されなかった場合、キャンバスの後続のステップも正しく動作しません。たとえば、ユーザーに予約時間を割り当てるコンテキストステップを作成し、予約時間の値を過去の日付に設定した場合、メッセージステップのリマインダーメールは送信されません。

コネクテッドコンテンツの文字列をJSONに変換する

コンテキストステップでコネクテッドコンテンツコールを行う場合、コールから返されたJSONは一貫性とエラー防止のために文字列データタイプとして評価されます。この文字列をJSONに変換したい場合は、as_json_stringを使用して変換します。例：

1
2
{% connected_content http://example.com :save product %}
{{ product | as_json_string }}

トラブルシューティング

無効なコンテキスト変数

コンテキスト変数は以下の場合に無効とみなされます：

• 埋め込まれたコネクテッドコンテンツへのコールが失敗した場合。
• ランタイムでLiquid式がデータタイプに一致しない値または空（null）の値を返した場合。

たとえば、コンテキスト変数のデータタイプが数値であるにもかかわらず、Liquid式が文字列を返した場合、無効となります。

このような状況では：

• ユーザーは次のステップに進みます。
• キャンバスステップの分析では、これが「未更新」としてカウントされます。

トラブルシューティングの際は、「未更新」指標を監視して、コンテキスト変数が正しく更新されているか確認してください。コンテキスト変数が無効な場合、ユーザーはコンテキストステップを通過してキャンバスを続行できますが、後続のステップの条件を満たさない可能性があります。

各データタイプの設定例については、データタイプを参照してください。

コネクテッドコンテンツによる送信の遅延

バッチ内のすべてのユーザーが処理されてから、ユーザーが次に進みます。バッチ処理が完了すると、成功したユーザーは次のステップに進み、失敗したユーザーは別途リトライされます。成功したユーザーは、リトライが成功するのを待たずに先に進みます。

リトライ動作

キャンバスステップ（コンテキストステップを含む）では、Brazeは標準のコネクテッドコンテンツのリトライ動作ではなく、キャンバス固有のリトライメカニズムを使用します。コネクテッドコンテンツコールが失敗した場合：

• メッセージステップでは、コネクテッドコンテンツコールは最大5回リトライできます。
• その他すべてのステップでは、Brazeはエクスポネンシャルバックオフで約13回ステップをリトライします。

すべてのリトライが失敗した場合、ユーザーはキャンバスを退出します。

標準のコネクテッドコンテンツで使用される:retryタグは、キャンバスステップ内で行われるコネクテッドコンテンツコールには適用されません。キャンバスステップには、キャンバスワークフロー向けに最適化された独自のリトライロジックがあります。

コンテキストステップですべてのユーザーを処理するのにかかる時間は、以下に依存します：

• ステップに入るユーザー数
• コネクテッドコンテンツが使用されているかどうか（およびその応答時間）
• バッチサイズ（デフォルトはバッチあたり1,000ユーザー）

コネクテッドコンテンツのエンドポイントにレート制限がある場合、コンテキストステップは各バッチ内でユーザーを順次処理するため、レート制限を自然に尊重するのに役立ちます。ただし、複数のバッチは並列で処理されるため、エンドポイントが複数のバッチからの同時リクエストを処理できることを確認してください。

タイムゾーンの一貫性の標準化

キャンバスコンテキストの一般提供に伴い、アクションベースのキャンバスにおけるすべてのデフォルトのタイムスタンプイベントプロパティはUTCになります。この変更は、キャンバスステップやメッセージの編集時に、より予測可能で一貫性のある体験を確保するための広範な取り組みの一環です。この変更は、特定のキャンバスがコンテキストステップを使用しているかどうかに関係なく、すべてのアクションベースのキャンバスに影響します。

よくある質問

キャンバスコンテキストの一般提供以降、何が変わりましたか？

キャンバスコンテキストが一般提供されたことにより、以下の詳細が適用されます：

• アクションベースのキャンバスにおけるトリガーイベントプロパティのdatetimeタイプを持つすべてのタイムスタンプはUTCになります。
• この変更は、特定のキャンバスがコンテキストステップを使用しているかどうかに関係なく、すべてのアクションベースのキャンバスに影響します。

この変更の理由は何ですか？

この変更は、キャンバスステップやメッセージの編集時に、より予測可能で一貫性のある体験を作り出すための広範な取り組みの一環です。

APIトリガーまたはスケジュールされたキャンバスはこの変更の影響を受けますか？

いいえ。

この変更はキャンバスエントリプロパティに影響しますか？

はい、canvas_entry_propertyがアクションベースのキャンバスで使用されており、プロパティタイプがtimeの場合、canvas_entry_propertiesに影響します。すべての状況において、タイムスタンプを希望するタイムゾーンで表示するために、Liquidのtime_zoneフィルターを使用することをお勧めします。

以下はその方法の例です：

新しいタイムスタンプの動作がメッセージにどのように影響するかの実用的な例は何ですか？

メッセージステップに以下のコンテンツを含むアクションベースのキャンバスがあるとします：

1
Your appointment is scheduled for {{canvas_entry_properties.${appointment_time} | date: "%Y-%m-%d %l:%M %p"}}, we'll see you then!

これにより、以下のメッセージが生成されます：

1
Your appointment is scheduled for 2025-08-05 4:15 PM, we’ll see you then!

Liquidでタイムゾーンが指定されていないため、ここのタイムスタンプはUTCです。

タイムゾーンを明確に指定するには、Liquidのtime_zoneフィルターを次のように使用できます：

1
Your appointment is scheduled for {{canvas_entry_properties.${appointment_time} | time_zone: "America/Los_Angeles" | date: "%Y-%m-%d %l:%M %p"}}, we'll see you then!

これにより、以下のメッセージが生成されます：

1
Your appointment is scheduled for 2025-08-05 8:15 AM, we'll see you then!

Liquidで America/Los_Angeles タイムゾーンが指定されているため、ここのタイムスタンプはPSTです。

希望するタイムゾーンは、イベントプロパティのペイロードで送信し、Liquidロジックで使用することもできます：

1
2
3
4
{
  "appointment_time": "2025-08-05T08:15:30:250-0800"
  "user_timezone": "America/Los_Angeles"
}

コンテキスト変数はキャンバスエントリプロパティとどう異なりますか？

キャンバスエントリプロパティは、キャンバスコンテキスト変数として含まれます。つまり、Braze APIを使用してキャンバスエントリプロパティを送信し、Liquidスニペットでコンテキスト変数を使用するのと同様に、他のステップで参照できます。

1つのコンテキストステップ内で変数同士を参照できますか？

はい。コンテキストステップ内のすべての変数は順番に評価されるため、以下のようなコンテキスト変数を設定できます：

これは複数のコンテキストステップにまたがっても適用されます。たとえば、次のシーケンスを想像してください：

1. 最初のコンテキストステップで、値がjob_titleのJobInfoという変数を作成します。
2. メッセージステップが{{context.${JobInfo}}}を参照し、ユーザーにjob_titleを表示します。
3. その後、コンテキストステップがコンテキスト変数を更新し、JobInfoの値をjob_descriptionに変更します。
4. JobInfoを参照するすべての後続ステップは、更新された値job_descriptionを使用するようになります。

コンテキスト変数はキャンバス全体で最新の値を使用し、各更新はその変数を参照するすべての後続ステップに影響します。