Advertiser/Data Provider Integration to HTTP Endpoints
このガイドでは、広告主やデータプロバイダーが UID2 HTTP エンドポイントを呼び出すコードを記述して、SDK、Snowflake、または AWS Entity Resolution などの他の実装オプションを使用するのではなく、UID2 とインテグレーションする手順について説明します。
広告主及びデータプロバイダー向けのインテグレーションオプションと手順の概要は、Advertiser/Data Provider Integration Overview を参照してください。
Complete UID2 Account Setup and Configure Account
UID2 とインテグレーションするには、UID2 アカウントが必要です。まだアカウントを作成していない場合は、まず Account Setup ページに記載されている手順に従ってください。
初期アカウント設定が完了すると、UID2 Portal にアクセスするための指示とリンクが送信されます。ここで、credentials を作成し、必要に応じて追加の値を構成できます。詳細は、Getting Started with the UID2 Portal を参照してください。
UID2 Portal の API Keys ページで、次の値を設定する必要があります:
- API key (クライアントキーとも呼ばれます)
- Client secret (参加者と UID2 サービスのみに知られている値)
これらの値を安全に保管することが非常に重要です。詳細は、Security of API Key and Client Secret を参照してください。
High-Level Steps
UID2 とインテグレーションするための広告主やデータプロバイダー向けの手順は、以下のとおりです:
Integration Diagram
次の図は、オーディエンスの構築とターゲティングのために、DII を raw UID2 にマッピングするためにデータ収集者が行わなければならない手順です。
DII は、ユーザーの正規化されたメールアドレスまたは電話番号、または正規化および SHA-256 ハッシュ化されたメールアドレスまたは電話番号を指します。
1: Generate Raw UID2s from DII
Step | Endpoint | Description |
---|---|---|
1-a | POST /identity/map request | DIIを含むリクエストをアイデンティティマッピングエンドポイントに送信します。 |
1-b | POST /identity/map response | レスポンスで返される raw UID2 (u フィールド) は、関連する DSP でオーディエンスをターゲティングするために使用できます。レスポンスは、ユーザーの raw UID2 ( u )、リフレッシュ タイムスタンプ (r )、およびオプションで、現在の UID2 が過去 90 日以内にローテーションされた場合の前の raw UID2 (p ) を返します。リフレッシュ タイムスタンプを使用して、UID2 を更新するタイミングを判断します。詳細は、5: Monitor for Raw UID2 Refresh を参照してください。 |
2: Store Raw UID2s and Refresh Timestamps
Step 1、Generate Raw UID2s from DII のレスポンスには、マッピング情報が含まれています。以下の情報を保存することを推奨します:
- DII と raw UID2 (
u
フィールド) のマッピングをキャッシュします。 - raw UID2 がいつ更新されるかを知るために、リフレッシュ タイムスタンプ (
r
フィールド) を保存します。 - 過去 90 日以内にローテーションされた場合の前の raw UID2 (
p
フィールド) をオプションで保存します。
3: Manipulate or Combine Raw UID2s
Step 1 で受け取った UID2 を使用します。例えば、以下のような操作を行うことができます:
- いくつかの操作を行います:たとえば、DII から生成した raw UID2 と、広告主やデータプロバイダーなどの別の参加者から受け取った raw UID2 を突合します。
- 新しい raw UID2 を既存のオーディエンスに追加します。