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

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 インテグレーションなど、一部の機能や補完的な製品の代替方法も提供しています。

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

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

JavaScript Integration Overview: High-Level Steps​

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

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

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