Skip to content

ワークスペースおよびインスタンス間のデータ移行

ワークスペースはBrazeデータを分離して管理します。このページでは、その分離が移行にどのように影響するか、製品機能やAPIで移動できるもの、Braze外で再構築または対応が必要なものについて説明します。移行は通常、会社管理者だけのタスクではなく、部門横断的な取り組みです。管理者はワークスペースのセットアップとチャネル設定を担当し、開発者はSDKとAPIの変更を処理し、マーケターはセグメントの再構築やメッセージングコンテンツのコピーを行います。各ステップには、ソースおよび送信先ワークスペースでの適切な権限が必要です。

Brazeに保存するすべてのもの（ユーザープロファイル、セグメント、メッセージングコンテンツ、エンゲージメント履歴）はワークスペース内に存在します。Segment、Campaign、またはCanvasは、別のワークスペースのデータを読み取ったりターゲットにしたりすることはできません。ダッシュボードユーザーは、ステージングと本番環境、異なるブランド、または地域別の分割のために、同じ会社のダッシュボード上で複数のワークスペースを使用することがよくあります。このセットアップにより分離が実現しますが、ダッシュボード上のすべてのワークスペースデータを別のワークスペースや別のBrazeインスタンスに移動する単一のアクションは存在しません。

計画の参考として、はじめに：ワークスペースおよびワークスペースの作成と管理をご覧ください。

Brazeがワークスペース間で自動移行しないもの

SDKやAPIを新しいワークスペース（または独自のワークスペースを持つ新しいBrazeダッシュボード環境）に向けた場合、以下は一括移行されません。

領域 動作
ユーザープロファイル プロファイルはパッケージ化された単位として転送されません。送信先ワークスペースでユーザーを再作成またはインポートしてください（ユーザープロファイルデータを参照）。
Segmentsとフィルター Segmentの定義はソースワークスペースに残ります。可能な限り同じロジックを使用して、送信先ワークスペースでSegmentsを再構築してください。
メッセージング履歴 プロファイル上のCampaignおよびCanvasの受信履歴はソースワークスペースに紐づいています。Brazeオンボーディングに関するFAQに記載されているように、カスタム属性などを使用して自分でモデル化しない限り、別のワークスペースの新しいプロファイルには表示されません。
チャネル固有の設定 送信ドメイン、SMSサブスクリプション、WhatsApp番号、および同様の設定はワークスペースにスコープされています。該当する場合は、送信先ワークスペースで再設定してください。

移動または再作成できるもの

CampaignおよびCanvasコンテンツ

多くのCampaignおよびCanvasの定義を下書きとして別のワークスペースにコピーできます。サポートされるチャネル、省略されるフィールド、およびLiquidに関する注意事項は、ワークスペース間でのCampaignおよびCanvasのコピーに記載されています。コピー後、起動する前にSegments、トリガー、およびワークスペース固有の参照を更新してください。

ユーザープロファイルデータ

一般的なアプローチ：

  • REST API： /users/trackを使用して、必要な識別子と属性で送信先ワークスペースにユーザーを作成または更新します。これは、履歴データをBrazeに取り込む際のレガシーユーザーデータの移行で説明されているパターンと同じです。
  • CSVインポート： マーケター主導のインポートについては、ユーザーをインポートするおよびCSVインポートをご覧ください。
  • クラウドデータ取り込み： ウェアハウスから送信先ワークスペースに属性を同期するには、クラウドデータ取り込みをご覧ください。
  • ソースワークスペースからのエクスポート： /users/export/idsまたは/users/export/segmentを使用して移動が許可されているデータを抽出し、送信先用にusers/trackまたはCSVにマッピングします。データのエクスポートおよび再読み込み時には、データ保持、プライバシー、および契約上の義務を遵守してください。

標準プロファイルAPIにマッピングされないユーザーエクスポートフィールド

ユーザーエクスポートから送信先ワークスペースでユーザーを再構築する場合、一部のエクスポートフィールドは、REST APIやCSVを通じてBrazeの標準プロファイルフィールドに書き戻すことができません（SDKやサーバーがそれらを入力する方法とは異なります）。多くの場合、代わりにカスタム属性として値を保持できます。以下の制限に注意してください。

デバイス情報（devices）

エクスポート内のデバイスレコードはSDKによって入力されます。REST APIを通じてBrazeの標準デバイスフィールドにそのデータを移行することはできません。

送信先ワークスペースをターゲットとするアプリでユーザーがセッションを開始する前にその情報が必要な場合は、ユーザーのインポート時にカスタム属性として送信してください。組み込みデバイスデータに依存する標準のセグメンテーションフィルターやLiquid参照は、ユーザーが新しいワークスペースに接続されたアプリインスタンスでセッションを開くまで（SDKが標準デバイスフィールドを更新するまで）、エクスポートされたデバイスペイロードを使用しません。

合計セッション数およびアプリごとのセッションデータ（appsとネストされたsessions）

エクスポート内のappsオブジェクトからのセッション合計およびネストされたセッションデータは、同じ組み込みフィールドに再インポートすることはできません。レガシーカウント（例：ソースワークスペースからの合計セッション数）を保持するには、カスタム属性に保存し、送信先ワークスペースでそれらのフィールドでセグメンテーションを行ってください。

date_of_first_sessionとdate_of_last_sessionは、/users/trackまたはCSVインポートを通じて設定できます。受け入れられる形式については、ユーザー属性オブジェクトおよびCSVインポートをご覧ください。

ランダムバケット（random_bucket）

各ユーザーには、ワークスペース内でランダムバケット番号が割り当てられます。この値は再インポートできません。ユーザーは送信先ワークスペースで新しいランダムバケットを取得します。

ホールドアウトやサンプリングのために古い番号に依存している場合（例：random_bucketがしきい値未満のユーザーを除外する場合）、エクスポートされた値をカスタム属性として保存し、組み込みのランダムバケットフィールドの代わりにその属性でSegmentsやフィルターを構築してください。

パートナーアトリビューションフィールド（attributed_*）

パートナー連携からのアトリビューションフィールド（エクスポート内のattributed_*フィールド）は、REST APIを通じてBrazeの標準アトリビューションフィールドに設定することはできません。セグメンテーションやメッセージングのために保持する必要がある場合は、送信先ワークスペースでカスタム属性にマッピングしてください。

プッシュトークン

ユーザーが以前のプロバイダーやアプリバージョンからのプッシュトークンを既に持っている場合、APIを通じてモバイルアプリ用のトークンをインポートするか、統合後にSDKに依存することができます。Webプッシュトークンには APIの制限があります。詳細と例については、プッシュトークンの移行をご覧ください。

WhatsApp

電話番号とサブスクリプショングループは、特定の転送フローを使用してワークスペース間で移動できます。ワークスペース間でのWhatsApp電話番号とサブスクリプショングループの転送をご覧ください。

Braze外のエンゲージメントおよび分析データ

環境を統合する際に送信、開封、またはクリックの履歴レコードが必要な場合、Currentsおよびその他のエクスポートが、そのデータをウェアハウスやツールに格納するためのサポートされた方法です。そのデータは、別のワークスペース上のネイティブなユーザーごとのメッセージ履歴としてBrazeに再取り込みされることはありません。

SDKまたはAPIキーを変更する前に

アプリやサイトを新しいワークスペースに向けた場合：

  • アプリやサイトを開いたユーザーは、新しいワークスペースに新しいプロファイルを作成できます。以前のワークスペース固有の履歴は自動的に引き継がれません。
  • 同じ人物が両方のワークスペースに存在する可能性がある場合、重複のようなシナリオが発生する可能性があります（例：プッシュリーチの重複）。本番環境とステージング環境のキーを意図せず共有するのではなく、計画的なデータおよびターゲティング計画を優先してください。
New Stuff!