Advertiser/Data Provider Integration to HTTP Endpoints
このガイドでは、広告主およびデータプロバイダが、UID2 とインテグレーションするために、SDK、Snowflake、または AWS Entity Resolution などの他の実装オプションを使用せずに、UID2 HTTP エンドポイントを呼び出すためのコードを記述する手順について説明します。
広告主とデータプロバイダー向けのインテグレーションオプションと手順の概要については、Advertiser/Data Provider Integration Overview を参照してください。
Complete UID2 Account Setup and Configure Account
UID2 とインテグレーションするには、UID2 のアカウントが必要です。まだアカウントを作成していない場合は、最初に Account Setup ページの手順に従ってください。
アカウントの初期設定が完了すると、本番環境用の credentials を作成し、必要に応じて追加の値を設定できる UID2 Portal にアクセスするための手順とリンクが送信されます。詳細については、UID2 Portal での開始 を参照してください。
UID2 Portal の API Keys ページで、以下の値を設定する必要があります:
- API key、Client Key とも呼ばれます。
- Client secret、参加者と UID2 Servivce のみが知る値です。
これらの値を安全に保管することは非常に重要です。詳細については、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 を含むリクエストを ID マッピングエンドポイントに送信します。 |
1-b | POST /identity/map response | レスポンスで返される advertising_id (raw UID2) は、関連する DSP でオーディエンスをターゲットするために使用できます。レスポンスは、ユーザーの raw UID2 と、それに対応するソルトバケットの bucket_id を返します。バケットに割り当てられたソルトは年に一度ローテーションし、生成された raw UID2 に影響を与えます。ソルトバケットのローテーションを確認する方法の詳細は、5: Monitor for salt bucket rotations related to your stored raw UID2s を参照してください。 |
2: Store Raw UID2s and Salt Bucket IDs
Step 1 のレスポンス Generate Raw UID2s from DII には、マッピング情報が含まれています。以下の情報を保存することを勧めます:
- DII (
identifier
) と raw UID2 (advertising_id
)、ソルトバケット (bucket_id
) のマッピングをキャッシュします。 - レスポンスデータを受信した際のタイムスタンプを保存します。後で、このタイムスタンプを、Step 5 の Monitor for Salt Bucket Rotations for Your Stored Raw UID2s で返される
last_updated
タイムスタンプと比較できます。
3: Manipulate or Combine Raw UID2s
Step 1 で受け取った UID2 を使用します。たとえば、次のような操作を行うことができます:
- 操作を行う: たとえ ば、DII から生成した UID2 と広告主またはデータプロバイダーなど他の参加者から受け取った UID2 を組み合わせる。
- 既存のオーディエンスに新しい UID2 を追加する。
4: Send Stored Raw UID2s to DSPs to Create Audiences or Conversions
raw UID2 を以下の目的で使用します:
- 保存された raw UID2 を DSP に送信して、オーディエンスとコンバージョンを作成する。
- 計測のために raw UID2 を使用する。
たとえば、Step 1-b で返された advertising_id
(raw UID2) を DSP に送信してオーディエンスを構築します。各 DSP は、オーディエンスを構築するための独自のインテグレーションプロセスを持っています。オーディエンスを構築するために raw UID2 を送信するための DSP から提供されるインテグレーションガイダンスに従ってください。
また、計測(アトリビューション)やリターゲティングのために、API やピクセルを介してコンバージョン情報を送信することもできます。