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

UID2 Integration Overview for Prebid

このガイドは、UID2 とインテグレーションし、RTB ビッドストリームで Prebid.js によって渡される UID2 token(Advertising Token) を生成したいパブリッシャー向けのインテグレーションオプションの概要です。

Prebid.js Support for Web​

UID2 は、以下をサポートする Prebid.js module を提供しています:

さらに柔軟性を高めるため、UID2 は JavaScript SDK など、一部の機能や補完的なプロダクトの代替手段も提供しています。

注意

UID2 は GDPR が適用される場所では使用しないように設計されています。このモジュールは渡された同意データをチェックし、gdprApplies フラグが true に設定されている場合は動作しません。

Generating the UID2 Token​

DII へのアクセスに応じて、Prebid.js で使用する UID2 Token を生成する方法は次の表のように 2 種類あります 。

どの方法が最適かを判断し、該当するインテグレーションガイドに従ってください。

ScenarioIntegration Guide
Client-Side で DII にアクセスでき、フロントエンドの開発のみを行いたい。UID2 Client-Side Integration Guide for Prebid.js
Server-Side で DII にアクセスし、Server-Side の開発ができる。UID2 Client-Server Integration Guide for Prebid.js

Refreshing the UID2 Token​

Prebid.js UID2 Module は、UID2 Token を自動的にリフレッシュすることができます。Prebid.js の外部で手動リフレッシュを実装したい場合は、Server-Side インテグレーションガイドの Refreshing a UID2 Token を参照してください。Client-Side のインテグレーションソリューションには、トークンの自動リフレッシュが含まれています。

Storing the UID2 Token in the Browser​

デフォルトでは、UID2 モジュールはローカルストレージを使用してデータを保存します。代わりにクッキーを使用する場合は、次の例のように params.storage を cookie に設定します。

詳細は、Prebid ドキュメントの Unified ID 2.0 Configuration を参照してください。

pbjs.setConfig({ 
  userSync: { 
    userIds: [{ 
      name: 'uid2', 
      params: { 
        // default value is 'localStorage' 
        storage: 'cookie'   
      } 
    }] 
  } 
});

クッキーのサイズが大きくなる可能性があるため、問題になる可能性があります。ただし、ローカルストレージが選択肢にない場合、これは1つのアプローチです。

Passing the UID2 Token to the Bidstream​

UID2 module を設定するには pbjs.setConfig を呼び出します。サポートされているパラメータの詳細については、実装に適用されるガイドを参照してください:

UID2 module が設定されると、ユーザーの UID2 Token を管理し、ユーザーのブラウザに保存します。

Client-Side または Server-Side でクライアントリフレッシュモードを使用してトークンを生成する場合、ユーザーのブラウザでサイトが開いている間は、モジュールが自動的にトークンをリフレッシュします。しかし、Server-Side でトークンのリフレッシュを管理するオプションもあります。詳細については、Server-Side インテグレーションガイドの Refreshing a UID2 Token を参照してください。Client-Side のインテグレーションソリューションには、トークンの自動リフレッシュが含まれています。

Integration Overview: High-Level Steps​

Prebid.js を使ってサイトを UID2 とインテグレーションするには、以下のステップを完了する必要があります:

  1. UID2 アカウントのセットアップを完了します。
  2. Prebid.js をサイトに追加します。
  3. UID2 module を設定します。

詳細な手順については、以下のインテグレーションガイドのいずれかを参照してください:

UID2 Integration with Prebid Mobile SDK for Mobile Devices​

UID2 と Prebid のインテグレーションは、Android および iOS モバイルデバイスで UID2 Mobile Integration with Prebid Mobile SDK を使用してサポートされています。