SDK for JavaScript Reference Guide
この SDK を使用して、UID2 を使用したクライアント ID の生成また は確立、ターゲティング広告用の Advertising Token の取得、および UID2 Token の自動リフレッシュを容易に行うことができます。
以下のセクションでは、UID2 ID の確立のための高レベルな ワークフロー、SDK API リファレンス、および UID2 ストレージフォーマット を説明します。
UID2 Identify Module、または UID2 サポートのある他の製品と Prebid.js を使用している場合、SDK を使用する必要はありません。Prebid.js モジュールがすべてを管理します。詳細は、UID2 Client-Side Integration Guide for Prebid.js を参照してください。
コンテンツパブリッシャー向けのインテグレーション手順は、以下のガイドを参照してください:
SDK Version
このページは、最新の UID2 SDK for JavaScript バージョン 4 を説明しています。以前のバージョンを使用している場合は、Migration Guide を使用してインテグレーションをアップグレードすることを勧めます。必要に応じて、以下の以前のバージョンのドキュメントも利用できます:
Changes in Version 4
Version 4 には、Version 3 からの主な変更が含まれています:
-
New:
isIdentityAvailable()
関数は Version 3.10.0 でリリースされました。詳細については、isIdentityAvailable を参照してください。 -
Removed elements:
abort()
関数は v3 で非推奨となり、v4 には含まれていません。代わりに、abort()
と同じ機能を持つ disconnect() を使用してください。また、より徹底的な切断ロジックも含まれています。hasIdentity()
関数は削除されました。この関数は公開されていなかったため、使用されていない可能性がありますが、他の関数で使用されていたため、公開されていました。この関数を使用している場合は、isIdentityAvailable を使用してください。
Functionality
この SDK は、独自にカスタマイズした UID2 インテグレーションを行いたいパブリッシャーの開発を簡素化します。次の表は、SDK がサポートする機能を示しています。
Encrypt Raw UID2 to UID2 Token for Sharing | Decrypt UID2 Token to Raw UID2 | Generate UID2 Token from DII | Refresh UID2 Token | Map DII to Raw UID2s | Monitor Rotated Salt Buckets |
---|---|---|---|---|---|
— | — | ✅ | ✅ | — | — |
Sample Implementation
サンプルアプリケーションと関連するドキュメントは以下を参照してください:
- The UID2 Google Secure Signals with SDK v3 example:
- Code and docs
- Running site: Client-Side UID2 SDK Integration Example
- The example of JavaScript client-side integration: Code and running site (Client-Side Integration Example, UID2 JavaScript SDK).
UID2 Account Setup
UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントを作成していない場合は、まず Account Setup ページの手順に従ってください。
API Permissions
初期アカウント設定が完了すると、UID2 Portal にアクセスするための手順とリンクが送信されます。以下の操作を行うことができます:
- アカウント用の credentials を生成します。
- オプション: Client-Side の実装の場合、ドメイン名やモバイルアプリ ID などの設定値を設定します。
- オプションとして、チームメンバーに関する情報を設定するなど、他の値を設定します。
SDK が提供する特定の機能を使用する権限が与えられ、そのアクセスのための資格情報が提供されます。