An Entitlement is a time-bound permission that allows users to view feature video of a product within the client apps. The entitlement governs access to the video, ensuring that only authorised users can stream the content during the designated entitlement period. Video cannot be watched on the client apps without a valid entitlement, this includes products that are made available for free.

Period

The entitlement period defines the length of time a user can access the Feature Video. This period is typically determined by the price band from which the entitlement was generated. For example, different subscription tiers, rentals or free products may offer varying entitlement durations.

Creation

Entitlements can be generated under the following conditions:

Free, Rental or Subscription

When a valid purchase is made through the client apps, there is an active subscription or a product is available for free, an entitlement is automatically created when playback is attempted. The user is granted permission to view the feature video of the product for the duration defined by the price band associated with the purchase, subscription or availability window.

Third-Party System Creation

Entitlements may also be generated by third-party systems integrated with the platform. These systems, often external services or partners, have the ability to create entitlements for users according to predefined business agreements.

Manually Granted

In special cases, customer support teams can manually grant entitlements to users via the Dashboard. This is typically done to resolve user issues or provide temporary access as part of a support case.

Expiration

Entitlements automatically expire when the entitlement period ends. Entitlements cannot be extended once they have been created. Once an entitlement has expired, the user will lose access to the feature video unless a new entitlement is generated.

Manually Granting Entitlements

Entitlements can be manually created for individual users. This is usually done in scenarios where a user needs to be granted temporary access or to resolve a dispute as a part of a customer support flow.

Reporting

The Reports Section of the Dashboard allows authorized personnel to generate entitlement reports. These reports offer detailed insights into entitlements, including various metadata and usage statistics. The key columns of the report include:

Product Details

Product Name: Name of the feature video or content.
Product ID: Unique identifier of the product.

Purchase and Entitlement Details

Purchase ID: Identifier for the specific purchase made.
Entitlement ID: Unique ID representing the entitlement granted.
Entitlement Type: Type of entitlement (e.g. TVOD, SVOD).

Entitlement Period

Started: Date when the entitlement became active.
Ended: Date when the entitlement expired or will expire.

Market Information

Market ID: Identifier of the market in which the content was purchased or viewed.
Market Name: Name of the market.

Usage Statistics

Product Duration: Total runtime or duration of the product.
Total Viewed: Amount of the content that the user has watched.
Total Viewed Percentage: Percentage of the content that the user has watched relative to its total duration.
Furthest Viewed: The furthest point in the video that the user has reached.
Total Device Types: Number of different device types the content was accessed from.

Category Types

The columns in this section will reflect the category types you have created in the system.

User and Device Information

User ID: Unique identifier of the user who holds the entitlement.
Device Name: Name of the device that holds the entitlement.
Device ID: Identifier of the device that holds the entitlement.
Platform: The platform (e.g., iOS, Android) of the entitlement holder.