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) を使用している場合は、ビジネスポートフォリオをリンクすることもおすすめします。
WhatsApp Contact Bookを有効にする
Contact Bookは、すでにやり取りしたことのあるユーザーの電話番号を記録するMetaの機能です。ユーザーがユーザー名を導入しても、そのユーザーがContact Bookに含まれていれば、電話番号は引き続きビジネス側に表示されます。そのため、ユーザーがユーザー名を有効にした後も、Brazeは電話番号でユーザーを識別し続けることができます。
Contact Bookを有効にするには、次の手順に従います。
- Meta Business Suite > ビジネス設定 > ビジネス情報に移動します。
- Contact Book機能が有効になっていることを確認します。
Contact Book機能はデフォルトでオンになっていますが、Metaのビジネス設定で確認することをおすすめします。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ユーザーをセグメントでターゲットにできますか?
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のみの新しいユーザーとして表示されます。
参考情報