CTV Integration Guide
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 を参照してください。
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 つのオプション があります:
- Client-Side Integration (UID2 Token は Client-Side で生成とリフレッシュされます)
- Server-Side Integration (UID2 Token は Server-Side で生成とリフレッシュされます)
- Client-Server Integration (UID2 Token は 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 |