メインコンテンツまでスキップ

AWS Entity Resolution integration guide

AWS Entity Resolution は、Amazon Web Services が提供する ID ソリューションプロダクトで、AWS の顧客が UID2 フレームワークとインテグレーションすることを可能にします。このインテグレーションにより、UID2 Operator を直接呼び出したり、機密性の高いクライアント ID や秘密鍵の値を扱ったりすることなく、安全かつシームレスに UID2 を生成することができます。

このサービスは、DII (メールアドレスまたは電話番号) を raw UID2 に迅速かつ安全にマッピングすることができます。

注記

現在 UID2 エコシステムに参加していない場合は、Request Access to UID2 にアクセスしてください。

AWS Entity Resolution を使用して UID2 とインテグレーションに関するビデオプレゼンテーションとデモは、YouTube の Getting Started with AWS Entity Resolution Integration with Unified ID 2.0 を参照してください。

ヒント

広告主とデータプロバイダー向けのすべてのインテグレーションオプションと手順の概要は、Advertiser/data provider integration overview を参照してください。

Functionality​

次の表は、AWS Entity Resolution インテグレーションで利用可能な機能をまとめたものです。

Encrypt Raw UID2 to UID2 TokenDecrypt UID2 Token to Raw UID2Generate UID2 Token from DIIRefresh UID2 TokenMap DII to Raw UID2s
NoNoNoNoYes

Integration summary​

次の表は、AWS Entity Resolution を使用して UID2 とインテグレーションする手順をまとめたものです。

Step/LinkDetails
Initial setup stepsUID2 アカウント、AWS アカウントを作成し、リンクします:
Configure AWS accountIAM ユーザー、データテーブル、データのスキーママッピングを設定します。
Create a matching workflow入力場所、適用するマッチング手法、出力場所など、データをマッチングするためのワークフローを作成します。
Run the matching workflow入力データを処理して raw UID2 を生成します。

Workflow diagram​

以下の図は、サービスへの登録から設定ステップを経て raw UID2 を受け取るまでの、エンドツーエンドの UID2 プロセスを示しています。

AWS Entity Resolution workflow

次の表は、図に示されたステップを示しています。

StepActorAction
1ParticipantAWS に登録します。
2ParticipantUID2 の契約を締結し、UID2 連絡先と AWS アカウント ID を共有します。
3ParticipantAmazon Data Exchange の UID2 をサブスクライブします。
4UID2 AdministratorStep 2 で提供された AWS アカウント ID と、Step 3 で受信したサインアップリクエストを照合し、リクエストを承認します。
5Participant入力データを Amazon S3 バケットに格納します。
6ParticipantEntity Resolution を設定し、マッチングワークフローを作成します。
7Participantマッチングワークフローを実行します。
8AWS Entity ResolutionS3 バケットから入力データを読み込みます。
9AWS Entity Resolution入力データを POST /SendApiAsset を使って Amazon Data Exchange に送信します。
10Amazon Data ExchangePOST /uid2/assignment を用いて API Gateway にデータを送信します。
11API Gatewaypath=assignment を使って Lambda にデータを送ります。
12Lambda for UID2 generationUID2 Public Operator にデータを送り、POST /identity/map を使用して raw UID2 に変換します。
13UID2 Public Operatorraw UID2 を API Gateway に返します。
14Lambda for UID2 generationraw UID2 を API Gateway に返します。
15API Gatewayraw UID2 を Amazon Data Exchange に返します。
16Amazon Data Exchangeraw UID2 を AWS Entity Resolution に返します。
17AWS Entity Resolutionraw UID2 を含む出力レコードを S3 バケットに書き込みます。

Preparing DII for processing​

UID2 に変換する入力データが許容可能な形式であることは非常に重要です。そうでない場合、期待される結果は得られません。たとえば、Phone number normalization で説明されているように、電話番号には国コードを含めるように正規化する必要があります。

詳細は、Preparing emails and phone numbers for processing を参照してください。

フルトークン生成パイプラインをエンドツーエンドで検証し、正規化・ハッシュ化・エンコードされた値から生成されたトークンが正確であることを確認するためには、［UID2 Token Validator］（../ref-info/ref-token-validator.md）を使用してください。

Initial setup steps​

以下は、AWS Entity Resolution で UID2 インテグレーションを設定するための初期手順です:

Create AWS account​

AWS アカウントにサインアップするか、既存のアカウントを使用します。

詳細は AWS ドキュメントの Getting started: Are you a first time AWS user? を参照してください。

Create UID2 account​

UID2 の連絡先に、あなたを UID2 参加者として登録するよう依頼します。依頼先がわからない場合は、Contact info を参照してください。

UID2 の連絡先に、Entity Resolution での UID2 インテグレーションに使用する AWS アカウント ID を送信してください。

Subscribe to UID2 on AWS data exchange​

AWS Data Exchange の Unified ID 2.0 Identity Resolution ページにアクセスし、Continue to Subscribe. をクリックします。

AWS data exchange market place screenshot

加入リクエストを受け取ると、UID2 チームは以下を行います:

  • サブスクリプションのリクエストを確認します。
  • リクエストを Create UID2 account で送信した AWS アカウント ID と照合します。
  • リクエストを承認します。

Configure AWS account​

UID2 の参加者は AWS の S3 バケットにデータを保存し、AWS Entity Resolution とインテグレーションします。AWS アカウントを作成したら(Create AWS account を参照してください。)、基本的な手順は以下の通りです。

注記

詳細な手順は、AWS ドキュメントの Setting up AWS Entity Resolution を参照してください。

  1. 管理者ユーザーを作成します.

  2. データテーブルを準備します.

    AWS Entity Resolution では、各入力データテーブルには、消費者識別子を持つソースレコードが含まれます。UID2 では、識別子はメールアドレスまたは電話番号のいずれかになりますが、各レコードの識別子は 1 つだけでなければなりません。識別子は、提供された他のソースレコードと照合することができます。各レコードには、Step 4 で作成したスキーママッピングの主キーとして定義されている固有 ID が必要です。以下の手順に従ってください:

    • 入力データテーブルをサポートされているデータ形式で保存します。
    • 入力データテーブルを Amazon S3 にアップロードします。
    • AWS Glue テーブルを作成します。

  3. コンソールユーザーの IAM ロールを作成します。

  4. AWS Entity Resolution のワークフロージョブロールを作成します。

  5. データのスキーママッピングを作成します: AWS ドキュメントの Creating a schema mapping を参照してください。

Create a matching workflow​

最初のアカウント作成とセットアップが完了したら、次のステップはデータのマッチングワークフローを作成することです。

以下のステップは、AWS Entity Resolution ユーザーインターフェースで行うアクションの概要です。詳細と手順は、AWS Entity Resolution ドキュメントの Creating a matching workflow with UID 2.0 を参照してください。

注記

UID2 は、UID2 生成のためにメールアドレスまたは電話番号のいずれかをサポートします。しかし、AWS Entity Resolution では、スキーママッピングに両方の値が存在する場合、ワークフローはメールアドレスを使用し、電話番号はパススルーフィールドとして扱います。もしデータにメールアドレスと電話番号が混在している場合、最適な方法は、スキーママッピングを別々にして、それぞれ別のワークフローを作成することです。このシナリオでは、以下のステップを 2 回行います—1 つはメールアドレス用のワークフロー、もう 1 つは電話番号用のワークフローを作成します。

マッチングワークフローを作成するには、まず AWS Management コンソールにサインインし、AWS Entity Resolution ページを開き、Workflows > Matching workflows > Create matching workflow を選択します。次に、マッチングワークフローの以下のステップを完了します。

  1. 一致するワークフローについて、以下の詳細を指定します:

    • Name: この値は必須です。短く、わかりやすく、直感的な名前を推奨します。たとえば、会社名を指定する場合: CompanyName_UID2_Daily_Matching。

    • Description: マッチングワークフローの説明(オプション)。

    • Data input: AWS のデータソース。ドロップダウンリストから、AWS Glue データベース、AWS Glue テーブル、スキーママッピングの順に選択します。データ入力は複数指定できます。以下の例では、メールアドレスのみを指定しています:

      UniqueIdNameEmailDate of Birth
      0001Test 1test1@uidapi.com1/1/90
      0002Test 2test2@gmail.com1/2/78
      注記

      1 レコードにつき、メールアドレスまたは電話番号フィールドは 1 つだけです。メールアドレスが存在する場合、電話番号はパススルーとして扱われます。電話番号を処理するには、別のワークフローを作成してください。詳細はこのセクションの前を参照してください。

    • Service access: Entity Resolution に、指定されたデータにアクセスし、AWS Glue でデータを呼び出し、AWS Data Exchange を呼び出す権限を付与します。新しいサービスロールを作成して、必要なすべての権限を持つ新しいロールを作成することを強くお勧めします。既存のサービスロールを使用する場合は、AWS Data Exchange を呼び出す権限を追加してください:

      {
      "Version": "2012-10-17",
      "Statement": [
          {
              "Effect": "Allow",
              "Sid": "DataExchangePermissions",
              "Action": "dataexchange:SendApiAsset",
              "Resource": [
                  "<Asset ARN>"
              ]
            }
        ]
      }

      Asset ARN は、AWS Data Exchange コンソールの "AWS Data Exchange" > "Entitled data" > "Unified ID 2.0 Identity Resolution" > "Data set: UnifiedID-2.0" > "Revision: Date" > "Asset: venice-api-gateway-prod" で確認できます。

    • Decryption Key: 入力データが暗号化されている場合、AWS Key Management Service (KMS) キーを指定する必要があります。

  2. マッチング技術を選びます:

    • Matching methodで、Partner services オプションを選択します。

    • 次に、Partner services で、Unified ID2.0 を選択します。

    • Next をクリックします。

      先のステップ、Subscribe to UID2 on AWS data exchange を完了していれば、Approved のメッセージが表示されます。

  3. データの出力先を定義します:

  • Data Output Destination には、出力データに使用する S3 バケットの URI を指定します。データフォーマットを選択します: Normalized または Original を選択します。

    Normalized がデフォルトで、データ入力はマッチングの前に正規化されます。

    データは、デフォルトでは AWS が所有し管理するキーで暗号化されます。別のキーを指定するには、暗号化設定をカスタマイズしてください。

  • 次の例に示すように、出力から除外したい入力フィールドと、出力データでハッシュ化したいフィールドを選択します。

    UniqueIdNameEmailDate of BirthUID2_identifierUID2_advertising_idUID2_bucket_id
    0001Test 1test1@uidapi.com1/1/90test1@uidapi.comQ4A5ZBuBCYfuV3Wd8Fdsx2+i33v7jyFcQbcMG/LH4eM=ad1ANEmVZ
    0002Test 2test2@gmail.com1/2/78test2@gmail.comkds8hgBuBCYfuV3Wd8Fdsx2+i33v7jyFcQbcMG/jgksuh=kd9ANE98d

  1. Review and Create: マッチングワークフローのすべての詳細を確認します。値に問題がなければ、Create をクリックします。

    一致するワークフローが作成され、確認メッセージが表示されます。

Run the matching workflow​

以下の手順に従って、マッチングワークフローを実行し、結果を表示します。

詳細は AWS Entity Resolution ドキュメントの Running and managing matching workflows を参照してください。

  1. AWS Management コンソールにサインインし、AWS Entity Resolution ページを開き、Workflows > Matching workflows を選択します。

  2. 実行したいワークフローを選択します。

  3. Matching workflows の詳細ページで、右上にある Run を選択します。

    マッチングワークフローが実行されます。完了すると、Completed というステータスメッセージが表示されます。

  4. 結果を表示するには、Data 出力タブに移動し、Amazon S3 の場所を選択します。