主要な概念 key-concepts

同時視聴数モニタリングのコアコンセプトを理解することは、導入を成功させるために不可欠です。 このガイドでは、基本的な構成要素とその仕組みについて説明します。

コアコンセプト core-concepts

セッション

セッション​は、アクティブなビデオ ストリーミング インスタンスを表します。 それは、ユーザーがコンテンツを視聴できる「チケット」だと考えてください。

セッションのライフサイクル

セッションのプロパティ

{
  "sessionId": "unique-session-identifier",
  "idp": "identity-provider",
  "subject": "user-identifier",
  "startTime": "2024-01-15T10:30:00Z",
  "expiresAt": "2024-01-15T10:40:00Z",
  "metadata": {
    "deviceId": "device-123",
    "channel": "Channel1",
    "contentType": "live"
  }
}

ポリシー

ポリシー​は、同時ストリーミングの制限と制限を定義するビジネス ルールです。 ユーザーが新しいストリームを開始できるタイミングを決定します。

ポリシーコンポーネント

ポリシー例

{
  "name": "basic_stream_limit",
  "description": "Maximum 3 concurrent streams per user",
  "rules": [
    {
      "type": "maxstreams",
      "limit": 3,
      "message": "You have reached your maximum of 3 concurrent streams"
    }
  ]
}

メタデータ

メタデータ​は、各セッションに関するコンテキストを提供します。 デバイス、コンテンツ、ユーザー、アプリケーションに関する情報が含まれます。

メタデータカテゴリー

必須メタデータと任意メタデータ

IDと認証 identity-and-authentication

ID プロバイダー（IdP）

ID プロバイダー​は、ユーザーを認証し、ID情報を提供するサービスです。 Adobe Passとの統合では、通常、MVPDを使用します。

IdPの例

件名

件名​は、ID プロバイダー内のユーザーの一意のIDです。 これは通常、ユーザーのアカウント IDまたはサブスクライバーIDです。

セッション管理 session-management

ハートビート

ハートビート​は、セッションをアクティブに保つ定期的なAPI呼び出しです。 「このユーザーはまだ見ている」とシステムに伝えます。

ハートビート要件

セッションの終了

セッションは、次の方法で終了できます。

ポリシー評価 policy-evaluation

ポリシーの仕組み

対立の解消 conflict-resolution

対立とは？

競合​は、ユーザーが新しいストリームを開始しようとしたが、その制限を超えた場合に発生します。

対立への対応

競合が発生すると、システムは詳細な情報を含む409 Conflict応答を返します。

{
  "status": "error",
  "error": {
    "code": "POLICY_VIOLATION",
    "message": "Concurrent usage limit exceeded"
  },
  "evaluationResult": {
    "decision": "DENY",
    "associatedAdvice": [
      {
        "adviceType": "rule-violation",
        "attributes": {
          "rule": "max_streams",
          "threshold": 3,
          "current": 4,
          "conflicts": [
            {
              "sessionId": "session-123",
              "terminationCode": "term-456",
              "metadata": {...}
            }
          ]
        }
      }
    ]
  }
}

解決戦略

LIFO （後入れ先出し）

FIFO （先入れ先出し）

アプリケーションとテナント applications-and-tenants

アプリケーション

アプリケーション​は、同時視聴数モニタリングと統合するソフトウェア プログラムです。 各アプリケーションには一意のIDがあり、独自のポリシーを持つことができます。

アプリケーション例

テナント

テナント​は、1つ以上のアプリケーションを所有する組織です。 テナントはアプリケーション間でポリシーを共有できます。

テナント構造

Tenant: "Streaming Company"
├── Application: "Mobile App"
├── Application: "Web App"
└── Application: "TV App"

環境 environments

ステージング環境

本番環境

統合フロー integration-flow

基本フロー

エラー処理

一般的な用語 common-terminology