コンテンツにスキップ

よくある質問

この記事では、キャンバスに関するよくある質問への回答を提供します。

キャンバスの構築と編集

キャンバスに含められるステップ数は？

キャンバスには最大200ステップを追加できます。

キャンバスエントリプロパティにサイズ制限はありますか？

はい。キャンバスコンテキストオブジェクト（キャンバスエントリプロパティ）の最大サイズは50 KBです。ペイロードはこの制限内でできるだけ小さく保ってください。キャンバスでのエントリプロパティとイベントプロパティの仕組みについては、コンテキストプロパティとイベントプロパティを参照してください。

「Too many キャンバス branches」エラーが表示されるのはなぜですか？

このエラーは、ステップの分岐とエントリオーディエンスサイズの組み合わせがクラスターのパフォーマンス問題を引き起こし、メッセージの送信が妨げられる可能性がある場合に表示されます。解決手順については、オーディエンスパスの使用、分岐やオーディエンスサイズの縮小、キャンバスフローでの再構築などを含め、「Too many キャンバス branches」エラーを参照してください。

キャンバスで再適格性とBrazeAITMによる最適化を使用できますか？

はい。キャンバスでは、再適格性が有効な場合にBrazeAITMによる最適化を使用できます。割り当ては時間の経過とともに変化するため、Brazeは再エントリ時に同じバリアントを保証することはできません。キャンペーンでは、BrazeAITMによる最適化がオンの場合、再適格性ウィンドウを24時間以上に設定する必要があります。

コンポーネントとステップの違いは何ですか？

コンポーネントは、キャンバスの効果を判断するために使用できるキャンバスの個々の部品です。コンポーネントには、ユーザージャーニーの分割、遅延の追加、複数のキャンバスパスのテストなどのアクションを含めることができます。キャンバスのステップは、キャンバスの分岐におけるパーソナライズされたユーザージャーニーを指します。基本的に、キャンバスはユーザージャーニーのステップを構成する個々のコンポーネントで構成されています。

接続されていないステップがあるキャンバスを起動できますか？

はい。起動後に接続されていないステップがあるキャンバスを保存することもできます。

接続されていないステップに到達したユーザーはどうなりますか？

ユーザーがキャンバスワークフローの接続されていないステップにいる場合、後続のステップがあればそのステップに進み、ステップの設定がユーザーの進み方を決定します。これは、ユーザーがステップをキャンバスの残りの部分に直接接続しなくても変更を加えられるようにするためです。また、すぐにライブにする前にテストするための余地も提供し、実質的に下書きの保存を可能にします。

ステップを切断する前に、キャンバスステップで待機中のユーザーの分析ビューを確認することをお勧めします。

1つのバリアントで複数の分岐があるキャンバスで、オーディエンスと送信時間が同じ場合はどうなりますか？

各ステップに対してジョブがキューに入れられ、ほぼ同時に実行され、そのうちの1つが「勝ちます」。実際には、ある程度均等に分配される可能性がありますが、最初に作成されたステップに少なくともわずかな偏りが生じる可能性があります。

さらに、その分布が正確にどのようになるかについて保証はできません。均等な分割が必要な場合は、ランダムバケット番号フィルターを追加してください。

キャンバスのオーディエンスはどのように評価されますか？

デフォルトでは、キャンバスのフルステップのフィルターとセグメントは送信時にチェックされます。条件分岐ステップは、前のステップを受信した直後（または遅延の前）に評価を実行します。

例外イベントはいつトリガーされますか？

例外イベントは、ユーザーが関連付けられたキャンバスコンポーネントの受信を待っている間のみトリガーされます。ユーザーが事前にアクションを実行した場合、例外イベントはトリガーされません。事前に特定のイベントを実行したユーザーを除外するには、代わりにフィルターを使用してください。

キャンバスを編集すると、すでにキャンバスにいるユーザーにどのような影響がありますか？

マルチステップキャンバスの一部のステップを編集した場合、すでにオーディエンスに含まれているがまだステップを受信していないユーザーは、更新されたバージョンのメッセージを受け取ります。これは、そのステップの評価がまだ行われていない場合にのみ発生します。

起動後に編集できる内容の詳細については、起動後のキャンバスの変更を参照してください。

キャンバスを停止するとどうなりますか？

キャンバスを停止すると、以下が適用されます。

  • ユーザーはキャンバスに入ることができなくなります。
  • フロー内のユーザーの位置に関係なく、それ以上のメッセージは送信されません。
  • 例外：メールを含むキャンバスはすぐには停止しません。送信リクエストがSendGridに送られた後は、ユーザーへの配信を止めることはできません。

ユーザーライフサイクルごとに1つのキャンバスを構築するべきですか、それとも別々のキャンバスにするべきですか？

キャンバスで達成したい目標に応じて、ユーザージャーニーの構築方法に異なるアプローチが必要になる場合があります。キャンバスの柔軟性により、ユーザーライフサイクルのあらゆる段階でユーザージャーニーをマッピングできます。効果的なユーザージャーニーを作成するための合理化されたアプローチの例については、Brazeキャンバステンプレートをご覧ください。

メッセージと配信

キャンバスのアプリ内メッセージはいつ送信されますか？

アプリ内メッセージは次のセッション開始時に送信されます。つまり、キャンバスが停止される前にユーザーがキャンバスステップに入った場合、アプリ内メッセージがまだ期限切れになっていなければ、次のセッション開始時にそのアプリ内メッセージを受信します。

キャンバスが停止される前にユーザーがセッションを開始しても、アプリ内メッセージがすぐに表示されない場合があります。これは、アプリ内メッセージがカスタムイベントによってトリガーされたり、遅延が設定されている場合に発生する可能性があります。つまり、キャンバスが停止された後にユーザーがアプリ内メッセージのインプレッションを記録し、アプリ内メッセージを「受信」する可能性があります。ただし、ユーザーはキャンバスが停止される前に、かつキャンバスステップを受信した後にセッションを開始している必要があります。

インプレッションが記録されているのに、キャンバスの送信数がゼロと表示されるのはなぜですか？

アプリ内メッセージステップを含むキャンバスで「メッセージ送信数」が常にゼロの場合、これはアプリ内メッセージの配信が他のメッセージングチャネルとは異なる仕組みで動作するためです。

アプリ内メッセージはBrazeから「プッシュ」されるのではなく、SDKによって「プル」されます。対象ユーザー向けのアプリ内メッセージはセッション開始時に自動的に配信され、トリガーイベントが発生するまで表示を「待機」します。対象ユーザーがセッションを開始したときにメッセージを受信するため、Brazeはこれを送信イベントとして報告しません。ユーザーがトリガーイベントを実行すると、メッセージが表示され、Brazeはインプレッションを記録し、ユーザープロファイル上でキャンバスステップ（またはキャンペーン）を受信済みとしてマークします。その結果、アプリ内メッセージの_送信数_合計はゼロになります。

長い遅延やブランチの後にユーザーがアプリ内メッセージを受信しなかったのはなぜですか？

上流の遅延ステップとオーディエンスチェックが完了した後、ユーザーはメッセージステップに到達した時点でアプリ内メッセージの対象になります。メッセージがカレンダー日付で期限切れになる場合や、ステップが利用可能になってからの期間のウィンドウが短い場合、遅いブランチのユーザーは期限切れ後に到着してメッセージを表示できない場合があります。有効期限を最も長い現実的なパス遅延に合わせてください。詳細と例については、アプリ内メッセージの有効期限を参照してください。

「キャンバス Entry Properties may not be used in In-App Messages.」と表示されるのはなぜですか？

このメッセージは、パーソナライゼーションがキャンバスのアプリ内メッセージで解決できないフィールドを参照している場合に表示されます。コンテキストとイベントプロパティおよびメッセージステップに記載されているcontextオブジェクトを使用してください。レガシーのLiquid名前空間canvas_entry_propertiesにはcontextとは異なる制約があります。複数のステップにわたって値を保持する必要がある場合は、Brazeチームとオリジナルキャンバスエディターの永続プロパティを確認してください。保存された値は、デバイスがアプリ内ペイロードをダウンロードする前にユーザーがキャンバスを退出すると消去されます。

キャンバスのドラッグ＆ドロップアプリ内メッセージのボタンクリックはどこで確認できますか？

ドラッグ＆ドロップアプリ内メッセージのボタンレベルの指標は、キャンバスの概要だけでなく、キャンバスの詳細のメッセージステップ分析カードに表示されます。キャンバスを開き、メッセージステップを選択して、アプリ内エンゲージメントを確認してください。レポートの概念については、キャンバス分析を参照してください。

同じキャンバスメッセージステップまたは多変量送信のバリアントごとに異なる送信時間をスケジュールできますか？

いいえ。同じ多変量構成またはメッセージステップのバリアントは1つの配信スケジュールを共有します。同じスケジュールされた送信に対して、あるバリアントを午後6時に、別のバリアントを午後7時に送信するよう割り当てることはできません。

送信をずらしたり、パスごとに異なる時間を使用するには、以下の方法を試してください。

  • メッセージステップの間に遅延ステップを配置して、各メッセージに独自のスケジュールを持たせます。
  • ブランチまたは実験パスステップを使用して、ユーザーが異なるタイミングのパスをたどるようにします。
  • ユースケースが1つのキャンバス内に収まる必要がない場合は、別々のキャンペーンに分けます。

キャンペーンでの多変量およびABテストの概念については、多変量およびABテストを参照してください。

キャンバスメッセージステップでユーザーがグローバルフリークエンシーキャップに達した場合はどうなりますか？

キャップされたチャネルのその送信は受信しませんが、グローバルフリークエンシーキャップによってメッセージが送信されない場合でも、メッセージステップはユーザーを進行させます。ステップごとの進行ケースについては、ユーザーの進行方法を参照してください。グローバルフリークエンシーキャップだけではユーザーがキャンバスから退出することはありません。この動作はメッセージステップの配信バリデーションとは別のものです。詳細については、レート制限とフリークエンシーキャップを参照してください。

送信数が推定オーディエンスサイズより少ないのはなぜですか？

送信数が推定オーディエンスより少なくなる理由の多くはキャンペーンと同様です。フリークエンシーキャップ、厳密なデバイスまたはブラウザフィルター、再エントリウィンドウ、レート制限、チャネルレベルの除外（例：プッシュの到達可能性やメールの購読・配信到達性チェックなど）が含まれます。

キャンバス固有の要因も適用されます。

  • アクションベースまたはAPIトリガーのエントリ：ユーザーはエントリ行動を実行した後にのみエントリ（してステップを受信）するため、それらのアクションが発生するまで、実際の送信数は事前の推定を下回ります。
  • オーディエンスパス：ユーザーは適格な最も優先度の高いブランチにルーティングされるため、下流のブランチはフラットなセグメント数が示すよりも少ないユーザーを受け取る場合があります。
  • オーディエンスと送信時チェック：フルステップは、別途設定しない限り、送信時にフィルターを再評価します。キャンバス構築時に適格だったユーザーが、メッセージ送信前に脱落する場合があります。
  • コントロールグループ：グローバルまたはキャンバスのコントロールグループは、エントリ者の一部をメッセージングから除外します。
  • クワイエットアワーと遅延：メッセージが保留またはリスケジュールされ、表示中のレポート期間から送信がずれる場合があります。
  • 最大エントリまたはオーディエンスキャップ：基盤となるセグメントがそれより大きい場合でも、エントリまたは送信キャップによって追加のユーザーが停止されます。
  • レポート期間：分析範囲に、推定と比較しているすべての送信が含まれていない場合があります。

推定オーディエンスとキャンバスユーザー数が一致しないのはなぜですか？

推定オーディエンスは、推定の実行時にセグメントとエントリフィルターに一致するユーザーを反映します。その時点以降、遅延またはアクションベースのエントリ、再エントリ、APIトリガー、またはブランチルーティングにより、スナップショットと比較してジャーニーに接触するプロファイル数が増加する場合があります。送信時フィルターが失敗した場合、ユーザーが脱落することもあり、実際のエントリや送信が減少します。タイミング、キャップ、評価設定を送信数が推定オーディエンスサイズより少ないのはなぜですか？と併せて比較してください。

_ユニーク受信者数_がターゲットしたユーザー数より多いのはなぜですか？

_ユニーク受信者数_が予想したオーディエンスより多くなることがあります。これは、Brazeがキャンバスおよびキャンペーンのレポートで日次ユニーク受信者数をトラッキングしているためです。これにより、ユーザーがジャーニーでメッセージを受信するたびに正確なコンバージョンアトリビューションが可能になります。

例えば、ユーザーが月曜日にキャンバスステップを受信し、金曜日に再び受信して各送信後にコンバージョンした場合、Brazeは2つの受信者行と2つの対象コンバージョンをカウントできます。定期的なエントリや再エントリの場合、同じ少数のプロファイルのセットが数日間にわたって複数の_ユニーク受信者数_を生み出す可能性があります。

キャンバスの送信レートが低下しているのはなぜですか？

日次スケジュールのキャンバスが時間の経過とともに送信するユーザーが減少している場合は、以下を確認してください。

  • 再エントリが有効になっているか確認してください：再エントリがなければ、Brazeは各ユーザーを一度だけキャンバスにエントリさせます。日次スケジュールのキャンバスでは、オーディエンスに一致し、まだキャンバスにエントリしていないユーザーのみが各エントリの対象になります。ユーザーがエントリするにつれて、後のエントリではより少ない対象ユーザーとなり、エントリ量が減少します。
  • オーディエンスのメンバーシップが固定されていないか確認してください：固定のユーザーリスト（セグメントフィルターとして使用されるCSVインポートなど）から構築されたオーディエンスは、自動的に新しいメンバーを獲得しません。新しいエントリ者がいなければ、ユーザーがキャンバスにエントリするにつれてエントリ量は回復できません。

配信速度レート制限や単一回の送信を減少させるその他の要因については、送信数が推定オーディエンスサイズより少ないのはなぜですか？を参照してください。

小さなコントロールグループセグメントで過去のメンバーシップに変化が表示されるのはなぜですか？

過去のメンバーシップチャートは推定サンプルを使用するため、グローバルコントロールグループセグメントを含む小さなセグメントでは、基盤となるオーディエンスが安定していても日ごとの変動が表示される場合があります。推定の仕組みとチャートが変動する理由については、過去のセグメントメンバーシップサイズの表示を参照してください。

分析とコンバージョン

コンバージョンダッシュボードはキャンバスのコンバージョンをどのようにアトリビューションしますか？

コンバージョンダッシュボードは、選択したアトリビューション方法（例：受信時、送信時、開封時、クリック時）に基づいてキャンバスのコンバージョンをアトリビューションします。レポートにユーザーが表示されるには、ユーザーがキャンバスまたはキャンペーンにエントリし、選択したアトリビューション方法を記録し、レポート設定内でコンバージョンイベントを実行する必要があります。

キャンバス分析におけるステップレベルおよびバリアントレベルのコンバージョンルールについては、キャンバスでユーザーのコンバージョンはどのようにトラッキングされますか？を参照してください。

キャンバスでユーザーのコンバージョンはどのようにトラッキングされますか？

ユーザーは、キャンバスのエントリごとに1回のみコンバージョンできます。コンバージョンは、そのエントリに対してユーザーが最後に受信したメッセージに割り当てられます。キャンバスの冒頭にあるサマリーブロックは、メッセージを受信したかどうかに関係なく、そのパス内でユーザーが実行したすべてのコンバージョンを反映します。各後続ステップは、そのステップがユーザーが受信した最新のステップであった間に発生したコンバージョンのみを表示します。

例を展開

例 1

10件のプッシュ通知を含むキャンバスパスがあり、コンバージョンイベントは「セッション開始」（「アプリを開く」）です。

  • ユーザー A は、エントリ後、最初のメッセージを受信する前にアプリを開きます。
  • ユーザー B は、各プッシュ通知の後にアプリを開きます。

結果： サマリーには2つのコンバージョンが表示され、個々のステップでは最初のステップに1つのコンバージョンが表示され、後続のすべてのステップではゼロになります。

例 2

サイレント時間帯が有効な1ステップのキャンバスがあります。

  1. ユーザーがキャンバスにエントリします。
  2. 最初のステップには遅延がありませんが、設定されたサイレント時間帯内にあるため、メッセージは抑制されます。
  3. ユーザーがコンバージョンイベントを実行します。

結果： ユーザーはキャンバスバリアント全体ではコンバージョンとしてカウントされますが、ステップを受信していないため、ステップではコンバージョンとしてカウントされません。

さまざまなコンバージョン率タイプの違いは何ですか？

  • キャンバスの合計コンバージョンは、コンバージョンイベントを完了したユニークユーザー数を反映しており、各ユーザーが完了したコンバージョン数ではありません。
  • バリアントコンバージョン率またはキャンバスの冒頭にあるサマリーブロックは、メッセージを受信したかどうかに関係なく、そのパス内でユーザーが実行したすべてのコンバージョンを集計した合計として反映します。
  • ステップコンバージョン率は、そのメッセージステップを受信し、記載されたコンバージョンイベントのいずれかを完了した個人の数を反映します。

キャンバスのステップコンバージョン率がキャンバスバリアントの合計コンバージョン率と等しくないのはなぜですか？

キャンバスバリアントのコンバージョン合計が、ステップ合計の合計よりも大きくなることはよくあることです。これは、ユーザーがバリアントにエントリするとすぐにバリアントに対してコンバージョンイベントを実行できるために発生します。ただし、同じコンバージョンイベントはキャンバスステップにはカウントされません。そのため、キャンバスにエントリし、最初のキャンバスステップを受信する前にコンバージョンイベントを実行したユーザーは、バリアントのコンバージョン合計にはカウントされますが、ステップ合計にはカウントされません。キャンバスにエントリしたが、いずれのステップも受信する前にキャンバスを退出したユーザーについても同様です。

また、ユーザーがバリアントにエントリし、ステップからメッセージが送信されず、その後コンバージョンした場合もあり得ます。この場合、コンバージョンはステップレベルでは記録されません。ただし、ユーザーは技術的にコンバージョンしているため、キャンバスレベルではコンバージョンが記録されます。

APIトリガーのキャンバスをユーザーが受信したことを確認するにはどうすればよいですか？

キャンバスフィルターを使用してセグメントを作成し、ユーザーがキャンバスにエントリしたか、特定のキャンバスステップを受信したかを確認できます。例えば、ユーザーがAPIトリガーのキャンバスにエントリしたことを確認したい場合はキャンバスエントリフィルターを使用し、キャンバスからメッセージを受信したことを確認したい場合は受信ステップフィルターを使用します。次に、/users/export/segmentエンドポイントを使用して、そのセグメントのユーザーをエクスポートします。

キャンバスを削除できますか？

いいえ、ただしキャンバスをアーカイブすることはできます。

アーカイブしたキャンバスやキャンペーンを再開するにはどうすればよいですか？

アーカイブされたメッセージは、編集可能な状態に戻すまで送信されません。キャンペーンまたはキャンバスをアーカイブ解除し、エントリスケジュールまたは送信時間を将来の期間に設定（クリーンなコピーが必要な場合はジャーニーを複製）してから、必要に応じて再開またはローンチしてください。キャンペーンとキャンバスのアーカイブを参照してください。

エラーが表示されないのにキャンバスが保存されないのはなぜですか？

オーディエンスまたはステップレベルのフィルターにある空のカスタム属性フィルターが、詳細なバリデーションメッセージなしに保存をブロックすることがあります。各フィルターカードを開き、不完全なカスタム属性ルールを削除するか、属性名と値の両方を入力してから、もう一度保存を選択してください。

キャンバスやキャンペーンからタグが消えたのはなぜですか？

ワークスペースからタグが削除されると、Brazeはそのタグを参照していたすべてのキャンペーンとキャンバスからそのタグを削除します。このクリーンアップは、キャンバスの変更ログに独自の行として表示されない場合があります。

各キャンバスコンポーネントの分析を表示するにはどうすればよいですか？

キャンバスコンポーネントの分析を表示するには、キャンバスに移動し、キャンバスの詳細ページを下にスクロールします。ここで、各コンポーネントの分析を確認できます。詳細については、キャンバス分析をご覧ください。

キャンバスステップからのエンゲージメントはいつユーザープロファイルに表示されますか？

Received Message from キャンバス Stepなどのフィルターは、Brazeがそのステップに対応する送信、受信、またはエンゲージメントイベントを記録した後に更新されます。アプリ内メッセージは、送信スタイルの指標とは別にインプレッションを記録する場合があります。インプレッションが記録されているのに、キャンバスの送信数がゼロと表示されるのはなぜですか？を参照してください。これらのイベントは、キャンバスの詳細のステップ指標にも表示されます。

ユニークユーザー数を確認する場合、キャンバス分析とセグメンターのどちらがより正確ですか？

セグメンターは、キャンバスやキャンペーンの統計と比較して、ユニークユーザーデータに関するより正確な統計です。これは、キャンバスやキャンペーンの統計が、何かが発生したときにBrazeがインクリメントする数値であるためです。つまり、この数値がセグメンターの数値と異なる結果になる変数が存在する可能性があります。例えば、ユーザーはキャンバスやキャンペーンに対して複数回コンバージョンすることがあります。

キャンバスにエントリするユーザー数が予想と異なるのはなぜですか？

キャンバスにエントリするユーザー数が予想と異なる場合があります。これは、オーディエンスとトリガーの評価方法によるものです。Brazeでは、トリガーの前にオーディエンスが評価されます（属性値の変更トリガーを使用している場合を除く）。このため、トリガーアクションが評価される前に、選択したオーディエンスに属していないユーザーはキャンバスから脱落します。

匿名ユーザーはキャンバスジャーニー中にどうなりますか？

匿名ユーザーはキャンバスにエントリおよび退出できますが、そのアクションは識別されるまで特定のユーザープロファイルに関連付けられないため、インタラクションが分析で完全にトラッキングされない場合があります。クエリビルダーを使用して、これらの指標のレポートを生成できます。

現在キャンバスジャーニー中のユーザーをキャンペーンやセグメントから除外できますか？

Entered キャンバス Variation、In キャンバス Control Group、Received Message from キャンバス Stepなどのセグメンテーションフィルターを使用して、キャンバスのエントリ、バリアントの割り当て、またはステップのエンゲージメントに基づいてユーザーをターゲットできます。これらのフィルターはエントリ履歴とインタラクションを評価するもので、ユーザーがアクティブなジャーニーをまだ進行中かどうかを示すものではありません。

アクティブなキャンバスへの参加に基づいてユーザーを含めたり除外したりするには、キャンバスのエントリと退出にユーザー更新ステップを追加してカスタム属性を設定およびクリアし、キャンペーンやセグメントでそれらの属性をフィルタリングしてください。

セグメンテーション

「キャンバスバリエーションに入っていない」と「キャンバスコントロールグループに入っていない」の違いは何ですか？

フィルターの完全な定義については、セグメンテーションフィルターを参照してください。

キャンバスバリエーションに入っていない

ユーザーが特定のキャンバスのバリエーションパスに一度も入ったことがないことを意味します。コントロールグループに入っていないすべてのユーザーが含まれ、キャンバスに入ったかどうかは問いません。これには、別のバリエーションに入ったユーザーや、どのバリエーションにも入っていないユーザーが含まれます。

キャンバスコントロールグループに入っていない

ユーザーがキャンバスに入ったものの、コントロールグループには入っておらず、結果としてバリエーションを受け取ったことを意味します。これにはキャンバスに入ったユーザーのみが含まれます。

バリエーションの割り当てはキャンバスへのエントリ時に行われます。ユーザーがキャンバスに入っていない場合、バリアントは割り当てられません。つまり、コントロールグループにもバリアントにも含まれません。

オリジナルキャンバスエディター

オリジナルキャンバスエディターのFAQを展開

オリジナルエディターの既存のキャンバスを現在のエディターに変換するにはどうすればよいですか？

キャンバスを複製できます。これにより、最新のキャンバスワークフローでオリジナルキャンバスのコピーが作成されます。

現在のキャンバスエディターとオリジナルキャンバスエディターの主な違いは何ですか？

キャンバスコンポーネントツールバー

以前のオリジナルキャンバスエディターでは、ユーザージャーニーにステップを作成するたびに、デフォルトでフルステップが追加されていました。これらのフルステップは、さまざまなキャンバスコンポーネントに置き換えられ、編集体験の可視性とカスタマイズ性が向上しています。キャンバスステップツールバーからすべてのキャンバスコンポーネントをすぐに確認できます。

ステップの動作

以前は、各フルステップに遅延とスケジュール設定、例外イベント、オーディエンスフィルター、メッセージ設定、メッセージ進行オプションなどの情報がすべて1つのコンポーネントに含まれていました。現在のエディターでは、これらは個別の設定になっており、キャンバス構築体験がよりカスタマイズ可能になり、機能面でもいくつかの違いが生じています。

メッセージコンポーネントの進行

メッセージコンポーネントは、ステップに入ったすべてのユーザーを進行させます。メッセージ進行の動作を指定する必要がないため、全体的なステップの設定がシンプルになります。メッセージ送信時に進行オプションを実装する場合は、前のステップを受信しなかったユーザーをフィルタリングするために、別のオーディエンスパスを追加してください。

遅延の「in」動作

遅延コンポーネントは、次のステップに進む前に遅延時間全体を待機します。

たとえば、4月12日に遅延コンポーネントがあり、1日後の午後2時にユーザーを次のステップに送るように遅延が設定されているとします。ユーザーが4月13日の午後2時1分にコンポーネントに入ったとします。

  • オリジナルのワークフローでは、ユーザーは4月14日の午後2時に次のステップに進みます。これはエントリ時間から1日未満です。
  • 現在のエディターでは、ユーザーは4月15日の午後2時に次のステップに進みます。同じ時刻ですが、エントリ時間から1日以上経過していることに注意してください。

インテリジェントタイミングの動作

インテリジェントタイミングはメッセージコンポーネントに保存されるため、遅延はインテリジェントタイミングの計算前に適用されます。つまり、ユーザーがコンポーネントに入るタイミングによっては、オリジナルのキャンバスワークフローで構築されたキャンバスよりも遅くメッセージを受信する場合があります。

たとえば、遅延が2日に設定され、インテリジェントタイミングがオンになっており、メッセージの最適な送信時刻が午後2時と判断されたとします。ユーザーが午後2時1分に遅延ステップに入ったとします。

  • 現在のワークフロー： 遅延が経過するまで48時間かかるため、ユーザーは3日目の午後2時にメッセージを受信します。
  • オリジナルのワークフロー： ユーザーは2日目の午後2時にメッセージを受信します。

インテリジェントタイミングがオンの場合、ユーザーがメッセージコンポーネントに入ってから24時間以内に、特定されたインテリジェントな時刻にメッセージが送信されます（遅延コンポーネントが関与していない場合でも同様です）。

例外イベント

サイレント時間帯

例外イベントはアクションパスを使用して適用され、メッセージステップとは分離されています。サイレント時間帯はメッセージコンポーネントで適用されます。つまり、ユーザーがすでにアクションパスを通過し（例外イベントで除外されず）、メッセージコンポーネントに到達した際にサイレント時間帯に遭遇し、キャンバスがサイレント時間帯後にメッセージを再送するように設定されていた場合、例外イベントは適用されなくなります。このユースケースは一般的ではないことに注意してください。

セグメントとフィルターについては、メッセージステップに配信バリデーションがあり、送信時に検証される追加のセグメントとフィルターをユーザーが設定できます。これにより、前述のサイレント時間帯のエッジケースを防止できます。

「in」または「on the next」スケジュール設定

例外イベントはアクションパスを使用して作成されます。アクションパスは「X時間ウィンドウの後」のみをサポートし、「X時間内」や「次のX時間に」はサポートしていません。

「リクエストタイムアウト」エラーのサポートチケットを送信する際に何を含めるべきですか？

キャンバスの編集中に「リクエストタイムアウト」エラーが発生し、Brazeサポートに連絡する必要がある場合は、解決を迅速に進めるために以下の情報を含めてください。

  • 画面録画: エラーが発生する前に行ったステップの録画（ページ遷移を含む）。
  • タイムスタンプとタイムゾーン: エラーが発生した正確な時刻とタイムゾーン。
  • ブラウザとバージョン: 使用しているブラウザ（例: Chrome 120、Safari 17）、および別のブラウザでエラーを再現できるか試したかどうか。
  • 再現手順: エラーをトリガーするアクションの明確な説明（関連する特定のキャンバスステップや設定を含む）。
  • ネットワークログ（任意）: ブラウザの開発者ツール（Network タブ）を開き、エラーを再現して、ネットワークログをHTTPアーカイブ（HAR）ログファイルとしてエクスポートします。これにより、サポートチームがタイムアウトしているAPI呼び出しを特定しやすくなります。

キャンバスの配信とトラブルシューティング

孤立したユーザーはキャンバスメッセージを受信できますか？

いいえ。孤立したユーザーはメッセージを受信する資格がありません。ユーザーがキャンバスジャーニーの途中でプロファイルが孤立した場合、そのユーザーはフローからサイレントに退出します。分析では、その退出に対してExitedイベントが常に表示されるとは限らず、ワークフローサマリーにexited_dateやexit_reasonなしのpartial_update_tokenが含まれることがあります。

マージと孤立プロファイルの詳細については、重複ユーザーのマージを参照してください。

アクティブなキャンバスやキャンペーンを停止した場合、すでにESPに送信されたメッセージは引き続き配信されますか？

はい。Brazeがメールサービスプロバイダー (ESP) にリクエストを送信した後、Brazeはその送信を取り消すことはできません。キャンバスやキャンペーンを停止すると、新しい送信リクエストは防止されますが、すでにESPに引き渡されたメッセージは引き続き配信される可能性があり、ESPが処理する際に送信カウントが増加することがあります。

これはキャンバスを停止した場合に記載されている動作と同じです。配信途中のメール送信はすぐには停止されません。

ユーザーに表示されるコンテンツなしでキャンバスのWebhookステップが実行されたことを確認するにはどうすればよいですか？

Brazeは、キャンペーンとキャンバスのWebhookステップについて、Webhookの送信数と関連する配信結果をトラッキングします。ステップの分析、Webhookレポート、またはCurrentsのWebhookイベントを使用して、ステップが実行されたことを確認してください。エンドポイントのリクエストログは、サーバー側で受信の証明が必要な場合に追加の確認を提供します。

BrazeにはWebhookステップ用の非表示トラッキングピクセルは組み込まれていません。カスタムの1ピクセル画像リクエストではなく、BrazeのWebhookメトリクスとエンドポイントのロギングを利用してください。

Webhookステップにボディフィールドがないのはなぜですか？

Webhookステップは、POST、PUT、PATCH、DELETEのリクエストボディを使用します。メソッドをGETに切り替えると、GETリクエストはリクエストボディをサポートしないため、Brazeはボディフィールドを削除します。JSONやフォームデータを送信する必要がある場合は、ボディをサポートするメソッドに戻してください。メソッドの詳細については、Webhookを作成するを参照してください。

Webhookステップでspacer.gifを使用するにはどうすればよいですか？

Brazeはcdn.braze.comおよびbraze-images.comにspacer.gifプレースホルダー画像をホストしています。一部のチームは、外部エンドポイントを呼び出さずにステップを実行する必要がある場合に、WebhookのURLをこの画像に向けています。標準のWebhookステップは実際のエンドポイントを呼び出すべきです。Webhookレポートとエンドポイントのログを使用して配信を確認してください（ユーザーに表示されるコンテンツなしでキャンバスのWebhookステップが実行されたことを確認するにはどうすればよいですか？を参照）。

「invalid next-step-id」エラーでキャンバスが読み込まれないのはなぜですか？

このコンソールエラーは、少なくとも1つのステップが欠落または無効な次のステップを指していることを意味します。たとえば、部分的な削除、複製、またはインポートの後に発生することがあります。エディターでキャンバスを開き、孤立したステップを再接続するか、有効な下流パスがなくなったステップを削除してください。キャンバスがまだ読み込まれない場合は、キャンバスIDとコンソールエラーのスクリーンショットを添えてBrazeサポートに連絡してください。

Currentsのキャンバスコンバージョンのタイムスタンプがキャンバスの分析と異なるのはなぜですか？

Currentsはキャンバスコンバージョンをusers.canvas.Conversionイベントとして記録します。イベントのtimeはコンバージョンイベントが発生した時刻です。そのイベントのconversion_behaviorフィールドは、コンバージョン定義（タイプとウィンドウ）を記述します。キャンバスの分析では、コンバージョンウィンドウ内のキャンバスエントリに対するコンバージョンもロールアップできます。エクスポートを照合する際は、Currentsのtimeをコンバージョンイベントのタイムスタンプおよびキャンバスのコンバージョンウィンドウ設定と比較してください。

Currentsでcanvas_step_nameがnullなのはなぜですか？

canvas_step_nameなどのキャンペーンおよびキャンバスの名前フィールドは、Brazeがステップメタデータの伝播を完了する前にCurrentsイベントが送信された場合（たとえば、ステップの作成またはリネーム後）にnullになることがあります。詳細については、Currentsデータでキャンペーン名またはキャンバスステップ名がNULLなのはなぜですか？を参照してください。

ユーザー更新ステップで配列が更新されないのはなぜですか？

ユーザー更新ステップのJSONを確認してください。配列やネストされた属性の更新には、変更する属性に対する有効なパスと値が必要です。外部ユーザーIDなど、ステップが自動的に提供するフィールドは含めないでください。ローンチ前にステップのプレビューとテストタブを使用してペイロードを確認してください。

external_idを持たないユーザーにキャンバスメッセージを送信できますか？

はい、Brazeユーザープロファイルがすでに存在する場合は可能です。external_idを持たないユーザーは匿名ユーザーであり、braze_idまたはユーザーエイリアスで参照できます。キャンバスエントリの前に/users/trackエンドポイントまたはSDKでプロファイルを作成または更新し、アクションベースまたはAPIトリガーエントリを使用してください。標準のキャンバスターゲティングにはBrazeユーザープロファイルが必要です。プロファイルなしでメールアドレスだけにキャンバスメッセージを送信することはできません。

ユーザーがトリガーイベントを実行した回数よりも少ない回数でキャンバスにエントリしたのはなぜですか？

アクションベースおよびAPIトリガーキャンバスの場合、Brazeはトリガーイベントを重複排除するため、同じキャンバスに対してユーザーは最大で約1秒に1回しかエントリできません。ユーザーが1秒以内に同じトリガーを複数回実行した場合、1回のエントリのみが処理されます。

同じ秒内に複数のエントリを許可するには、トリガーイベントの間隔を少なくとも1.1秒空けてください（たとえば、サーバーからイベントタイミングを制御する場合）。同じ秒内の複数のトリガーを許可するキャンペーンスタイルの動作については、適切なスケジューリングと再エリジビリティ設定を使用したキャンペーンとユースケースを比較してください。

APIトリガーキャンバスでユーザーが重複排除されるのはいつですか？

ユーザーがAPIトリガーキャンバスに再エントリし、前回のエントリで同一メッセージのためにすでにキューに入っている遅延ステップに到達した場合、Brazeは重複送信を防ぐためにユーザーを重複排除します。2番目のキャンバスインスタンスは退出するため、エントリ数が送信数を超えることがあります。

テストプッシュが意図しないアプリに送信されるのに、ライブ送信では正しく表示されるのはなぜですか？

ユーザープロファイルのテストプッシュは、そのプロファイルのプッシュ対応のすべてのデバイスに配信されます。デバイスに複数のアプリがインストールされている場合、OSは通常、最初に利用可能なアプリにテスト通知を配信しますが、これは検証したいアプリとは異なる場合があります。

アプリ固有のターゲティングを確認するには、プロファイルのテストプッシュだけに頼るのではなく、狭いオーディエンス（たとえばexternal_idでフィルタリング）を使用したキャンペーンまたはキャンバスを通じてライブまたはテストメッセージを送信してください。

複数のアプリを持つキャンバスメッセージステップでは、メッセージステップの送信時にオーディエンスを検証をオンにして、セグメントとフィルターのチェックが送信時に実行されるようにしてください。詳細については、メッセージステップを参照してください。

テストプッシュの一般的な動作については、テストメッセージの送信とプッシュFAQを参照してください。

iOSとAndroidでPush Storiesをデバッグするにはどうすればよいですか？

セットアップとクリエイティブの要件については、Push Storiesを参照してください。実装とリッチ通知の処理については、開発者ガイドのリッチ通知とPush Storiesを参照してください。

「キャンバス Messages Delayed 24+ Hours」メールは誰が受信しますか？

Brazeは、キャンバスメッセージがレート制限により24時間以上遅延した場合にこの通知を送信します。メールは、影響を受けるキャンバスに以前変更を加えたダッシュボードユーザーに送信されます（キャンバスの変更ログに基づきます）。Brazeがそれらの受信者を特定できない場合、メールはワークスペースの会社管理者に送信されます。

例外イベント後、ユーザーはいつメッセージの受信を停止しますか？

Brazeは例外イベントが発生するとすぐに退出を記録しますが、タイマーが終了するまでユーザーはステップ内に残ることがあります。これは遅延ステップで最も顕著です。動作はスケジュールされたステップとイベントトリガーステップでも異なります。タイムライン、例、分析のニュアンスについては、終了基準を参照してください。

メールのインタラクティビティトリガー（たとえば、メール内のエイリアスをクリックや任意のキャンペーンまたはキャンバスステップでエイリアスをクリック）を使用するアクショングループには、そのリンクを含むメッセージをすでに送信したメッセージステップが必要です。アクションパスステップがクリックを評価する前にメールが送信されるようにステップを追加または並べ替えるか、ユーザーがこのキャンバスですでに受信したメッセージに一致するインタラクションを選択してください。インタラクショントリガーの完全なリストについては、アクションベース配信を参照してください。

過去のカスタムイベントのタイムスタンプは、アクションベースのキャンバスやキャンペーンにどのように影響しますか？

Brazeは、対象となるイベントが取り込まれ、ユーザーがオーディエンスルールを満たしたときにアクションベースのジャーニーを評価します。イベントがキャンバスやキャンペーンがアクティブだったウィンドウの外でプロファイルに到着した場合、またはユーザーがオーディエンスに一致する前にイベントが到着した場合、エントリや下流の送信が期待どおりに発生しない可能性があります。イベントのタイムスタンプを稼働開始時間およびセグメントメンバーシップと比較するには、ユーザープロファイルのアクティビティログとカスタムイベントのトラブルシューティングのトラブルシューティング手順を使用してください。動作が期待と一致しない場合は、Brazeサポートに連絡してください。

Brazeカスタマーエンゲージメントプラットフォームのドキュメント。

リソース
法的情報
会社情報
© 2026 Braze, Inc. All rights reserved.
Braze ステータスの確認
New Stuff!