Previewing personalized content

See how your personalized content will look when populated with data.

When adding or editing content that contains HandlebarsHandlebars is Airship’s templating language for personalization. Handlebars expressions use double curly braces wrapped around a content template, ranging from a simple variable, e.g., {{first_name}} to complex evaluations of personalization data. , enable Preview Data and use JSON sample data representing a member of your audience to preview its appearance, without having to send test messages. You can supply your own sample data, or select a Preview GroupA preview group is an audience group you create for previewing personalized content in the dashboard. Wherever a personalization preview is available, you can select a preview group, and those users' attributes will appear for any Handlebars references to attributes. You can enable any preview group as a test group so the users can receive test messages sent to the group. These messages appear as tests in Messages Overview. , and those users' attributes will appear in the message preview.

The Preview Data option appears in these locations in the dashboard:

After you select a preview group or enter your own sample data, it is available within Preview Data on any other screen within the same template, snippet, or message — you do not have to reenter it. However, within Journeys, Preview Data on the Performance and Manage screens operates independently of Preview Data available while composing messages.

You can click and hold   to drag Preview Data to a new position on the screen.

Previewing personalized content using a preview or test group

First create a preview group with at least one userA preview group is an audience group you create for previewing personalized content in the dashboard. Wherever a personalization preview is available, you can select a preview group, and those users' attributes will appear for any Handlebars references to attributes. You can enable any preview group as a test group so the users can receive test messages sent to the group. These messages appear as tests in Messages Overview. , then follow these steps.

  1. Enter content that uses handlebars.
  2. Enable Preview Data.
  3. Click the search field and select or search for a preview group. The preview on the screen updates with the attributes of a user in your selected group.
  4. Click     to select another user within the group, and the message preview will update with that user’s attributes.
  5. (Optional) Click JSON   to view the data for the selected user.
    • You can modify the field’s content and click Apply JSON to see the changes in the preview.
    • After applying JSON changes for a user, you can click Reset JSON to restore the unedited data.

Previewing personalized content using your own JSON sample data

  1. Enter content that uses handlebars.
  2. Enable Preview Data.
  3. Click JSON  .
  4. Enter sample JSON, and click Apply JSON to see the changes in the preview.
    • Click Apply JSON again after editing the data.
    • Click Reset JSON to delete the field’s current content.
       Tip

      This JSON object mirrors the create_and_send audience object.

JSON sample data for automation and journeys

If your template or message is for an automated message or journey triggered by a custom event, you will want to use sample data based on that custom event.

Enter custom event properties representative of an audience member, mirroring the properties object in a custom event. See also: Personalize Automations and Journeys Using Custom Events.

The following are a custom event and the JSON you would enter in Preview Data for that event.

Sample custom event
{
    "occurred": "{{event_time}}",
    "user": {
        "named_user_id": "user"
    },
    "body": {
        "name": "purchase",
        "subscribe": true,
        "properties": {
            "customer_name": "user",
            "total": 48,
            "cost_units": "USD",
            "purchase": [
                {
                    "qty": 4,
                    "item": "MLB regulation baseball",
                    "per": "$12",
                    "total": "$48"
                }
            ]
        }
    }
}

Example JSON for previewing
{
    "total": 48,
    "cost_units": "USD",
    "purchase": [
        {
            "qty": 4,
            "item": "MLB regulation baseball",
            "per": "$12",
            "total": "$48"
        }
    ]
}