Web Integration Overview
パブリッシャーとして、UID2 とインテグレーションしてア ID トークンを生成し、ウェブページのコンテキストで RTB ビッドストリームに渡す方法はたくさんあります。
このページでは、インテグレーションステップとインテグレーションオプションの概要と、各オプションの追加情報へのリンクを紹介します。
Key Integration Steps
UID2 とインテグレーションするには、次の 3 つの主要なアクティビティを実装します。
これらの重要なステップを達成する方法はたくさんあります。最もシンプルで高速な実装は、Prebid.js 8.21.0 以降を使用した完全な Client-Side の実装です。
Integration Options Summary
次の表は、インテグレーションステップごとに利用可能なソリューションをまとめたものです。
すべてのステップを実行するには、ソリューションを組み合わせることができます。たとえば、Client-Side で SDK for JavaScript を使用してトークンを生成してリフレッシュし、Google Ad Manager Secure Signals を使用してトークンをビッドストリームに渡すことができます。
| Integration Solution | Generate Token | Refresh Token | Pass Token to the Bidstream |
|---|---|---|---|
| Prebid.js client-side (8.21.0 or later) | ✅ | ✅ | ✅ |
| Prebid.js client-server (7.53.0 or later) | — | ✅ | ✅ |
| SDK for JavaScript, client-side | ✅ | ✅ | — |
| SDK for JavaScript, client-server | ✅ | ✅ | — |
| SDK for Java | ✅ | ✅ | — |
| SDK for Python | ✅ | ✅ | — |
| Direct integration (API endpoints) | ✅ | ✅ | — |
| Google Ad Manager Secure Signals | — | — | ✅ |
実装を選択し、開始するには、以下の手順に従ってください:
- UID2 Token を生成するオプションの概要を確認します:
- UID2 Token をリフレッシ ュする オプションを確認します。
- トークンをビッドストリームに渡す オプションを確認します。
- 最適なオプションを選択し、実装ドキュメントをクリックしてください。
Generate the UID2 Token
UID2 Token を生成するには、主に2つの方法があります。—UID2 Token 生成リクエストを選択することができます:
- Client-Side (ユーザーのブラウザ内): Client-Side Integration Options を参照してください。
- Server-Side: Server-Side Integration Options を参照してください。
それぞれのオプションには利点があります。最も簡単で高速なインテグレーションオプションとして、Prebid.js 8.21.0 以降を使用した Client-Side インテグレーションを勧めます。
すべてのインテグレーションオプションで、UID2 Token をローカルストレージまたはクッキーストレージに保存することを選択できます。
Client-Side Integration Options
Client-Side で UID2 Token を生成することには、次のような利点があります:
- コードは消費者のウェブページ上の Client-Side で実行され、Server-Side のコーディングは必要ありません。
- Prebid.js のインテグレーションにより、すべての機能が処理されます—トークンの生成、トークンのリフレッシュ、トークンのビッドストリームへの受け渡しなど。Prebid.js 8.21.0 以降を使用している場合、これが最もシンプルで高速な実装オプションです。
Client-Side のインテグレーションを選択した場合、アカウント設定の一環として、セキュリティのためにルートレベルドメインのリストを提供する必要があります。詳細については、アカウント設定ページの Client-Side Web Integrations を参照してください。
次の表は、Client-Side で UID2 Token を生成したいパブリッシャーが、ウェブページから UID2 Token を生成するためのオプションと、それに対応するドキュメントリソースをまとめたものです。
| Option | Documentation |
|---|---|
| Prebid.js client-side implementation (8.21.0 or later) | UID2 Client-Side Integration Guide for Prebid.js |
| SDK for JavaScript, client-side implementation | Client-Side Integration Guide for JavaScript |
Server-Side Integration Options
Server-Side で UID2 Token を生成することには、次のような利点があります:
- directly identifying information (DII) を完全に Server-Side に置いておくことができます。
- 開発リソースがバックエンド開発者であれば、Server-Side のインテグレーションを好むかもしれません。
- Server-Side の Prebid.js インテグレーションでは、バージョンが 7.53.0 以降であれば、最新の Prebid.js バージョンにアップデートする必要はありません。
次の表は、Server-Side で UID2 Token を生成したいパブリッシャー向けのオプションをまとめたものです。
| Option | Documentation |
|---|---|
| SDK for JavaScript, client-server implementation | Client-Server Integration Guide for JavaScript |
| SDK for Java | - Publisher Integration Guide, Server-Side - SDK for Java |
| SDK for Python | - Publisher Integration Guide, Server-Side - SDK for Python |
| Direct integration (API endpoints) | Publisher Integration Guide, Server-Side |
Refresh the UID2 Token
セキュリティ上の理由から、UID2 Token の寿命は限られていますが、トークンをリフレッシュするメカニズムが組み込まれているので、続けて使用することができます。
トークンを取得すると、Refresh Token と、トークンの有効期間を示すタイムスタンプが付いてきます。現在の UID2 Token の有効期限が切れる前に Refresh Token を使って新しい UID2 Token を生成すれば、毎回新しい UID2 Token と更新された Refresh Token が発行されます。情報を有効に保つためにリフレッシュを続けることができます。
次の表は、UID2 Token のリフレッシュをサポートするインテグレーションオプションをまとめたものです。
| Option | Documentation |
|---|---|
| Prebid.js client-side implementation (8.21.0 or later) | UID2 Client-Side Integration Guide for Prebid.js |
| Prebid.js client-server implementation (7.53.0 or later) | UID2 Client-Server Integration Guide for Prebid.js |
| SDK for JavaScript, client-side implementation | Client-Side Integration Guide for JavaScript |
| SDK for JavaScript, client-server implementation | Client-Server Integration Guide for JavaScript |
| SDK for Java | - Publisher Integration Guide, Server-Side - SDK for Java |
| SDK for Python | - Publisher Integration Guide, Server-Side - SDK for Python |
| Direct integration (API endpoints) | Publisher Integration Guide, Server-Side |
Pass the UID2 Token Into the Bidstream
パブリッシャーは、DII (メールアドレスや電話番号) を UID2 Token に暗号化し、UID2 Token をビッドストリームに送信することで UID2 を使用します。
次の表は、UID2 Token をビッドストリームに渡すことをサポートするインテグレーションオプションをまとめたものです。
| Option | Documentation |
|---|---|
| Prebid.js client-side implementation (8.21.0 or later) | UID2 Client-Side Integration Guide for Prebid.js |
| Prebid.js client-server implementation (7.53.0 or later) | UID2 Client-Server Integration Guide for Prebid.js |
| Google Ad Manager Secure Signals | Google Ad Manager Secure Signals Integration Guide |
トークンを生成し、それをリフレッシュし続ける限り、UID2 Token をビッドストリームに渡すために他のオプションを使用することもできます。