Server-Side Token Generation

パブリッシャーが Client-Server または Server-Side UID2 インテグレーションを設定する場合、最初のステップはサーバーで UID2 Token を生成することです。その後、トークンを Client-Side または Server-Side でリフレッシュし、RTB ビッドストリームに送信するためにトークンを Client-Side に渡すことができます。

パブリッシャーが Server-Side で直接識別情報 (DII) (メールアドレスまたは電話番号) を提供して UID2 Token を生成するための 2 つのアプローチがあります:

SDK のインテグレーション
API エンドポイントへのダイレクトインテグレーション

警告

セキュリティ上の理由により、トークン生成に使用される API キーとシークレットは Server-Side で呼び出す必要があります。これらの値を Web ページ、モバイルアプリ、または Prebid に保存しないでください。詳細については、Security of API Key and Client Secret を参照してください。

オプションは次の表にまとめられています。

Integration Solution	Generate Token	Refresh Token
SDK for Java	✅	✅
SDK for Python	✅	✅
Direct integration (API endpoints with custom code)	✅	✅

Identity (UID2 Token と関連する値) を生成するために選択したインテグレーションオプションに関係なく、次のいずれかを実装する必要があります:

SDK: UID2 Server-Side SDK を使用して、Publisher Client クラスのいずれかを使用します。これらのクラスは、リクエストを 1 つのメソッド呼び出しに簡素化します。

手順については、次のいずれかを参照してください:
- SDK for Java, Usage for Publishers, Basic Usage
- SDK for Python, Usage for Publishers
SDK オプションを使用している場合、このガイドの残りの部分で必要な Identity レスポンスは、次のいずれかのメソッドの出力です:
- Java
- Python
tokenGenerateResponse.getIdentityJsonString()
token_generate_response.get_identity_json_string()
API: POST /token/refresh エンドポイントを呼び出します。

このガイドの残りの部分で必要な Identity レスポンスは、成功したエンドポイントのレスポンスの body セクション内のコンテンツです。例については、Successful Response を参照してください。

important

トークンを生成する DII が UID2 からオプトアウトされている場合、エンドポイントと SDK API はオプトアウトステータスを返します。この場合、情報を保存し、同じ DII に対してトークン生成エンドポイントを呼び出さないでください。