Personalized promotion in the mobile app with display time limitation

Published September 26, 2023
Modules
Difficulty

In today’s digital age, offering personalized promotions within your mobile application is a smart strategy to elevate your customers’ overall experience. By tailoring promotions to align with each user’s unique preferences and needs, you can foster deeper engagement and lasting loyalty. In this use case, we will delve into the art of crafting a seamless personalized promotion experience.

This use case describes the scenario where AI Engine selects a personalized promotion (handbill) for each app user. The campaign is based on the following assumptions:

  • The promotion is chosen from the breakfast menu,
  • It is visible on the app for three hours, specifically between 6 AM and 9 AM, and will be available for use for one hour once activated.

Prerequisites


  • Implement promotion module in your mobile application using Synerise mobile SDK or API.
  • Import your product feed to catalog.
  • Meet the documents requirements.
  • Apply this method to assign handbill promotions to a Profile.
  • Create promotions and tag them to use later as a filter when creating a handbill.
  • Create a filter on the list of (regular) promotions to be reused while preparing the personalized promotion. In our case, we create a filter for breakfast promotions.
    Click here to see how to build the filter

    1. Go to Communication > Promotions.
    2. On the right side of the screen, click
      Clicking the filter icon
    3. Click Define.
    4. On the pop-up, define the conditions by clicking Choose filters. The list contains all parameters from the product feed.
      Definition of promotion filter
      Definition of promotion filter
    5. To add a new condition, repeat the previous step.
    6. Save the filter by clicking Save and Apply.

Process


In this use case, you will go through the following steps:

  1. Create a personalized promotion.
  2. Create a document.

Create a personalized promotion


In this part of the process, create a handbill for breakfast promotions that will be active for customers for 1 hour after activation.

  1. Go to Campaigns menu icon > Personalized promotions > New handbill.
  2. Select the type of promotion - Mobile app.
  3. In A/B test settings, add variants of the personalized promotion by clicking Define.
    1. To add the first variant, click the plus button.
    2. In Advanced options, leave the default option - AI Engine (the AI engine chooses the items to be included in the promotion).
    3. Confirm by clicking Apply.
    AB test settings
    AB test settings
  4. In the Filter and limits section, define:
    • the filter you created in prerequisites,
    • the number of items that match a filter,
    • the order of the items in the promotion (from top to the bottom).
    Filters and Limits configuration
    Filters and Limits configuration
  5. In the Activity section, define the activity of the handbill as Relative defining the activity time of promotion. In our case it’s 1 hour.
    Note: You can find more detailed information on all Activity types here.
    Handbill activity
    Handbill activity
  6. Optionally, define the AI Engine boosting settings. You can find the instruction on how to do that here.
  7. After configuring all settings, publish the promotion.

Create a document


Create a document with personalized promotion targeted to the whole database. The document will be used to display the promotion in the mobile app during the specific time frame. In our case, the promotion is scheduled for 1 month throughout the week, from 6 to 9 AM.

If you want to learn more about the various document settings, read the article “Creating documents”.

  1. Go to Data Management icon Data Management > Documents > Add document.
  2. Enter the name for your document.
  3. In the Audience section, choose to whom the document will be displayed. Select Everyone.
  4. In the Configuration section:
    1. In the Slug field, enter the slug of the document, we recommend using the following name convention: this-is-slug-name.

    2. In the Priority field, use a number to define the document priority. The order of documents is defined by the priority value (1 is the highest, 100 is the lowest).

    3. Optionally, you can choose the group to which you add your document by using the Group option. In this case we focus on single promotion.

    4. From the Type drop-down list, select a document type. Document type defines how the document is validated by your mobile application. To create a new type, from the drop-down list, click Add type.

      Note: Full explanation of the type is available here.

    5. In the Body field, insert JSON which includes a reference to the promotion. Below you will find an example of the document body that contains the reference to the promotion created in Synerise. uri used in the body aims to get personalized promotions for the customer from the available list of promotions defined earlier in the handbill:

      {
        "card": "handbill",
        "promotions": {
          "childSchema": "promotion",
          "uri": "https://api.synerise.com/v4/promotions/promotion/get-for-client/handbill/a136d91c-21db-444a-9c0b-101b9a49cd40"
        }
      }
          

    6. Optionally, to check the preview of the document for the specific customer, use Preview body.

    7. To save your changes, click Apply.

    Document body configuration
    Document body configuration
  5. In the Schedule section, define the time when the document will be active.
    1. Schedule the activation of the document by selecting the Scheduled option.
    2. Define the start and end date according to your business needs. In our case it starts from the Ocrober 2nd till the October 31.
    3. Turn on the switch dedicated to setting time windows for the document to be active.
    4. In this case, we select all days of the week.
    5. Click + Add time.
    6. Define the time frame in which the document will be active. In our case, we select the time between 6 and 9 AM.
    Document schedule configuration
    Document schedule configuration
  6. To save your changes, click Apply.
  7. To activate immediately or at a scheduled date, click the Activate button.

Check the use case set up on the Synerise Demo workspace


You can check the configuration of the Personalized promotion and Document directly in Synerise Demo workspace.

If you don’t have access to the Synerise Demo workspace, please leave your contact details in this form, and our representative will contact you shortly.

Read more


😕

We are sorry to hear that

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

😉

Awesome!

Thank you for helping improve out documentation. If you need help or have any questions, please consider contacting support.

Close modal icon Placeholder alt for modal to satisfy link checker