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