Before you get started:
- Custom journey triggers require that you have access to development resources, as custom API work is required. Please reach out to the whiteglove@attentivemobile.com with questions.
- This article assumes that you’re already familiar with how journey triggers work. If not, you may want to start with What are journeys? and What are transactional journeys?
-
With an eCommerce integration or the Product Data API, you can input product data to incorporate product attributes in your subscriber segments or journey branches. This allows you to create product-change triggered journeys. For more information, see Use your product data in Attentive.
What are custom journey triggers?
With custom journey triggers, you can leverage the Custom Events API to build custom journey triggers for both email and text message journeys based on event data you collect about your customers and how they interact with your business. While prebuilt journeys offer an easy solution to quickly building great experiences for your customers, custom journey triggers let you build exactly the right type of journey for the exact use case you have.
You should know
- After you build an event with a custom trigger, customers enter that journey when you send the corresponding event to Attentive.
- You can include an offer in a journey triggered by a custom event, but only in marketing journeys.
- If you include a URL in a custom event sent to Attentive, you can use the URL in a macro. You can also use the link shortener. Attentive doesn't support custom UTMs on links, but you can include UTMs directly in the link you send to Attentive.
- You can run the same reports on journeys that use custom triggers as non-custom journeys. For each journey, triggered message, and journey revision, you can see:
- Sends
- CTR
- CVR
- Revenue
How can I use custom journey triggers?
You can use custom journey triggers for nearly any use case you can come up with! Here are some suggestions to get you started:
Order update journeys
- Custom event trigger examples: Order confirmed, Order shipped, Order delivered
- Event property macro examples: Order number, Tracking number, Shipping date, Customer first name
Appointment and reservation update journeys
- Custom event trigger examples: Appointment confirmed, Upcoming appointment, Appointment canceled
- Event property macro examples: Appointment number, Appointment date, Appointment location
Loyalty update journeys
- Custom event trigger examples: Loyalty points added, Loyalty points expiring
- Event property macro examples: Total loyalty points, Number of loyalty points added, Loyalty status (Gold, Silver, etc), Loyalty points expiration date
Interacted with email journeys
- Custom event trigger examples: Email sent, Email opened, Email clicked
- Event property macro examples: Email subject line, Email type (new sale, new release, etc.)
Additional types of on-site events
- Custom trigger event examples: Added to wishlist, Checkout started, Checkout completed
- Event property macro examples: Checkout link, Wishlist link, Product name(s), Cart amount
Create a new journey from a custom trigger
Keep in mind that before you can create a journey from a custom trigger, your team must first send events to the Custom Events API. Follow these steps to create a new journey from a custom trigger:
- On Prebuilt journeys tab of the Journeys page, click the custom journey tile.
- Click the custom event trigger you want to use for the journey, and then click Continue.
Tip: Journeys that use your custom triggers are labeled with Your Custom Event. - Select whether this journey is transactional or promotional. Not sure? Check out Transactional vs marketing: Which should I choose?
-
Build your journey.
- When you add an email or text message step to your journey, you can include details about the customer, their order, and more using dynamic content. See Personalize your message with dynamic content for more information about personalizing text messages and Personalize your email with dynamic content for more information about personalizing emails.
- When you add an email or text message step to your journey, you can include details about the customer, their order, and more using dynamic content. See Personalize your message with dynamic content for more information about personalizing text messages and Personalize your email with dynamic content for more information about personalizing emails.
- When you’re finished building your custom journey, click Turn on.
Add an image to a custom journey message
If you send images via Attentive’s Custom Events API, you can include those images in text or email messages in journeys triggered by the custom event.
Add an image to a custom journey email message
- Add or edit an email message step in the journey triggered by the custom event.
- Add a DYNAMIC IMAGE block to the email.
- Click Edit dynamic image.
- Select
{{triggerEvent.custom['mediaUrl']}}
from the Dynamic image content dropdown.
Add an image to a custom journey text message
- Add or edit a text message step in the journey triggered by the custom event.
- In the message composer, click +.
- Click Select next to Dynamic product image.