よくある質問

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

キャンバスの作成と編集

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

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

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

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

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

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

キャンバスで再エントリを有効にしてBrazeAI^TMで最適化を使用できますか？

はい。キャンバスでは、再エントリが有効な場合にBrazeAI^TMで最適化を使用できます。Brazeは再エントリ時に同じバリアントを保証することはできません。これは、アロケーションが時間の経過とともに変化するためです。キャンペーンでは、BrazeAI^TMで最適化がオンの場合、再エントリ待機期間は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は各ユーザーをキャンバスに1回だけ入場させます。日次スケジュールキャンバスでは、オーディエンスに一致し、まだキャンバスに入場していないユーザーのみが各エントリの対象となります。より多くのユーザーが入場するにつれて、後のエントリではそれぞれ対象ユーザーが少なくなり、エントリボリュームが減少します。
• オーディエンスのメンバーシップが固定されていないか確認：固定ユーザーリスト（セグメントフィルターとして使用されるCSVインポートなど）から構築されたオーディエンスは、自動的に新しいメンバーを獲得しません。新しいエントリユーザーがいなければ、ユーザーがキャンバスに入場するにつれてエントリボリュームは回復できません。

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

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

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

分析とコンバージョン

コンバージョンダッシュボードではキャンバスのコンバージョンをどのように帰属させますか？

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

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

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

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

例を表示

例1

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

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

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

注

コンバージョンイベント発生時にサイレント時間帯が有効な場合も、同じルールが適用されます。

例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を確認してください。配列やネストされた属性の更新には、変更する属性の有効なパスと値が必要です。external user 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サポートにお問い合わせください。