キャンバスの作成
このリファレンス記事では、キャンバスの作成、管理、テストに必要なステップについて説明します。このガイドに従うか、Braze Learningコースのキャンバスクイック概要をご確認ください。Brazeキャンバステンプレートから始めることで、セットアップを迅速に進めることもできます。詳細については、キャンバステンプレートを参照してください。自然言語の説明からキャンバスの下書きを作成するには、オペレーターにお問い合わせください。
元のキャンバスエディターの詳細を展開
元のキャンバスエクスペリエンスを使用してキャンバスを作成または複製することはできなくなりました。Brazeでは、最新のエディターにキャンバスをクローンすることを推奨しています。
ステップ1: 新しいキャンバスを設定する
まず、メッセージング > キャンバスに移動し、キャンバスを作成を選択します。
キャンバスビルダーが、キャンバスの名前付けからコンバージョンイベントの設定、カスタマージャーニーへのユーザーの誘導まで、キャンバスの設定を段階的にガイドします。以下の各タブを選択すると、各ビルダーステップで調整できる設定を確認できます。
ここでは、キャンバスの基本設定を行います。
- キャンバスに名前を付ける
- チームを追加する
- タグを追加する
- コンバージョンイベントを割り当て、イベントタイプとデッドラインを選択する
基本設定ステップの詳細をご覧ください。
ここでは、ユーザーがキャンバスにいつどのようにエントリするかを決定します。
- スケジュール配信：時間ベースのキャンバスエントリです
- アクションベース：ユーザーが定義されたアクションを実行した後にキャンバスにエントリします
- APIトリガー：APIリクエストを使用してユーザーをキャンバスにエントリさせます
エントリスケジュールステップの詳細をご覧ください。
ここでは、ターゲットオーディエンスを選択します。
- セグメントとフィルターを追加してオーディエンスを作成する
- キャンバスの再エントリとエントリ制限を微調整する
- ターゲットオーディエンスのサマリーを確認する
ターゲットオーディエンスステップの詳細をご覧ください。
ここでは、キャンバスを構築します。
キャンバスビルダーを使用してキャンバスを構築する方法をご覧ください。
ここでは、キャンバスの詳細のサマリーが表示されます。キャンバス承認ワークフローが有効になっている場合、起動前にリストされたキャンバスの詳細を承認できます。
ステップ1.1: キャンバスの基本設定から始める
ここでは、キャンバスに名前を付け、チームを割り当て、タグを作成または追加します。キャンバスのコンバージョンイベントも割り当てることができます。
コンバージョンイベントの選択
コンバージョンイベントのタイプを選択し、記録するコンバージョンを選択します。これらのコンバージョンイベントは、キャンバスの効率性を測定します。
キャンバスに複数のバリアントまたはコントロールグループがある場合、Brazeはこのコンバージョンイベントを使用して、このコンバージョン目標を達成するための最適なバリエーションを判定します。同じロジックを使用して、複数のコンバージョンイベントを作成できます。
ステップ1.2: キャンバスのエントリスケジュールを決定する
ユーザーがキャンバスにエントリする方法を3つの中から選択できます。
エントリスケジュールのタイプ
スケジュール配信では、キャンペーンをスケジュールするのと同様に、ユーザーが時間スケジュールに基づいてエントリします。キャンバスの起動と同時にユーザーを登録したり、将来のある時点でジャーニーにエントリさせたり、定期的（日次、週次、月次）にエントリさせたりすることができます。
月次の定期スケジュールを選択した場合、選択した日が存在しない月がある点にご注意ください。たとえば、キャンバスを毎月31日に送信するように設定した場合、4月31日は存在しないため、Brazeはその月の最終日（4月30日など）に送信します。
この例では、時間ベースのオプションに基づいて、ユーザーは2025年11月14日から2025年12月31日まで、毎週火曜日のローカルタイムゾーンの午後12時にこのキャンバスにエントリします。
ローカルタイムゾーン配信を使用する場合、Brazeはエントリ適格性を2回評価します。最初にスケジュールされた日のサモア時間（UTC+13）で、次にユーザーのローカルタイムで評価します。ユーザーがキャンバスにエントリするには、両方のチェックに適格である必要があります。エントリフィルターが相対的な時間ウィンドウ（たとえば「2日以上前」）を使用している場合、最初のチェックの時点で24時間が経過していない可能性があり、ユーザーが1日遅れてエントリすることがあります。これを避けるには、少なくとも2日以上のより広い時間ウィンドウを使用してください。詳細については、Brazeはローカルタイムゾーン配信でいつユーザーを評価しますか？をご覧ください。
アクションベース配信では、ユーザーがアプリを開く、購入する、カスタムイベントをトリガーするなどの特定のアクションを実行した際に、キャンバスにエントリしてメッセージの受信を開始します。
エントリオーディエンスウィンドウから、再適格性のルールやフリークエンシーキャップの設定など、キャンバスの動作の他の側面を制御できます。なお、アクションベース配信はアプリ内メッセージを含むキャンバスコンポーネントでは利用できません。
キャンバスステップとのインタラクションは、キャンバスのアクションベースのエントリトリガーとしては利用できません。キャンペーンのトリガーとしてのみ使用できます。あるキャンバスから別のキャンバスをトリガーするには、送信先キャンバスコンポーネントを使用するか、/canvas/trigger/sendエンドポイントを呼び出すBraze-to-Braze Webhookを作成してください。
アクションベースのキャンバスが予想より早くメッセージを送信する場合は、カスタムイベントのタイムスタンプがバックデートされた時刻ではなく現在の時刻で送信されていることを確認してください。たとえば、アクションベースのキャンバスがユーザーのカスタムイベント実行後に3時間の遅延を設定している場合、Brazeはカスタムイベントと一緒に送信されたタイムスタンプを使用してその遅延を評価します。タイムスタンプが3時間以上バックデートされている場合、Brazeは遅延がすでに経過したとみなし、メッセージを即座に送信します。
APIトリガー配信では、/canvas/trigger/sendエンドポイントを介してAPIを使用してユーザーが追加された後、キャンバスにエントリしてメッセージの受信を開始します。ダッシュボードでは、これを行うサンプルのcURLリクエストを確認できるほか、コンテキストオブジェクトを使用してオプションのcontextを割り当てることもできます。
APIトリガー配信では、以下のエンドポイントを使用できます。
配信方法を選択した後、ユースケースに合わせて設定を調整し、ターゲットオーディエンスの設定に進みます。
オリジナルエディターを使用するキャンバスの重複排除動作
再適格性のウィンドウがキャンバスの最大期間より短い場合、ユーザーは再エントリして複数のコンポーネントのメッセージを受信できます。ユーザーの再エントリが以前のエントリと同じコンポーネントに到達するエッジケースでは、Brazeはそのコンポーネントのメッセージを重複排除します。
ユーザーがキャンバスに再エントリし、以前のエントリと同じコンポーネントに到達し、各エントリのアプリ内メッセージに適格である場合、ユーザーはセッションを2回再開する限り、メッセージを2回受信します（アプリ内メッセージの優先度によります）。
ステップ1.3: ターゲットエントリオーディエンスを設定する
定義した条件に一致するユーザーのみがターゲットオーディエンスステップでジャーニーにエントリできます。つまり、Brazeはユーザーがキャンバスジャーニーにエントリする前にまずターゲットオーディエンスの適格性を評価します。たとえば、新規ユーザーをターゲットにしたい場合は、1週間以内に初めてアプリを使用したユーザーのセグメントを選択できます。
複数のアプリがあるワークスペースでは、キャンバスのエントリオーディエンスの適格性（セグメントとフィルターを含む）は、ユーザーがキャンバスにエントリした時点でのみ評価され、個々のメッセージステップでは評価されません。ワークスペースに複数のアプリがあり、メッセージステップが特定のアプリのユーザーのみをターゲットにする必要がある場合は、各メッセージステップで以下のいずれかの方法を使用してください。
- メッセージステップの配信バリデーションでメッセージ送信時にオーディエンスを検証を有効にし、アプリとWebサイトのターゲット設定が特定のアプリのユーザーに設定され、意図したアプリのみが選択されたセグメントを追加します。セグメントフィールドに追加し、追加フィルターのセグメントメンバーシップフィルターでは追加しないでください。アプリを持っているやアプリのフォアグラウンドプッシュが有効などのフィルターは、ユーザーをチェックするものであり、アプリを制限するものではないため、配信の制限にはなりません。
- Liquidを使用して、送信時にターゲットのデバイスまたはアプリを確認します。
これらの保護策がない場合、あるアプリでジャーニーに適格となったユーザーが、ワークスペース内の他のアプリも使用している場合、別のアプリ向けのメッセージを受信する可能性があります。
エントリコントロールでは、キャンバスがスケジュールされて実行されるたびにユーザー数を制限できます。APIトリガーベースおよびアクションベースのキャンバスの場合、この制限はUTC時間で毎時間適用されます。
オーディエンスのテスト
ターゲットオーディエンスにセグメントとフィルターを追加した後、ユーザーを検索して、オーディエンス条件に一致するかどうかを確認することで、オーディエンスが期待通りに設定されているかをテストできます。
エントリコントロールの選択
エントリコントロールは、ユーザーがキャンバスに再エントリできるかどうかを決定します。エントリスケジュールのタイプに応じて、選択したケイデンスでこのキャンバスに潜在的にエントリする人数を制限することもできます。
- スケジュール：キャンバスの全期間、またはキャンバスがスケジュールされるたび
- アクションベース：毎時、毎日、またはキャンバスの全期間
- APIトリガー：毎時、毎日、またはキャンバスの全期間
たとえば、スケジュールされたキャンバスがあり、エントリ数を制限を選択し、最大エントリ数フィールドを500,000ユーザーに設定し、制限ケイデンスをキャンバスがスケジュールされるたびにした場合、キャンバスはスケジュールされた送信ごとに500,000ユーザーにのみ送信します。
IPウォームアップにはキャンバスがスケジュールされるたびの選択は推奨しません。送信量の増加につながる可能性があるためです。
終了条件の設定
終了条件を設定すると、キャンバスから退出させたいユーザーを決定できます。ユーザーが例外イベントを実行したり、セグメントやフィルターに一致したりした場合、それ以降のメッセージは受信しなくなります。
ターゲット層の計算
ターゲット層セクションでは、選択したセグメントや追加フィルターなどのオーディエンスのサマリー、およびメッセージングチャネルごとのリーチ可能なユーザー数の内訳を確認できます。デフォルトの推定値ではなく、ターゲットオーディエンスのリーチ可能なユーザーの正確な数を計算するには、正確な統計を計算を選択してください。
以下の点にご注意ください。
- 正確な統計の計算には数分かかる場合があります。この機能は、フィルターやフィルターグループレベルではなく、セグメントレベルでのみ正確な統計を計算します。
- 正確な統計のロード中に、丸められた推定値が表示される場合があります。正確な数値はロード完了後にリーチ可能なユーザーセクションに表示されます。追加の統計情報を表示を選択すると、詳細な内訳を確認できます。
- 大規模なセグメントの場合、正確な統計を計算しても若干のばらつきが生じることがあります。この機能の精度は99.999%以上であることが期待されます。
ターゲットユーザーの平均生涯収益などの追加の統計を表示するには、追加の統計情報を表示を選択します。
ターゲットオーディエンス数がリーチ可能なユーザー数と異なる理由
キャンペーンまたはキャンバスに表示されるターゲット層のサイズは、セグメントの到達可能なオーディエンスサイズとは異なる場合があります。これは、そのセグメントを追加のフィルターなしでキャンペーンまたはキャンバスに直接追加している場合でも同様です。 これにはいくつかの理由が考えられます。
- グローバルコントロールグループがキャンペーンまたはキャンバスに適用されている場合、そのグローバルコントロールグループ内のユーザーは到達可能なユーザー数から除外されます。
- キャンペーンまたはキャンバスのターゲット層のサイズは、さまざまなメッセージチャネルを通じて連絡できないユーザーを除外します。この動作はチャネルごとに異なります。たとえば、キャンペーンまたはキャンバスの到達可能なオーディエンスでは、購読解除済み、スパムとしてマークされた（メールの場合）、またはハードバウンスした（メールの場合）ユーザーが除外されます。ただし、セグメント自体は、到達可能なメールユーザーの推定数を表示する際にオプトアウトのみを除外します。
- Brazeは選択した購読グループ内のユーザーにのみSMSメッセージを送信するため、キャンペーンまたはキャンバスのSMSターゲット層からは、選択した購読グループに含まれないユーザーも除外されます。
ステップ1.4: 送信設定を選択する
送信設定を選択して、購読設定の編集、レート制限の有効化、サイレント時間の有効化を行います。レート制限やフリークエンシーキャップを有効にすることで、ユーザーへのマーケティングプレッシャーを軽減し、過剰なメッセージ送信を防ぐことができます。
メールやプッシュチャネルをターゲットとするキャンバスの場合、明示的にオプトインしたユーザーのみにメッセージを送信するようキャンバスを制限したい場合があります（購読済みまたは購読解除済みのユーザーを除外します）。たとえば、オプトインステータスが異なる3人のユーザーがいるとします。
- ユーザーAはメールをサブスクライブしており、プッシュが有効です。このユーザーはメールを受信しませんが、プッシュを受信します。
- ユーザーBはメールにオプトインしていますが、プッシュが有効ではありません。このユーザーはメールを受信しますが、プッシュを受信しません。
- ユーザーCはメールにオプトインしており、プッシュが有効です。このユーザーはメールとプッシュの両方を受信します。
これを行うには、購読設定を「オプトインしたユーザーのみ」に送信するように設定します。このオプションにより、オプトインしたユーザーのみがメールを受信し、Brazeはデフォルトでプッシュが有効なユーザーにのみプッシュを送信します。
これらの購読設定はステップごとに適用されるため、エントリオーディエンスには影響しません。つまり、この設定は各キャンバスステップを受信するためのユーザーの適格性を評価するために使用されます。
この構成では、ターゲットオーディエンスステップにオーディエンスを単一のチャネルに限定するフィルター（たとえば Foreground Push Enabled = True や Email Subscription = Opted-In）を含めないでください。
キャンバスのサイレント時間（メッセージが送信されない時間帯）を指定することもできます。送信設定でサイレント時間を有効にするにチェックを入れてください。次に、ユーザーのローカルタイムでサイレント時間を選択し、メッセージを中止するか次に利用可能な時間に送信するかを選択します。
次に利用可能な時間に送信を選択すると、サイレント時間中はメッセージが抑制され、サイレント時間外の次に利用可能な時間に送信されます。たとえば、サイレント時間がユーザーのローカルタイムで午前11時30分から午後2時30分までメッセージの送信を防ぐように設定されていて、ユーザーが午前11時35分にメッセージステップに入ったとします。この時間はサイレント時間内であるため、メッセージはまだ送信されず、ユーザーはサイレント時間終了後の午後2時30分にメッセージステップを受信します。
ステップ2: キャンバスを作成する
Braze キャンバステンプレートを使用して、時間を節約しキャンバス作成を効率化しましょう！あらかじめ用意されたテンプレートのライブラリから、ユースケースに合ったものを見つけてカスタマイズできます。詳細については、キャンバステンプレートをご覧ください。
ステップ2.1: バリアントを追加する
バリアントを追加を選択して、キャンバスに新しいバリアントを追加します。バリアントはユーザーがたどるジャーニーを表し、複数のステップや分岐を含めることができます。
プラスボタンを選択して、追加のバリアントを追加できます。新しいバリアントを追加すると、ユーザーがバリアント間でどのように配分されるかを調整でき、異なるエンゲージメント戦略の効果を比較分析できます。
デフォルトでは、キャンバスのバリアント割り当てはユーザーIDとキャンバスIDの決定論的ハッシュ（ユーザーのランダムバケット番号ではなく）によって決定されます。つまり、バリアント配分率が変更されない限り、特定のユーザーは再エントリ時に常に同じバリアントに割り当てられます。起動後に配分率を調整すると、ユーザーがキャンバスに再エントリした際に異なるバリアントに割り当てられる場合があります。
配分率を変更しても割り当てを固定したい場合は、単一のキャンバスバリアントを使用し、オーディエンスパスステップでユーザーをルーティングしてください。ジャーニーの開始時にユーザー更新ステップを使用してカスタム属性にランダムな数値を保存し、オーディエンスパスでその属性をフィルターします。
手順の詳細を展開
- ランダムな数値を保存するための数値カスタム属性を作成します。
lottery_numberやrandom_assignmentなど、見つけやすい名前を付けてください。ダッシュボードでデータ設定 > カスタム属性に移動します。 - 単一のキャンバスバリアントを使用します（または各バリアントに同じユーザー更新ステップを追加します）。ジャーニーの最初にユーザー更新ステップを追加します。このステップは、ユーザーがオーディエンスパスステップに到達する前にランダムな数値を生成・保存します。
- ユーザー更新ステップで、高度なJSONエディターを選択します。{% random %} タグを使用して数値を生成します。詳細については、ランダムな数値でメッセージを送信するをご覧ください。例えば、
{% random 10 %}は0から9までの整数を返します。ステップ1のカスタム属性を次のようなJSONで設定します。
{% if {{custom_attribute.${lottery_number}}} == blank %} {% capture lottery_number_str %}{% random 10 %}{% endcapture %} { "attributes": [ { "lottery_number": {{ lottery_number_str | plus: 0 }} } ] } {% endif %}
{% if %} ブロックは、属性が空白の場合にのみ数値を設定するため、ユーザーがキャンバスに再エントリしても同じ割り当てが維持されます。
- ユーザー更新ステップの後にオーディエンスパスステップを追加します。各オーディエンスグループで、バリアント配分率を使用する代わりに、カスタム属性に基づくフィルターを追加します。
例えば、{% random 10 %}を使用した場合、あるグループはlottery_numberが4未満、別のグループは3より大きく7未満、3つ目のグループは6より大きく10未満のように設定します。
ステップ2.2: キャンバスステップを追加する
コンポーネントサイドバーからコンポーネントをドラッグ＆ドロップして、キャンバスワークフローにステップを追加できます。または、 プラスボタンを選択してポップオーバーメニューからコンポーネントを追加します。
ステップを追加していくにつれて、ズームレベルを変更して詳細にフォーカスしたり、ユーザージャーニー全体を俯瞰したりできます。Shift + +でズームイン、Shift + -でズームアウトできます。
キャンバスには最大200ステップを追加できます。キャンバスが200ステップを超えると、読み込みの問題が発生する場合があります。
最大期間
キャンバスジャーニーのステップが増えると、最大期間はユーザーがこのキャンバスを完了するまでにかかる可能性のある最長時間を表します。これは、最も長いパスについて、各バリアントの各ステップの遅延とトリガーウィンドウを合計して計算されます。例えば、キャンバスに3日間の遅延を持つ遅延ステップとメッセージステップがある場合、キャンバスの最大期間は3日間になります。
ステップの編集
ユーザージャーニーのステップを編集したい場合は、キャンバスワークフローに応じた方法を確認しましょう！
キャンバスワークフロー内の任意のコンポーネントを選択して、ステップを編集できます。例えば、ワークフローの最初のステップである遅延コンポーネントを特定の日に編集したいとします。ステップを選択して設定を表示し、遅延を3月1日に調整します。これにより、3月1日にユーザーがキャンバスの次のステップに進みます。
または、アクションパスステップのアクション設定をすばやく編集・調整して、一定期間ユーザーを保持することもできます。これにより、この評価期間中のアクションに基づいて次のパスが優先されます。
キャンバスの軽量コンポーネントにより、シンプルな編集体験が実現し、キャンバスの細かな調整がより簡単になります。
キャンバス内のメッセージ
キャンバスコンポーネント内のメッセージを編集して、特定のステップが送信するメッセージを制御します。キャンバスはメール、モバイルおよびWebプッシュメッセージ、他のシステムと連携するためのwebhookを送信できます。キャンペーンと同様に、特定のLiquidテンプレートを使用してメッセージをパーソナライズできます。
キャンバスコンポーネント名をメッセージやリンクテンプレートに含めることができることをご存知ですか？
campaign.${name} Liquidタグをキャンバスで使用すると、現在のキャンバスコンポーネント名を表示できます。
メッセージコンポーネントはユーザーに送信されるメッセージを管理します。メッセージングチャネルを選択し、配信設定を調整してキャンバスのメッセージングを最適化できます。このコンポーネントの詳細については、メッセージをご覧ください。
キャンバスコンポーネントの設定が完了したら、完了を選択します。
contextオブジェクトは、キャンバス作成時のエントリスケジュールステップで設定され、ユーザーをキャンバスにエントリさせるトリガーを示します。これらのプロパティは、APIトリガーキャンバスのエントリペイロードのプロパティにもアクセスできます。contextオブジェクトのサイズは最大50 KBです。
キャンバスへのエントリ時に作成されたこれらのプロパティを参照する場合は、次のLiquidを使用します: context.${property_name} 。イベントはカスタムイベントまたは購入イベントである必要があります。
例えば、次のリクエストを考えます: "context" : {"product_name" : "shoes", "product_price" : 79.99}。このLiquid {{context.${product_name}}} を使用して、メッセージに「shoes」という単語を追加できます。
イベントプロパティは、カスタムイベントと購入に対して設定したプロパティです。これらのevent_propertiesは、アクションベース配信のキャンペーンやキャンバスで使用できます。
キャンバスでは、カスタムイベントおよび購入イベントのプロパティは、アクションパスステップに続く任意のメッセージステップのLiquidで使用できます。これらのevent_propertiesを参照する場合は、次のLiquidを使用します: {{event_properties.${property_name}}} 。これらのイベントは、メッセージコンポーネントでこのように使用するにはカスタムイベントまたは購入イベントである必要があります。
アクションパスステップに続く最初のメッセージステップでは、そのステップで参照されるイベントに関連するevent_propertiesを使用できます。このアクションパスステップとメッセージステップの間に、他のステップ（別のアクションパスステップまたはメッセージステップ以外）を配置できます。event_propertiesにアクセスできるのは、メッセージステップがアクションパスステップのその他全員パス以外のパスまでたどれる場合のみです。
ステップ2.3: 接続を編集する
ステップ間の接続を移動するには、2つのコンポーネントを接続する矢印を選択し、別のコンポーネントを選択します。接続を削除するには、矢印を選択し、キャンバスコンポーザーのフッターにある接続をキャンセルを選択します。
単一のバリアントに同じオーディエンスと送信時間を持つ複数の分岐がある場合、Brazeはそれらの分岐間で均等な分割を保証しません。配分は最初に作成された分岐が優先される場合があります。均等な分割を行うには、各分岐でランダムバケット番号フィルターを使用してください。詳細については、1つのバリアントに複数の分岐があるキャンバスで、オーディエンスと送信時間が同一の場合はどうなりますか？をご覧ください。
ステップ 3: コントロールグループを追加する
キャンバスにコントロールグループを追加するには、 プラスボタンを選択して新しいバリアントを追加します。
Brazeはコントロールグループに配置されたユーザーのコンバージョンを追跡しますが、メッセージは送信されません。正確なテストを維持するために、コンバージョンイベント選択画面に表示されるとおり、バリアントとコントロールグループのコンバージョン数をまったく同じ期間で追跡します。
バリアント名ヘッダーをダブルクリックすると、メッセージ間の配信割合を調整できます。
この例では、キャンバスが2つのバリアントに分割されています。バリアント1にはユーザーの70%が含まれます。2つ目のバリアントは、残りの30%のユーザーを含むコントロールグループです。
BrazeAIでキャンバスバリアントを最適化する
複数のトップレベルバリアントを持つキャンバスの場合、BrazeAITMで最適化をオンにすると、各バリアントに入るユーザーの割合が自動的に調整されます。BrazeAITMはバリアントのパフォーマンスを使用して、期待されるコンバージョン数を最大化します。
2つ以上のバリアントと1つのコンバージョンイベントを追加します。次に、バリアントの割合を選択してバリアント配信を編集を開き、BrazeAITMで最適化をオンにします。
最初のコンバージョン期限が過ぎると、BrazeAITMは12時間ごとにパフォーマンスを確認し、最もコンバージョンを促進するバリアントにより多くのユーザーを誘導します。最適化によって明確な勝者が特定されると、今後の対象ユーザーはすべてそのバリアントに入ります。
この最適化は、新しいユーザーが頻繁に入るキャンバスに最適です。
ステップ4：保存して起動する
キャンバスの作成が完了したら、Launch キャンバス を選択してキャンバスを保存し、起動します。キャンバスを起動すると、キャンバス Details ページでジャーニーの分析データが届き次第確認できます。
下書きとして保存して後から戻ることもできます。
