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

CTV Integration Guide

Connected TV (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

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 を生成する必要はありません。