Radar

AIRSHIP VERIFIED INTEGRATION

This integration is maintained by Radar. Please contact Radar for support.

Radar makes it easy to start tracking location data with their iOS and Android SDKs, and generate contextual events from this data using their different event types: Geofences, Insights, and Places.

Radar sends location data to Airship using our server-side Custom Events API. Whenever location events are generated, Radar will send custom events and properties to Airship. This data can then be used with the Custom Event trigger in the Automation and Sequence composers.

Radar Use Cases

  • Media: Trigger sending a notification to a user when they enter a place within a specific category, e.g., a fitness venue, asking them to read your latest article on Health & Wellness.

  • Retail: Trigger sending a notification to a user when they enter one of your store locations, telling them about a new product you are offering.

  • Dining: Trigger sending a notification to a user when they enter a specific geofence, offering them a 20% off coupon for your restaurant.

Radar Integration Requirements

  • Accounts
    1. Radar — Enterprise account
    2. Airship — Must include messaging
  • Airship project
    • The Airship SDK must use the same user identity as the Radar SDK.

Configuring the Radar Integration

In Airship:

  1. Go to Settings.
  2. Under Project Configuration, select Manage for Partner Integrations.
  3. Select Radar.
  4. Select Configure for the inbound integration and follow the onscreen instructions to:

Radar will send custom events and properties to Airship for use with the Custom Event trigger. See the full list of Radar Events.

Using the Custom Event trigger

In the Setup step in an Automation or when configuring the trigger for a Sequence:

  1. Select the Custom Event trigger.

  2. Search for a Radar event, then select from the listed results. Results include events that occurred in the last 30 days. All Radar events have the prefix radar in the name. For example, radar_geofence_entered.

  3. (Optional) Select Add Another to add more Radar events. Multiple event are handled as a boolean OR.

Filtering Custom Events

When configuring the Custom Event trigger, you can filter custom events using numeric values associated with those custom events, or by key/value properties attached to the events. Filtering events this way can help you more precisely target your audience.

 Note

The filter does not show events and event properties for custom events associated with Named UsersA customer-provided identifier used for mapping multiple devices and channels to a specific individual.. You can still use events associated with named users as triggers, but you must enter their information manually.

Each Radar location event has associated properties that may be used as filters. For example, you can choose to trigger an automation or sequence when a user enters a Radar geofence (radar_geofence_entered) with a confidence property (radar_confidence) value of Medium.

  1. Select Add event properties for the custom event.

  2. Select Add property.

  3. Select Search for properties, enter a search term, and select from the listed results.

  4. Set the property or value for your event filter and the operator determining how you want to evaluate the property or value. An operator will pre-populate for most properties. Equals is used for radar_confidence only.

  5. (Optional) Add an alternative by selecting the plus icon () at the end of a row.

  6. Select ALL or ANY to determine how to evaluate multiple filters and alternatives within each filter:

    • ALL = all criteria must be met (boolean AND)
    • ANY = any criteria must be met (boolean OR)

  7. Select Save.

Radar Events and Properties

Use the following terms when searching for and filtering Radar events. See Radar’s documentation for additional detail.

Each event is followed by its associated properties and each property’s acceptable value.

Radar Geofences

radar_geofence_entered
radar_geofence_description: String
radar_geofence_tag: String
radar_geofence_external_id: String
radar_confidence: Low, Medium, or High
radar_geofence_exited
radar_geofence_description: String
radar_geofence_tag: String
radar_geofence_external_id: String
radar_confidence: Low, Medium, or High
radar_duration: A number, in minutes

Radar Insights

radar_home_entered
radar_confidence: Low, Medium, or High
radar_home_exited
radar_confidence: Low, Medium, or High
radar_office_entered
radar_confidence: Low, Medium, or High
radar_office_exited
radar_confidence: Low, Medium, or High
radar_traveling_started
radar_confidence: Low, Medium, or High
radar_traveling_stopped
radar_confidence: Low, Medium, or High

Radar Places

radar_place_entered
radar_place_name: String
radar_place_chain_slug: String
radar_place_chain_name: String
radar_place_categories: String
radar_place_facebook_id: String
radar_confidence: Low, Medium, or High
radar_place_exited
radar_place_name: String
radar_place_chain_slug: String
radar_place_chain_name: String
radar_place_categories: String
radar_place_facebook_id: String
radar_confidence: Low, Medium, or High
radar_duration number: A number, in minutes