CTV Integration Guide
Connected TV (CTV) パブリッシャーであれば、UID2 とインテグレーションして、CTV アプリのコンテキストで RTB ビッドストリームに渡す ID トークンを生成およびリフレッシュする方法がいくつかあります。
Key Integration Steps
UID2 とインテグレーションするには、次の 3 つの主要なステップを実装します:
- UID2 Token を生成します。
- 必要に応じて UID2 Token をリフレッシュします。
- UID2 Token をビッドストリームに渡します。
これらのステップをどのように実装するかを決定するには、CTV Integration Options から選択してください。
Integrating with Single Sign-On (SSO)
シングルサインオン(SSO)プロバイダーとのインテグレーションに関する情報は、Publisher Integration with SSO Providers を参照してください。
Private Operator Option
パブリッシャーで、ファーストパーティデータを企業ネットワーク内に保持したい場合は、Private Operator を展開することを選択できます。このシナリオでは、自身のためだけのプライベートインスタンスをホストします。
その他の情報については、次のリソースを確認してください:
UID2 Private Operator ソリューションは、UID2 Token の Client-Side 生成をサポートしていません。Client-Side インテグレーションを希望する場合は、Public Operator ソリューションを使用する必要があります。
Complete UID2 Account Setup and Configure Account
UID2 とインテグレーションするには、UID2 のアカウントが必要です。まだアカウントを作成していない場合は、最初に Account Setup ページの手順に従ってください。
アカウントの初期設定が完了すると、本番環境用の credentials を作成し、必要に応じて追加の値を設定できる UID2 Portal にアクセスするための手順とリンクが送信されます。詳細については、UID2 Portal での開始 を参照してください。
設定する具体的な値は、CTV integration options で選択したオプションによって異なります:
- Client-Server または Server-Side の実装の場合、UID2 Portal の API Keys ページで次の値を設定する必要があります:
-
API key、Client Key とも呼ばれます。
-
Client secret、参加者と UID2 Servivce のみが知る値です。
importantこれらの値を安全に保管することは非常に重要です。詳細については、Security of API Key and Client Secret を参照してください。
-
- Client-Side の実装には、UID2 Portal の Client-Side Integration ページで次の値を設定する必要があります:
- Subscription ID と Public Key: Adding and Managing Key Pairs を参照してください。
- この SDK を使用するすべてのサイトの domain names のリスト: Adding and Managing Root-Level Domains を参照してください。
- モバイルアプリ ID (適用される場合): モバイルアプリ ID の追加と管理 を参照してください。
CTV Integration Options
UID2 Token の生成とリフレッシュをどこで行うかに基づいて、最適なインテグレーションオプションを選択できます。以下の表に示すように、3 つのオプションがあります:
Option | Details |
---|---|
Client-Side Integration | トークンは Client-Side で生成され、リフレッシュされます。 |
Server-Side Integration | トークンは Server-Side で生成され、リフレッシュされます。 |
Client-Server Integration | トークンは Server-Side で生成され、Client-Side でリフレッシュされます。 |
Client-Side Integration for CTV Apps
Client-Side オプションは、UID2 Token を完全 に Client-Side で管理したいパブリッシャー向けです:
- トークンは CTV アプリ内で Client-Side で生成されます。
- トークンは CTV アプリ内から必要に応じてリフレッシュされます。
このセットアップでは、すべてのコード変更が CTV アプリ内で行う必要があります。
この方法で実装するには、UID2 Client-Side Integration Guide for Mobile の手順に従ってください。
次の表は、対応するオペレーティングシステムと、関連するドキュメントリソースへのリンクを示しています。
Operating System | Integration Guide | Link to SDK Guide |
---|---|---|
Apple tvOS | UID2 Client-Side Integration Guide for Mobile | SDK for iOS Reference Guide |
Android TV | UID2 Client-Side Integration Guide for Mobile | SDK for Android Reference Guide |
Server-Side Integration for CTV Apps
Server-Side オプションは、UID2 Token を完全に Server-Side で管理したいパブリッシャー向けです:
- トークンは Server-Side で生成されます。
- 必要に応じてトークンは Server-Side でリフレッシュされます。
このセットアップでは、ほとんどのコード変更が Server-Side で行われ、CTV アプリ内での変更は最小限に抑えられます。
この方法の利点の 1 つは、複数のプラットフォーム (Web / CTV / モバイル) に対処する場合、すべてを Server-Side で行うことで、プラットフォーム固有の作業を減らすことができることです。
この方法で実装するには、Publisher Integration Guide, Server-Side の手順に従ってください。
Server-Side コードが Java または Python である場合、UID2 SDK のいずれかを使用して、UID2 への HTTP リクエストを行うことができます。自分でソースコードを書く代わりに、次のいずれかの SDK ガイドを参照してください:
- SDK for Java Reference Guide: Usage for Publishers
- SDK for Python Reference Guide: Usage for Publishers
Client-Server Integration for CTV Apps
このオプションは UID2 Token を Client-Server で管理したいパブリッシャー向けです:
- トークンは Server-Side で生成されます。
- トークンは CTV アプリ内から必要に応じて Client-Side でリフレッシュされます。
この方法で実装するには、UID2 Client-Server Integration Guide for Mobile の手順に従ってください。
次の表は、対応するオペレーティングシステムと、関連するドキュメントリソースへのリンクを示しています。
Operating System | Integration Guide | Link to SDK Guide |
---|---|---|
Apple tvOS | UID2 Client-Server Integration Guide for Mobile | SDK for iOS Reference Guide |
Android TV | UID2 Client-Server Integration Guide for Mobile | SDK for Android Reference Guide |
Best Practices
CTV インテグレーションのベストプラクティスは次のとおりです:
-
トークンを事前にローテーションさせる
CTV 広告は広告ブレイク中のトラフィックスパイクに関連付けられています。これらの時間帯に UID2 Token を生成またはリフレッシュすることは理想的ではありません。忙しい時間帯の 前にトークンを生成またはリフレッシュすることを勧めます。
トークンが有効期限前にリフレッシュされた場合、古いトークンが有効期限切れになるまで、新しいトークンまたは古いトークンのいずれかを使用できます。TTL (time to live) タイムスタンプは、トークンが生成またはリフレッシュされたときに UID2 Operator から返されるレスポンスボディの一部です。
-
トークンは必要な場合のみローテーションさせる
UID2 Token はユーザーの HEM (Household Email Address) または電話番号に紐付けられており、視聴セッションやアプリセッションには紐付けられていません。ユーザーに有効な UID2 Token がある限り、新しい視聴セッションやアプリセッションごとに新しいトークンを生成する必要はありません。たとえば、ユーザーがアプリを離れ、再度開いた場合、既存のトークンがまだ有効であれば、新しい UID2 Token を生成する必要はありません。
-
ポッド内の複数の広告スロットで同じトークンを使用する
UID2 Token がポッドの期間中に有効である限り、ポッド内の任意の広告スロットで使用できます。
理想的には、これらのガイドラインに従うと、広告ブレイク中に新しい UID2 Token を生成する必要はありません。