キャンバスの作成
このリファレンス記事では、キャンバスの作成、管理、テストに必要なステップについて説明します。このガイドに従うか、Brazeラーニングコースの Canvas クイック概要をご確認ください。Braze キャンバステンプレートから始めることで、セットアップを迅速に進めることもできます。詳細については、キャンバステンプレートを参照してください。
元のキャンバスエディターの詳細を展開
元のキャンバスエクスペリエンスを使用してキャンバスを作成または複製することはできなくなりました。Braze では、最新のエディターにキャンバスをクローンすることを推奨しています。
ステップ 1: 新しいキャンバスをセットアップする
まず、メッセージング > キャンバスに移動し、キャンバスを作成を選択します。
キャンバスビルダーが、キャンバスのセットアップをステップバイステップでガイドします。名前の設定からコンバージョンイベントの設定、適切なユーザーをカスタマージャーニーに取り込むところまで、すべてカバーしています。以下の各タブを選択して、各ビルダーステップで調整できる設定を確認してください。
ここでは、キャンバスの基本情報を設定します。
- キャンバスに名前を付ける
- チームを追加する
- タグを追加する
- コンバージョンイベントを割り当て、イベントタイプと期限を選択する
基本情報ステップの詳細をご覧ください。
ここでは、ユーザーがいつ、どのようにキャンバスに入るかを決定します。
- スケジュール: 時間ベースのキャンバスエントリです
- アクションベース: ユーザーが定義されたアクションを実行した後にキャンバスに入ります
- APIトリガー: APIリクエストを使用してユーザーをキャンバスに入れます
エントリスケジュールステップの詳細をご覧ください。
ここでは、ターゲットオーディエンスを選択します。
- セグメントとフィルターを追加してオーディエンスを作成する
- キャンバスの再エントリとエントリ制限を微調整する
- ターゲットオーディエンスのサマリーを確認する
ターゲットオーディエンスステップの詳細をご覧ください。
ここでは、キャンバスの送信設定を選択します。
- サブスクリプション設定を選択する
- キャンバスメッセージの送信レート制限を設定する
- サイレント時間を有効にして設定する
送信設定ステップの詳細をご覧ください。
ここでは、キャンバスを構築します。
キャンバスビルダーを使用してキャンバスを構築する方法をご覧ください。
ここでは、キャンバスの詳細のサマリーを確認できます。キャンバス承認ワークフローが有効になっている場合、起動前にリストされたキャンバスの詳細を承認できます。
ステップ 1.1: キャンバスの基本情報から始める
ここでは、キャンバスに名前を付け、チームを割り当て、タグを作成または追加します。キャンバスのコンバージョンイベントも割り当てることができます。
キャンバスにタグを付けると、検索やレポートの作成が簡単になります。たとえば、レポートビルダーを使用する際に、特定のタグでフィルタリングできます。

コンバージョンイベントを選択する
コンバージョンイベントタイプを選択し、記録するコンバージョンを選択します。これらのコンバージョンイベントは、キャンバスの効率を測定します。

キャンバスに複数のバリアントまたはコントロールグループがある場合、Braze はこのコンバージョンイベントを使用して、このコンバージョン目標を達成するための最適なバリエーションを決定します。同じロジックを使用して、複数のコンバージョンイベントを作成できます。
ステップ 1.2: キャンバスのエントリスケジュールを決定する
ユーザーがキャンバスに入る方法を3つの中から選択できます。
エントリスケジュールのタイプ
スケジュール配信では、キャンペーンをスケジュールするのと同様に、ユーザーは時間スケジュールに基づいてエントリします。キャンバスの起動と同時にユーザーを登録したり、将来の特定の時点でジャーニーに入れたり、定期的(毎日、毎週、毎月)にエントリさせたりできます。
月次の定期スケジュールを選択した場合、選択した日が存在しない月があることに注意してください。たとえば、キャンバスを毎月31日に送信するように設定したとします。この場合、Braze はその月の最終日(4月30日など)に送信します。4月31日は存在しないためです。
この例では、時間ベースのオプションに基づいて、ユーザーは2025年11月14日から2025年12月31日まで、毎週火曜日のローカルタイムゾーンの午後12時にこのキャンバスにエントリします。

ローカルタイムゾーン配信を使用する場合、Braze はエントリ適格性を2回評価します。最初にスケジュールされた日のサモア時間(UTC+13、夏時間中はUTC+14)で、次にユーザーのローカルタイムゾーンで評価します。ユーザーがキャンバスに入るには、両方のチェックで適格である必要があります。エントリフィルターが相対的な時間ウィンドウ(たとえば「2日以上前」)を使用している場合、最初のチェック時点で24時間が経過していない可能性があり、ユーザーが1日遅れてエントリすることがあります。これを避けるには、少なくとも2日以上のより広い時間ウィンドウを使用してください。詳細については、Braze はローカルタイムゾーン配信のユーザーをいつ評価しますか?を参照してください。
1
2
3
4
5
アクションベースの配信では、ユーザーはアプリを開く、購入する、カスタムイベントをトリガーするなどの特定のアクションを実行した際にキャンバスに入り、メッセージの受信を開始します。
**エントリオーディエンス**ウィンドウから、再適格性のルールやフリークエンシーキャップの設定など、キャンバスの動作の他の側面を制御できます。アクションベースの配信は、アプリ内メッセージを含むキャンバスコンポーネントでは使用できないことに注意してください。

アクションベースのキャンバスが予想より早くメッセージを送信する場合は、カスタムイベントのタイムスタンプが過去の時刻ではなく現在の時刻で送信されているか確認してください。たとえば、アクションベースのキャンバスにユーザーがカスタムイベントを実行してから3時間の遅延がある場合、Braze はカスタムイベントと共に送信されたタイムスタンプを使用してその遅延を評価します。タイムスタンプが3時間以上過去の場合、Braze は遅延がすでに経過したものとして扱い、メッセージを即座に送信します。
APIトリガー配信では、API経由で/canvas/trigger/send エンドポイントを使用してユーザーが追加された後、キャンバスに入りメッセージの受信を開始します。ダッシュボードでは、これを行うcURLリクエストの例を確認でき、コンテキストオブジェクトを使用してオプションのcontextを割り当てることもできます。

APIトリガー配信には以下のエンドポイントを使用できます。
配信方法を選択した後、ユースケースに合わせて設定を調整し、ターゲットオーディエンスの設定に進みます。
元のエディターを使用したキャンバスの重複排除動作
再適格性のウィンドウがキャンバスの最大期間より短い場合、ユーザーは再エントリして複数のコンポーネントのメッセージを受信できます。ユーザーの再エントリが前回のエントリと同じコンポーネントに到達するエッジケースでは、Braze はそのコンポーネントのメッセージを重複排除します。
ユーザーがキャンバスに再エントリし、前回のエントリと同じコンポーネントに到達し、各エントリでアプリ内メッセージの対象となる場合、セッションを2回再開する限り、ユーザーはメッセージを2回受信します(アプリ内メッセージの優先度に依存します)。
ステップ 1.3: ターゲットエントリオーディエンスを設定する
ターゲットオーディエンスステップでは、定義した条件に一致するユーザーのみがジャーニーに入ることができます。つまり、Braze はユーザーがキャンバスジャーニーに入る前に、まずターゲットオーディエンスの適格性を評価します。たとえば、新規ユーザーをターゲットにしたい場合、1週間以内にアプリを初めて使用したユーザーのセグメントを選択できます。
エントリコントロールでは、キャンバスが実行されるようにスケジュールされるたびにユーザー数を制限できます。APIトリガーベースおよびアクションベースのキャンバスの場合、この制限はUTC時間の毎時に適用されます。
オーディエンスフィルターと同じトリガー (属性の変更やカスタムイベントの実行など) でアクションベースのキャンペーンやキャンバスを設定しないでください。競合状態が発生する可能性がある。その場合、ユーザーがトリガーイベントを実行した時点でオーディエンスに含まれていないため、キャンペーンを受け取ったりキャンバスに入ったりしない。
オーディエンスのテスト
ターゲットオーディエンスにセグメントとフィルターを追加した後、ユーザーを検索して、オーディエンス条件に一致するかどうかを確認することで、オーディエンスが期待通りに設定されているかテストできます。

エントリコントロールの選択
エントリコントロールは、ユーザーがキャンバスに再エントリできるかどうかを決定します。エントリスケジュールのタイプに応じて、選択したケイデンスでこのキャンバスに入る可能性のある人数を制限することもできます。
- スケジュール: キャンバスのライフタイム、またはキャンバスがスケジュールされるたび
- アクションベース: 毎時、毎日、またはキャンバスのライフタイム
- APIトリガー: 毎時、毎日、またはキャンバスのライフタイム
たとえば、アクションベースのキャンバスでエントリ数を制限を選択し、最大エントリ数フィールドを5,000ユーザーに設定し、制限ケイデンスを毎日にした場合、キャンバスは1日あたり5,000ユーザーにのみ送信します。

Braze では、IP ウォーミングの場合にキャンバスがスケジュールされるたびを選択することは推奨しません。送信量が増加する可能性があるためです。
終了条件の設定
終了条件を設定すると、キャンバスから退出させたいユーザーを決定できます。ユーザーが例外イベントを実行するか、セグメントとフィルターに一致した場合、それ以降のメッセージは受信しません。
ターゲット層の計算
ターゲット層セクションでは、選択したセグメントや追加のフィルターなどのオーディエンスのサマリーと、メッセージングチャネルごとの到達可能なユーザー数の内訳を確認できます。デフォルトの推定値ではなく、ターゲットオーディエンスの到達可能なユーザーの正確な数を計算するには、正確な統計を計算を選択します。
注意事項:
- 正確な統計の計算には数分かかる場合があります。この機能はセグメントレベルでのみ正確な統計を計算し、フィルターやフィルターグループレベルでは計算しません。
- 大規模なセグメントの場合、正確な統計を計算しても若干の変動が見られることは正常です。この機能の精度は99.999%以上と想定されています。
ターゲットユーザーの平均ライフタイム収益などの追加統計を表示するには、追加統計を表示を選択します。

ターゲットオーディエンス数と到達可能なユーザー数が異なる理由
CampaignまたはCanvasに表示されるターゲット層のサイズは、Segmentの到達可能なオーディエンスサイズとは異なる場合があります。これは、そのSegmentを追加のフィルターなしでCampaignまたはCanvasに直接追加している場合でも同様です。 これにはいくつかの理由が考えられます。
- グローバルコントロールグループがCampaignまたはCanvasに適用されている場合、そのグローバルコントロールグループ内のユーザーは到達可能なユーザー数から除外されます。
- CampaignまたはCanvasのターゲット層のサイズは、さまざまなメッセージチャネルを通じて連絡できないユーザーを除外します。この動作はチャネルごとに異なります。たとえば、CampaignまたはCanvasの到達可能なオーディエンスでは、配信停止済み、スパムとしてマークされた(メールの場合)、またはハードバウンスした(メールの場合)ユーザーが除外されます。ただし、Segment自体は、到達可能なメールユーザーの推定数を表示する際にオプトアウトのみを除外します。
- Brazeは選択したサブスクリプショングループ内のユーザーにのみSMSメッセージを送信するため、CampaignまたはCanvasのSMSターゲット層からは、選択したサブスクリプショングループに含まれないユーザーも除外されます。
ステップ 1.4: 送信設定を選択する
送信設定を選択して、サブスクリプション設定の編集、レート制限の有効化、サイレント時間の有効化を行います。レート制限またはフリークエンシーキャップを有効にすることで、ユーザーへのマーケティングプレッシャーを軽減し、過剰なメッセージ送信を防ぐことができます。
メールとプッシュチャネルをターゲットとするキャンバスの場合、明示的にオプトインしたユーザーのみがメッセージを受信するようにキャンバスを制限したい場合があります(購読中または購読解除のユーザーを除外)。たとえば、オプトインステータスが異なる3人のユーザーがいるとします。
- ユーザー A はメールを購読中で、プッシュが有効です。このユーザーはメールを受信しませんが、プッシュは受信します。
- ユーザー B はメールにオプトインしていますが、プッシュは有効ではありません。このユーザーはメールを受信しますが、プッシュは受信しません。
- ユーザー C はメールにオプトインしており、プッシュも有効です。このユーザーはメールとプッシュの両方を受信します。
これを行うには、サブスクリプション設定を「オプトインしたユーザーのみ」に送信するように設定します。このオプションにより、オプトインしたユーザーのみがメールを受信し、Braze はデフォルトでプッシュが有効なユーザーにのみプッシュを送信します。
これらのサブスクリプション設定はステップごとに適用されるため、エントリオーディエンスには影響しません。したがって、この設定は各キャンバスステップを受信するためのユーザーの適格性を評価するために使用されます。
この設定では、ターゲットオーディエンスステップにオーディエンスを単一チャネルに制限するフィルター(たとえば Foreground Push Enabled = True や Email Subscription = Opted-In)を含めないでください。
必要に応じて、キャンバスのサイレント時間(メッセージが送信されない時間帯)を指定します。送信設定でサイレント時間を有効にするにチェックを入れます。次に、ユーザーのローカルタイムゾーンでサイレント時間を選択し、メッセージがサイレント時間内にトリガーされた場合のフォールバック動作を設定します。

ステップ 2: キャンバスを構築する
Braze キャンバステンプレートを使用して、時間を節約しキャンバスの作成を効率化しましょう!事前構築されたテンプレートのライブラリーを閲覧して、ユースケースに合ったものを見つけ、特定のニーズに合わせてカスタマイズしてください。詳細については、キャンバステンプレートを参照してください。
ステップ 2.1: バリアントを追加する

バリアントを追加を選択し、キャンバスに新しいバリアントを追加します。バリアントはユーザーがたどるジャーニーを表し、複数のステップと分岐を含めることができます。
プラスボタンを選択して、追加のバリアントを追加できます。新しいバリアントを追加すると、ユーザーがバリアント間でどのように分配されるかを調整でき、異なるエンゲージメント戦略の効果を比較・分析できます。

デフォルトでは、キャンバスのバリアント割り当てはユーザーがキャンバスに入った時点でロックされます。つまり、ユーザーが最初にあるバリアントに入った場合、キャンバスに再エントリするたびにそのバリアントが割り当てられます。ただし、この動作を回避する方法があります。
これを行うには、Liquid を使用して乱数ジェネレーターを作成し、各ユーザーのキャンバスエントリの最初に実行し、その値をカスタム属性として保存してから、その属性を使用してユーザーをランダムに分割します。
手順を展開
- 乱数を保存するカスタム属性を作成します。「lottery_number」や「random_assignment」など、見つけやすい名前を付けてください。属性はダッシュボードで作成するか、
/users/trackエンドポイントへのAPI呼び出しで作成できます。 - キャンバスの最初に Webhook キャンペーンを作成します。このキャンペーンが乱数を作成し、カスタム属性として保存する手段となります。詳細は Webhook の作成を参照してください。URLを
/users/trackエンドポイントに設定します。 - 乱数ジェネレーターを作成します。こちらに記載されているコードを使用して作成できます。これは各ユーザーのユニークなエントリ時間を利用して乱数を生成します。生成された数値を Webhook キャンペーン内の Liquid 変数として設定します。
- Webhook キャンペーンの
/users/track呼び出しをフォーマットして、ステップ1で作成したカスタム属性を、現在のユーザーのプロファイルに生成した乱数に設定するようにします。このステップが実行されると、ユーザーがキャンペーンに入るたびに変わる乱数が正常に作成されます。 - キャンバスの分岐を、ランダムに選択されたバリアントで分割するのではなく、オーディエンスルールに基づいて分割するように調整します。各分岐のオーディエンスルールで、カスタム属性に基づいてオーディエンスフィルターを設定します。
たとえば、ある分岐のオーディエンスフィルターを「lottery_number が3未満」に設定し、別の分岐のオーディエンスフィルターを「lottery_number が3より大きく6未満」に設定できます。
ステップ 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つのコンポーネントを接続する矢印を選択し、別のコンポーネントを選択します。接続を削除するには、矢印を選択し、キャンバスコンポーザーのフッターにある接続をキャンセルを選択します。
ステップ 3: コントロールグループを追加する
プラスボタンを選択して新しいバリアントを追加することで、キャンバスにコントロールグループを追加できます。
Braze はコントロールグループに配置されたユーザーのコンバージョンを追跡しますが、メッセージは受信しません。正確なテストを維持するために、コンバージョンイベント選択画面に表示されているように、バリアントとコントロールグループのコンバージョン数をまったく同じ期間追跡します。
バリアント名ヘッダーをダブルクリックして、メッセージ間の配分を調整できます。
この例では、キャンバスを2つのバリアントに分割しています。バリアント1にはユーザーの70%が含まれます。2番目のバリアントは残りの30%のユーザーを含むコントロールグループです。

キャンバスのインテリジェントセレクション
インテリジェントセレクション機能が多変量キャンバスで利用可能になりました。多変量キャンペーンのインテリジェントセレクション機能と同様に、キャンバスのインテリジェントセレクションは各キャンバスバリアントのパフォーマンスを分析し、各バリアントに送られるユーザーの割合を調整します。この配分は、各バリアントのパフォーマンス指標に基づいて、コンバージョンの合計期待数を最大化するように行われます。
多変量キャンバスでは、コピーだけでなく、タイミングやチャネルもテストできることを覚えておいてください。インテリジェントセレクションを使用すると、キャンバスをより効率的にテストでき、ユーザーが最適なキャンバスジャーニーに送られることに自信を持てます。

キャンバスのインテリジェントセレクションは、各バリアントに振り分けられるユーザーの配分を段階的にリアルタイムで調整することで、キャンバスの結果を最適化します。統計アルゴリズムがバリアント間で決定的な勝者を判定すると、パフォーマンスの低いバリアントを除外し、キャンバスの今後の適格な受信者すべてを勝者バリアントに割り当てます。
このため、インテリジェントセレクションは新しいユーザーが頻繁にエントリするキャンバスで最も効果的に機能します。
ステップ 4: 保存して起動する
キャンバスの作成が完了したら、キャンバスを起動を選択してキャンバスを保存し起動します。キャンバスを起動すると、キャンバスの詳細ページでジャーニーの分析データが入ってくるのを確認できます。
後で戻る必要がある場合は、キャンバスを下書きとして保存することもできます。

起動後にキャンバスを編集する必要がありますか?可能です!詳細については、起動後のキャンバスの編集を参照してください。