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 とインテグレーションするためのオプション を、次の表にまとめました。最適なオプションを選択してください。
Scenario | Option | Integration Guide |
---|---|---|
Client-Side で DII にアクセスでき、フロントエンド開発のみを行いたい。 | Client-side integration | Client-Side Integration Guide for JavaScript |
Server-Side で DII にアクセスでき、Server-Side の開発が可能であるか、Private Operator を使用している。 | Server-side integration | Client-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 には、自動の 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 とインテグレーションするには、以下のステップを完了する必要があります:
- UID2アカウントのセットアップを完了します。
- SDKをサイトに追加します。
- SDKを設定します。
詳細な手順については、以下のインテグレーションガイドのいずれかを参照してください: