よくある質問
この記事では、キャンバスに関するよくある質問への回答を提供します。
キャンバスの構築と編集
キャンバスにはいくつのステップを含めることができますか？
1つのキャンバスには最大200のステップを追加できます。
キャンバスステップ名の最大文字数はいくつですか？
キャンバスステップ名は最大256文字です。
キャンバスエントリープロパティにサイズ制限はありますか？
はい。キャンバスコンテキストオブジェクト（キャンバスエントリープロパティ）の最大サイズは50 KBです。この制限内で、ペイロードはできるだけ小さくしてください。キャンバスにおけるエントリープロパティとイベントプロパティの仕組みについては、コンテキストプロパティとイベントプロパティを参照してください。
「Too many キャンバス branches」エラーが表示されるのはなぜですか？
このエラーは、ステップの分岐とエントリーオーディエンスのサイズの組み合わせによって、メッセージの送信を妨げるクラスターのパフォーマンス問題が発生する可能性がある場合に表示されます。オーディエンスパスの使用、分岐やオーディエンスサイズの削減、キャンバスフローでの再構築などの解決手順については、「Too many キャンバス branches」エラーを参照してください。
キャンバスで再適格性とともに Optimize with BrazeAITM を使用できますか？
はい。キャンバスでは、再適格性が有効な場合でも Optimize with BrazeAITM を使用できます。割り当ては時間とともに変化するため、再エントリー時に同じバリアントになることは保証できません。キャンペーンで Optimize with 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テストを参照してください。
キャンバスのメッセージステップでユーザーがグローバルフリークエンシーキャップの対象になった場合はどうなりますか？
キャップの対象となったチャネルでは、そのユーザーは送信を受信しません。ただし、グローバルフリークエンシーキャップによってメッセージが送信されなかった場合でも、メッセージステップはユーザーを次に進めます。ステップごとの進行ケースについては、ユーザーの進み方を参照してください。グローバルフリークエンシーキャップだけでユーザーがキャンバスから退出することはありません。この動作は、メッセージステップの配信検証とは別のものです。詳細については、レート制限とフリークエンシーキャップを参照してください。
送信数が推定オーディエンスサイズより少ないのはなぜですか？
送信数が推定オーディエンスより少なくなる理由の多くは、キャンペーンの場合と同じです。たとえば、フリークエンシーキャップ、厳格なデバイスやブラウザーのフィルター、再エligibility期間、レート制限、チャネルレベルの除外（プッシュの到達可能性や、メールの購読および配信到達性のチェックなど）が挙げられます。
キャンバス固有の要因もあります。
- アクションベースまたはAPIトリガーのエントリ: ユーザーはエントリ行動を実行した後にのみエントリ（およびステップを受信）するため、実際の送信数はそれらのアクションが発生するまで事前の推定値を下回ります。
- オーディエンスパス: ユーザーは条件を満たす中で最も優先度の高い分岐に振り分けられるため、下流の分岐は単純なセグメントの人数から想定されるよりも少ないユーザーしか受け取らない場合があります。
- オーディエンスと送信時のチェック: 別途設定しない限り、フルステップは送信時にフィルターを再評価します。キャンバスの作成時に条件を満たしていたユーザーも、メッセージの送信前に対象外になる場合があります。
- コントロールグループ: グローバルまたはキャンバスのコントロールグループは、エントリしたユーザーの一部をメッセージングの対象外にします。
- サイレント時間と遅延: メッセージが保留または再スケジュールされ、表示しているレポート期間の外に送信がずれる場合があります。
- 最大エントリ数またはオーディエンスの上限: 基になるセグメントがより大きい場合でも、エントリ数や送信数の上限によって追加のユーザーが停止されます。
- レポート期間: 分析の期間に、推定値と比較しているすべての送信が含まれていない場合があります。
推定オーディエンスとキャンバスのユーザー数が一致しないのはなぜですか？
推定オーディエンスは、推定を実行した時点でセグメントとエントリフィルターに一致するユーザーを反映しています。その後、遅延エントリやアクションベースのエントリ、再エligibility、APIトリガー、分岐による振り分けによって、ジャーニーに関与するプロファイル数がスナップショット時点より増える場合があります。また、送信時のフィルターを満たさなかったユーザーは対象外となり、実際のエントリ数や送信数が減少します。タイミング、上限、評価の設定を、送信数が推定オーディエンスサイズより少ないのはなぜですか？とあわせて比較してください。
ユニーク受信者数が、ターゲットにしたユーザー数より多いのはなぜですか？
Brazeはキャンバスとキャンペーンのレポートで日次のユニーク受信者を追跡するため、ユニーク受信者数が想定していたオーディエンスより多くなることがあります。これにより、ジャーニー内でユーザーがメッセージを受信するたびに、正確なコンバージョンアトリビューションを行えます。
たとえば、ユーザーが月曜日と金曜日にキャンバスステップを受信し、それぞれの送信後にコンバージョンした場合、Brazeは受信者を2行、対象となるコンバージョンを2件としてカウントすることがあります。定期的なエントリや再エligibilityがある場合、同じ少数のプロファイルが数日間にわたって複数のユニーク受信者を生み出すことがあります。
キャンバスの送信率が低下しているのはなぜですか？
毎日スケジュールしているキャンバスの送信先ユーザーが時間の経過とともに減少している場合は、次の点を確認してください。
- 再エligibilityがオンになっているか確認する: 再エligibilityがない場合、Brazeは各ユーザーをキャンバスに1回だけエントリさせます。毎日スケジュールされたキャンバスでは、オーディエンスに一致し、まだキャンバスにエントリしていないユーザーだけが各回のエントリの対象になります。エントリするユーザーが増えるにつれて、以降の各回で対象となるユーザーが減るため、エントリ数が減少します。
- オーディエンスのメンバーが固定されていないか確認する: 固定のユーザーリスト（セグメントフィルターとして使用されるCSVインポートなど）で作成したオーディエンスには、新しいメンバーが自動的に追加されません。新しいエントリ対象者がいないと、ユーザーがキャンバスにエントリするにつれてエントリ数は回復しません。
配信速度のレート制限や、1回の送信で送信数が少なくなるその他の要因については、送信数が推定オーディエンスサイズより少ないのはなぜですか？を参照してください。
小規模なコントロールグループのセグメントで、過去のメンバーシップに変動が表示されるのはなぜですか？
過去のメンバーシップのグラフは推定サンプルを使用しているため、グローバルコントロールグループのセグメントを含む小規模なセグメントでは、基になるオーディエンスが安定していても日ごとに変動が表示されることがあります。推定の仕組みとグラフが変動する理由については、過去のセグメントメンバーシップサイズの表示を参照してください。
分析とコンバージョン
コンバージョンダッシュボードでは、キャンバスのコンバージョンをどのようにアトリビューションしますか？
コンバージョンダッシュボードは、選択したアトリビューション方法（受信時、送信時、開封時、クリック時など）に基づいて、キャンバスのコンバージョンをアトリビューションします。ユーザーがレポートに表示されるには、キャンバスまたはキャンペーンにエントリし、選択したアトリビューション方法のイベントを記録し、レポート設定の範囲内でコンバージョンイベントを実行する必要があります。
キャンバス分析におけるステップレベルおよびバリアントレベルのコンバージョンルールについては、キャンバスでユーザーのコンバージョンはどのようにトラッキングされますか？を参照してください。
キャンバスでユーザーのコンバージョンはどのようにトラッキングされますか？
ユーザーがコンバージョンできるのは、キャンバスのエントリごとに1回のみです。コンバージョンは、そのエントリでユーザーが受信した最新のメッセージに割り当てられます。キャンバスの冒頭にあるサマリーブロックには、メッセージを受信したかどうかにかかわらず、そのパス内のユーザーが実行したすべてのコンバージョンが反映されます。後続の各ステップには、そのステップがユーザーが受信した最新のステップであった間に発生したコンバージョンのみが表示されます。
ユーザーがキャンバスに再エントリした場合、コンバージョンイベントは最新のエントリについてのみトラッキングされます。コンバージョンイベントがバックフィルされた場合でも、以前のエントリについてはコンバージョンイベントは記録されません。
例を展開する
例1
10件のプッシュ通知を含むキャンバスパスがあり、コンバージョンイベントは「セッション開始」（「アプリを開く」）です。
- ユーザーAは、エントリした後、最初のメッセージを受信する前にアプリを開きます。
- ユーザーBは、各プッシュ通知の後にアプリを開きます。
結果: サマリーには2件のコンバージョンが表示されますが、個々のステップでは、最初のステップのコンバージョンが1件、後続のすべてのステップが0件と表示されます。
コンバージョンイベントの発生時にサイレント時間が有効になっている場合も、同じルールが適用されます。
例2
サイレント時間が有効になっている1ステップのキャンバスがあります。
- ユーザーがキャンバスにエントリします。
- 最初のステップには遅延がありませんが、設定されたサイレント時間内であるため、メッセージは抑制されます。
- ユーザーがコンバージョンイベントを実行します。
結果: ユーザーはキャンバスバリアント全体ではコンバージョンしたとカウントされますが、ステップを受信していないため、ステップではカウントされません。
コンバージョン率の種類にはどのような違いがありますか？
- キャンバスの総コンバージョン数は、各ユーザーが完了したコンバージョンの数ではなく、コンバージョンイベントを完了したユニークユーザーの数を反映します。
- バリアントのコンバージョン率、またはキャンバスの冒頭にあるサマリーブロックは、メッセージを受信したかどうかにかかわらず、そのパス内のユーザーが実行したすべてのコンバージョンを合計として反映します。
- ステップのコンバージョン率は、そのメッセージステップを受信し、設定されたいずれかのコンバージョンイベントを完了した人数を反映します。
キャンバスステップのコンバージョン率がキャンバスバリアントの総コンバージョン率と一致しないのはなぜですか？
キャンバスバリアントのコンバージョン合計が、そのステップ合計の和より大きくなることはよくあります。これは、ユーザーがバリアントにエントリした時点で、そのバリアントのコンバージョンイベントを実行できるためです。ただし、この同じコンバージョンイベントはキャンバスステップにはカウントされません。そのため、キャンバスにエントリし、最初のキャンバスステップを受信する前にコンバージョンイベントを実行したユーザーは、バリアントのコンバージョン合計にはカウントされますが、ステップ合計にはカウントされません。キャンバスにエントリしたものの、いずれのステップも受信する前にキャンバスを退出したユーザーについても同様です。
また、ユーザーがバリアントにエントリし、ステップからメッセージを送信されずにコンバージョンすることもあります。この場合、ステップレベルではコンバージョンは記録されません。ただし、ユーザーは技術的にはコンバージョンしているため、キャンバスレベルではコンバージョンが記録されます。
ユーザーがAPIトリガーのキャンバスを受信したかどうかを確認するにはどうすればよいですか？
キャンバスフィルターを使用してセグメントを作成すると、ユーザーがキャンバスにエントリしたか、特定のキャンバスステップを受信したかを確認できます。例えば、ユーザーがAPIトリガーのキャンバスにエントリしたことを確認したい場合はキャンバスエントリフィルターを、キャンバスからメッセージを受信したことを確認したい場合は受信ステップフィルターを使用します。その後、/users/export/segmentエンドポイントを使用して、そのセグメント内のユーザーをエクスポートします。
キャンバスを削除できますか？
いいえ。ただし、キャンバスをアーカイブすることはできます。
アーカイブしたキャンバスまたはキャンペーンを再開するにはどうすればよいですか？
アーカイブされたメッセージは、編集可能な状態に戻すまで送信されません。キャンペーンまたはキャンバスをアーカイブ解除し、エントリスケジュールまたは送信時間を将来の期間に設定してから（クリーンなコピーが必要な場合はジャーニーを複製します）、必要に応じて再開またはリリースします。詳しくは、キャンペーンとキャンバスをアーカイブするを参照してください。
エラーが表示されないのにキャンバスが保存されないのはなぜですか？
オーディエンスフィルターまたはステップレベルのフィルターに空のカスタム属性フィルターがあると、詳細な検証メッセージが表示されないまま保存がブロックされることがあります。各フィルターカードを開き、不完全なカスタム属性ルールを削除するか、属性名と値の両方を入力してから、もう一度保存を選択してください。
キャンバスまたはキャンペーンからタグが消えたのはなぜですか？
ワークスペースからタグが削除されると、Brazeはそのタグを参照していたすべてのキャンペーンとキャンバスからタグを削除します。このクリーンアップは、キャンバスの変更ログに必ずしも個別の行として記録されるわけではありません。
各キャンバスコンポーネントの分析を表示するにはどうすればよいですか？
キャンバスコンポーネントの分析を表示するには、キャンバスに移動し、キャンバスの詳細ページを下にスクロールします。ここで各コンポーネントの分析を確認できます。詳しくは、キャンバス分析を参照してください。
キャンバスステップのエンゲージメントがユーザープロファイルに表示されるのはいつですか？
Received Message from キャンバス Stepなどのフィルターは、Brazeがそのステップに対応する送信、受信、またはエンゲージメントイベントを記録した後に更新されます。アプリ内メッセージでは、インプレッションが送信系の指標とは別に記録される場合があります。インプレッションが記録されているのに、キャンバスの送信数がゼロと表示されることがあるのはなぜですか？を参照してください。これらのイベントは、キャンバスの詳細のステップ指標にも表示されます。
ユニークユーザー数を確認する場合、キャンバス分析とセグメンターのどちらがより正確ですか？
ユニークユーザーデータについては、キャンバスやキャンペーンの統計よりもセグメンターの方が正確です。これは、キャンバスとキャンペーンの統計が、何かが発生したときにBrazeが加算する数値であるためです。つまり、この数値がセグメンターの数値と異なる結果になる要因が存在します。例えば、ユーザーはキャンバスまたはキャンペーンで複数回コンバージョンすることがあります。
キャンバスにエントリしたユーザー数が想定と一致しないのはなぜですか？
キャンバスにエントリするユーザー数は、オーディエンスとトリガーの評価方法によって、想定した数と異なる場合があります。Brazeでは、オーディエンスはトリガーより先に評価されます（属性の変更トリガーを使用する場合を除く）。そのため、トリガーアクションが評価される前に選択したオーディエンスに含まれていないユーザーは、キャンバスから除外されます。
キャンバスのジャーニー中、匿名ユーザーはどうなりますか？
匿名ユーザーもキャンバスにエントリしたり退出したりできますが、識別されるまでその行動は特定のユーザープロファイルに関連付けられないため、インタラクションが分析で完全にトラッキングされない場合があります。クエリビルダーを使用すると、これらの指標のレポートを生成できます。
キャンバスのトラブルシューティングについてさらにサポートが必要な場合は、問題の発生から30日以内にBrazeサポートにお問い合わせください。診断ログは過去30日分のみ保持されています。
現在キャンバスのジャーニー中のユーザーを、キャンペーンやセグメントから除外できますか？
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時間」はサポートしていません。
「Request Timed Out」エラーのサポートチケットを送信する際には、何を含めればよいですか？
キャンバスの編集中に「Request Timed Out」エラーが発生し、Brazeサポートに問い合わせる必要がある場合は、解決を早めるために以下の情報を含めてください。
- 画面録画: エラーが発生する前に行ったステップの録画（ページ遷移を含む）。
- タイムスタンプとタイムゾーン: エラーが発生した正確な時刻とタイムゾーン。
- ブラウザとバージョン: 使用しているブラウザ（例: Chrome 120、Safari 17）、および別のブラウザでエラーを再現できるか試したかどうか。
- 再現手順: エラーをトリガーするアクションの明確な説明（関連する特定のキャンバスステップや設定を含む）。
- ネットワークログ（任意）: ブラウザの開発者ツール（Network タブ）を開き、エラーを再現して、ネットワークログをHTTPアーカイブ（HAR）ログファイルとしてエクスポートします。これにより、サポートチームがタイムアウトしているAPI呼び出しを特定しやすくなります。
キャンバスの配信とトラブルシューティング
孤立ユーザーはキャンバスメッセージを受信できますか？
いいえ。孤立ユーザーはメッセージを受信できません。ユーザーがキャンバスのジャーニーに参加している間にプロファイルが孤立した場合、そのユーザーは通知なしにフローから退出します。この退出について、分析に退出イベントが常に表示されるとは限りません。また、ワークフローの概要に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サポートにお問い合わせください。