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.

Configuration#

On the Cordial API Keys page, create and copy a new API key with Contact Activities permissions. Additionally, ask the Cordial team to create a secondary key for contacts (e.g., emailHash) that you can pass to Radar.

Then, on the Radar Integrations page under Cordial, set Enabled to Yes and paste your API key. Note that you can set separate API keys and app identifiers for the Test and Live environments. Then, paste your async API endpoint, like https://integrations-ingest-svc.usw2.cordial.com. Finally, enter the secondary key.

Whenever events are generated, Radar will send custom events and user attributes to Cordial.

Set metadata[cordial:{secondaryKey}] to map Radar users to the secondary key on Cordial contacts. For example, if your secondary key is emailHash:

Swift
Kotlin

Radar.setMetadata(["cordial:emailHash": emailHash])

Radar.setMetadata(JSONObject().put("cordial:emailHash", emailHash))

User mapping#

Radar User Field	Cordial Contact Attribute	Type	Example Value	Context Type
`metadata[cordial:{secondaryKey}]`	`{secondaryKey}`	string	`"2aae6c35c94fcfb415dbe95f408b9ce91ee846ed"`
`_id`	`radar_id`	string	`"5b2c0906f5874b001aecfd8d"`
`location`	`current_location`	location	`(39.525665, -76.350663)`
`locationAuthorization`	`radar_location_authorization`	string	`"GRANTED_FOREGROUND"`
`locationAccuracyAuthorization`	`radar_location_accuracy_authorization`	string	`"FULL"`
`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_id`	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"`	Trips
`trip.destinationGeofenceTag`	`radar_trip_destination_geofence_tag`	string	`"store"`	Trips
`trip.destinationGeofenceExternalId`	`radar_trip_destination_geofence_external_id`	string	`"123"`	Trips
`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