Cordial
The Cordial integration is available on the Enterprise plan.
Radar can send events and user attributes to Cordial.
Use the Cordial integration to send location-triggered and location-targeted messages to increase engagement and conversion.
#
ConfigurationContact your customer success manager to enable this feature.
#
User mappingNote that Radar uses the special string "(null)"
to represent null
user attribute values.
Radar User Field | mParticle User Attribute | Type | Example Value | Context Type |
---|---|---|---|---|
userId | userId | string | "1" | |
location.coordinates[0] | radar_location_longitude | number | -76.350663 | |
location.coordinates[1] | radar_location_latitude | number | 39.525665 | |
locationAuthorization | radar_location_authorization | string | "GRANTED_FOREGROUND" | |
locationAccuracyAuthorization | radar_location_accuracy_authorization | string | "FULL" | |
_id | radar_id | string | "5b2c0906f5874b001aecfd8d" | |
updatedAt | radar_updated_at | timestamp | "2018-06-22T15:23:39.000Z" | |
segments[*].externalId | radar_segment_external_ids | array[string] | ["starbucks-visitors"] | |
topChains[*].slug | radar_top_chain_slugs | array[string] | ["starbucks", "walmart"] | |
topChains[*].externalId | radar_top_chain_external_ids | array[string] | ["123", "456"] | |
geofences[*]._id | radar_geofence_ids | array[string] | ["5b2c0906f5874b001aecfd8e"] | Geofences |
geofences[*].description | radar_geofence_descriptions | array[string] | ["Store #123"] | Geofences |
geofences[*].tag | radar_geofence_tags | array[string] | ["store"] | Geofences |
geofences[*].externalId | radar_geofence_external_ids | array[string] | ["123"] | Geofences |
place._id | radar_place_id | string | "59302bcf8f27e8a156bd4f91" | Places |
place.name | radar_place_name | string | "Starbucks" | Places |
place.categories | radar_place_categories | array[string] | ["food-beverage", "cafe", "coffee-shop"] | Places |
place.chain.slug | radar_place_chain_slug | string | "starbucks" | Places |
place.chain.name | radar_place_chain_name | string | "Starbucks" | Places |
country.code | radar_region_country_code | string | "US" | Regions |
country.name | radar_region_country_name | string | "United States" | Regions |
state.code | radar_region_state_code | string | "MD" | Regions |
state.name | radar_region_state_name | string | "Maryland" | Regions |
dma.code | radar_region_dma_code | string | "26" | Regions |
dma.name | radar_region_dma_name | string | "Baltimore" | Regions |
postalCode.code | radar_region_postal_code | string | "21014" | Regions |
trip.externalId | radar_trip_external_id | string | "299" | Trip Tracking |
trip.destinationGeofenceTag | radar_trip_destination_geofence_tag | string | "store" | Trip Tracking |
trip.destinationGeofenceExternalId | radar_trip_destination_geofence_external_id | string | "123" | Trip Tracking |
beacons[*]._id | radar_beacon_ids | array[string] | ["5b2c0906f5874b001aecfd8f]" | Beacons |
beacons[*].description | radar_beacon_descriptions | array[string] | ["Store #123 - Drive-Thru"] | Beacons |
beacons[*].tag | radar_beacon_tags | array[string] | ["drive-thru"] | Beacons |
beacons[*].externalId | radar_beacon_external_ids | array[string] | ["123"] | Beacons |
#
Event mapping#
user.entered_geofenceRadar Event Field | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
geofence._id | geofence_id | string | "5b2c0906f5874b001aecfd8e" |
geofence.description | geofence_description | string | "Store #123" |
geofence.tag | geofence_tag | string | "store" |
geofence.externalId | geofence_external_id | string | "123" |
geofence.metadata[{key}] | geofence_metadata_{key} | {type} | {value} |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.exited_geofenceRadar Event Field | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
geofence._id | geofence_id | string | "5b2c0906f5874b001aecfd8e" |
geofence.description | geofence_description | string | "Store #123" |
geofence.tag | geofence_tag | string | "store" |
geofence.externalId | geofence_external_id | string | "123" |
geofence.metadata[{key}] | geofence_metadata_{key} | {type} | {value} |
confidence | confidence | string | "high" |
duration | duration | number (minutes) | 42.1 |
foreground | foreground | boolean | true |
#
user.dwelled_in_geofenceRadar Event Field | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
geofence._id | geofence_id | string | "5b2c0906f5874b001aecfd8e" |
geofence.description | geofence_description | string | "Store #123" |
geofence.tag | geofence_tag | string | "store" |
geofence.externalId | geofence_external_id | string | "123" |
geofence.metadata[{key}] | geofence_metadata_{key} | {type} | {value} |
confidence | confidence | string | "high" |
duration | duration | number (minutes) | 5 |
foreground | foreground | boolean | true |
#
user.entered_placeRadar Event Field | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
place._id | place_id | string | "59302bcf8f27e8a156bd4f91" |
place.name | place_name | string | "Starbucks" |
place.chain.slug | place_chain_slug | string | "starbucks" |
place.chain.name | place_chain_name | string | "Starbucks" |
place.categories | place_categories | string (comma-separated) | "food-beverage,cafe,coffee-shop" |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.exited_placeRadar Event Field | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
place._id | place_id | string | "59302bcf8f27e8a156bd4f91" |
place.name | place_name | string | "Target" |
place.chain.slug | place_chain_slug | string | "target" |
place.chain.name | place_chain_name | string | "Target" |
place.categories | place_categories | string (comma-separated) | "food-beverage,cafe,coffee-shop" |
confidence | confidence | string | "high" |
duration | duration | number (minutes) | 42.1 |
foreground | foreground | boolean | true |
#
user.entered_region_countryRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
region.code | region_code | string | "US" |
region.name | region_name | string | "United States" |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.exited_region_countryRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
region.code | region_code | string | "US" |
region.name | region_name | string | "United States" |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.entered_region_stateRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
region.code | region_code | string | "MD" |
region.name | region_name | string | "Maryland" |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.exited_region_stateRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
region.code | region_code | string | "MD" |
region.name | region_name | string | "Maryland" |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.entered_region_dmaRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
region.code | region_code | string | "26" |
region.name | region_name | string | "Baltimore" |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.exited_region_dmaRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
region.code | region_code | string | "26" |
region.name | region_name | string | "Baltimore" |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.started_tripRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
trip.externalId | trip_external_id | string | "299" |
trip.metadata[{key}] | trip_metadata_{key} | {type} | {value} |
trip.destinationGeofenceTag | trip_destination_geofence_tag | string | "store" |
trip.destinationGeofenceExternalId | trip_destination_geofence_external_id | string | "123" |
foreground | foreground | boolean | true |
#
user.updated_tripRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
trip.externalId | trip_external_id | string | "299" |
trip.metadata[{key}] | trip_metadata_{key} | {type} | {value} |
trip.destinationGeofenceTag | trip_destination_geofence_tag | string | "store" |
trip.destinationGeofenceExternalId | trip_destination_geofence_external_id | string | "123" |
foreground | foreground | boolean | true |
#
user.approaching_trip_destinationRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
trip.externalId | trip_external_id | string | "299" |
trip.metadata[{key}] | trip_metadata_{key} | {type} | {value} |
trip.destinationGeofenceTag | trip_destination_geofence_tag | string | "store" |
trip.destinationGeofenceExternalId | trip_destination_geofence_external_id | string | "123" |
foreground | foreground | boolean | true |
#
user.arrived_at_trip_destinationRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
trip.externalId | trip_external_id | string | "299" |
trip.metadata[{key}] | trip_metadata_{key} | {type} | {value} |
trip.destinationGeofenceTag | trip_destination_geofence_tag | string | "store" |
trip.destinationGeofenceExternalId | trip_destination_geofence_external_id | string | "123" |
foreground | foreground | boolean | true |
#
user.stopped_tripRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
trip.externalId | trip_external_id | string | "299" |
trip.metadata[{key}] | trip_metadata_{key} | {type} | {value} |
trip.destinationGeofenceTag | trip_destination_geofence_tag | string | "store" |
trip.destinationGeofenceExternalId | trip_destination_geofence_external_id | string | "123" |
foreground | foreground | boolean | true |
#
user.entered_beaconRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
beacon._id | beacon_id | string | "5b2c0906f5874b001aecfd8f" |
beacon.description | beacon_description | string | "Store #123 - Drive-Thru" |
beacon.tag | beacon_tag | string | "drive-thru" |
beacon.externalId | beacon_external_id | string | "123" |
beacon.metadata[{key}] | beacon_metadata_{key} | {type} | {value} |
confidence | confidence | string | "high" |
foreground | foreground | boolean | true |
#
user.exited_beaconRadar Event Attribute | mParticle Event Attribute | Type | Example Value |
---|---|---|---|
beacon._id | beacon_id | string | "5b2c0906f5874b001aecfd8f" |
beacon.description | beacon_description | string | "Store #123 - Drive-Thru" |
beacon.tag | beacon_tag | string | "drive-thru" |
beacon.externalId | beacon_external_id | string | "123" |
beacon.metadata[{key}] | beacon_metadata_{key} | {type} | {value} |
confidence | confidence | string | "high" |
duration | duration | number (minutes) | 1.42 |
foreground | foreground | boolean | true |