基本 TempPass
基本的な TempPass 機能を使用すると、プログラマーは、様々なシナリオに対応して、コンテンツへの時間制限アクセスを提供できます。
- 短いプレビュー: 潜在的な購読者を引き付けるために、1 日 10 分のアクセス期間などの簡単なプレビューを提供します。
- イベントベースのアクセス: 4 時間のセッションなど、主要なイベントに対して長時間のアクセスを有効にします。
- 組み合わせアクセス: 最初の拡張表示期間と、数日にわたる毎日の短いプレビューなど、期間の組み合わせと一致。
特定のイベントでは、コンテンツへの段階的な無料アクセスが必要となる場合があります。例えば、最初の拡張無料アクセス期間(4 時間)の後、1 日あたりの無料アクセス間隔(1 日あたり 10 分など)を短くすることが挙げられます。 このシナリオを実装するには、プログラマーはAdobe担当者と調整して、ニーズに合わせて 2 つの TempPass MVPD を設定する必要があります。
例えば、最初の 4 時間のフリーセッションと 1 日の 10 分間のフリーセッションを提供するには、Adobeでプログラマーのを設定します。
- TempPass1:最初の空きアクセス期間に対応するために、有効期間(TTL)を 4 時間に設定します。
- TempPass2:後続の 1 日の空きアクセス間隔の有効期間(TTL)が 10 分に設定されます。
毎日のアクセスに対して適切な機能を確保するには、すべてのデバイスの TempPass2 を毎日 00:00 にリセットする必要があります。
機能の詳細
設定パラメーター:
- TTL (Time-To-Live): プログラマーは、アクセス時間を指定できます。 このクロックベース TTL は、実際の表示時間に関係なく期限切れとなります。
ユーザー ID:
基本的な TempPass 機能では、デバイス識別子をユーザー識別パラメーターとして使用します。
次の表を参照すると、ユーザー識別パラメーターがユーザーの体験版エクスペリエンスにどのように影響するかを理解するのに役立ちます。
デバイス識別子 | 結果 |
---|---|
新規 | 新規体験版 |
既存 | 既存の体験版 |
表示時間の計算:
TTL は、コンテンツの表示に費やされた実際の時間とは無関係に、最初の承認リクエストの時間から有効期限までの期間を表します。 今後の各リクエストでは、現在のサーバー時間と保存されている有効期限を確認して、アクセスを許可します。
認証:
ベーシック TempPass では認証が必要ないため、認証手順に直接進むことができます。
認証:
実際のMVPDとのやり取りは行われないので、基本「一時パス」MVPDは、その一時パスが有効であると指定されたリソースを認証します。 認証が成功した場合、メディアトークン検証用ライブラリは、コンテンツ再生を開始する前のメディアトークンの検証とリソースの検証に引き続き適用されます。
認証決定は、ユーザー識別パラメーターおよび設定された TTL に基づいて行われます。 リソースに対して正常な認証を取得するには、有効なリクエストが次の条件を満たす必要があります。
- 未使用の期間: 有効期限は、(データベースに保存された)最初の認証リクエスト時間を設定済み TTL に追加することによって計算されます。 現在のサーバー時間をこの有効期限と比較して、TempPass がまだ有効かどうかを判断します。
ユーザーが設定された TTL を超えると、TempPass がリセットされない限り、同じデバイス上のコンテンツを表示できなくなります。
事前認証:
基本的な「一時パス」MVPDに対して事前認証リクエストが行われると、リクエストからリソースのリスト全体が正常に事前認証として返されます。 認証条件が特定のリソースではなく、時間制限に基づいていることを考慮すると、この動作は認証ロジックを反映しています。 時間制約が有効である限り、リクエストされたリソースは許可されます。
ログアウト:
ベーシック TempPass ではログアウトする必要がないため、実際のユーザーのMVPDを使用して、認証手順に直接切り替えることができます。
トラッキングデータと分析:
基本的な TempPass フローでは、トラッキングデータは、MVPD ID が「Temp Pass」に設定された、ハッシュ化されたバージョンのデバイス ID を使用します。 プログラマーは、Analytics 実装において、TempPass 指標を標準のMVPD指標と区別する必要があります。
プロモーション TempPass
プロモーション TempPass 機能は、プロモーションキャンペーンを実行するために特別に設計された基本的な TempPass の機能を拡張します。 この機能を使用すると、メールアドレスなどの有効なユーザー ID を収集した後、指定した期間、事前定義済みの数のVOD タイトルにアクセスできるようにすることで、ユーザーを引き付けることができます。
プロモーション TempPass には、基本的な TempPass のすべての機能が含まれており、次の柔軟性が追加されています。
- プロモーション期間中にアクセスできるVOD タイトルの最大数を定義します。
- プロモーション アクセスが有効な期間を設定します。
ユーザーが定義済みのアクセス制限(VOD タイトルの数または期間)を超えると、TempPass がリセットされない限り、同じデバイス上または同じユーザー ID を持つコンテンツを表示できなくなります。
機能の詳細
設定パラメーター:
- ユーザー情報キー: メールアドレスなどの、ユーザーが指定した識別子を通信するために使用するキー(キーはメール)。
- リソース数: ユーザーがアクセスできるVOD タイトルの数を定義します。
- TTL (Time-To-Live): ユーザーが許可されたリソースを使用できる期間です。
ユーザー ID:
プロモーション TempPass 機能では、デバイス識別子の上に表示されるユーザー指定の識別子のハッシュをユーザー識別パラメーターとして使用します。
Adobeでは、データをAdobeに送信する前に、SHA-2 ファミリまたはその固有の SHA-256 関数 SHA-512 を使用することをお勧めします。 例えば、"user@domain.com" を超える SHA-256 は、"f7ee5ec7312165148b69fcca1d29075b14b8aef0b5048a332b18b88d09069fb7" です。
次の表を参照すると、ユーザー識別パラメーターがユーザーの体験版エクスペリエンスにどのように影響するかを理解するのに役立ちます。
ユーザー指定の識別子ハッシュ | デバイス識別子 | 結果 |
---|---|---|
新規 | 新規 | 新規体験版 |
既存 | 新規 | 既存の体験版(ユーザーが指定した識別子ハッシュに基づく) |
新規 | 既存 | 既存の体験版(デバイス ID に基づく) |
既存 | 既存 | 既存の体験版 |
表示時間の計算:
TTL は、コンテンツの表示に費やされた実際の時間とは無関係に、最初の承認リクエストの時間から有効期限までの期間を表します。 今後の各リクエストでは、現在のサーバー時間と保存されている有効期限を確認して、アクセスを許可します。
認証:
プロモーションの TempPass では認証が必要ないため、認証手順に直接進むことができます。
プログラマーのアプリケーションの実装をサポートするために、プロモーションの TempPass は、対応するキーを介してアクセスできる以下のユーザーメタデータ情報を公開します。
remaining_resources
: ユーザーがまだ使用できるリソースの数を示します。used_assets
:ユーザーが既に消費したリソースのリストを提供します。expiration_date
: ユーザーのプロモーション一時パスの有効期限を表示します。
認証:
実際のMVPDとのやり取りがないため、プロモーションの「Temp Pass」MVPDは、TempPass が有効であると指定されたリソースを認証します。 認証が成功した場合、メディアトークン検証用ライブラリは、コンテンツ再生を開始する前のメディアトークンの検証とリソースの検証に引き続き適用されます。
認証決定は、ユーザー識別パラメーター、設定されたリソース数および TTL に基づいて行われます。 リソースに対して正常な認証を取得するには、有効なリクエストが次の条件を満たす必要があります。
- 未使用の期間: 有効期限は、(データベースに保存された)最初の認証リクエスト時間を設定済み TTL に追加することによって計算されます。 現在のサーバー時間をこの有効期限と比較して、TempPass がまだ有効かどうかを判断します。
- 未使用のリソース: 消費されたリソースの数が追跡されます(データベースに保存されます)。 消費されたリソースの数と設定されたリソースの数を比較して、TempPass がまだ有効かどうかを判断します。
設定された TTL またはリソース数を超えるユーザーが発生した場合、TempPass がリセットされない限り、同じデバイス上または同じユーザー提供の ID を持つコンテンツを表示できなくなります。
事前認証:
プロモーションの「Temp Pass」MVPDに対して事前認証リクエストが行われると、リクエストからリソースのリスト全体が正常に事前認証として返されます。 承認条件が特定のリソースではなく、時間制限とアクセスしたリソースの合計数に基づいていることを考慮すると、この動作は承認ロジックを反映します。 時間制限が有効で、リソースの制限を超えていない限り、リクエストされたリソースは許可されます。
ログアウト:
プロモーションの TempPass にログアウトする必要はなく、実際のユーザーのMVPDを使用して認証ステップに直接切り替えることができます。
トラッキングデータと分析:
プロモーションの TempPass フロー中、トラッキングデータは、MVPD ID が「Temp Pass」に設定された、ハッシュ化されたバージョンのデバイス ID を使用します。 プログラマーは、Analytics 実装において、TempPass 指標を標準のMVPD指標と区別する必要があります。