Automations allow you to use events as a trigger to fire actions. For example, when a user enters a Geofence you can send them a push notification.

An automation is comprised of an availability period (for time-limited promotions) and one or more rules. Each rule is in turn comprised of a trigger (audience and event) and one or more actions (e.g. send a push notification).

Automation rules

To add, edit and delete automations for an app, click on the app and then from the app dashboard for that app, expand push from the left menu and select "Automation". Next to each automation, you can see how many times the rules for that automation have been triggered. In other words, on how many occasions installs in the specified audiences, has completed the selected events within the availability period of the automation.

To Edit or Delete an Automation, click the context menu next to that Automation and select "Edit" or "Delete" as appropriate. You can also quickly add a rule to an existing automation from this menu.

Click the primary action button to add a new Automation, set the availability period and add rules...

Adding Automations

First, give the automation a meaningful name.

Add Automation

The "Enabled" toggle allows you to quickly suspend this automation. When disabled, no actions will be triggered by this automation.

Availability period

Next, define the availability period of the automation.

Date range

If the automation is to run between specific dates only, click the "Available date range" drop-down and change "Always Available" to "Between certain dates" then enter a start and end date for the automation.

Automation date range

Days of week

If the automation is to run on specific days of the week, click the "Available days" drop down and change "Every day" to "Only selected days" then click the "Days of week" drop down and select one or more days.

Automation days of week

Late Triggers

Triggers are recorded locally within the app and uploaded to Kumulos in the background. Therefore, there may be a delay uploading the trigger if, for example, there is no network connection. The "Ignore late triggers" toggle determines if Kumulos should ignore triggers if the automation is not available on the day the trigger is uploaded. For example, if an automation is available on a Friday, but the trigger is not uploaded until the Saturday, should the action still fire (default) or should the trigger be ignored (in which case, enable the "Ignore late triggers" toggle).

Save Automation

Click "Save" when done to add rules to the automation...

Adding Rules

An automation can have one or more rules. Each rule is comprised of a trigger (audience and event) and one or more actions (e.g. send a push notification).

Add multiple rules (with different triggers) to send different content to different members of your audience by either varying the audience (segment or channel) or by changing the event (geolocation).

Add multiple actions to a rule to send multiple notifications to your audience once they have triggered the rule (e.g. a drip-feed marketing campaign).

Automation rules

Next to the trigger for each rule, you can see how many times the rule has been triggered. In other words, on how many occasions an install in the specified audience, has completed the selected event within the availability period of the automation.

The "Enabled" toggle provides a quick way to disable a rule. Disabled rules will not cause any actions to be fired.

To edit or delete a rule, click the context menu next to the rule and select "Edit" or "Delete" as appropriate. To preview how a notification will appear on a user's device, click the magnifying glass.

To add a rule to an automation, click the primary action button.

Trigger

A trigger is comprised of audience and an event.

Automation trigger

Audience

First specify the audience that can trigger this rule. Either any install or only installs in a selected audience segment or that have subscribed to the selected channel.

Event

Next, specify the event to trigger this rule. Currently supported events are:

  • Entering a geofence
  • Leaving a geofence
  • Proximity to a beacon
  • Custom analytics event

Additional events to be added soon include dwell time in a geofence and first app open.

For geofences and beacons, you need to select the geofence(s) or beacon(s). You can select geofences or beacons individually or, if you have used tags to group your geofences and beacons, you can select one or more tags.

If you select multiple geofence(s) or beacon(s), then any of the selected geofences(s) or beacon(s) will trigger the rule.

Select beacons

If you select multiple tags, then only geofence(s) or beacon(s) matching all selected tags will trigger the rule.

Select tags

Click Next when ready to add actions to the rule.

Actions

You can add one or more actions to be fired when a rule is triggered.

Automation actions

Currently, the only action supported is to send a push notification. However, additional actions will soon be available including executing an API call or triggering a webhook.

To edit or delete an action, click the pencil or trash icon as appropriate. To preview how a notification will appear on a user's device, click the magnifying glass. Click "Add Action" to add an(other) action to be fired when this rule is triggered.

First, specify when the action is to fire, either immediately or after a delay of so many hours or days.

Automation action

Next, specify any limits to apply to this action. This is particularly important for geoloction events, especially beacon proximity (to prevent the action firing potentially every second an install is in proximity with a beacon). By default, an action will only fire once every hour. This can be changed to:

  • Fire unlimited times
  • Fire at most once only (per install)
  • Fire at most so many times (per install) in a given number of hours or days

Automation action allowed occurrences

We do not recommend firing an action unlimited times for geolocation triggers. This could lead to a bad user experience if an install is on the boundary of a geofence or remains in proximity of a beacon for a period of time.

See the iBeacon Proximity recipe in the cookbook for an example (in Swift) of how to throttle iBeacon proximity events to only when an iBeacon first comes into proximity.

Sending a notification

To send a push notification when the automation rule is triggered, define the content of the notification and any other options (e.g. URL) and click "Done" to add the automation rule.

The options for the push notification are exactly the same as when sending a notification manually from your agency console. However, keep reading for a brief overview of what these are.

Automation sending a push notification

Content

If you want the notification to appear in the foreground, add a title and a message. Use the emoji pickers to add emojis to your title and message as required.

Kumulos supports Emoji v4.0 / Unicode version 9.0 which is fully supported in iOS 10.3 and Android v7. Older versions of iOS and Android may not support all emojis available. See Emojipedia for more details of what emojis are supported in which versions.

As you add content to the notification you can preview how the notification will look on a user's device. By default, the preview shows how the notification will look on an iPhone. Click the Android tab to see how the notification will look on an Android phone.

Background Push

To send a notification that can be processed in the background, toggle the "Background Push" switch. The title & message become optional, and can be omitted to create a silent push.

On iOS this will set the content-available flag on the notification.

Open a URL

To open a URL when the push notification is tapped by the user, toggle the "Open URL" switch and enter the URL you want to open.

Ensure that you have reviewed the appropriate SDK integration guides to support URL push

Data

To add an arbitrary meta-data object to the push notification, toggle the "Data" switch and enter a valid JSON object into the editor. Additional data can be consumed by the SDK, please refer to the platform integration guides for further information.

iOS Badges

To set the badge on your app on iOS, toggle the "Set Badge" switch. By clicking on "Badge Type" you can choose whether to set the badge to the absolute number you enter in "Count" or to Increment the badge by the positive or negative number you enter in "Count".