重複ユーザーのマージ
重複ユーザーを見つけてマージし、キャンペーンやキャンバスの効果を最大化する方法を説明します。
REST API:ユーザーの識別とマージ
このページのツールでは、ダッシュボードで重複プロファイルをマージします。Brazeのユーザーデータエンドポイントを使用して、プロファイルを統合したり、別のプロファイルに関連付け直したりすることもできます。
- POST: ユーザーの識別 (
/users/identify):エイリアスのみ、メールのみ、または電話番号のみのプロファイルを、external_idを持つプロファイルに統合します。 - POST: ユーザーのマージ (
/users/merge):あるユーザープロファイルを別のユーザープロファイルにマージします。両方のプロファイルにすでにexternal_idがある場合にも使用できます。このエンドポイントを呼び出す前に、前提条件とマージの動作を確認してください。
匿名プロファイルが既存の識別済みプロファイルと一致した場合(たとえば、SDKの changeUser() 呼び出しや /users/identify を通じて)、Brazeは匿名プロファイルを孤立させ、特定のフィールドのみを識別済みプロファイルにコピーします。詳細については、匿名ユーザーを識別するとどうなるかを参照してください。
ユーザーのマージを元に戻すのは困難です。複数の external_id 値にまたがる複雑なマージや、大規模なプロファイル移行を計画している場合は、/users/merge を使用する前に、Brazeのカスタマーサクセスマネージャーに相談してください。
Brazeは、マージ時に3つのユーザータイプ(削除対象としてマークされたユーザー、テストユーザー、グローバルコントロールグループユーザー)を異なる方法で処理します。詳細については、ユーザーマージの動作を参照してください。
個別マージ
ユーザー検索で重複したプロファイルが返された場合は、Brazeダッシュボードのユーザープロファイルから各プロファイルを個別にマージできます。
ステップ1: 重複したプロファイルを検索する
Brazeで、オーディエンス > ユーザー検索を選択します。

重複したプロファイルのメールアドレスや電話番号などの一意の識別子を入力し、検索を選択します。

ステップ2: 重複をマージする
マージプロセスを開始するには、重複をマージを選択します。

保持するユーザープロファイルとマージするユーザープロファイルを選択し、プロファイルをマージを選択します。すべての重複したプロファイルをマージするまで、このプロセスを繰り返します。

重複したユーザープロファイルは、マージ後に復元できません。
一括マージ
重複ユーザーを一括マージすると、Brazeは識別子(メールアドレスなど)が一致するプロファイルを見つけ、1つのプロファイルを保持します。Brazeはまず external_id を持つプロファイルを優先し、次にタイの解決設定(タイの解決に使用する項目と優先順位付け)を適用します。external_id を持つプロファイルがない場合、Brazeは external_id を持たないプロファイル全体に対してタイの解決に使用する項目と優先順位付けを使用します。Brazeは、これらの設定によって保持するプロファイルが1つに特定された場合にのみユーザーをマージします。たとえば、タイの解決に使用する項目が更新日で、両方のプロファイルの最終更新タイムスタンプが同じ場合、Brazeはタイを解決できないため、それらのユーザーはマージされません。
ステップ1:「オーディエンスを管理」に移動する
Brazeダッシュボードで、オーディエンス > オーディエンスを管理を選択します。

ステップ2: 結果をプレビューする(オプション)
重複をマージする前に結果をプレビューするには、重複のリストを生成を選択します。

Brazeはプレビューを生成し、CSVファイルとしてお客様のメールアドレスに送信します。
CSVには作成元列が含まれており、各プロファイルが最初にどのように作成されたか(たとえば、SDK、REST API、CSVインポートなど)が表示されます。これにより、重複をマージする前にプロファイルのソースを把握できます。
重複する行を確認する際は、作成元を external_id、メールアドレス、電話番号などの識別子と比較してください。この情報を参考にして、すべての重複をマージを選択する前に、どのプロファイルをプライマリプロファイルとして保持するかを決定します。
作成元フィールドは、重複するプロファイルに似た値が含まれているものの、取り込み経路が異なる場合に特に役立ちます。チームがマージを判断する際の手がかりとなり、さらに確認するまで分けておきたいプロファイルを誤ってマージしてしまうリスクを軽減できます。
次の例では、Brazeはユーザーのexternal IDを使用して重複プロファイルにフラグを立て、どのプロファイルを保持するかを特定します。これらのプロファイルを一括マージすると、Brazeはexternal IDを持つプロファイルをユーザーの新しいプライマリプロファイルとして使用します。
| メールアドレス | External ID | 電話番号 | Braze ID | ルールの識別子 | 作成元 | 保持するプロファイル | マージするプロファイル |
|---|---|---|---|---|---|---|---|
| [email protected] | 123-external-id | 555 123-4567 | example-id-12345 | sdk | TRUE | FALSE | |
| [email protected] | 555 123-4567 | example-id-12346 | rest | FALSE | TRUE | ||
| [email protected] | 555 123-4567 | example-id-12347 | csv | FALSE | TRUE |
マージの動作
Brazeは、保持するプロファイルの空のフィールドを、マージされるプロファイルの値で埋めます。値が埋められるフィールドの一覧については、マージの動作を参照してください。
ステップ3: 重複をマージする
プレビューの結果に問題がなければ、すべての重複をマージを選択します。

マージ後に重複ユーザープロファイルを復元することはできません。
ルールベースのマージ
ルールを使用すると、マージ実行時に重複するプロファイルをどのように解決するかを制御し、最も関連性の高いユーザープロファイルを保持できます。ルールを設定すると、Brazeは条件に一致するプロファイルを保持します。
ステップ1: ルールを定義する
- オーディエンス > オーディエンスを管理 > ルールを編集に移動します。
- ルールを編集パネルの保持するプロファイルセクションで、重複をマージする際に保持するプロファイルの識別子を選択します。メールアドレスまたは電話番号を選択できます。
- 同順位の解決セクションで、保持するプロファイルの条件に一致するプロファイル間の同順位を解決する基準を選択します。以下を選択できます。
- 同順位の解決方法: 作成日、更新日、最終セッション
- 優先順位: 最新、最古

たとえば、電話番号を持つプロファイルを保持するように設定できます。複数のユーザーが同じ電話番号を持つ場合は、更新日フィールドを使用して同順位を解決し、最も新しく更新されたユーザーを優先できます。
ステップ2: 結果をプレビューする (オプション)
ルールを保存した後、重複のリストを生成を選択すると、ルールがどのように機能するかをプレビューできます。Brazeはプレビューを生成し、ルールを適用した場合にどのユーザーが保持され、どのユーザーがマージされるかを示すCSVファイルとしてメールアドレスに送信します。
ステップ3: 重複をマージする
プレビューの結果に問題がなければ、オーディエンスを管理ページに戻り、すべての重複をマージを選択します。

重複するユーザープロファイルは、マージ後に復元できません。
スケジュールされたマージ
ルールベースのマージと同様に、スケジュールされたマージでは、事前に設定したルールを使用して、ユーザープロファイルのマージを毎日自動で実行できます。

この機能をオンにすると、Brazeが自動的に時間枠を割り当て、ユーザーの会社のタイムゾーンで毎日午前0時ごろにマージ処理を実行します。スケジュールされたマージはいつでもオフにできます。Brazeは、スケジュールされたマージが実行される24時間前にワークスペースの管理者に通知し、リマインダーと設定を確認する時間を提供します。

重複したユーザープロファイルは、マージ後に復元できません。
同じメールアドレスに複数のユーザープロファイルが関連付けられているのはなぜですか?
識別前に異なる識別子、インポート、または匿名セッションを通じてプロファイルが作成された場合、Brazeは同じメールアドレスを共有する複数のユーザープロファイルを保存します。これは、ユーザーが単一のexternal_idを共有していない場合に想定される動作です。
重複をマージする前に、識別子によるユーザープロファイルのエクスポートエンドポイントを使用して、メールアドレスにどのプロファイルが存在し、各プロファイルにどのフィールドが含まれているかを確認してください。ダッシュボードで重複を確認するには、オーディエンス > ユーザー検索でメールアドレスを検索することもできます。