コンテンツにスキップ

よくある質問

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

キャンバスの作成と編集

キャンバスに含めることができるステップ数はいくつですか？

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

例を展開

例 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つのコンポーネントに含まれていました。現在のエディターではこれらが個別の設定になっており、キャンバス構築エクスペリエンスのカスタマイズ性が向上し、機能面でもいくつかの違いがあります。

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

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

遅延の「～以内」の動作

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

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

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

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

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

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

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

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

例外イベント

サイレント時間

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

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

「～以内」または「次の～」のスケジュール設定

例外イベントはアクションパスを使用して作成されます。アクションパスは「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!