Iterable

​

Configuration

IterableAPI.userId = userId
Radar.setUserId(userId)
let dataField = ["userId": userId]
IterableAPI.updateUser(dataField, mergeNestedObjects: false)

​

Example use cases

​

Send a personalized push notification when user is near a store

​

Configure geofences in Radar

1. First, ensure your Geofences are configured in Radar. For a “nearby” use case, we typically suggest something like a 500 meter radius. You may also want to take advantage of isochrone (time-based) geofences, which would allow you to define, for example, a geofence with boundaries set to all points within a 10 minute walk from your target location.
2. Note the tag for the nearby geofences you’ve set up in step one. You can find your geofence tags in Radar by viewing your geofences.

​

Create a new Journey in Iterable

3. In Iterable, navigate to Journeys and click + New journey. For more on Journeys in Iterable, please refer to Iterable’s documentation.
4. New Journeys in Iterable have a “start” node by default. Double click this node and change the Received Api Trigger dropdown value to Triggered Custom Event. Under Event name, start typing Radar and you should see a list of available events begin to auto-populate. Select radarGeofenceEntered.
5. Change the Use Filter option to Yes.
6. Where it says Select a property, start typing RadarGeofence and look for the radarGeofenceEntered.geofenceTag property. Set this property to contain (use Iterable’s Contains operator) the tag you set up in step one and verified in step two.
7. Click Update Node.
8. Add a new node via Iterable’s drag and drop functionality. For this example, drag in the Send Push node, then connect the Start node with the Send Push node.

​

Set up a push notification template in Iterable

9. Now, we’ll need to create an Iterable Template to create a personalized push to be used for this campaign. Navigate to Content -> Templates, and click + New template -> Push -> Create template (giving it a name as needed).
10. We’re going to customize the title of the Template using data from Radar so your message can say “You’re near {{Store name}} ”, with {{Store name}} representing the name of the nearby store whose geofence the user has entered. In the Title text box, enter **{{radarGeofenceEntered.geofenceDescription}}**. This syntax is called Handlebar notation. You can read more about it in Iterable’s documentation.
11. Add in a Push message, then click Save Template.
12. Back in the Journey, double click on the Send mobile push node and change the template to the one you just created.

​

Test your campaign

​

Filter users in an Iterable Journey whose last known location is X minutes away from a store

​

Configure geofences in Radar

1. First, let’s configure Geofences in Radar. Read more about creating geofences here. Set up isochrone geofences with a 10 minute drive time.
2. Note the tag for the 10 minute drive geofences you’ve set up in step one. You can find your geofence tags in Radar by viewing your geofences.

​

Create a new Journey in Iterable

3. In Iterable, navigate to Journeys and click + New journey. For more on Journeys in Iterable, please refer to Iterable’s documentation.
4. Iterable will start your Journey with a “start” node by default. Double click this node and change the Received Api Trigger dropdown value to Opened An Email. Select the campaign and filter as desired. Click Update Node.
5. Now, we’ll add a new node that filters this initial trigger down based on Radar data. Under Filters on the left sidebar of Iterable’s Journey builder, drag Fields Match in below the Start node.
6. Double click on this new Filter users node. Where it says Choose a property, select Contact Property. Type in radarGeofenceTags, and set it to contain (use Iterable’s Contains operator) the tag you set up in step one and verified in step two. Click Update Node.
7. Connect the Start node with the Filter users node.

​

Set up a push notification template in Iterable

8. Now, we’ll need to create an Iterable Template to create a personalized push to be used for this campaign. Navigate to Content -> Templates, and click + New template -> Push -> Create template (giving it a name as needed).
9. Add in a Push message, then click Save Template.
10. Back in the Journey, drag a Send Push action into the Journey builder. Double click on the Send mobile push node and change the template to the one you just created. Finally, drag from the Yes option under the Filter users node to the Send Push node to finish the Journey connection.

​

Test your campaign

​

User mapping

​

Event mapping

​

radarGeofenceEntered

​

radarGeofenceExited

​

radarDwelledInGeofence

​

radarPlaceEntered

​

radarPlaceExited

​

radarCountryEntered

​

radarCountryExited

​

radarStateEntered

​

radarStateExited

​

radarDMAEntered

​

radarDMAExited

​

radarTripStarted

​

radarApproachingTripDestination

​

radarArrivedTripDestination

​

radarTripStopped

​

radarBeaconEntered

​

radarBeaconExited