メインコンテンツまでスキップ

Web Integration Overview

パブリッシャーとして、UID2 とインテグレーションしてア ID トークンを生成し、ウェブページのコンテキストで RTB ビッドストリームに渡す方法はたくさんあります。

このページでは、インテグレーションステップとインテグレーションオプションの概要と、各オプションの追加情報へのリンクを紹介します。

Key Integration Steps

UID2 とインテグレーションするには、次の 3 つの主要なアクティビティを実装します。

  1. Generate the UID2 token
  2. Refresh the UID2 token as needed
  3. Pass the UID2 token into the bidstream

これらの重要なステップを達成する方法はたくさんあります。最もシンプルで高速な実装は、Prebid.js 8.21.0 以降を使用した完全な Client-Side の実装です。

Integration Options Summary

次の表は、インテグレーションステップごとに利用可能なソリューションをまとめたものです。

すべてのステップを実行するには、ソリューションを組み合わせることができます。たとえば、Client-Side で SDK for JavaScript を使用してトークンを生成してリフレッシュし、Google Ad Manager Secure Signals を使用してトークンをビッドストリームに渡すことができます。

Integration SolutionGenerate TokenRefresh TokenPass 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, server-side
SDK for Java
SDK for Python
Direct integration (API endpoints)
Google Ad Manager Secure Signals

実装を選択し、開始するには、以下の手順に従ってください:

  1. UID2 Token を生成するオプションの概要を確認します:
  2. UID2 Token をリフレッシュする オプションを確認します。
  3. トークンをビッドストリームに渡す オプションを確認します。
  4. 最適なオプションを選択し、実装ドキュメントをクリックしてください。

Generate the UID2 Token

UID2 Token を生成するには、主に2つの方法があります。—UID2 Token 生成リクエストを選択することができます:

それぞれのオプションには利点があります。最も簡単で高速なインテグレーションオプションとして、Prebid.js 8.21.0 以降を使用した Client-Side インテグレーションを勧めます。

注記

すべてのインテグレーションオプションで、UID2 Token をローカルストレージまたはクッキーストレージに保存することを選択できます。

Client-Side Integration Options

Client-Side で UID2 Token を生成することには、次のような利点があります:

  • コードは消費者のウェブページ上の Client-Side で実行され、Server-Side のコーディングは必要ありません。
  • トークンの生成、トークンのリフレッシュ、トークンのビッドストリームへの受け渡しなど、すべての機能を処理する Prebid インテグレーションがあります。Prebid 8.21.0 以降を使用している場合、これが最もシンプルで高速な実装オプションです。

Client-Side のインテグレーションを選択した場合、アカウント設定の一環として、セキュリティのためにルートレベルドメインのリストを提供する必要があります。詳細については、アカウント設定ページの Client-Side Web Integrations を参照してください。

次の表は、Client-Side で UID2 Token を生成したいパブリッシャーが、ウェブページから UID2 Token を生成するためのオプションと、それに対応するドキュメントリソースをまとめたものです。

OptionDocumentation
Prebid.js client-side implementation (8.21.0 or later)UID2 Client-Side Integration Guide for Prebid.js
SDK for JavaScript, client-side implementationClient-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 を生成したいパブリッシャー向けのオプションをまとめたものです。

OptionDocumentation
SDK for JavaScript, client-server implementationClient-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 のリフレッシュをサポートするインテグレーションオプションをまとめたものです。

OptionDocumentation
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 implementationClient-Side Integration Guide for JavaScript
SDK for JavaScript, client-server implementationClient-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 をビッドストリームに渡すことをサポートするインテグレーションオプションをまとめたものです。

OptionDocumentation
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 SignalsGoogle Ad Manager Secure Signals Integration Guide
注記

トークンを生成し、それをリフレッシュし続ける限り、UID2 Token をビッドストリームに渡すために他のオプションを使用することもできます。