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

UID2 integration overview for JavaScript

このガイドは、UID2 とインテグレーションし、SDK for JavaScript を使ってUID2 Token (Advertising Token) を生成したいパブリッシャー向けのインテグレーションオプションの概要です。

Prebid.js と追加 SDK オプションを含むすべてのウェブオプションの概要は、Publisher web integration overview を参照してください。

Introduction​

UID2 は、以下をサポートする JavaScript 用の SDK を提供しています:

さらに柔軟性を高めるため、UID2 は、Prebid インテグレーションなど、一部の機能や補完的な製品の代替方法も提供しています。

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）を使用してください。

Client-side or client-server integration​

SDK for JavaScript を使って UID2 とインテグレーションするためのオプションを、次の表にまとめました。最適なオプションを選択してください。

ScenarioOptionIntegration Guide
Client-Side で DII にアクセスでき、フロントエンド開発のみを行いたい。Client-Side integrationClient-side integration guide for JavaScript
Client-Server で DII にアクセスでき、Server-Side の開発が可能であるか、Private Operator を使用している。Client-Server integrationClient-server integration guide for JavaScript

Complete UID2 account setup and configure account​

UID2 とインテグレーションするには、UID2 アカウントが必要です。アカウントをまだ作成していない場合は、最初にAccount setup ページの手順に従ってください。

アカウントの初期設定が完了すると、UID2 Portal にアクセスするための手順とリンクが送信されます。ここで、本番環境用の credentials を作成し、提供する必要がある追加の値を設定できます。詳細は、Getting started with the UID2 Portal を参照してください。

UID2 Portal で行う手順は、実装が Client-Side、Client-Server、または Server-Side であるかによって異なります。各実装ガイドに具体的な手順が記載されています。

Generating the UID2 token​

DII へのアクセスに応じて、SDK for JavaScript を使用して UID2 Token を生成するには、Client-Side または Server-Side の2つの方法があります。

Client-side or client-server integration の表から、どちらのオプションが最適かを判断し、該当するインテグレーションガイドに従ってください。

Refreshing the UID2 token​

SDK for JavaScript には、自動の トークンリフレッシュ 機能があります。

Storing the UID2 token in the browser​

Client-Side のオプションでは、ローカルストレージを使用してデータを保存します。Server-Side オプションはデフォルトでローカルストレージを使いますが、代わりにクッキーを使うこともできます。詳細は、SDK for JavaScript reference guide の UID2 storage format を参照してください。

クッキーのサイズが大きくなる可能性があり、それが問題になるかもしれません。しかし、ローカルストレージがオプションでない場合、これは一つの可能なアプローチです。

Passing the UID2 token to the bidstream​

JavaScript SDK は、UID2 Token の生成、更新、保存を管理しますが、トークンをビッドストリームに渡すことは管理しません。

トークンは、Prebid.jsなどのオプションを使用してビッドストリームに渡すことができます。いくつかの提案は、Publisher Web インテグレーション概要の Pass the UID2 token into the bidstream を参照してください。

JavaScript integration overview: High-level steps​

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

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

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