Personalize Alert

Alerts can be personalized in the content creation step of Alert creation using the Text personalization button or using JINJA.

Personalize with the Personalization Editor

To personalize, do the following:

  1. Click the Text personalization button.
  2. Add the attribute to be personalized in the Personalisation attribute field on the screen that pops up.
  3. You can specify user attributes as fallbacks for the personalized attribute. Note: User Attributes must be enabled in Inform Settings for this option to be available. For more information, refer to User Attribute settings.

    PersonalizationEditor.png

  4. Click Copy and close to copy the personalized attribute to the clipboard.
  5. Paste the copied value in the message editor using standard keyboard shortcuts.
info

Naming convention to be followed for Personalization

The names of the user attribute added for personalization can contain only the following: String characters, a combination of alphabets and numbers, and underscores. For example, the attribute name to be personalized can be username or user_name, or usernmae1, while user name and user name1 are not allowed. If the attribute name were to contain any character other than string characters or underscore or alphanumerics, for example, spaces, only numbers, or special characters, personalization would not work.

User Attributes as fallbacks Without User Attributes
The following flow diagram depicts how personalization works with User Attributes as fallbacks.

UserAttributesas_Fallback.png

Here is a sample message body where the user's first name and order id have been personalized with user attributes as fallbacks.

Sample Message Body

Hi {{username|default("{{UserAttribute['

USER_ATTRIBUTE_USER_NAME

']|default('user')}}")}}!

Your order {{orderid}} has been placed successfully.

Happy Shopping!

Team MoEngage

Sample Payload with personalization

JSON
{
"user_id": "john_doe",
"payloads": {
        "SMS": {
            "recipient": "+1555555555",
            "personalized_attributes": {
                "firstname": "John",
                "orderid": "#order HXY-12345-ZSDF"
            }
        },
        "EMAIL": {
            "recipient": "john.doe@moengage.com",
            "personalized_attributes": {
                "firstname": "John",
                "orderid": "#order HXY-12345-ZSDF"
            }
        }
    }

The firstname and orderid need to be sent when the request is triggered.

Personalized Alert as received by the customer

Alert SMS Received by User Alert Email Received by User Alert Push Notification Received by User
AlertSMS.jpg

Personalize using JINJA

To personalize an alert using JINJA, add the JINJA to the template editor in the content creation step and pass the attributes used in the JINJA in the personalized_attributes object in your request payload.

Sample Payload with personalization

Sample Email Payload
{  
    "alert_id": "652fba0290f2820d05e12852",
    "user_id": "John_Doe",
    "transaction_id": "135671868",
    "payloads": {
        "EMAIL": {
            "recipient": "john.doe@example.com",
            "personalized_attributes": {
                "items": [
                  {  
                    "name": "iPhone 15",
                    "price": "2500 AED",
                    "image": "https://yourbrand.com/iPhone.jpg"
                  },
                  {
                    "name": "Macbook Air",
                    "price": "3000 AED",
                    "image": "https://yourbrand.com/MacbookAir.jpg"
                  },
                  {
                    "name": "Airpods",
                    "price": "800 AED",
                    "image": "https://yourbrand.com/Airpods.jpg"
                  }
                ],
           }
        }
    }
}

Personalized Alert Received by the customer

JINJAPersonalization_Email.png

Previous

Next

Was this article helpful?
0 out of 0 found this helpful

How can we improve this article?