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

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

セクション記事

• 

  ワークスペース間のデータ移行

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

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

ワークスペースとは

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

ワークスペースの作成

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

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

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

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

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

2. ワークスペースに名前を付けます。

3. Createを選択します。Braze がワークスペースを作成するまで数秒かかる場合があります。

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

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

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

1. App Settingsページから、+ Add appを選択します。
2. アプリインスタンスに名前を付け、このアプリインスタンスが対応するプラットフォームを選択します。複数のプラットフォームを選択すると、Braze は各プラットフォームに対して1つのアプリインスタンスを作成します。

3. Add appを選択して確認します。

アプリ API キー

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

ライブ SDK バージョン

特定のアプリのアプリ設定ページに表示されるライブ SDK バージョンは、1日の合計セッション数の5%以上を占め、かつ過去1日間に500セッション以上あるアプリバージョンのうち、最も高いバージョンです。

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

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

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

ワークスペースの管理

お気に入りの追加

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

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

1. プロファイルドロップダウンを選択し、Manage your accountを選択します。
2. Account Profileセクションで、Favorite workspacesフィールドを見つけます。
3. リストからワークスペースを選択します。
4. Save Changesを選択します。

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

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

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

1. Settings > App Settingsに移動します。
2. ワークスペース名にカーソルを合わせ、を選択します。
3. ワークスペースに新しい名前を付け、 Saveを選択します。

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

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

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

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

よくある質問

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

これは、アプリを更新するのか、まったく新しいアプリを作成するのかによって異なります。

アプリの更新

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

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

新しいアプリのリリース

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

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

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

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

1. 意味のある名前でSegmentを作成します。Braze では「All Users ({名前} {プラットフォーム})」という形式を使用しています。たとえば、「All Users (Upon Voyage iOS)」です。
2. Apps and websites targetedで、Users from specific appsを選択します。
3. Specific appsドロップダウンで、アプリまたはサイトを選択します。

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

Campaigns

Campaignsの場合は、コンポーザーのTarget AudiencesステップにSegmentを追加します。

Canvas

Canvasでは、Delivery ValidationsセクションのメッセージステップにSegmentを追加します。配信バリデーションは、メッセージ送信時にオーディエンスが配信基準を満たしているかを再確認します。正しいアプリに配信されるように、各メッセージステップに配信バリデーションを指定することを忘れないでください。エントリレベルでのセグメンテーションは不要です。

元のCanvasワークフローの手順を展開

元のCanvasワークフローでは、AudienceセクションのCanvasコンポーネントレベルにSegmentを追加します。エントリレベルでのセグメンテーションは不要です。

次のステップ

ワークスペースを作成したら、設定を行います:

• ワークスペース設定で、API キー、メール設定、プッシュ設定などを設定します。
• 会社ユーザーの管理で、このワークスペースにユーザーを追加し、権限を割り当てます。