起動後のキャンバスの編集

このリファレンス記事では、初回起動後にキャンバスで変更できる内容について説明します。

起動後のキャンバスは、以下の方法で編集できます。

• ユーザージャーニーへの新しいキャンバスステップの挿入
• 新しいバリアントと接続の追加
• バリアント配分の調整
• すべてのキャンバスステップの停止または再開

ユーザージャーニーでは、以下の項目を削除できます。

• キャンバスステップ
• キャンバスバリアント
• キャンバスステップ間の接続

キャンバスのユーザージャーニーでステップを編集または追加する場合、以下の詳細が適用されます。

• まだキャンバスに入っていないユーザーは、新しく作成されたすべてのステップの対象となります。
• キャンバスのエントリ設定でユーザーがステップに再入場できる場合、新しく作成されたステップをすでに通過したユーザーも再入場の対象となります。
• 起動済みのキャンバスに現在いるユーザーで、新しいステップが追加されたユーザージャーニーのポイントにまだ到達していないユーザーは、新しく追加されたステップを受け取る対象となります。

遅延ステップまたはアクションパスステップを削除する場合、そのステップで現在待機中のユーザーを別のキャンバスステップにリダイレクトすることもできます。遅延の場合、ユーザーは遅延期間の終了までステップに留まります。アクションパスの場合、ユーザーは評価時間枠の終了までステップに留まります。

キャンバスを最初に起動すると、Braze はユーザーが現在いるメッセージステップのキューにユーザーを追加しますが、キャンバス内の後続のすべてのメッセージのキューには追加しません。起動後にキャンバスを編集した場合、一部のユーザーはすでにキューに追加されており、変更が反映されない場合があります。キャンバスを停止し、複製してから変更を加え、新しいバージョンを起動すると、キャンバスはすでにキューに追加されたユーザーだけでなく、すべてのユーザーを再評価します。

具体的な編集のユースケースについては、ベストプラクティスセクションを参照してください。一般的に、予期しない動作が発生する可能性があるため、ライブキャンバスの編集は避けることがベストプラクティスです。

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

キャンバスがどのワークフローで作成されたかに応じて、起動後に許可されるキャンバスの編集内容を以下に示します。キャンバスがオリジナルのキャンバスワークフローを使用している場合、起動後の編集を行うには、まずキャンバスフローに複製する必要があります。

既存の接続を編集または削除することはできず、既存の接続されたステップの間にステップを挿入することもできません。キャンバスのユーザージャーニーでステップを編集または追加する場合、以下の詳細が適用されます。

• まだキャンバスに入っていないユーザーは、新しく作成されたすべてのステップの対象となります。
• キャンバスのエントリ設定でユーザーがステップに再入場できる場合、新しく作成されたステップをすでに通過したユーザーも再入場の対象となります。
• 起動済みのキャンバスに現在いるユーザーで、ユーザージャーニーの新しく追加されたステップにまだ到達していないユーザーは、新しく追加されたステップを受け取る対象となります。
• 遅延ステップがキャンバスの最後のステップである場合、そのステップに到達したユーザーは自動的にキャンバスから退出し、新しく作成されたステップを受け取りません。

重要:

キャンバスステップの遅延または時間枠設定を更新した場合、更新時にそのステップにいるユーザーは、最初にステップに入った時に割り当てられた遅延時間に従います。キャンバスに新しく入るユーザーと、そのステップのキューにまだ追加されていないユーザーのみが、更新された時間にメッセージを受け取ります。

キャンバスを停止しても、メッセージの受信を待っているユーザーは退出しません。キャンバスを再度有効にし、ユーザーがまだメッセージを待っている場合、ユーザーはメッセージを受け取ります（メッセージが送信されるべき時間が過ぎている場合は受け取りません）。

キャンバスの詳細

キャンバスの起動後に、以下の設定と詳細を編集できます。

• キャンバスの名前と説明
• チームとタグ
• エントリタイプ、スケジュール、コントロール
• サブスクリプションステータス
• レート制限
• フリークエンシーキャップ
• サイレント時間
• ターゲットオーディエンス

キャンバスの起動後:

• コンバージョンイベントは編集できません。
• 以下のステップは追加・削除できず、ランキングを調整するための並べ替えもできません: オーディエンスパス、アクションパス、実験パス。
  • 回避策 1: 新しいオーディエンスパス、アクションパス、または実験パスを作成し、その新しいステップにパスを再設定します。
  • 回避策 2: キャンバスを複製して編集を行います。

個別のステップ

個別のキャンバスステップについては、起動後に以下の詳細を編集できます。

• 名前
• メッセージコンテンツ
• トリガー
• オーディエンス
• 例外イベント
• 遅延（遅延ステップのみ）

ただし、ステップのスケジュールタイプとコントロールの割合は起動後に編集できません。アクションパスとオーディエンスパスのステップでは、ランキングと評価時間枠は起動後に編集できません。

キャンバスバリアントの割合

キャンバスの起動後は、コントロールバリアントの割合を減少させることのみ可能です。キャンバスでバリアントの割合が変更されると、ユーザーが他のバリアントに再配分される場合があります。

最初に、ユーザーはキャンペーンを初めて受け取る前に、特定のバリアントにランダムに割り当てられます。それ以降、キャンペーンを受け取るたびに（またはユーザーがキャンバスバリアントに再入場するたびに）、バリアントの割合が変更されない限り、同じバリアントを受け取ります。

バリアントの割合が変更されると、ユーザーは他のバリアントに再配分される場合があります。ユーザーは割合が再度変更されるまで、そのバリアントに留まります。なお、ランダムバケット番号を使用した NOT フィルターによる分岐を使用するキャンバスでは、ユーザーがキャンバスに再入場する際に、ユーザージャーニーで毎回同じ Branch を受け取るとは限りません。

コントロールグループ

バリアントの割合が変更されていない場合、コントロールグループは一貫性を保ちます。コントロールグループの割合が減少または増加した場合、以前にメッセージを受け取ったユーザーは後の送信でコントロールグループに入ることができず、コントロールグループ内のユーザーがメッセージを受け取ることもありません。

ローカル送信時間

ローカル送信時間で起動がスケジュールされたキャンバスは、スケジュールされた送信時間の最大24時間前まで編集できます。この時間枠は「セーフゾーン」と呼ばれます。

エントリスケジュールが起動時にユーザーを即座に入場させるように設定されている場合、キャンバスは5分刻みの最も近い時間に起動します。たとえば、午前8時31分（PST）にユーザーを即座に入場させるようにキャンバスを更新した場合、起動時間は午前8時30分（PST）に設定され、会社のタイムゾーンが適用されます。

バリアントの削除

キャンバスからバリアントが削除されると、以下のことが発生します。

• バリアント内のステップ（他のバリアントと共有されているステップを含む）が削除されます。
• ステップの分析と、合計エントリ数、合計退出数、コンバージョン率などのキャンバスのトップレベルの分析が削除されます。
• 削除されたバリアント内のユーザーはステップから退出し、後続のメッセージは送信されません。

キャンバスエントリプロパティ

キャンバスエントリプロパティは、送信時にステップにテンプレート化されません。つまり、キャンバスの起動後にキャンバスエントリプロパティが編集された場合、これらの変更はキャンバスに新しく入るユーザーにのみ適用されます。キャンバスでユーザーの再入場が許可されている場合、再入場するユーザーは更新されたキャンバスエントリプロパティに基づいて決定されます。

ベストプラクティス

キャンバスの起動後に編集や追加を行う際に留意すべきベストプラクティスを確認してください。

切断されたステップ

切断されたステップを含むキャンバスを起動でき、起動後にこれらのキャンバスを保存することもできます。ワークフローからステップを切断する前に、保留中のユーザーがいないかステップの分析ビューを確認することをお勧めします。

キャンバスワークフローの切断されたステップにユーザーがいるとします。後続のステップがある場合、そのユーザーは次のステップに進みます。ステップの設定によって、ユーザーがどのように進むかが決まります。

切断されたステップを作成または編集することで、キャンバスの残りの部分に直接接続することなく、これらの独立したステップに変更を加えることができます。これにより、キャンバスを再度起動する前にステップをテストするのに役立ちます。

実験パスステップ

キャンバスにアクティブまたは進行中の勝者パスまたはパーソナライズ済みパスの実験があり、アクティブなキャンバスを更新した場合（実験パスステップ自体を更新したかどうかに関係なく）、進行中の実験は終了し、実験パスステップは勝者パスやパーソナライズ済みパスを決定しません。実験を再開するには、既存の実験パスを切断して新しいものを起動するか、キャンバスを複製して新しいキャンバスを起動します。それ以外の場合、ユーザーは最適化方法が選択されていないかのように実験パスを通過します。

時間遅延

時間遅延のあるキャンバスの編集は少し複雑になる場合があるため、キャンバスを編集する際は以下の詳細に留意してください。

• 遅延ステップの遅延を更新した場合、キャンバスに新しく入るユーザーと、そのステップのキューにまだ追加されていないユーザーのみが、更新された遅延時間でメッセージを受け取ります。
• 時間遅延のあるステップ（遅延やアクションパスなど）を削除し、それらのユーザーを別のキャンバスステップにリダイレクトする場合、ユーザーはステップの時間遅延が完了した後にのみリダイレクトされます。たとえば、1日の遅延がある遅延ステップを削除し、それらのユーザーをメッセージステップにリダイレクトするとします。この場合、ユーザーは1日の遅延が完了した後にのみリダイレクトされます。
• キャンバスに1つ以上の実験パスステップがある場合、ステップを削除するとこのステップの結果が無効になる可能性があります。

キャンバスの停止

キャンバスを停止しても、ステップで待機中のユーザーは退出しません。キャンバスを再度有効にし、ユーザーがまだ待機中の場合、ユーザーはステップを完了して次のステップに進みます。ただし、ユーザーが次のステップに進むべき時間がすでに過ぎている場合、ユーザーはキャンバスから退出します。

たとえば、キャンバスフローワークフローを使用して作成されたキャンバスが午後2時に起動するように設定されており、1つのバリアントに2つのステップ（1時間の遅延がある遅延ステップとメッセージステップ）があるとします。

ユーザーが午後2時1分にこのキャンバスに入り、同時に遅延ステップに入ります。つまり、ユーザーはユーザージャーニーの次のステップ（メッセージステップ）に午後3時1分に進む予定です。午後2時30分にキャンバスを停止し、午後3時30分にキャンバスを再度有効にした場合、午後3時1分を過ぎているため、ユーザーはキャンバスから退出します。ただし、午後2時40分にキャンバスを再度有効にした場合、ユーザーは予定通り午後3時1分にメッセージステップに進みます。

注意事項

以下の一般的な問題は、起動後にキャンバス内の他のコンポーネントを編集したり、コンポーネントを追加したりすることで発生する可能性があります。

• レポートデータの欠落（メッセージバリアントが削除されて再追加された場合）
• ユーザーが期待されるパスに従わない
• メッセージが予期しない時間に送信される
• 編集は Currents データを上書きしないため、キャンバスステップ間で不一致が発生する場合があります（削除によりキャンバスに存在しない canvas_step_ids など）
• ユーザーが同じメッセージを2回受け取る可能性がある
• 既存のレート制限により、ユーザーがメッセージを受け取れない
  • アクティブなキャンバスのレート制限を更新すると、新しいレート制限は、キャンバスにすでにいるユーザーを含め、今後のすべてのメッセージ送信に適用されます。ただし、内部キャッシュ（最大30秒）により、新しいレート制限が完全に適用されるまでに短い遅延が発生する場合があります。Braze はユーザーが現在いるメッセージステップのキューにユーザーを追加するため、各ステップのメッセージが実際に送信される時点で有効なレート制限が適用されます。
• キャンバスが自動的に停止された場合、キャンバスの起動後の下書きも削除されます。