加入者マッチ

Subscriber Match インサイトは、電話番号のエンドユーザーデータをモバイルネットワーク事業者に登録されているものと比較します。情報には、ユーザーの名前、住所、郵便番号、電話番号、および生年月日を含めることができ、Subscriber Matchは、指定された属性ごとに一致する応答を返します。この洞察は、他のすべてのインサイト APIで利用できる。

加入者マッチでできること

実際のユーザーをより迅速に検証し、解約を減らし、カスタマー・エクスペリエンスを向上させる。
顧客成約率の向上
個人情報窃盗や合成ID詐欺のリスクを軽減します。
KYC (Know Your Customer)を向上させ、市場における規制を遵守する。
加入者照合を、SIMスワップや位置確認などの他のインサイトとシームレスに組み合わせ、リスクを特定し、安全なオンライン取引を実現します。

注：本番でこのインサイトを使用するには、携帯電話会社の承認が必要であり、これは「ネットワーク・レジストリ」を通じて管理される。アクセスを要求する方法については、以下に従ってください。本ガイド.

前提条件

Identity Insights を使用するには、アカウントが正しく設定されていることを確認する必要があります。はじめにのガイドを参照されたい：

アカウントの作成
Identity Insights API で使用する Vonage アプリケーションの作成、
利用可能なさまざまな環境と、それらを使用するためのアカウントの設定方法、
また、Dashboard Getting Started UIを使用して、コードを書かずにAPIを使用する方法も紹介します。

このガイドでは、cURL を使用してプログラムで購読者一致インサイトを使用する方法を説明します。

Identity Insights API は、複数の地域のエンドポイントから利用できる。本ガイドの例では EU エンドポイントを使用していますが、全リストは以下を参照してください。技術詳細.

APIを呼び出す

Identity Insights API の認証は、コンパクトで自己完結型の JSON トークンである JWT を介して行われます。JWT を生成するには、当社のオンラインジェネレーターあるいは Vonage CLI.JWTを生成するには、アプリケーションIDと秘密鍵が必要です。JWTを取得したら、APIにリクエストを送信できます。

この例では、サブスクライバーマッチインサイトのcURLリクエストを示している。 subscriber_match配列には、必要な数だけ属性を含めることができる：

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "3932462384260",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
        "subscriber_match": {
            "id_document": "66666666q",
            "given_name": "Federica",
            "family_name": "Sanchez Arjona",
            "street_name": "Crawfords Corner Road",
            "street_number": "4",
            "postal_code": "07733",
            "locality": "Holmdel",
            "region": "Monmouth County",
            "country": "US",
            "house_number_extension": "Suite 2416",
            "birthdate": "1978-08-22"
          }
        }
    }'

APIは次に、特定の携帯電話ユーザーに関連する情報を、携帯電話ユーザーのオペレーター自身の記録からファイルされたものと比較し、提供された各属性の一致値を返す：

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "subscriber_match": {
        "id_document_match": "EXACT",
        "given_name_match": "DATA_UNAVAILABLE",
        "family_name_match": "DATA_UNAVAILABLE",
        "address_match": "EXACT",
        "street_name_match": "EXACT",
        "street_number_match": "EXACT",
        "postal_code_match": "EXACT",
        "country_match": "EXACT",
        "birthdate_match": "NONE",
        "status": {
            "code": "OK",
            "message": "Success"
      }
    }
  }
}

ここでは status オブジェクトは、指定された電話番号について返された情報のステータスを示します：

フィールド説明

status.code リクエストのステータスを示すコード。のいずれかでなければならない：

NO_COVERAGE:国またはモバイルネットワークは、利用可能なサプライヤーによってサポートされていません。
INVALID_PURPOSE:使用された目的は、このインサイトで有効または許可されていません。
UNAUTHORIZED:アプリケーション、サプライヤー、電話番号の組み合わせでは、リクエストを承認できませんでした。
INTERNAL_ERROR:リクエストの処理中に内部エラーが発生しました。
SUPPLIER_ERROR:サプライヤーがリクエスト処理中にエラーを返しました。
NOT_FOUND:このインサイトの電話番号が見つかりません。
INVALID_NUMBER_FORMAT:電話番号フォーマットは、キャリアからユーザーへの割り当てには無効です。
SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED:オペレータは、idDocument が他の属性と一致することを要求する。
SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH:オペレータは、他の属性にマッチするために必要な idDocument にマッチすることはできません。
SUBSCRIBER_MATCH.INVALID_PARAM_COMBINATION:表示されたパラメータの組み合わせは無効です。
OK:インサイトは正常に処理されました。

status.message より詳細なステータスの説明。

フィールド	説明
`status.code`	リクエストのステータスを示すコード。のいずれかでなければならない： `NO_COVERAGE`:国またはモバイルネットワークは、利用可能なサプライヤーによってサポートされていません。 `INVALID_PURPOSE`:使用された目的は、このインサイトで有効または許可されていません。 `UNAUTHORIZED`:アプリケーション、サプライヤー、電話番号の組み合わせでは、リクエストを承認できませんでした。 `INTERNAL_ERROR`:リクエストの処理中に内部エラーが発生しました。 `SUPPLIER_ERROR`:サプライヤーがリクエスト処理中にエラーを返しました。 `NOT_FOUND`:このインサイトの電話番号が見つかりません。 `INVALID_NUMBER_FORMAT`:電話番号フォーマットは、キャリアからユーザーへの割り当てには無効です。 `SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED`:オペレータは、idDocument が他の属性と一致することを要求する。 `SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH`:オペレータは、他の属性にマッチするために必要な idDocument にマッチすることはできません。 `SUBSCRIBER_MATCH.INVALID_PARAM_COMBINATION`:表示されたパラメータの組み合わせは無効です。 `OK`:インサイトは正常に処理されました。
`status.message`	より詳細なステータスの説明。

フィールド	説明	必須
`id_document_match`	顧客のID文書に関連付けられたId番号が、オペレータのシステムのものと一致するかどうかを示します。	いいえ
`given_name_match`	顧客の姓名がオペレータシステムのものと一致するかどうかを示します。	いいえ
`family_name_match`	顧客の姓/名/姓がオペレータシステムのものと一致するかどうかを示します。	いいえ
`address_match`	顧客の完全な住所がオペレータのシステム上の住所と一致するかどうかを示します。	いいえ
`street_name_match`	顧客の通り名がオペレータのシステム上のものと一致するかどうかを示します。	いいえ
`street_number_match`	顧客のストリート番号がオペレータのシステムのものと一致するかどうかを示します。	いいえ
`postal_code_match`	顧客の郵便番号/郵便番号がオペレータのシステムのものと一致するかどうかを示します。	いいえ
`locality_match`	顧客の住所の所在地域が、オペレーターのシステム上の住所と一致するかどうかを示します。	いいえ
`region_match`	顧客の地域または都道府県が、オペレーターのシステム上の地域または都道府県と一致するかどうかを示します。	いいえ
`country_match`	顧客の住所の国とオペレーターのシステムの国が一致するかどうかを示します。	いいえ
`house_number_extension_match`	顧客の住所の家屋番号の内線番号が、オペレーターのシステムのものと一致するかどうかを示します。	いいえ
`birthdate_match`	顧客の生年月日がオペレータシステムの生年月日と一致するかどうかを示します。	いいえ

これらのフィールドは、それぞれ以下のいずれかの値を持つ：

EXACT - の場合、提供された値は正確に一致する。
HIGH - の場合、提供される値は近いが不完全な一致である。
PARTIAL - の場合、提供された値は部分的に一致する。
LOW- 提供された値はわずかに一致する。
NONE - の場合、提供された値はまったく一致しない。
DATA_UNAVAILABLE - リクエスト属性のデータが保持されていない。
INCLUDED_WITH_ADDRESS_MATCH - を計算する際に、入力フィールドに提供された値が考慮された。 address_match しかし、独立した評価はされていない。

さらに読む

Identity Insights API の詳細については、以下を参照してください。 APIリファレンス.
ご不明な点がございましたら、下記までお問い合わせください。 VonageコミュニティSlack.