ワークスペースの作成と管理
この記事では、ワークスペースの作成、設定、管理方法について説明します。
ワークスペースとは
Braze で行うすべての操作はワークスペース内で行われます。ワークスペースは、関連するモバイルアプリや Web サイトのエンゲージメントを追跡・管理するための共有環境です。ワークスペースは、同じまたは非常に類似したアプリをグループ化します。たとえば、モバイルアプリの Android 版と iOS 版などです。
ワークスペースの作成
ステップ 1:計画を立てる
開始する前に、チームと Braze のオンボーディングマネージャーと協力して、ユースケースに最適なワークスペース構成を決定してください。Braze でのワークスペース計画の詳細については、はじめに: ワークスペースガイドをご覧ください。
ステップ 2:ワークスペースを追加する
グローバルヘッダーのワークスペースドロップダウンから、新しいワークスペースを作成したり、既存のワークスペースを切り替えたりできます。
- ワークスペースドロップダウンを選択し、 ワークスペースを作成を選択します。
- ワークスペースに名前を付けます。
社内の他のメンバーがワークスペースを簡単に見つけられるように、命名規則を採用することをお勧めします。たとえば、「Upon Voyage US – Production」や「Upon Voyage US – Staging」などです。
- 作成を選択します。Braze がワークスペースを作成するまで数秒かかる場合があります。
アプリ設定ページに移動し、アプリインスタンスの追加を開始できます。このページには、設定 > アプリ設定からいつでもアクセスできます。
ステップ 3:アプリインスタンスを追加する
ワークスペース内に収集されるさまざまなサイトやアプリを「アプリインスタンス」と呼びます。
- アプリ設定ページから、+ アプリを追加を選択します。
- アプリインスタンスに名前を付け、このアプリインスタンスが対応するプラットフォームを選択します。複数のプラットフォームを選択すると、Braze は各プラットフォームに対して1つのアプリインスタンスを作成します。
- アプリを追加を選択して確認します。
アプリ API キー
アプリインスタンスを追加すると、その API キーにアクセスできるようになります。API キーは、アプリインスタンスと Braze API 間のリクエストに使用されます。API キーは、Braze SDK をアプリや Web サイトに統合する際にも重要です。
各プラットフォームのアプリの各バージョンに対して、個別のアプリインスタンスを作成する必要があります。たとえば、iOS と Android の両方で Free 版と Pro 版のアプリがある場合、ワークスペース内に4つのアプリインスタンス（Free iOS アプリ、Free Android アプリ、Pro iOS アプリ、Pro Android アプリ）を作成します。これにより、各アプリインスタンスに1つずつ、合計4つの API キーが使用できるようになります。
ライブ SDK バージョン
特定のアプリのアプリ設定ページに表示されるライブ SDK バージョンは、1日の合計セッション数の5%以上を占め、かつ過去1日間に500セッション以上あるアプリバージョンのうち、最も高いバージョンです。
このフィールドは、Braze SDK をアプリまたは Web サイトに統合した後に表示されます。お使いのプラットフォームで Braze SDK の新しいバージョンが利用可能な場合、「新しいバージョンが利用可能」というタグとともにここに表示されます。
ステップ 4:必要に応じて繰り返す
プランに必要な数のワークスペースを設定するために、ステップ 2 と 3 を繰り返します。ベストプラクティスとして、統合テストや Campaign テスト用のテストワークスペースを作成することをお勧めします。
テストワークスペースを追加する
特定のユーザーを本番インスタンスから完全にサンドボックス化することで、アプリテストを実行できます。新しいワークスペースを作成し、アプリケーションを公開する際に、Braze が使用する API キーをテストワークスペースではなく本番ワークスペースのものに変更してください。
ワークスペースの管理
お気に入りの追加
お気に入りのワークスペースを追加して、最もよく使用するワークスペースにさらに素早くアクセスできます。
お気に入りのワークスペースを追加するには:
- プロファイルドロップダウンを選択し、アカウントを管理を選択します。
- アカウントプロファイルセクションで、お気に入りのワークスペースフィールドを見つけます。
- リストからワークスペースを選択します。
- 変更内容を保存を選択します。
お気に入りに追加できるワークスペースの数に制限はありませんが、利便性のためにリストを短くしておくことをお勧めします。
ワークスペースの名前変更
ワークスペースの名前を変更するには:
- 設定 > アプリ設定に移動します。
- ワークスペース名にカーソルを合わせ、 を選択します。
- ワークスペースに新しい名前を付け、 保存を選択します。
ワークスペースとアプリインスタンスの削除
ワークスペースまたはアプリインスタンスを削除するには:
- 設定 > アプリ設定に移動します。
- ワークスペースを削除を選択して該当するワークスペースを削除するか、該当するアプリインスタンスの横にあるゴミ箱アイコンを選択します。
現在ユーザーのターゲティングに使用されているアプリインスタンスやワークスペース、または1,000人以上のユーザーがいるものは削除できません。削除しようとすると、エラーメッセージが表示されます。削除を進めるには、ダッシュボードリンクと削除するアプリインスタンスまたはワークスペースの名前を含むサポートケースを作成してください。
ワークスペースの削除には注意してください！ワークスペースを削除すると、復元できません。
よくある質問
アプリを更新する際に新しいワークスペースを作成すべきですか？
これは、アプリを更新するのか、まったく新しいアプリを作成するのかによって異なります。
アプリの更新
アプリを更新する場合は、同じワークスペース内に新しいアプリインスタンスを作成して、旧バージョンと新バージョンを分離する必要があります。これにより、セグメンテーション時にそのアプリを選択することで、新バージョンのユーザーを効果的にターゲットできます。旧バージョンのユーザーにメッセージを送信したい場合は、フィルターを使用して以前のアプリバージョンをターゲットできます。
新しいワークスペースを作成すると、ユーザーは旧ワークスペースと新ワークスペースの2か所に存在することになります。また、同じプッシュトークンを持つ可能性もあります。これにより、すでにアップグレード済みのユーザーが、旧ワークスペースのユーザーのみを対象としたマーケティングメッセージを受信してしまう可能性があります。
新しいアプリのリリース
まったく新しいアプリをアプリストアにリリースする場合は、新しいワークスペースを作成する必要があります。新しいワークスペースを作成することで、古いアプリバージョンのすべての履歴データとユーザープロファイルはこの新しいワークスペースには存在しません。そのため、既存のユーザーが新しいアプリバージョンにアップグレードすると、古いアプリの行動データなしで新しいプロファイルが作成されます。
1つのワークスペースに複数のアプリインスタンスがあります。メッセージで単一のアプリのみをターゲットにするにはどうすればよいですか？
メッセージが特定のアプリのみをターゲットにするようにするには、選択したアプリインスタンスのユーザーのみをターゲットにする Segment を追加します。これは、ユーザーが同じワークスペース内の異なるアプリインスタンスに対して2つのプッシュトークンを持っている可能性がある場合に特に重要です。このシナリオでは、ユーザーが現在使用しているアプリとは異なるアプリの通知を受信する可能性があります。理想的な体験とは言えません！
デフォルトでは、Segment はワークスペース内のすべてのアプリと Web サイトをターゲットにします。1つのアプリまたは Web サイトのみをターゲットにする Segment を設定するには:
- 意味のある名前で Segment を作成します。Braze では「All Users ({名前} {プラットフォーム})」という形式を使用しています。たとえば、「All Users (Upon Voyage iOS)」です。
- ターゲットのアプリと Web サイトで、特定のアプリのユーザーを選択します。
- 特定のアプリドロップダウンで、アプリまたはサイトを選択します。
この Segment をメッセージに追加し、必要に応じて追加の Segments やフィルターでオーディエンスをさらに絞り込むことができます。
Campaigns
Campaigns の場合は、コンポーザーのターゲットオーディエンスステップに Segment を追加します。
Canvas
Canvas では、配信バリデーションセクションのメッセージステップに Segment を追加します。配信バリデーションは、メッセージ送信時にオーディエンスが配信基準を満たしているかを再確認します。正しいアプリに配信されるように、各メッセージステップに配信バリデーションを指定することを忘れないでください。エントリレベルでのセグメンテーションは不要です。
元の Canvas ワークフローの手順を展開
元の Canvas ワークフローでは、オーディエンスセクションの Canvas コンポーネントレベルに Segment を追加します。エントリレベルでのセグメンテーションは不要です。
次のステップ
ワークスペースを作成したら、設定を行います: