コンテンツにスキップ

ワークスペースの作成と管理

この記事では、ワークスペースの作成、設定、管理方法について説明します。


    ワークスペースの作成と管理

    この記事では、ワークスペースの作成、設定、管理方法について説明します。

    ワークスペースとは?

    Brazeで行うすべてのことはワークスペース内で行われます。ワークスペースは、関連するモバイルアプリやWebサイトのエンゲージメントを追跡・管理するための共有環境です。ワークスペースは、同一または非常に類似したアプリをグループ化します。たとえば、モバイルアプリのAndroid版とiOS版などです。

    ワークスペースの作成

    ステップ1:計画を立てる

    始める前に、チームやBrazeオンボーディングマネージャーと協力して、ユースケースに最適なワークスペース構成を決定してください。Brazeでのワークスペース計画の詳細については、はじめに:ワークスペースガイドをご覧ください。

    ステップ2:ワークスペースを追加する

    グローバルヘッダーのワークスペースドロップダウンから、新しいワークスペースの作成や既存のワークスペース間の切り替えができます。

    1. ワークスペースドロップダウンを選択し、 ワークスペースを作成を選択します。

    「ワークスペースを作成」ボタンが表示されたワークスペースドロップダウン。

    1. ワークスペースに名前を付けます。
    1. 作成を選択します。Brazeがワークスペースを作成するまで数秒かかる場合があります。

    「Upon Voyage US - Staging」という名前が入力された「ワークスペースを作成」モーダル。

    アプリ設定ページに移動し、アプリインスタンスの追加を開始できます。このページには設定 > アプリ設定からいつでもアクセスできます。

    アプリを追加するボタンが表示されたUpon Voyage US - Stagingワークスペースの「アプリ設定」ページ。

    ステップ3:アプリインスタンスを追加する

    ワークスペース内に収集されるさまざまなサイトやアプリを「アプリインスタンス」と呼びます。

    1. アプリ設定ページから、+ アプリを追加を選択します。
    2. アプリインスタンスに名前を付け、このアプリインスタンスが対応するプラットフォームを選択します。複数のプラットフォームを選択した場合、Brazeはプラットフォームごとに1つのアプリインスタンスを作成します。

    アプリの詳細を選択するオプションが表示された「Upon Voyage US - Stagingに新しいアプリを追加」モーダル。

    1. アプリを追加を選択して確認します。

    アプリAPIキー

    アプリインスタンスを追加すると、そのAPIキーにアクセスできるようになります。APIキーは、アプリインスタンスとBraze API間のリクエストに使用されます。APIキーは、Braze SDKをアプリやWebサイトに統合する際にも重要です。

    APIキーとSDKエンドポイントのフィールドが表示されたUpon Voyage iOSアプリの設定ページ。

    ライブSDKバージョン

    特定のアプリのアプリ設定ページに表示されるライブSDKバージョンは、1日の総セッション数の少なくとも5%を占め、過去1日に少なくとも500セッションがある最も高いアプリバージョンです。

    このフィールドは、Braze SDKをアプリやWebサイトに統合した後に表示されます。お使いのプラットフォームでBraze SDKの新しいバージョンが利用可能な場合、「Newer Version Available」というタグで通知されます。

    フィールド値が「5.4.0」で新しいバージョンが利用可能であることを示すアイコンが表示された「ライブSDKバージョン」セクション。

    ステップ4:必要に応じて繰り返す

    ステップ2と3を繰り返して、プランに必要な数のワークスペースをセットアップします。ベストプラクティスとして、統合テストやキャンペーンテスト用のテストワークスペースを作成することをお勧めします。

    ワークスペースの管理

    お気に入りの追加

    お気に入りのワークスペースを追加すると、最もよく使うワークスペースにさらに素早くアクセスできます。

    「お気に入りのワークスペース」タブが表示されたワークスペースドロップダウン。

    お気に入りのワークスペースを追加するには:

    1. プロファイルのドロップダウンを選択し、アカウントを管理を選択します。
    2. アカウントプロファイルセクションで、お気に入りのワークスペースフィールドを見つけます。
    3. リストからワークスペースを選択します。
    4. 変更を保存を選択します。

    お気に入りに登録できるワークスペースの数に制限はありませんが、利便性のためにリストを短くしておくことをお勧めします。

    ワークスペースの名前変更

    ワークスペースの名前を変更するには:

    1. 設定 > アプリの設定に移動します。
    2. ワークスペース名にカーソルを合わせ、 編集を選択します。
    3. ワークスペースに新しい名前を付け、 保存を選択します。

    ワークスペース名の横に表示される鉛筆アイコン。

    ワークスペースとアプリインスタンスの削除

    ワークスペースまたはアプリインスタンスを削除するには:

    1. 設定 > アプリの設定に移動します。
    2. ワークスペースを削除を選択して該当するワークスペースを削除するか、該当するアプリインスタンスの横にあるゴミ箱アイコンを選択します。

    現在ユーザーのターゲティングに使用されているアプリインスタンスやワークスペース、または1,000人を超えるユーザーが存在するものは削除できません。削除しようとすると、エラーメッセージが表示されます。削除を進めるには、ダッシュボードのリンクと削除対象のアプリインスタンスまたはワークスペースの名前を含めてサポートケースを作成してください。

    ワークスペースを削除するボタンとアプリを削除するゴミ箱アイコンが表示されたアプリの設定ページ。

    よくある質問

    アプリを更新する際に新しいワークスペースを作成すべきですか?

    これは、アプリを更新するのか、それとも完全に新しいアプリを作成するのかによって異なります。

    アプリの更新

    アプリを更新する場合は、同じワークスペース内に新しいアプリインスタンスを作成して、旧バージョンと新バージョンを分離する必要があります。こうすることで、セグメンテーション時にそのアプリを選択すれば、新しいバージョンのユーザーを効果的にターゲットにできます。旧バージョンのユーザーにメッセージを送りたい場合は、フィルターを使用して以前のアプリバージョンをターゲットにできます。

    新しいワークスペースを作成すると、ユーザーは旧ワークスペースと新ワークスペースの2か所に存在することになります。また、同じプッシュトークンを持つ可能性もあります。これにより、すでにアップグレードしたユーザーであっても、旧ワークスペースのユーザーのみを対象としたマーケティングメッセージを受信してしまう場合があります。

    新しいアプリのリリース

    完全に新しいアプリをアプリストアにリリースする場合は、新しいワークスペースを作成する必要があります。新しいワークスペースを作成すると、旧アプリバージョンの履歴データやユーザープロファイルはこの新しいワークスペースには存在しません。そのため、既存のユーザーが新しいアプリバージョンにアップグレードすると、旧アプリの行動データを含まない新しいプロファイルが作成されます。

    1つのワークスペースに複数のアプリインスタンスがあります。メッセージで1つのアプリだけをターゲットにするにはどうすればよいですか?

    メッセージが特定のアプリのみをターゲットにするようにするには、選択したアプリインスタンスのユーザーのみをターゲットにするセグメントを追加します。これは、ユーザーが同じワークスペース内の異なるアプリインスタンスに対して2つのプッシュトークンを持つ可能性がある場合に特に重要です。このシナリオでは、ユーザーが現在使用しているアプリとは別のアプリの通知を受信する可能性があります。理想的な体験ではありません!

    デフォルトでは、セグメントはワークスペース内のすべてのアプリとWebサイトをターゲットにします。1つのアプリまたはWebサイトのみをターゲットにするセグメントを設定するには:

    1. わかりやすい名前でセグメントを作成します。Brazeでは「All Users ({名前} {プラットフォーム})」という形式を使用しています。例:「All Users (Upon Voyage iOS)」。
    2. 対象アプリとWebサイトで、特定のアプリのユーザーを選択します。
    3. 特定のアプリのドロップダウンで、アプリまたはサイトを選択します。

    特定のアプリのユーザーをターゲットにしているセグメント。

    その後、このセグメントをメッセージに追加し、必要に応じて追加のセグメントやフィルターでオーディエンスをさらに絞り込むことができます。

    キャンペーン

    キャンペーンの場合は、コンポーザーのターゲットオーディエンスステップにセグメントを追加します。

    キャンバス

    キャンバスの場合は、メッセージステップの配信バリデーションセクションにセグメントを追加します。配信バリデーションは、メッセージ送信時にオーディエンスが配信条件を満たしているかを再確認します。各メッセージステップに配信バリデーションを指定して、正しいアプリに配信されるようにしてください。エントリレベルでのセグメンテーションは必要ありません。

    元のキャンバスワークフローの手順を展開

    元のキャンバスワークフローでは、キャンバスコンポーネントレベルのオーディエンスセクションにセグメントを追加します。エントリレベルでのセグメンテーションは必要ありません。

    次のステップ

    ワークスペースを作成したら、以下を設定してください。

    New Stuff!