Overview

Our integration with Radar enables you to use location data to trigger automated messages in Cordial. Using Radar's geofencing and location data, you can message customers who've opted in for location sharing about sales at nearby stores, offer discounts, and more. This incentivizes shopping at brick-and-mortar locations and drives loyalty.

Example store location message

Use case

For a specific use case, check out our case study about how JOANN leverages the integration with Radar and Cordial to increase sales.

Create contact attributes in Cordial

In order to begin using Radar User Field data to trigger messages in Cordial, you need to create the Cordial contact attributes listed here.

• Learn how to create contact attributes in Cordial.

Send geolocation data from Radar to Cordial

Radar can send contact attributes (User Fields) and events to trigger personalized messages in Cordial.

The full list of Radar data you can send to Cordial is available here.

1. In your Radar account, navigate to Integrations > Cordial.

2. In the Enabled dropdown, click Yes.

3. In Cordial, navigate to Settings > API Keys to create an API key.

• Learn how to create an API key in Cordial.

4. In Radar, paste in your Cordial API key and the appropriate Asynchronous API endpoint: 

• usw1: https://integrations-ingest-svc.cordial.com
• usw2: https://integrations-ingest-svc.usw2.cordial.com
• use1: https://integrations-ingest-svc.use1.cordial.com

5. Enter a Cordial secondary key to set metadata[cordial:{secondaryKey}] to map Radar User Fields to the secondary key on Cordial contacts. Learn more.

A secondary key is used in Cordial to find a specific subset of data within a JSON object. Unlike primary keys, secondary keys don't need to be unique. Multiple JSON objects can have the same value for a secondary key, and each value can be associated with multiple JSON objects. Secondary keys are used to enable and enhance specific queries, which facilitates segmentation.

6. Click Show Advanced and choose the Radar events you want to send to Cordial under Event type allowlist.

7. Click Save.

Trigger messages in Cordial with data sent from Radar

Once you've successfully set up the connection between Radar and Cordial, you can trigger messages to send based on changes to contact attributes, such as updates to location, as well as events, such as activity within a specific geofence you've created in Radar.

1. Create your dynamic message content using Sculpt or the HTML Editor in Cordial. Here's an example Sculpt Block for a location message.

2. Navigate to Automations > Create New Automation to create a message automation that will send based on updates to contact or event data in Radar.

3. Create a Message Header and select the Message Content, then click Publish.

4. With your content finalized and ready to send (published), click Event Triggered under Sending Methods.

5. Click Edit in the Trigger Events pane.

6. If you're triggering the message based on a change to a contact attribute (User Field), select When a change is made to a contact attribute value and choose the desired attribute from the menu.

• You can find the full list of available contact attributes (User Fields) in Radar here.

7. If you're triggering the message based on an event in Radar, select A contact's real-time behavior and choose the desired event from the menu.

• You can find the full list of available events available in Radar here.

8. Beneath the Trigger Events window, click Edit in the Audience pane and configure your audience with any contacts you want to include or exclude from the message using the Audience Builder.

9. With your content and trigger settings finalized, click Enable in the Event Triggered window to begin sending your automated message to applicable contacts.