ワークスペースの作成と管理
この記事では、ワークスペースの作成、設定、および管理を行う方法について説明します。
ワークスペースとは
Braze での操作はすべて、ワークスペース内で行われます。ワークスペースとは、関連するモバイルアプリや Web サイトのエンゲージメントの追跡および管理を行うための共有環境です。ワークスペースは、同じアプリ、またはよく似たアプリ (モバイルアプリの Android 版と iOS 版など) のグループです。
ワークスペースの作成
ステップ 1: 計画の立案
始める前に、チームや Braze のオンボーディングマネージャーと協力して、ユースケースに最適なワークスペース構成を決定する必要があります。Braze でのワークスペース計画の詳細については、[開始;ワークスペース][link] ガイド。
ステップ2:ワークスペースの追加
グローバルヘッダーのワークスペースのドロップダウンから、新しいワークスペースを作成したり、既存のワークスペース間で切り替えたりできます。
- ワークスペースのドロップダウンを選択し、 [ワークスペースを作成] をクリックします。
- ワークスペースに名前を付けます。
社内の他のユーザーがこのワークスペースを簡単に見つけられるように、命名規則を採用することをお勧めします。例えば、「Upon Voyage US - Production」と「On Voyage US - Staging」です。
3.Createを選択します。Braze が ワークスペースを作成するまで数秒かかることがあります。
アプリインスタンスの追加を開始するための [アプリ設定] ページが表示されます。このページには、[設定] > [アプリ設定] からいつでもアクセスできます。
ステップ 3: アプリインスタンスの追加
ワークスペース内に収集したさまざまなサイトやアプリを「アプリインスタンス」と呼びます。
- [アプリ設定] ページで、[+ アプリを追加] をクリックします。
- アプリインスタンスに名前を付けて、配置先のプラットフォームを 1 つ以上選択します。複数のプラットフォームを選択した場合、Braze はプラットフォームごとにアプリインスタンスを 1 つ作成します。
- [アプリを追加] をクリックして確定します。
アプリの API キー
アプリインスタンスを追加したら、その API キーにアクセスできます。API キーは、アプリインスタンスと Braze API の間でリクエストを行う際に使用されます。API キーは、Braze SDK とお客様のアプリや Web サイトとの連携にも重要です。
各プラットフォームでアプリのバージョンごとに個別のアプリインスタンスを作成する必要があります。例えば、iOS と Android の両方に無料版とプロ版のアプリがある場合は、ワークスペース内に 4 つのアプリインスタンス (無料版 iOS アプリ、無料版 Android アプリ、プロ版 iOS アプリ、プロ版 Android アプリ) を作成します。これにより、アプリインスタンスごとに 1 つずつ、使用する API キーが 4 つ得られます。
ライブ SDK バージョン
アプリの「設定」ページに表示されるライブSDKのバージョンは、最高アプリのバージョンで、1日の総セッションsの少なくとも5%が表示され、過去1日で少なくとも500 セッションsが表示されます。
このフィールドは、Braze SDK とアプリまたは Web サイトを連携した後に表示されます。新しいバージョンの Braze SDK がプラットフォームで利用可能の場合、「新しいバージョンが利用可能」というタグとともにここに表示されます。
ステップ 4: 必要に応じて繰り返し
ステップ 2 と 3 を繰り返して、計画に必要な数のワークスペースを設定します。ベストプラクティスとして、連携とキャンペーンのテスト向けにテスト用ワークスペースを作成することをお勧めします。
テスト用ワークスペースの追加
生産インスタンスから特定のユーザーを完全にサンドボックス化して、アプリのテストを実行できます。新しいワークスペースを作成し、アプリケーションを公開するときに、Braze の使用する API キーを、テスト用ワークスペースではなく、必ず生産ワークスペースの API キーと一致するように変更してください。
ワークスペースの管理
お気に入りの追加
お気に入りのワークスペースを追加すると、最も頻繁に使用するワークスペースに、より迅速にアクセスできます。
お気に入りのワークスペースを追加するには、次の手順に従います。
- プロファイルドロップダウンを選択し、アカウントを管理を選択します。
- [アカウントプロフィール] セクションで、[お気に入りのワークスペース] フィールドを見つけます。
- リストからワークスペースを選択します。
- 変更の保存を選択します。
お気に入りにするワークスペースの数に制限はありませんが、便宜上、このリストを短くしておくことをお勧めします。
ワークスペース名の変更
ワークスペース名を変更するには、次の手順に従います。
- [設定] > [アプリ設定] に移動します。
- ワークスペースの名前にマウスポインタを置き、 を選択します。
- ワークスペースに新しい名前を付け、保存を選択します。
ワークスペースの削除
ワークスペースを削除するには、次の手順に従います。
- [設定] > [アプリ設定] に移動します。
- ワークスペースの削除を選択します。
ワークスペースを削除する際には注意してください。ワークスペースは、削除すると復元できません。
よくある質問
更新したアプリをリリースするときに、新しいワークスペースを作成したほうがよいですか?
ユーザーがアプリを更新するだけで済み、アプリストアにまったく新規のアプリをリリースしない場合、旧バージョンのユーザーにメッセージを送信する予定がなければ、新しいワークスペースを作成しないでください。
旧バージョンのアプリの履歴データとユーザープロファイルはすべて、作成した新しいワークスペースに引き継がれません。したがって、既存のユーザーが新しいアプリのバージョンにアップグレードすると、古いアプリの行動データが一切含まれない新しいプロファイルが作成されます。
さらに、ユーザーは古いワークスペースと新しいワークスペースの 2 か所に存在することになります。また、同じプッシュトークンを持つ可能性もあります。したがって、古いワークスペースユーザーのみを対象にしたマーケティングメッセージが、既にアップグレード済みのユーザーにも送信される可能性があります。
どのような代替方法がありますか?
古いアプリと新しいアプリを分離するには、同じワークスペース内に新規のアプリインスタンスを作成します。これにより、セグメンテーションの際にそのアプリを選択すれば、新バージョンのユーザーを効果的にターゲットにできます。旧バージョンを使用しているユーザーにメッセージを送信する場合は、フィルターを使用して旧バージョンのアプリをターゲットにすることができます。
1 つのワークスペースに複数のアプリインスタンスがあります。メッセージで 1 つのアプリのみをターゲットにしていることは、どのようにして確認できますか?{#singular-app}
メッセージのターゲットが特定のアプリのみであることを確認するには、選択したアプリインスタンスのユーザーのみをターゲットにするセグメントを追加します。これは特に、ユーザーが同じワークスペース内の異なるアプリインスタンスに対して 2 つのプッシュトークンを持つ可能性がある場合に重要です。このシナリオでは、ユーザーが現在使用しているアプリとは別のアプリの通知を受信する可能性があります。これは理想的なエクスペリエンスではありません。
セグメントのデフォルトのターゲットは、ワークスペース内のすべてのアプリと Web サイトです。1 つのアプリや Web サイトのみをターゲットにするセグメントを設定するには、次の手順に従います。
- セグメントを作成し、わかりやすい名前を付けます。Braze では、「すべてのユーザー (({Name} {Platform}))」という形式を使用しています。例は、「すべてのユーザー (Upon Voyage iOS)」です。
- [ターゲットに設定されたアプリと Web サイト] で、[特定のアプリのユーザー] を選択します。
- [特定のアプリ] ドロップダウンで、アプリまたはサイトを選択します。
次に、このセグメントをメッセージに追加し、必要に応じてさらにセグメントやフィルターを追加して、オーディエンスの絞り込みを開始できます。
キャンペーン
キャンペーンの場合は、コンポーザーの「ターゲットユーザー」ステップにセグメントを追加します。
キャンバスフロー
キャンバスフローの [配信検証] セクションのメッセージステップにセグメントを追加します。配信検証では、メッセージ送信時にオーディエンスが配信条件を満たしていることが再確認されます。正しいアプリに配信されるように、必ず各メッセージステップに配信検証を指定してください。エントリレベルでセグメンテーションを行う必要はありません。
元のキャンバスワークフローでのステップs の展開
2023 年 2 月 28 日以降、元のエディターを使用したキャンバスの作成や複製はできなくなりました。このコンテンツは参考用であり、元のエディターでのセグメントとターゲット設定を理解するためのものです。
Braze では、元のキャンバスエクスペリエンスを使用しているお客様に、キャンバスフローへの移行をお勧めしています。これは、キャンバスの構築と管理をより良く行う目的で改良された編集エクスペリエンスです。「キャンバスからキャンバスフローへの複製」を参照してください。
元のキャンバスワークフローで、[オーディエンス] セクションのキャンバスコンポーネントレベルにセグメントを追加します。エントリレベルでセグメンテーションを行う必要はありません。
[link]: /docs/ja/user_guide/getting_started/workspaces/