Journeys

A journey is a series of messages that are initiated by a single automation trigger.

 Note

Please contact Airship Sales to enable Journeys for your account.

Airship sends messages in the series based on your timing settings, and you can also set ConditionsTags that must or must not be present on a device (or channel_id) for members of your audience to receive a message from an automation or journey. The message is not sent if your conditions are not met. that determine the continuation of the series.

Journeys are goal-based. The goal determines how a user exits the journey:

  • Completion: Airship delivers all messages in the journey as long as conditions for delivery are met. Use this ending type for onboarding.

  • Event: Airship stops sending the remaining messages in the journey when the user achieves a desired result — select the custom event that will cause the user to exit the journey. Examples:

    • Abandoned cart: Create a series of reminder messages, and cancel the journey if the user completes a purchase.

    • Introduce new feature: Create a series educating users about a new feature, and cancel the journey if the user engages with the feature.

You can create journeys in the dashboard. Journeys support all channels and message types.

See also: Configure Triggers.

Message Frequency Limiting

Automation limits cap the number of automated messages a named user can receive within a time frame, preventing you from over-messaging your audience. Each automation and message in a journey counts toward the automation limit. Automation limits are set at the project level.

Rule limits cap the number of times a named user can trigger a journey, preventing you from over-messaging your audience, e.g., a maximum of 1 per day. Rule limits are set per journey and apply at the named user level.

Your automation limits and counts are displayed below the list of views in Messages » Messages Overview » Ongoing. See also: Manage Automation Limits.

Personalizing the Messages in a Journey

You can trigger journeys based on custom events. When you set up a journey using the Custom Event trigger, you can reference event properties using HandlebarsAirship’s message personalization syntax using double curly braces ({{handlebars}}). You can use handlebars to insert variables and conditional logic in messages and templates. to personalize the message for each member of your audience. If you set up templates, you can reference your templates in messages in the journey.

In your templates — or if using HandlebarsAirship’s message personalization syntax using double curly braces ({{handlebars}}). You can use handlebars to insert variables and conditional logic in messages and templates. directly in your messages — you can reference custom event properties in the $data.events.[0].properties namespace. If your events have a property called name, you would add it to your message or template using {{$data.events.[0].properties.name}}.

For example, if you have a custom event representing a purchase, you can send an automated message confirming the purchase and providing information about what the user bought.

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"
                }
            ]
        }
    }
}

Message Content

Hi {{$def $data.events.[0].properties.customer_name "valued customer"}}!

Thanks for your purchase of:
{{#each $data.events.[0].properties.purchased}}
{{this.qty}}x  {{this.per}}  {{this.item}}  {{this.total}}
{{/each}}
total: ${{$data.events.[0].properties.total}}

Is being processed. We'll message you again when it ships!