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

UID2 Integration Overview for JavaScript

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

Prebid.js と追加 SDK オプションを含むすべてのウェブオプションの概要については、Web Integration Overview を参照してください。

Introduction​

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

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

Integrating with Single Sign-On (SSO)​

シングルサインオン(SSO)プロバイダーとのインテグレーションに関する情報は、Publisher Integration with SSO Providers を参照してください。

Client-Side or Client-Server Integration​

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

ScenarioOptionIntegration Guide
Client-Side で DII にアクセスでき、フロントエンド開発のみを行いたい。Client-side integrationClient-Side Integration Guide for JavaScript
Server-Side で DII にアクセスでき、Server-Side の開発が可能であるか、Private Operator を使用している。Server-side 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 には、自動の Token Refresh 機能があります。

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などのオプションを使用してビッドストリームに渡すことができます。いくつかの提案については、Webインテグレーション概要の Pass the UID2 Token Into the Bidstream を参照してください。

JavaScript Integration Overview: High-Level Steps​

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

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

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