The "trigger" option (only available for app push notifications) enables you to send a notification from one minute to several days after users have installed the app or triggered an action in the app.

Trigger campaigns are useful to manage a wide variety of use cases, from simple welcome notifications sent shortly after users install the app to advanced abandoned cart alerts. You can find more information on how user journeys work here.

Below are the steps to create your trigger campaign.

1. Trigger event

The trigger action is the most important part of your push campaign. There are two options to choose from:

  • Installation: The "Installation" event is available by default. Users trigger it when they open the app for the first time.

⚠️ Note for 'Installation' trigger: you can use it only for campaign without additionnal targeting conditions (e.g. country = UK or custom user id = no).

  • Installation then opted-in: For onboarding campaigns, we recommend to use this event, which will allow you to create campaigns to target users who have installed the app AND who opted-in within 24 hours of installation.

Note: this event is accompanied by a "Date attribute" corresponding to the installation date (see case n°2).

Examples:

> Case n°1

9 a.m. → the user installs the app

9:03 a.m. → the user opt-in

9:08 a.m. → Batch sends the push (= opt-in + 5min)

> Case n°2

If you want that your push timer to be counted from the installation, you will need to use the "install_date" attribute (by clicking on 'after' > 'install_date') on the push timing:

9 a.m. → the user installs the app

9:03 a.m. → the user opt-in

9:05 a.m. → Batch sends the push (= installation + 5min)

With this case, you may have some skipped push, example:

9 a.m. → the user installs the app

12 p.m. → the user opt-in

The push is supposed to be sent at 9:05 a.m., but it is not because it will be 12:00 p.m. and as between 12:00 and 9:20 am there is more than 30min ago, so Batch skip sending.

FYI the Batch rule: if the difference between the date we are supposed to send the push and the current time is greater than 30min = the push is skipped.

⚠️ Warning: if your notifications opt-in request is not made at the first opening of the app but on based on a specific scenario, eg. after account creation/connection => always configure your campaigns with option n°1 OR the option n°2 with a push timing more than 24hours after the install date.

  • Custom Events: You can choose any events that have been tagged in your app during the integration of the SDK (see more here). You can also apply filters to your event based on any additional data that is attached to it (Label, Attributes, Tag collection) if you want to trigger the notification on a specific action:

Trigger Event Filters

Examples to filter your events triggering your campaign

  • Send a promotional code D+1 only to users who added a product with the shoes category to their cart.

  • Send a personalized push notification to customers who booked a flight in Business or First class with insurance from Paris.

2. Timer

This is the time interval in minutes, hours or days to wait for sending a notification. Batch will wait this amount of time from the chosen trigger date which can be either the date of the Trigger event or a custom data attached to the event (ex: send a push notification 1h before or after a said date).

Trigger timer options

The minimum push timing is 1 minute and maximum push timing is 30 days.

Examples to set a push delay based on a date attribute

  • Send a push notification 5 days before the user Premium subscription ends

  • For a ticket purchase triggering event, send a push notification 1 hour before the train departure, 3 minutes after the bar opens or 10 minutes before arrival!

3. Cancellation event

You can add one or several cancellation events. Users who trigger one of the cancellation events before the push is sent will exit the user journey and won't receive the notification. You can use an event tagged in your app and apply filters based on additional event data too (Label, Attributes, Tag collection).

  • The frequency capping allows you to limit the maximum number of times an opt-in install receive a notification. This is useful to avoid overwhelming your users with the same message.

  • Use the grace period to set a delay in minutes or hours between each notification sent to the same opt-in install. This is handy to avoid sending too many messages to users too close together. For Example : an add_to_cart campaign with the timer at min+1 and a grace period of 2h :

    • The user makes an add_to_cart event

    • He receives his push 1 min later

    • He makes an add_to_cart event just after (during the grace period of 2h)

    • The second event will be skipped and the second push will not be sent

Example to define multiple send cancellation events

In the case of an abandoned cart campaign, the customer will not receive the push if he empties his cart or if he confirms it (purchase).

4. Multi-trigger mode

By default, if the user fires multiple times the trigger event of the campaign, the timer of the campaign will be reset.

You may want to parallelize journeys, and allow the user to trigger several times the same campaign. You can do that by activating the multi-trigger mode.

The multi-trigger mode allows you to schedule a push each time the user fires the trigger event with a new ID (Ex: Trigger a push for each trip booked by the user on the app based on the trip ID). This ID must be one of the attributes attached to the event or the event label and can only be a String.

Mutil-trigger Mode

Example to allow a user to enter multiple user journeys at once

  • Send a push notification 3 hours before the start of each private sale the user is registered to.

  • Send a push notification 1 hour before the flight departure of each trip the user booked.

Need more help?

Find our documentation here.

If you have any question, don't hesitate to ping us at support@batch.com, or directly on the live-chat!


Did this answer your question?