Depending on your business task, you can send to end-user devices the messages of several types:
Information messages — displayed in the app’s UI as a modal window with the ability to add some identifying information into the message text. This type of messages is well suited for notifying subscribers about promotions, new platform features, technical works, and so on.
Information message with MAC of the end-user device in text
Watermark messages — overlay identifying subscriber data on top of the TV channel stream with the ability to set the text transparency, position on the screen, display duration, and TV channel. This type of messages allows you to prevent or complicate unauthorized copying of content on end-user devices.
Watermark messages do not change the video stream as such — they only overlay text on top of the video in the end-user player.
Watermark message displaying MAC of the end-user device
To send a message:
Create it in Messages > Messages or Messages > Watermark messages, guided by the field tooltips.
Important notes:
You can use the following user-identifying variables in the Message text field:
Example of a message text:
Dear {!USERID!},
Your account {!SAN!} with device {!DEVICEID!} has been selected to participate in our annual ban giveaway!
{!USERID!} — user ID;
{!DEVICEID!} — unique device ID;
{!SAN!} — service account number.
The field Message service type allows you select the message delivery technology for Information Messages:
Long Polling — Smartlabs notification — messages are displayed on the end-user device as a modal window in the SmartTUBE App only after it is launched;
Push notifications — Android push notification and Apple push notification — messages are additionally displayed in the notification shade regardless of whether the SmartTUBE App is running or not.
The position of the Watermark Message on the screen is set by XY coordinates (Top and Left fields) from the upper-left corner of the screen as a percentage of its size.
Specify receivers of the message. There are two ways:
specify a list of MAC-addresses the message will be sent to. For this purpose click Send to MAC-addresses from the list and specify the list in the appropriate field or upload it in a file.
List format: 1 MAC-address in 1 row, duplicates are accounted as different addresses (message is delivered again). MAC-addresses are not validated, if there is a mistake in an address, the message will not be delivered and the system will not inform about the mistake.
specify a receivers’ filter either in the message card or in Messages > Receivers’ filters:
Filter conditions is a groups of statements joined by AND. Each group consists of statements joined by OR. It means that a service account matches the filter conditions, if at least one statement in each group is true.
You can filter the message receivers by the following parameters:
Service account number
Login
Service account state
Device location
Pricing plan
STB MAC address
Application version
IP address
Service available within the pricing plan
Connection creation date (after / before): The date when the user device was bound to the service account.
Not in pricing plan: The pricing plan to which the service account is not subscribed.
Device type
Last authentication date (after / before)
Service is active for the service account
Service is not active for the service account
Service account name
Click to send the message.
If you want the message to be delivered to all subscribers, create a filter without conditions, save it and specify it in the Receivers’ filter field of the message. The delivery of such a message could take a long time depending on the subscribers number.
Message Delivery Statistics
When all the messages are sent, you can view the delivery statistics in the Message statistics tab or export it in CSV with the button. Please note that the Status column of the CSV file has the following designation:
0 — presumably not delivered
1 — delivered, but not read
2 — read
3 — deleted
Event-driven Notifications
You can create notifications which will be sent to chosen subscribers at specified events occurrence. The subscribers will see the messages in the SmartTUBE app.
To create an event-driven notification:
Add the message which you want to send in Messages > Messages, as described above.
Create a notification in Messages > Notifications, specify the type of event which will initiate the notification and event conditions.
E.g., if you want to send a message “The pricing plan was changed to ‘You kiddin’ me!'” at pricing plan changing:
Add the message with text “The pricing plan was changed to ‘You kiddin’ me!’.
Add the notification with the following parameters:
Event type: Change product offer.
Event variant: You-kiddin-me.
Message: “The pricing plan was changed to ‘You kiddin’ me!'”.
