Skip to main content

Iterable

Radar can send custom events and user data to Iterable.

Use the Iterable integration to send location-triggered and location-targeted messages to increase engagement and conversion.

The Iterable integration is available on the Enterprise plan.

Configurable#

On the Iterable API Keys page, create and copy a Mobile API key.

Then, on the Radar Integrations page under Iterable, set Enabled to Yes and paste your key. Note that you can set separate keys for the Test and Live environments.

Whenever events are generated, Radar will send custom events and user data to Iterable.

User mapping#

Note that Radar uses the special string "(null)" to represent null user data field values.

Radar User FieldIterable User Data FieldTypeExample ValueContext Type
userIduserIdstring"1"
location.coordinates[0]radarLocationLongitudenumber-76.350663
location.coordinates[1]radarLocationLatitudenumber39.525665
_idradarIdstring"5b2c0906f5874b001aecfd8d"
updatedAtradarUpdatedAttimestamp"2018-06-22T15:23:39.000Z"
segments[*].externalIdradarSegmentExternalIdsarray[string]["starbucks-visitors"]
topChains[*].slugradarTopChainSlugsarray[string]["starbucks", "walmart"]
topChains[*].externalIdradarTopChainExternalIdsarray[string]["123", "456"]
geofences[*]._idradarGeofenceIdsarray[string]["5b2c0906f5874b001aecfd8e"]Geofences
geofences[*].descriptionradarGeofenceDescriptionsarray[string]["Store #123"]Geofences
geofences[*].tagradarGeofenceTagsarray[string]["store"]Geofences
geofences[*].externalIdradarGeofenceExternalIdsarray[string]["123"]Geofences
place._idradarPlaceIdstring"59302bcf8f27e8a156bd4f91"Places
place.nameradarPlaceNamestring"Starbucks"Places
place.categoriesradarPlaceCategoriesarray[string]["food-beverage", "cafe", "coffee-shop"]Places
place.chain.slugradarPlaceChainSlugstring"starbucks"Places
place.chain.nameradarPlaceChainNamestring"Starbucks"Places
insights.state.homeradarInsightsStateHomebooleanfalseInsights
insights.state.officeradarInsightsStateOfficebooleanfalseInsights
insights.state.travelingradarInsightsStateTravelingbooleantrueInsights
country.coderadarRegionCountryCodestring"US"Regions
country.nameradarRegionCountryNamestring"United States"Regions
state.coderadarRegionStateCodestring"MD"Regions
state.nameradarRegionStateNamestring"Maryland"Regions
dma.coderadarRegionDMACodestring"26"Regions
dma.nameradarRegionDMANamestring"Baltimore"Regions
postalCode.coderadarRegionPostalCodestring"21014"Regions

Event mapping#

Radar EventContext TypeIterable Event
user.entered_geofenceGeofencesradarGeofenceEntered
user.exited_geofenceGeofencesradarGeofenceExited
user.entered_placePlacesradarPlaceEntered
user.exited_placePlacesradarPlaceExited
user.entered_homeInsightsradarHomeEntered
user.exited_homeInsightsradarHomeExited
user.entered_officeInsightsradarOfficeEntered
user.exited_officeInsightsradarOfficeExited
user.started_travelingInsightsradarTravelingStarted
user.stopped_travelingInsightsradarTravelingStopped
user.entered_region_countryRegionsradarCountryEntered
user.exited_region_countryRegionsradarCountryExited
user.entered_region_stateRegionsradarStateEntered
user.exited_region_stateRegionsradarStateExited
user.entered_region_dmaRegionsradarDMAEntered
user.exited_region_dmaRegionsradarDMAExited
user.started_tripTrip TrackingradarTripStarted
user.updated_tripTrip TrackingradarTripUpdated
user.approaching_trip_destinationTrip TrackingradarApproachingTripDestination
user.arrived_at_trip_destinationTrip TrackingradarArrivedTripDestination
user.stopped_tripTrip TrackingradarTripStopped

radarGeofenceEntered#

Radar Event FieldIterable Event Data FieldTypeExample
geofence._idgeofenceIdstring"5b2c0906f5874b001aecfd8e"
geofence.descriptiongeofenceDescriptionstring"Store #123"
geofence.taggeofenceTagstring"store"
geofence.externalIdgeofenceExternalIdstring"123"
geofence.metadata[{key}]geofenceMetadata{key}{type}{value}
confidenceconfidencestring"high"

radarGeofenceExited#

Radar Event FieldIterable Event Data FieldTypeExample
geofence._idgeofenceIdstring"5b2c0906f5874b001aecfd8e"
geofence.descriptiongeofenceDescriptionstring"Store #123"
geofence.taggeofenceTagstring"store"
geofence.externalIdgeofenceExternalIdstring"123"
geofence.metadata[{key}]geofenceMetadata{key}{type}{value}
confidenceconfidencestring"high"
durationdurationnumber (minutes)42.1

radarPlaceEntered#

Radar Event FieldIterable Event Data FieldTypeExample
place._idplaceIdstring"59302bcf8f27e8a156bd4f91"
place.nameplaceNamestring"Starbucks"
place.chain.slugplaceChainSlugstring"starbucks"
place.chain.nameplaceChainNamestring"Starbucks"
place.categoriesplaceCategoriesarray[string]["food-beverage", "cafe", "coffee-shop"]
confidenceconfidencestring"high"

radarPlaceExited#

Radar Event FieldIterable Event Data FieldTypeExample
place._idplaceIdstring"59302bcf8f27e8a156bd4f91"
place.nameplaceNamestring"Starbucks"
place.chain.slugplaceChainSlugstring"starbucks"
place.chain.nameplaceChainNamestring"Starbucks"
place.categoriesplaceCategoriesarray[string]["food-beverage", "cafe", "coffee-shop"]
confidenceconfidencestring"high"
durationdurationnumber (minutes)42.1

radarHomeEntered#

Radar Event FieldIterable Event Data FieldTypeExample
confidenceconfidencestring"high"

radarHomeExited#

Radar Event FieldIterable Event Data FieldTypeExample
confidenceconfidencestring"high"

radarOfficeEntered#

Radar Event FieldIterable Event Data FieldTypeExample
confidenceconfidencestring"high"

radarOfficeExited#

Radar Event FieldIterable Event Data FieldTypeExample
confidenceconfidencestring"high"

radarTravelingStarted#

Radar Event FieldIterable Event Data FieldTypeExample
confidenceconfidencestring"high"

radarTravelingStopped#

Radar Event FieldIterable Event Data FieldTypeExample
confidenceconfidencestring"high"

radarCountryEntered#

Radar Event FieldIterable Event Data FieldTypeExample Value
region.coderegionCodestring"US"
region.nameregionNamestring"United States"
confidenceconfidencestring"high"

radarCountryExited#

Radar Event FieldIterable Event Data FieldTypeExample Value
region.coderegionCodestring"US"
region.nameregionNamestring"United States"
confidenceconfidencestring"high"

radarStateEntered#

Radar Event FieldIterable Event Data FieldTypeExample Value
region.coderegionCodestring"MD"
region.nameregionNamestring"Maryland"
confidenceconfidencestring"high"

radarStateExited#

Radar Event FieldIterable Event Data FieldTypeExample Value
region.coderegionCodestring"MD"
region.nameregionNamestring"Maryland"
confidenceconfidencestring"high"

radarDMAEntered#

Radar Event FieldIterable Event Data FieldTypeExample Value
region.coderegionCodestring"26"
region.nameregionNamestring"Baltimore"
confidenceconfidencestring"high"

radarDMAExited#

Radar Event FieldIterable Event Data FieldTypeExample Value
region.coderegionCodestring"26"
region.nameregionNamestring"Baltimore"
confidenceconfidencestring"high"

radarTripStarted#

Radar Event AttributeIterable Event Data FieldTypeExample Value
trip.externalIdtripExternalIdstring"299"
trip.metadata[{key}]tripMetadata{key}{type}{value}
trip.destinationGeofenceTagdestinationGeofenceTagstring"store"
trip.destinationGeofenceExternalIddestinationGeofenceExternalIdstring"123"

radarApproachingTripDestination#

Radar Event AttributeIterable Event Data FieldTypeExample Value
trip.externalIdtripExternalIdstring"299"
trip.metadata[{key}]tripMetadata{key}{type}{value}
trip.destinationGeofenceTagdestinationGeofenceTagstring"store"
trip.destinationGeofenceExternalIddestinationGeofenceExternalIdstring"123"

radarArrivedTripDestination#

Radar Event AttributeIterable Event Data FieldTypeExample Value
trip.externalIdtripExternalIdstring"299"
trip.metadata[{key}]tripMetadata{key}{type}{value}
trip.destinationGeofenceTagdestinationGeofenceTagstring"store"
trip.destinationGeofenceExternalIddestinationGeofenceExternalIdstring"123"

radarTripStopped#

Radar Event AttributeIterable Event Data FieldTypeExample Value
trip.externalIdtripExternalIdstring"299"
trip.metadata[{key}]tripMetadata{key}{type}{value}
trip.destinationGeofenceTagdestinationGeofenceTagstring"store"
trip.destinationGeofenceExternalIddestinationGeofenceExternalIdstring"123"