加入者マッチ

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

の各フィールドは subscriber_match 配列は以下のいずれかの値を持つ：

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

さらに status リクエストの結果を示す配列：

code - は以下のいずれかの値となる：
- UNAUTHORIZED - リクエストの認証に問題があります。
- INVALID_PURPOSE - リクエストで提供された目的は有効ではない。
- INVALID_NUMBER_FORMAT - 電話番号の書式が無効です。
- NOT_FOUND - 提供された電話番号がオペレーターに見つからない場合。
- NO_COVERAGE - そのユーザーがいる国では、APIはカバーされていない。
- INTERNAL_ERROR- APIがエラーを返した。
- SUPPLIER_ERROR - 提供された属性の1つに問題があります。より詳細な情報は message フィールドにいる。
- OK - インサイトは正常に処理された。
- SUBSCRIBER_MATCH.ID_DOCUMENT_REQUIRED - 演算子は、idDocument が他の属性と一致することを要求する。
- SUBSCRIBER_MATCH.ID_DOCUMENT_MISMATCH - 演算子は idDocument にマッチしない。
- SUBSCRIBER_MATCH.INVALID_PARAM_COMBINATION - 指定されたパラメータの組み合わせは無効です。
message - には、より詳細なステータスの説明が含まれている。

さらに読む

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