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

CTV Integration Guide

CTV パブリッシャーであれば、UID2 とインテグレーションして、CTV アプリのコンテキストで RTB ビッドストリームに渡す ID トークンを生成およびリフレッシュする方法がいくつかあります。

Key Integration Steps​

UID2 とインテグレーションするには、次の 3 つの主要なステップを実装します:

  1. UID2 Token を生成します。
  2. 必要に応じて UID2 Token をリフレッシュします。
  3. 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 で選択したオプションによって異なります:

CTV Integration Options​

UID2 Token の生成とリフレッシュをどこで行うかに基づいて、最適なインテグレーションオプションを選択できます。以下の表に示すように、3 つのオプションがあります:

OptionDetails
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 SystemIntegration GuideLink to SDK Guide
Apple tvOSUID2 Client-Side Integration Guide for MobileSDK for iOS Reference Guide
Android TVUID2 Client-Side Integration Guide for MobileSDK 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 ガイドを参照してください:

Client-Server Integration for CTV Apps​

このオプションは UID2 Token を Client-Server で管理したいパブリッシャー向けです:

  • トークンは Server-Side で生成されます。
  • トークンは CTV アプリ内から必要に応じて Client-Side でリフレッシュされます。

この方法で実装するには、UID2 Client-Server Integration Guide for Mobile の手順に従ってください。

次の表は、対応するオペレーティングシステムと、関連するドキュメントリソースへのリンクを示しています。

Operating SystemIntegration GuideLink to SDK Guide
Apple tvOSUID2 Client-Server Integration Guide for MobileSDK for iOS Reference Guide
Android TVUID2 Client-Server Integration Guide for MobileSDK for Android Reference Guide