WhatsAppユーザー名とビジネススコープユーザーID
WhatsAppユーザー名は、ビジネスとのメッセージングにおいてユーザーの電話番号を非表示にするオプションのプライバシー機能です。Brazeはこれを自動的に処理するため、ほとんどのお客様にとってキャンペーンやキャンバスを変更する必要はありません。
Metaは、WhatsAppユーザー名とBSUIDを段階的に展開しています。BrazeはBSUIDによるメッセージングを完全にサポートしているため、今後BSUIDのみのユーザーが増える可能性があります。Metaの最新情報については、ビジネススコープユーザーIDを参照してください。
WhatsAppユーザーがユーザー名を採用すると、メッセージを送信するビジネスに電話番号が自動的に共有されなくなります。代わりに、WhatsAppはビジネスにビジネススコープユーザーID（BSUID）を提供します。これは、各ビジネスポートフォリオとユーザーのペアに固有のユニークな識別子です。
BrazeはBSUIDを自動的に処理します。ユーザー名を採用したユーザーは、引き続きBrazeワークスペースに表示され、メッセージを受信し、キャンバスをトリガーし、イベントを生成します。一部のお客様は変更に備える必要がある場合があります。
ビジネススコープのユーザー ID (BSUID)
BSUID は、特定のビジネスポートフォリオ内でユーザーを表すために WhatsApp が割り当てる、一意で永続的な識別子です。電話番号を非公開にすることを選択したユーザーのための代替電話番号と考えてください。
BSUID には、次の3つの主な特徴があります。
| 特徴 | 説明 |
|---|---|
| 一意 | ビジネスポートフォリオ内で、同じ BSUID を共有するユーザーは存在しません。 |
| ビジネススコープ | 同じユーザーでも、メッセージをやり取りするビジネスごとに異なる BSUID を持ちます。BSUID を異なるビジネスポートフォリオ間で共有したり比較したりすることはできません。 |
| Webhook で利用可能 | BSUID は、ユーザーの電話番号を含むすべての Webhook ペイロードに含まれます。 |
WhatsAppユーザータイプの変更点
WhatsAppユーザーには2つのタイプがあります。
| ユーザータイプ | WhatsAppでの識別方法 | Brazeが受け取る情報 |
|---|---|---|
| ユーザー名を持たないユーザー | 電話番号（変更なし） | 電話番号（変更なし） |
| ユーザー名を持つユーザー | ユーザー名（表示用）、BSUID（バックエンド） | BSUID、およびビジネスと既存の会話があるユーザーの場合は電話番号 |
主な違いは、ユーザー名を採用したユーザーが電話番号をビジネスと共有するのは、過去にそのユーザーと会話したことがある場合、またはそのユーザーがWhatsAppの連絡先帳に登録されている場合に限られるという点です。
BrazeでのBSUIDの処理方法
Brazeは、BSUIDをユーザープロファイル上でラベルwhats_app_bsuidを持つユーザーエイリアスとして保存します。つまり、BSUIDのみを持つユーザーも完全なBrazeユーザープロファイルを持ち、キャンバスへのエントリー、メッセージの受信、イベントの生成、APIによる更新が可能です。
メッセージを送信する
BrazeがWhatsAppメッセージを送信する際、電話番号があればそれを使用します。ユーザーがBSUIDしか持っていない場合 (ユーザー名を採用した後に初めてメッセージを送ってきたユーザーなど)、Brazeは代わりにBSUIDを使用して送信します。メッセージテンプレート、キャンペーン、キャンバスステップを変更する必要はありません。
受信メッセージとキャンバストリガー
ユーザー名を持つユーザーがWhatsAppの受信メッセージを送信すると、Brazeは次の処理を行います。
- BSUIDまたは電話番号 (Webhookで利用可能な方) でユーザーを検索します。
- 一致するユーザーが見つからない場合は、BSUIDをユーザーエイリアスとして保存した新しい匿名ユーザープロファイルを作成します。
- WhatsAppの受信メッセージで開始するように設定されたキャンバスまたはキャンペーンをトリガーします。
ユーザープロファイル
ユーザーのBSUIDは、BrazeユーザープロファイルのWhatsAppセクションで確認できます。
購読グループ
BSUIDユーザーの購読グループ管理は、ユーザーエイリアスで識別されるほかのユーザーと同じように機能します。BSUIDユーザーの購読ステータスは、次の方法で更新できます。
user_aliasを使用したusers/trackエンドポイント- ユーザー更新キャンバスステップ (自動的に機能します)
- CSVアップロード
subscription/status/setエンドポイントはuser_aliasをサポートしていません。BSUIDのみを持つユーザーの購読ステータスを更新するには、users/trackエンドポイントを使用してください。
Currentsとイベントデータ
すべてのWhatsApp Currentsイベント (送信、配信、既読、失敗、受信、中止、再試行) にはBSUIDフィールドが含まれます。電話番号とBSUIDの両方を持つユーザーの場合は、両方のフィールドが含まれます。BSUIDのみを持つユーザーの場合は、BSUIDフィールドのみが含まれます (電話番号フィールドは空になります)。
変更への準備方法
ほとんどの顧客の場合、対応は必要ありません。Braze が BSUID のルーティング、ユーザーの作成、イベントのトラッキングを自動的に処理します。ただし、WhatsApp Contact Book を有効にすることをおすすめします。また、複数の WhatsApp Businessアカウント (WABA) を使用している場合は、ビジネスポートフォリオをリンクすることもおすすめします。
BSUID のみを提供するインバウンドユーザーが想定される場合は、連絡先情報をリクエストすることもできます。これにより、プロファイルに電話番号を保存し、必要に応じて重複を統合できます。
WhatsApp Contact Book を有効にする
Contact Book は、すでに会話したことのあるユーザーの電話番号を記録する Meta の機能です。ユーザーがユーザー名を採用した場合でも、そのユーザーが Contact Book に含まれていれば、電話番号は引き続きビジネス側に表示されます。つまり、ユーザーがユーザー名を有効にした後も、Braze は電話番号でユーザーを識別し続けることができます。
Contact Book を有効にするには、次の手順を実行します。
- Meta Business Suite > ビジネス設定 > ビジネス情報に移動します。
- Contact Book 機能が有効になっていることを確認します。
Contact Book 機能はデフォルトでオンになっていますが、Meta Business の設定で確認することをおすすめします。Contact Book が無効になっている場合、ユーザー名を採用したユーザーは、以前にメッセージを送信したことがあっても、新しい BSUID のみのユーザーとして表示されます。
複数の WABA を使用している場合はビジネスポートフォリオをリンクする
BSUID の範囲は単一のビジネスポートフォリオに限定されます。組織が同じ Braze ワークスペース内で複数のビジネスポートフォリオの WABA を管理している場合、同じユーザーでもポートフォリオごとに異なる BSUID を持つことになります。その結果、Braze のユーザープロファイルが重複する可能性があります。
これを防ぐには、Meta の担当者に連絡して、ビジネスがポートフォリオのリンクの対象かどうかを確認してください。詳細については、ビジネスポートフォリオと親 BSUID をリンクするを参照してください。
すべての WABA が同じビジネスポートフォリオ内にある場合、対応は必要ありません。
ビジネスポートフォリオと親BSUIDをリンクする
組織が異なるビジネスポートフォリオにまたがって複数のWhatsApp Businessアカウント (WABA) を運用している場合は、Metaの担当者に問い合わせて、それらのポートフォリオをリンクする資格があるかどうかを確認できます。資格はMetaによって判断され、マネージドビジネスが利用できます。
リンクされたポートフォリオの動作
ビジネスポートフォリオがリンクされると、WhatsAppはすべてのメッセージWebhookに、通常のBSUIDに加えて親BSUIDを含めます。親BSUIDは、Webhookペイロード内の新しい parent_user_id プロパティに割り当てられます。
親BSUIDは通常のBSUIDと同じプロパティを持ちますが、リンクされたポートフォリオのセット内にあるすべてのビジネス電話番号で共有されます。つまり、ユーザーがどのWABAにメッセージを送信しても、同じユーザーには一貫した単一の識別子が割り当てられるため、ユーザープロファイルが重複するリスクを回避できます。
親BSUIDには、国コードと英数字の識別子の間に ENT が含まれます。以下に例を示します。
US.ENT.11815799212886844830
通常のBSUIDには ENT は含まれません。
Brazeによる親BSUIDの使用方法
Webhookに通常のBSUIDと親BSUIDの両方が含まれている場合、Brazeは親BSUIDをプライマリ識別子として使用します。これにより、リンクされたポートフォリオ内の複数のWABAにメッセージを送信するユーザーを、同じBrazeユーザープロファイルに一貫して照合できます。
親BSUIDが存在しない場合 (たとえば、ポートフォリオがリンクされていない場合や、ユーザーがリンクされていないWABAにメッセージを送信している場合)、Brazeは通常のBSUIDを使用します。通常のBSUIDは、どのような場合でも引き続き正常に機能します。
ビジネスポートフォリオのリンク手続きはMetaが管理します。開始するには、Metaの担当者に連絡してください。ポートフォリオがリンクされている場合でも、通常のBSUIDを使用してユーザーにメッセージを送信できます。親BSUIDは追加されるものであり、通常のBSUIDを置き換えるものではありません。
| シナリオ | Brazeが使用する識別子 |
|---|---|
| 単一のビジネスポートフォリオ | 通常のBSUID |
| リンクされた複数のポートフォリオ | 親BSUID (優先)。親BSUIDが存在しない場合は、通常のBSUIDを使用します |
| リンクされていない複数のポートフォリオ | 通常のBSUID (ポートフォリオごとにユーザープロファイルが重複する可能性があります) |
よくある質問
既存のキャンペーンやキャンバスは動作しなくなりますか？
いいえ。既存のキャンペーンとキャンバスは引き続き動作します。ユーザー名を導入しないユーザーには一切影響がありません。ユーザー名を導入したユーザーで、すでにあなたのビジネスとの会話履歴がある場合、Brazeは引き続きそのユーザーの電話番号をプライマリー識別子として使用します。
ユーザー名を導入したユーザーが、すでに自社のビジネスにメッセージを送信していた場合はどうなりますか？
WhatsApp Contact Bookが有効になっており、過去30日以内にそのユーザーとの会話があった場合（またはそのユーザーにメッセージを送信した場合）、Webhookペイロードには引き続きBSUIDとともに電話番号が含まれます。Brazeはそのユーザーを既存のユーザープロファイルに照合します。重複するプロファイルは作成されません。
ユーザー名を導入したユーザーが、自社のビジネスとの過去の会話がない場合はどうなりますか？
Brazeは受信Webhookでユーザーの BSUIDを受け取り、既存のユーザープロファイルに照合するか（以前にBSUIDを保存していた場合）、BSUIDをユーザーエイリアスとして保存した新しい匿名ユーザープロファイルを作成します。その後、そのユーザーはキャンバスに参加したり、アウトバウンドメッセージを受信したりでき、Brazeの標準的なID解決ツールを使用して識別したり、他のプロファイルとマージしたりできます。
BSUIDのみのユーザーから電話番号を取得するには、WhatsAppのBSUIDのみのユーザーに連絡先情報をリクエストするを参照してください。
BSUIDユーザーをセグメントでターゲットにできますか？
BSUIDユーザーは完全なBrazeユーザープロファイルであるため、標準のオーディエンスフィルター（「WhatsAppメッセージを受信したことがある」や購読グループのメンバーシップなど）を使用してターゲットにできます。ただし、BSUIDの値に特化したセグメンテーション（「BSUIDが存在する」や「BSUIDがXと等しい」など）はサポートされていません。
BSUIDユーザーに対するWhatsAppの料金はどのように決まりますか？
WhatsAppの会話料金は、ユーザーの国によって決まります。電話番号で識別されるユーザーの場合、Metaは電話番号の国コードから国を判断します。BSUIDで識別されるユーザーの場合、国はBSUID自体に直接エンコードされています。たとえば、US で始まるBSUIDは米国のユーザーを表します。
つまり、ユーザーが電話番号とBSUIDのどちらで識別されていても、料金の挙動は一貫しています。会話料金の計算に使用される国はMetaが提供する識別子によって決まり、Brazeはこれを変更せずにそのまま渡します。特別な対応は必要ありませんが、BSUIDのみのユーザーにメッセージを送信する場合、Metaの国別料金は電話番号ではなく、ユーザーのBSUIDにエンコードされた国に基づくことに注意してください。
API呼び出しでBSUIDユーザーを参照するにはどうすればよいですか？
user_alias パラメーターを使用し、alias_label: "whats_app_bsuid" を指定して、alias_name にユーザーのBSUIDの値を設定します。例:
{
"user_alias": {
"alias_label": "whats_app_bsuid",
"alias_name": "DDC91135R"
}
}
これは users/track、users/identify、CSVアップロード、およびユーザー更新キャンバスステップで機能します。
Currentsのデータパイプラインは動作しなくなりますか？
WhatsAppのCurrentsイベントには、既存の電話番号フィールドに加えて bsuid フィールドが含まれます。BSUIDのみを持つユーザーの場合、電話番号フィールドは空になります。ダウンストリームのパイプラインで電話番号フィールドに厳格な要件がある場合は、null値または空の値を処理できることを確認してください。
異なるビジネスポートフォリオにまたがって複数のWABAを持っています。同じユーザーがBrazeで2つの異なるプロファイルとして表示されますか？
ポートフォリオがリンクされていない場合は、はい。同じWhatsAppユーザーでもビジネスポートフォリオごとに異なるBSUIDを持つため、Brazeはそれぞれに別のプロファイルを作成します。
これを解決するには、Metaの担当者に連絡して、ポートフォリオのリンクの利用資格を確認してください。リンクされると、Metaはすべてのポートフォリオで共有される親BSUIDを提供し、Brazeはこれを使用してWABA全体でユーザーを一貫して識別します。詳細については、ビジネスポートフォリオと親BSUIDをリンクするを参照してください。
Contact Bookを無効にできますか？
Contact Bookは有効のままにしておくことを強くお勧めします。Contact Bookを無効にすると、ユーザーの過去の電話番号レコードがすべて失われます。その結果、ユーザー名を導入したユーザーは、以前にメッセージを送信したことがある場合でも、新しいBSUIDのみのユーザーとして表示されます。
その他のリソース