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

UID2 Integration Overview for Prebid

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

Integrating with Single Sign-On (SSO)​

SSO ログインを提供するために1つ以上の SSO プロバイダーとインテグレーションしている場合、SSO プロバイダーからログインユーザーのメールアドレスを取得して UID2 Token を生成できる可能性があります。

詳細は、Publisher Integration with SSO Providers を参照してください。

Preparing DII for Processing​

UID2 に変換する入力データが許容可能な形式であることは非常に重要です。そうでない場合、期待される結果は得られません。たとえば、Phone Number Normalization で説明されているように、電話番号には国コードを含めるように正規化する必要があります。

詳細は、Preparing Emails and Phone Numbers for Processing を参照してください。

フルトークン生成パイプラインをエンドツーエンドで検証し、正規化・ハッシュ化・エンコードされた値から生成されたトークンが正確であることを確認するためには、［UID2 Token Validator］（../ref-info/ref-token-validator.md）を使用してください。

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 を使用してサポートされています。