Notifications Page Manual 3.0

Access to this menu in Betools through: Instances > Notifications

The notifications page allows to configure notifications for clients and devices

Blocks

Notifications

---

The Notification Page will perform some validations when creating the Notification by the operator: Schedule date must be in the future Notification size validation: the size of the notification will be checked against the configured GVP Parameters (APN_PAYLOAD_LIMIT and GCM_PAYLOAD_LIMIT). If the notification is being sent to each device group (iOS, Android) and it exceeds the payload limit defined, it will show an error when creating the notification.

Notifications basic information

Field	Description	Restrictions
Name	The name for the notification.	Mandatory
Source	The mib source associated with the notification.	Mandatory
Instance	Instance associated with the notification.	Mandatory
Message	Is the message that will be displayed to the end user in the notification.
Show Badge	It is a checkbox which indicates if the application will have to show a badge or not (if available in the device).
Image	An image associated with the notification (will only be sent to the notification server if it supports it). Apple iOS doesn't support but Android does.
CSV file	To upload to the notification a .csv containing the list of UNIQUE IDs of the users that the notification will be sent to.
Custom style/css	custom style to be applied in the notification when displaying to the end user (currently not used by devices).
Enabled	It's a checkbox that enable/disable the notification.
Event start date	Can be used when creating a notification for an specific event notification (for example a match). In order to use it, just associate the Live channel that will have the event in the notification and then set the event start date to the date where the event will take place. This will allow devices to identify exactly the event that is being highlighted.
Scheduled Date	The day and hour that the notification has to be sent.	Mandatory
Sent Date	Operator that created this item.	ReadOnly
Free URL	This is a field allowing the operator to introduce a URL or action, according to the nomenclature and format defined by Mediaroom (no validation by MiB), that will be included in the notifications sent to clients. This approach of FreeURL is complementary (and has more priority) to the possibility of indicating the Action by selecting a CatalogItem to associate to the notification. By introducing a non-empty *Free URL* (linked to an Action Button), the notification is considered an *Interactive notification* (having an action, URL or link to a Mediaroom section). The action or link is associated to a button or clickable element (Action Button in generic terms). The text and action associated to the button must be defined by MiB, within the notificationData parameter of the method sent to Mediaroom Web Service. More precisely, the action or link is defined through the attributes __msgButtonUrlX or __msgButtonMdX (where X=0 for the Action Button generated by MiB) included in the notificationData parameter (more details at Notification structure section).
Owner	Name of the creator.	Read Only
Number Users	Number of users that the notification was sent to.	Read Only
Number Devices	Number of devices that the notification was sent to successfully.	Read Only
Number Errors	Number of errors.	Read Only
Notification Status	Provides feedback about the notification sending process status. Possible status are: Pending: is the status before the schedule date is reached. In this status, the notification can still be modified. Schedule error: this status is an error status, meaning that the notification could not be processed correctly. Please verify the Error Details to know more about the reason that caused this error. Processing: is the status while the Notification Agent is processing the notification, after the scheduled data has been reached. Sent: means that the notification was sent without any errors in the sending process. Error: means that the notification could not be send to one or more user devices. Please refer to the Error Details to know more about the different error reasons.	Read Only
Error Detail	Detailed error summary. The Notification agent will update this field with a detailed summary of the sending process. It is important to remark that the Google GCM and Apple APN services have slightly different behavior when returning the result of the notification sending process. While Android will report if the notification has properly delivered to the end device or not, the Apple APN service doesn't do it, it just confirms if the notification has been created properly or not, but doesn't provide feedback about if the device received the notification or not. The reasons for a notification to fail are: Expired device: it means that the token that was registered by the application for that devices has expired, so the notification was not sent to them. This error happens usually because the user has deinstalled the application and the device has not renewed the notification token. Invalid devices: it means that the token that was registered by the application for that devices has been marked as invalid, so the notification was not sent to them. This error happens usually because the service has detected that this device is not receiving notifications anymore so the device is marked as invalid and will be removed automatically by the feedback service. Renewed devices: the token of these devices has been renewed, but the notification has been delivered properly to this devices. Unknown errors: the external notification service has reported error in the sending process but without providing details for the error. If this error occurs very often, the configurations and logs should be reviewed in order to search for the root cause of this problem.	Read Only

Upload CSV File

---

The operator can upload a .csv file with the list of users to which notification is to be sent.

Add new CSV File

• Then click the button and a dialog will be open so you will be able to select the CSV File to be uploaded.
• Once finished, save changes by using the in the movie page and the CSV File will be associated.
  

Device Types

---

The operator will also have to select the device types that the notification is addressed to: Android Phone, Android Tablet, iPhone and iPad. This will allow the operator to restrict the notification to only a set of device types. The notification mechanism will vary depending on the device type.
Add existing Device Type

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

Remove Notification Interests

• Use the button to remove the association of Device Type from the Notification.
• Once finished, save changes by using the in the Notification page.

Notification Interests

---

Optionally the operator will be able to select one or more predefined Interests to be associated with the notification, users will be able to select between a list the information they are more interested in, so they can receive notifications about this. When the operator associates one or more interests with the notification, it will mean that before sending the notification to the selected users, we will filter the list obtaining only the users that match with the interests associated with the notification. For further information please access the Notification Interests.

Add existing Notification Interests

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

Remove Notification Interests

• Use the button to remove the association of Notification Interests from the Notification.
• Once finished, save changes by using the in the Notification page.

Catalog Item

---

With this block, the operator will be able to select one product (Movie, Subscription or LiveChannel) to be associated and attached with the notification. This will allow the operator to advertise the product to the users.

Add existing Catalog Item

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

Remove Notification Interests

• Use the button to remove the association of Catalog Item from the Notification.
• Once finished, save changes by using the in the Notification page.

Actions

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

Create

Notification creation is enabled.

1. Use the button to create an empty entry.
2. Fill all the required information.
3. Once finished, save changes by using the button.

Edit

Notification edition is enabled. It can be used to modify some existing information. Once finished modifying the information, save changes by using the button in the Notification page.

Edit in List

Edit in list is disabled for this page.

Bulk Edit

Notification is enabled in this page, allowing you to modify several items at the same time.

Copy

Copy is disabled in this page.

Copy with relateds

Copy with relateds is disabled for this page.

Delete

Notification can be deleted by the operator using the button. A confirmation popup will be shown before excluding it.