キャンバスの作成
このリファレンス記事では、キャンバスの作成、管理、テストに必要なステップについて説明します。このガイドに従うか、Braze Learningコースのキャンバスクイック概要をご確認ください。Brazeキャンバステンプレートから始めることで、セットアップを迅速に進めることもできます。詳細については、キャンバステンプレートを参照してください。自然言語の説明からキャンバスの下書きを作成するには、オペレーターにお問い合わせください。
元のキャンバスエディターの詳細を展開
元のキャンバスエクスペリエンスを使用してキャンバスを作成または複製することはできなくなりました。Brazeでは、最新のエディターにキャンバスをクローンすることを推奨しています。
ステップ1：新しいキャンバスを設定する
まず、メッセージング > キャンバスに移動し、キャンバスを作成を選択します。
キャンバスビルダーが、キャンバスの設定をステップバイステップでガイドします。名前の設定からコンバージョンイベントの設定、対象ユーザーをカスタマージャーニーに取り込むまで、すべてが含まれます。以下の各タブを選択して、ビルダーの各ステップで調整できる設定を確認してください。
ここでは、キャンバスの基本を設定します。
- キャンバスに名前を付ける
- チームを追加する
- タグを追加する
- コンバージョンイベントを割り当て、イベントタイプと期限を選択する
基本設定ステップの詳細をご覧ください。
ここでは、ユーザーがキャンバスに入るタイミングと方法を決定します。
- スケジュール：時間ベースのキャンバスエントリです
- アクションベース：ユーザーが定義されたアクションを実行した後にキャンバスに入ります
- APIトリガー：APIリクエストを使用してユーザーをキャンバスに登録します
エントリスケジュールステップの詳細をご覧ください。
ここでは、ターゲットオーディエンスを選択します。
- セグメントとフィルターを追加してオーディエンスを作成する
- キャンバスの再エントリとエントリ制限を調整する
- ターゲットオーディエンスのサマリーを確認する
ターゲットオーディエンスステップの詳細をご覧ください。
ここでは、キャンバスを構築します。
キャンバスビルダーを使用したキャンバスの構築方法をご覧ください。
ここでは、キャンバスの詳細のサマリーが表示されます。キャンバス承認ワークフローが有効になっている場合、ローンチ前にリストされたキャンバスの詳細を承認できます。
ステップ1.1：キャンバスの基本設定から始める
ここでは、キャンバスに名前を付け、チームを割り当て、タグを作成または追加します。また、キャンバスのコンバージョンイベントを割り当てることもできます。
コンバージョンイベントを選択する
コンバージョンイベントの種類を選択し、記録するコンバージョンを選択します。これらのコンバージョンイベントは、キャンバスの効果を測定します。
キャンバスに複数のバリアントまたはコントロールグループがある場合、Brazeはこのコンバージョンイベントを使用して、このコンバージョン目標を達成するための最適なバリエーションを決定します。同じロジックを使用して、複数のコンバージョンイベントを作成できます。
ステップ1.2：キャンバスのエントリスケジュールを決定する
ユーザーがキャンバスに入る方法を3つの中から選択できます。
エントリスケジュールの種類
スケジュール配信では、キャンペーンをスケジュールするのと同様に、ユーザーは時間スケジュールに基づいてエントリします。キャンバスのローンチ直後にユーザーを登録したり、将来の特定の時点でジャーニーに登録したり、定期的（毎日、毎週、または毎月）に登録したりできます。
月次の定期スケジュールを選択する場合、選択した日が存在しない月があることに注意してください。たとえば、毎月31日にキャンバスを送信するように設定したとします。この場合、Brazeは4月30日などその月の最終日に送信します。4月31日は存在しないためです。
この例では、時間ベースのオプションに基づき、2025年11月14日から2025年12月31日まで、毎週火曜日の正午（ローカルタイムゾーン）にユーザーがこのキャンバスに入ります。
ローカルタイムゾーン配信を使用する場合、Brazeはエントリ資格を2回評価します。最初にスケジュールされた日のサモア時間（UTC+13）で、次にユーザーのローカルタイムゾーンで評価します。ユーザーがキャンバスに入るには、両方のチェックで資格を満たす必要があります。エントリフィルターに相対的な時間枠（たとえば「2日以上前」）を使用している場合、最初のチェックの時点で24時間が経過していない可能性があり、ユーザーが1日遅れてエントリする場合があります。これを避けるには、少なくとも2日以上など、より広い時間枠を使用してください。詳細については、Brazeはローカルタイムゾーン配信でいつユーザーを評価しますか？を参照してください。
アクションベース配信では、ユーザーがアプリを開く、購入する、カスタムイベントをトリガーするなど、特定のアクションを実行するとキャンバスに入り、メッセージの受信を開始します。
エントリオーディエンスウィンドウから、再適格ルールやフリークエンシーキャップ設定など、キャンバスの動作の他の側面を制御できます。アクションベース配信は、アプリ内メッセージを含むキャンバスコンポーネントでは使用できないことに注意してください。
キャンバスステップとのインタラクションは、キャンバスのアクションベースのエントリトリガーとして使用できません。キャンペーンのトリガーとしてのみ使用できます。あるキャンバスから別のキャンバスをトリガーするには、送信先へ送信キャンバスコンポーネントを使用するか、/canvas/trigger/sendエンドポイントを呼び出す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ユーザーにのみ送信します。
Brazeは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 ページでジャーニーの分析データを確認できるようになります。
また、後で作業を続ける必要がある場合は、キャンバスを下書きとして保存することもできます。
