Extend Personalized Content

You might have communication channels to which you need to send more information to be used on the destination. You can extend the personalized content with the following types of information:

  • Statics – The values are added on content item and are persisted with the same values when a campaign uses the content.
  • Dynamics – On content item level, the user will add information as tokens and the values are composed from audience at runtime moment (when a campaign is launched).

In order to extend the information on a desired communication channel (add extended properties), you need to add in message a generic attribute formatted as key/value pairs.

To extend the information on a desired communication channel, follow these steps:

  1. Create a new entity and add all the needed attributes. We recommend you to use the following naming convention: FTOS_CMB_CommChannel_[channel name].
    2. NOTE  
    The new entity should meet the following prerequisites:
    • Contains at least one attribute lookup to ebs.FTOS_CMB_ActionTemplateContent named contentItemId.
    • Static attributes are added as standard entity attributes.
    • Dynamic attributes are added as lookup to FTOS_CMB_ContentToken.
  2. On the desired communication channel, choose the newly created entity as value for extendedPropertiesEntityId.
  3. On the content item, if the selected channel is the one that you set up, add all the desired values to be used by campaigns.

On the FTOS_DPA_MessageQueue entity, you will find for each message which uses the below channel, an attribute named ChannelProviderParams with all key/value pairs.

Let’s assume that you need to communicate from a campaign custom information to an endpoint on a mobile channel.

This section shows you how to extend Personalized Content to communicate from a campaign to an endpoint on a mobile channel the following custom information: first name, last name with some extra details like campaign type, availability date, and maximum credit amount:

  1. Create an entity named FTOS_CMB_CommChannel_MobileApp with the following attributes:
    • FTOS_CMB_CommChannel_MobileAppid - PK
    • contentItemId – lookup to ebs.FTOS_CMB_ActionTemplateContent
    • campaignType – OptionSet
    • availabilityDate– Date
    • maxCreditAmount– lookup to FTOS_CMB_ContentToken
  2. Add the Mobile App communication channel (ADMIN > Omnichannel Communication Automation > Communication Channels) and make sure that for the Extended Property attribute you select FTOS_CMB_CommChannel_MobileApp.
  3. Create a new content and a new content item by following these steps:
    1. On the content template item, choose the Mobile App communication channel.
    2. Click the Edit Channel Extended Properties button. The Edit AppMobile Extended Properties page opens.
    3. From the Content Item ID field, select the campaign type (Notification).
    4. From the tokenDate field, select a fixed date (e.g.,30.11.2019) and from the tokens list, select MaximumCreditAmount.
      5. NOTE  
      You must add the token from the Audience.
    5. Save the form and return to the content template item.
  4. Confirm the template and use it in a campaign.
  5. Start the campaign.

For each attendee, you will find a message in the Message Queue entity. In ChannelProviderParams you will find a key/value pair; for example: {campaignType: notification, availabilityDate: 31.03.2019, maxCreditAmount: 2500}. You can use these values to send a proper message to the mobile app endpoint.