Introduction

Notifications for a new TV show episode can prompt users who are subscribed or interested to immediately access the fresh content as soon as it becomes available. As marketers, we need not manually send a campaign to the target audience every time a new episode is released. We can leverage business events to notify viewers about new episodes of their favorite series in real time.

Advantages of sending notifications for a new episode

• Increased engagement: Notifications remind users to return to the platform and watch the new episode, boosting engagement and viewership.
• Content discovery: Notifications can highlight new episodes that users might not have otherwise discovered, leading to more content consumption.
• User retention: By keeping users informed about new content, you can improve user retention and encourage them to stay subscribed.
• Personalized experience: You can tailor notifications based on user preferences and viewing history, ensuring users receive relevant updates.
• Convenience: Notifications inform users about new episodes without constantly checking the platform.

We will achieve this use case in four steps:

1. Set up Postman
2. Create a business event
3. Create a Push campaign
4. Trigger the alert for a new episode

Expected Result

Users will receive a push notification about a new episode being available. The following image shows a push notification for the new episode, The One with Joey’s Fridge, for the popular TV show Friends.

Step 1: Set Up Postman

Postman is used here for demonstration purposes. Ideally, your engineering team should integrate these APIs with the content management system you have, and they can trigger these APIs from their backend servers.

1. If you don’t have Postman installed yet, kindly download it and sign in using your email address. MoEngage documents all the APIs in a publicly downloadable collection here: https://www.postman.com/moengage-dev/workspace/api-docs/overview
2. After you open this page in the browser, export the Business Events API collection from MoEngage space and import it into your workspace in Postman.
   

We will now add a new business event to the MoEngage account.

Step 2: Create a Business Event

You must inform MoEngage what this business event contains so that you can use it while configuring the campaign content. Business events for an episode would typically have the episode's name, number, image, and so on. We will send this information to MoEngage using the Create Business Event API. It broadly needs the event name, attributes, and who created it.

We will name the event as ENT_New_Content_Released. We will have example@moengage.com as the email address that created this event. We will add the following event attributes to the business event with their data types.

• Event name: ENT_New_Content_Released
• Attributes of the event and their data type:
  • Name of the Series: string
  • Episode Name: string
  • Episode Number: integer
  • Episode Image: string
  • Episode URL: string (This can be used to direct the user to the content instead of having them search for it.)

Perform the following steps:

1. Write the information above in the JSON format and send it to MoEngage through Postman:

   JSON

   
   {
     "event_name": "ENT_New_Content_Released",
     "event_attributes": [
       {
         "attribute_name": "name of the series",
         "attribute_data_type": "string"
       },
       {
         "attribute_name": "episode name",
         "attribute_data_type": "string"
       },
       {
         "attribute_name": "episode number",
         "attribute_data_type": "int"
       },
       {
         "attribute_name": "episode image",
         "attribute_data_type": "string"
       },
       {
         "attribute_name": "episode url",
         "attribute_data_type": "string"
       }
     ],
     "created_by": "example@moengage.com"
   }
   

    

2. Use the information above in the JSON format and make the API call with authorization information for the right data center to which your workspace belongs. For more information, refer to Create Business Event API.
   After the API call is made and the event is created successfully, MoEngage sends the following response:
   
   JSON

   {
   
   "message": "The business event has been created",
   
   "_id": "{{Business Event ID}}"
   
   }

3. To verify if adding a business event has succeeded:
   1. In the MoEngage dashboard, go to any Business Event Triggered campaign.
   2. In the Select business event list, you can check for your event. You can see the ENT-New_Content_Released event.
      

Step 3: Create a Push Campaign

In this section, we will create a push notification campaign using these details to personalize the campaign.

Step 3.1: Target Users

1. On the left navigation menu in the MoEngage dashboard, click Engage, and then click Campaigns.
2. On the All campaigns page, click + Create campaign.
3. Under Outbound, click Push > Business Event Triggered.
   
4. You are taken to the first step, Target users, of defining your campaign.
5. Define your campaign with a name and tags. Enter the following details:
   1. Team: Select a team if your organization has teams enabled for your account. For more information, refer to Teams in MoEngage.
   2. Campaign name: Enter a name for the campaign. For example, Episode Notifications.
   3. Campaign tags: Select the required campaign tags.
      
6. In the Select business event list, select the ENT_New_Content_Released event.
   
7. In the Target audience section, define the logic to identify all the customers who have watched the series episode in the last 3 days. So, for this example, the target audience can be as shown below:
   
8. In the Target Platforms section, select Android.
   
9. Click Next to move to the second step, Content, where you can define the content for your Push campaign.

Step 3.2: Content

1. Select the template that you would like to use. For our example, select Basic notification.
   
2. Enter the required content for the campaign. We can manually enter a title, message, and summary or generate it using Merlin AI. For more information, refer to Generate Push Messages with Merlin AI.
   
   

   The content for such communications would need to have the values picked from the business event’s attributes, which can be done similarly to any other personalization.

3. Add personalization to the message using information such as the user's name. Such personalization makes the message more contextual and makes the users feel connected. To do the same:
   1. Type @.
   2. On the Push Personalization dialog box, find relevant attributes from a user's business event or user property.
      
4. Use the deep link option to direct users to a page in your App or website where they can check their ticket details.
   
   1. In the Default click action list, select Deeplinking.
   2. In the URL field, mention the relevant URL.
5. Click Next to move to the third step, Schedule and goals, where you can define your campaign's schedule and goals.

Step 3.3: Schedule and Goals

1. Define when to start and end this campaign and the conversion goal based on your requirements.
2. Change the deliverability settings based on your requirements. For more information, refer to Create Push Campaigns.
   
3. Click Publish.

Step 4: Trigger the Alert for a New Episode

For the demonstration, we will trigger this API through Postman. Still, for all practical purposes, you must ideally trigger this event when a new episode is added to your content management system.

To trigger the alert, we will use another business event API, trigger API. For this API, we have to pass the actual values of the new episode, which will be sent as part of the push notification. We must use the same data types we used while creating the business event.

We will use the following payload to trigger the campaign:

{
"event_name": "ENT_New_Content_Released",
"event_attributes": {
"name of the series": "Friends",
"episode name": "The one with Joey's Fridge",
"episode number": 19,
"episode image": "https://image.moengage.com/showcasemoengage/20230907052100588487CT730Mfriends619jpgcompshowcasemoengage.jpg",
"episode url":"https://myapp.com/friends/season6/episode19"
},
"triggered_by": "example@moengage.com"
}

Conclusion

In this use case, we created notifications for new episodes through a push campaign to keep your customers updated on the latest content in their favorite series. We used Business Event Triggered Campaigns in MoEngage to achieve this.