Subscription Page Manual 3.0

Access to this menu in Betools through: Commercial > Subscriptions

This section lists all the Subscriptions that compose the commercial offer available in the different services.
You can use this menu to create, modify or delete Subscriptions and to manage the contents and attributes that are linked to each.

Blocks

Subscriptions

---

Field	Description	Restrictions
ID	Internal ID at Database. Also shown at: - MIB3 > Commercial > Purchases: Product ID - MIB3 > Users > Block User Rights, Block User history: Product ID	Readonly
Streamer External ID	Pending description.	-
Name	Internal name. - Not displayed in end user apps. - Displayed in Purchase Confirmation Email (Tag {productName})	Mandatory
Title	Title for the subscription to be displayed in the end user applications	-
ExternalID	External Identifier. It is used: - In top down provisioning/cancellations: always - In bottom up purchases: - Device - GVP traffic: always - GVP - OB systems traffic: when ENABLE_IT_COMMERCIAL_CODE = false Configuration: - MIB automatically configures it with ID when operator creates subscription. - Operator can edit it at MIB3. External ID accepts letters and numbers. Recommendation: do not leave spaces. (Examples of good External IDs: "4982", "Amazon_UY")	-
IT Commercial Code	In some cases, the commercial offer (subscriptions) configured in GVP will have different IDs in different systems. For example the same subscription "Full Cine HD" will have: - 1 ID in GVP -> GVP_SUBSCRIPTIONS.ID - 1 ID in OB System A -> GVP_SUBSCRIPTIONS.EXTERNAL_ID - 1 ID in OB Sysem B -> GVP_SUBSCRIPTIONS.IT_CODE It is used: - In top down provisioning/cancellations: never - In bottom up purchases: - Device - GVP traffic: never - GVP - OB systems traffic: when ENABLE_IT_COMMERCIAL_CODE = true Configuration: - MIB leaves it empty by default. - Operator can edit it at MIB3.	-
UX Reference Layout	Description to be displayed to the user	-
Description	Description to be displayed to the user	-
Short Description	Short Description to be displayed to the user (Max. length 500 chars)	-
Source	Controls the access and visibility of this subscription for other operators. Only operators with rights over this source or its children will be able to see it.	Mandatory
Instance	Instance where the subscription belongs to.	-
Status	Active / Inactive subscription status. When Inactive, the subscription cannot be purchased or provisioned from OSS/BSS to users. Only Active are shown in Subscriptions Area	-
Type	Can be: Normal or Timeshift (All Playlists, VOD are deprecated, don't use them). Normal subscription - these are subscriptions that the users will see on “Subscriptions Tab” in the home page. Users can buy and watch its contents normally. Only normal subscriptions are synched with Mediaroom. Only Normal are shown in Subscriptions Area VoD Subscription - Not used. Deprecated. Timeshift Subscription - Allows the end user watch programs or shows later than the real time that a certain program was set. It is just enable the channels in Restart TV Channel Set, that will be enable the timeshift function and it will possible to the user watch for the TV programs/shows later, that he couldn't watch before for any reason. All Playlists Subscriptions - Not used. Deprecated.	-
Purchase Type	Indicates to apps how the subscription can be purchased: API Only: Subscription only available to be purchased from apps Provisioning Only: Subscription only available to be purchased from OSS/BSS Both: can be purchased both ways" Relationship to Subscriptions Area - "My subscriptions" will show all subscriptions bought by the user regardless purchase type. - "Purchase button" behaviour depends on purchase type: - "Provisioning Only": will open external URL configured for that subscription (more info about External URL is at this link). OB systems need to issue a top down provisioning request (UNICA updateService) in order to give grants. - ApiOnly" or "Both": will trigger the purchase towards OB systems. When OB accepts billing, GVP platform will provide rights to the subscription. - "Cancel button" will be shown only for those subscriptions purchased from a device (GVP_USERS_PURCHASES.DEVICE_TYPE_ID != GalBss) and with type "ApiOnly" or "Both" (this is redundant)	-
Required Days	Number of days since the purchase that the user will not be able to perform upgrade operations having this subscription purchased until the user can cancel it or can upgrade to a higher package.	Mandatory
Is Adult	(Requires Pin) Indicates to applications if the Subscription will contain only contents for adult.	Mandatory
Credit Limit	Credit Limit available through the Subscription: - -1 means de subscription credit limit is unlimited. - 0 means that users holding this subscription are not allowed to purchase TVOD rentals.	Mandatory
Available From	Date when it will become available (visible in the app portals). Only Available are shown in Subscriptions Area Ignored when TD provisioned.	Mandatory
Available Until	Date when it will be unavailable (not visible in the app portals) Only Available are shown in Subscriptions Area Only if "Available Until" has not passed, subscriptions can be TD provisioned.	Mandatory
Is Visible	Subscription is visible in "Subscriptions Area" Only Visible are shown in Subscriptions Area
Is OTT	Subscription is visible in OTT devices. (i.e. deviceTypes not included in (MIB3 Instance parameters -> gvp.api->DEVICETYPES->IPTV nor HYBRID) will show only subscriptions with Is_OTT = true - In bottom up purchases it is not crossed against User's Service type. That is, an IPTV user can purchase subscriptions with Is IPTV = false. - In top down provisioning subscription and user's service must match. That is, an IPTV user cannot purchase subscriptions with Is IPTV = false - In cancellations it is not taken into account.	-
Is IPTV	Subscription is visible for IPTV STBs. IPTV (MIB3 Instance parameters -> gvp.api->DEVICETYPES->IPTV) devices will shown only subscriptions with Is_IPTV = true - In bottom up purchases it is not crossed against User's Service type. That is, an IPTV user can purchase subscriptions with Is IPTV = false. - In top down provisioning subscription and user's service must match. That is, an IPTV user cannot purchase subscriptions with Is IPTV = false - In cancellations it is not taken into account.	-
IS Hybrid	Subscription is visible for Hybrid DTH STBs. HYBRID (MIB3 Instance parameters -> gvp.api->DEVICETYPES->HYBRID) devices will shown only subscriptions with Is_HYBRID = true	-
Available (TEF)	Indicates if Telefonica users can see this subscription	-
Available (non-TEF)	Indicates if Non-Telefonica users can see this subscription	-
Available (Anonymous)	Indicates if anonymous users (not logged) can see this subscription	-
Vod Default Order	Indicates the default order type chosen to display the VOD contents in the subscription.	-
Fox Cache Sync	Indicates if the subscription has FOX content, and therefore, is synchronized with the FOX platform.	-
Synched with Mediaroom	Indicates if the subscription is synched with Mediaroom	Readonly
Mediaroom Sync Status	Indicates the status of the synchronization with mediaroom.	Readonly
Synched date	Last mediaroom synchornization date	Readonly

Mediaroom Synchronization Workflow

---

In this block you can follow the Mediaroom synchronization Workflow done by the CMG Agent.

Mediaroom workflow

Jobs Workflow

This block shows the detail of the works related to the subscription

Jobs Worflow block

Live Channels

---

This blocks allows you to manage the different live channels associated to this subscriptions. All the users that have rights over this subscription will have rights over the channels defined in this block.

Subscription Live Channels block

Associate Live Channels

• Use the button and a multiple Live Channel selection dialog will open, allowing you to search and select Live Channels that can be added.
• Select the channels to be added and press the button. The Live Channels will be added to the Subscription.
• To save changes, press the in the Subscription page.
  

Delete Live Channels from the subscription

• Use the button to remove all the Live Channels desired.
• Once finished, save changes by using the in the Subscription page.

Temporal Live Channels

This block shows the temporal live channels, that offered free to end users during a period of time for promotional purpose

Temporal Live Channels block

Event Collection

---

This block allows you to associate Event Collections to a subscription. Event Collections are PPV events that are offered to the users in a SVOD model (Championships, also known as Season Tickets). When an Event Collection is added to a Subscription, it will mean that every user with rights over that Subscription will have access to the events that are linked to that specific Event collection.

Subscription Event Collections block

Add new Event Collection

• Use the button and a new Event Collections page will be open to create it.
• Configure it and then save it and you will be able to add it using the Add Existing option.

Add existing Event Collection

• Click the button and a dialog will open to select and existing Event Collection.
• Once finished, save changes by using the in the Subscription page and the Event Collection will be associated.
  

Remove Event Collection

• Use the button to remove the association of an Event collection from the subscription .
• Once finished, save changes by using the in the subscription page. This will not delete the Event collection file from the platform. In order to delete the Event Collection, you will have to go to the Event Collections page.

Movies Criteria

---

This blocks allows you to select those VOD Contents (Movies, Series, Seasons and Episodes) that will be available as part of this subscription. As well as the Live Channels and the Event collections, all the users that have rights over this subscription will have rights over the movies defined in this block.
To do this, the operator is able to define a set of rules, called Content Criteria Filters that will be evaluated during the Catalog Exporter process. All the Movies that match the specified filters will be linked to this Subscription.

Movies content criteria block

Create new Content Criteria
It is really easy to create a new content criteria. You only have to build an expression by combining filters that will be evaluated to select the movies that match. The expression will be composed of one or more Groups each of them composed of one or more filters and the AND/OR relationship between them. Example:

Group1 = FilterA OR FilterB
Group2 = FilterC
Content Criteria = (Group1 AND Group2) = ((FilterA OR FilterB) AND FilterC)

1. First add a new Group by clicking on the button.
2. Then add a new Filter by clicking on the button.
3.  Select the type of filter from the list and fill the value for the filter. There are multiple filter types available and you can combine them as you want. Some examples of filters are:
   • Commercialization Type
   • Content Category
   • Distributor ID
   • Episodes by SeasonID
   • Episodes by SearieID
   • Genre ID
   • Instance ID
   • Last X days
   • Movie Type
   • Person Role
   • etc.
4. Continue adding as many filters as desired to build the first group expression.
5. When you have added all the filters for the first group, select the operator (AND / OR) that will be used to link the filters for that group.
6. Now you can add a new group, go back to 1. When you have finished adding groups, select the operator (AND / OR) between the different groups.

Once finished you can continue to the Highlights section, Orders section or Preview. Save changes at anytime by clicking on the in the Subcription page.

Highlight content
In the new content criteria, you can select some content to be highlighted. This highlighted content will be returned first when ordering the Default order is selected in the VOD channel. To do it, follow this steps:

1. First click on the button to select movies to be highlighted.
2. A page will open allowing you to search over the different movies you have access to. Important: You will be able to select ANY movie from the list of movies you have access to. The movie will be returned independently on the Content Criterias that you have defined in the block. Of course, if duplicated, the content will be returned only once, highlighted.
3.  Select one or more contents to be added. It is important to understand that the highlighted contents will be ordered depending on the order they are added. So add first the contents you want to be highlighted first. In the current version of this block, it is not available the [manual ordering of highlights], it will be added in future versions.
4. Save changes at anytime by clicking on the in the VOD Channel page.

Highlights selection in Content Criteria block

Define default ordering and maximum number of results
In the new content criteria, you can also define the maximum number of results to be returned and the behavior of the default ordering and select what ordering criteria should be applied for those contents.

1. First click on the Default Order section
2. Select the primary ordering criteria from the list available:
   • Default: Ordered by ID
   • Editorial Rating : Ordered by movie Editorial Rating value
   • Episode / Season Order: Ordered by movie.order value
   • Most Rated: Ordered by rating value
   • Popularity: Ordered by views value
   • Release Date: Ordered by movie release date value.
3. You can also select a secondary ordering criteria, in case some movies match the primary order criteria
4.  It is also possible to define a maximum number of results to be returned by the criteria. By default, it is set to 0 (unlimited).
5. Save changes at anytime by clicking on the in the VOD Channel page.

Order section in Content Criteria block

Content Criteria Preview
At any time you can go to the Preview tab and evaluate the results of the Content Criteria.

Preview section in Content Criteria block

Services

---

This blocks allows you to manage the different services associated to this subscriptions. All the users that have rights over this Subscription will have rights over the Services defined in this block (User Services)

Subscription Services block

Associate Services

• Use the button and a multiple Service selection dialog will open, allowing you to search and select Services that can be added.
• Select the services to be added and press the button. The Services will be added to the Subscription.
• To save changes, press the in the Subscription page.
  

Delete Services from the subscription

• Use the button to remove all the Services desired.
• Once finished, save changes by using the in the Subscription page.

External URLs

---

In this block it is possible to configure an external URL, so devices can take the user to an external Subscription page instead of taking them to the GVP Subscription page. This will be useful to allow the OB to build their custom pages in the OB Online Channel and to provide more advanced information than the one that is available currently in GVP.

Subscription External URLs block

Add new External URL

• Use the button and a new row will be added so you can configure the new URL.
• Define the url that will apply to all devices and also you will be able to define a Device Type specific URL, by setting the Device Type for that URL, and then this URL will only be returned to that specific device type
• Once finished, save changes by using the in the Subscription page and the External ULR will be associated.

Once the operator has defined the External URLs for a Subscription, the UNIAPI will return in the Subscription object the specific External URL, taking into account the Device Type that is performing the request:

• If the Subscription has a specific External URL for the device type that is making the request, it will return that URL;
• If the Subscription has not a specific External URL for the device type but there is a Default URL, it will return that URL;
• If the Subscription has no default or specific External URL, it will not return any URL.

Add existing External URL

• Click the button and a dialog will open to select and existing one.
• Once finished, save changes by using the in the Subscription page and the External URL will be associated.
  

Remove External URL

• Use the button to remove the External URL from the subscription .
• Once finished, save changes by using the in the subscription page. This will not delete the Event collection file from the platform.

Images

---

This block allows you to manage the images associated to the Subscription and the information associated, such as the Type and Quality.

Images block

Add new images

Upload image dialog

• Use the button and a new row will be added so you can upload the new image.
• Then click the button and a dialog will be open so you will be able to select the image to be uploaded.
• Now select the subtitle language and a name for the subtitle.
• Once finished, save changes by using the in the Subscription page and the subtitle will be associated.
  

Add existing images

• Click the button and a dialog will open to select and existing image.
• Once finished, save changes by using the in the Subscription page and the image will be associated.
  

Image preview

Remove images

• Use the button to remove the association of a image from the Subscription .
• Once finished, save changes by using the in the Subscription page. This will not delete the image file from the platform. In order to delete the image, you will have to go to the Images Page.

Preview images
By clicking in the button in each image, you can access to the image preview.

Subscriptions Relationship

---

Following relationships can be configured:

• Upgrade: List of Subscriptions IDs that the user can purchase with this subscription owned and that will result in the cancellation of this subscription.

- Hint: In this case, GVP is not performing any action. The OB is in charge of sending a TD cancelation. In other words, configuring this relationship has no effect.

• Incompatible: List of Subscriptions IDs that the user cannot purchase with this subscription owned. Devices are using this relationship in order to filter those subscriptions that must be hidden to a user.
  
• Managed Upgrade: Identifies the subscriptions that the user can purchase with this subscription owned and that will result in the immediate cancellation of this subscription by GVP side without any additional action from OB side. It is important to notice that this relationship was developed for cPVR and as a consequence:

- Subscription cancellation is not synced with Nagra

- Subscription is not notified to OB.

Relationships are not bidirectional.

Subscription Relationships block

Create a Subscription relationship

• Use the button and a Subscription selection dialog will open, allowing you to search and select subscriptions that can be added.
• Select the Subscription to be added.
• Now select the type of relationship (Upgrade, Incompatible) of this subscription added with the subscription being edited.
• To save changes, press the in the Subscription page.
  

Delete Subscription relationships

• Use the button to remove all the subscription relationships desired.
• Once finished, save changes by using the in the Subscription page.

Subscription users

---

In this block it is possible to check the number of active subscription users. To reload the number of users that have rights over this subscription, use 70px button.

Subscription Relationships block

Commercial Offers

---

This block allows to manage the relationships between subscriptions and commercial offers. The records of this block can also be added from the commercial page.

Commercial Offers Block

Add new images

• Use the button and a new row will be added.
• We select a record in the dialog box.
• Once finished, save changes by using the in the Subscription page and the commercial offers will be associated.
  

Actions

Create	Edit	Edit in List	Bulk Edit	Copy	Copy with Relateds	Delete

Create

Subscription creation is enabled by default for most of the operator profiles.

1. Use the button to create an empty Subscription.
2. Fill all the subscription data and the related blocks.
3. Once finished, save changes by using the button in the subscription page.

Edit

Subscription edit is enabled by default for most of the operator profiles. It can be used to perform modification in the subscription data and related information. Once finished modifying the subscription, save changes by using the button in the subscription page.

Edit in List

Edit in list is disabled for Subscriptions for security reasons. You have to go to Edit Page to perform any modification.

Bulk Edit

Bulk Edit is disabled fot the Subscription page.

Copy

Copy is enabled for Subscriptions. Using the button, you will be able to clone the basic information from the subscription into a new subscription. The relateds will not be copied using this mode. Once the subscription is copied, review that all the fields have been copied properly and press Save button.

Copy with Relateds

Copy is enabled for Subscriptions. Using the button, you will be able to clone a subscription and the relateds blocks into a new subscription.
The copy with relateds will behave differently for each block:

• Mediaroom Synchronization Workflow: Do not copy.
• Live Channels: Use same IDs (Shallow Copy).
• Event Collection: Use same IDs (Shallow Copy).
• Movies Criteria: Do not copy.
• Services: Use same IDs (Shallow Copy).
• Images: Use same IDs (Shallow Copy).
• Subscriptions Relationship: Copy objects (Deep copy).
• External URLs: Copy objects (Deep copy).
• Subscription users: Do not copy.

Once the subscription is copied, review that all the fields have been copied properly and press Save button.

Delete

Delete button is not available because the subscription deletion is not allowed directly from Subscription page. In order to delete a Subscription, you have to follow a specific process:

1. First disable the subscription so it gets deleted from Mediaroom. To do this, change the Type of the Subscription to VOD and press Save button.
2. Wait for CMG synchronization. Once the sync is successful, review in SMT/GMT that the Subscription has been removed from Mediaroom.
3. Now you can proceed to execute Subscription deletion procedure, using the Subscriptions Cleaner tool.