Event

Radar is the leading geofencing and location platform. Use Radar to build a range of location-based product and marketing experiences: pickup and delivery tracking, location-triggered notifications, and audience building.

Implementation Scenarios

  • Geofencing from 10 meters to an entire country
  • Foreground and background location tracking
  • Location-triggered messaging and notifications
  • Contextual in-app experience based on real time location
  • Trip tracking for pickup, delivery, and fleet tracking
  • Real time ETA updates and arrival notifications during a trip
  • Location-informed audience segmentation

Prerequisites

In order to enable mParticle’s integration with Radar, you will need an account with Radar to obtain your Publishable API Key, found on the Organization page in the Radar dashboard.

mParticle Radar Implementation

mParticle’s Radar integration requires that you add the Radar kit to your iOS or Android app. This kit-only integration solely supports client-side data forwarding.

  • The mParticle SDK will automatically initialize the Radar SDK using your Publishable API Key.
  • If the Run Automatically setting is enabled, Radar will automatically track users if location permissions have been granted.

    • On Android, users that have granted location permissions will be tracked once on app open and persistently in the background.
    • On iOS, users that have granted foreground location permissions will be tracked once on app open. Users that have granted background location permissions will be tracked once on app open and persistently in the background.
  • If the Run Automatically is disabled, you can call Radar methods directly to track users.
  • You can also call Radar methods directly to receive Radar geofence entry and exit events. For more information, see the Radar SDK documentation.

The source code for each kit is available if you would like to learn exactly how the method mapping occurs:

Add the Radar Kit to your iOS or Android app. See the Cocoapods and Gradle examples below, and reference the Apple SDK and Android SDK GitHub pages to read more about kits.

//Sample Podfile
target '<Your Target>' do
    pod 'mParticle-Radar', '~> 6'
end
//Sample build.gradle
dependencies {
    compile ('com.mparticle:android-radar-kit:4.+')
}

For more information, see Radar’s SDK and mParticle integration documentation.

Configuration Settings

Setting Name Data Type Default Value Description
Publishable API Key string Your Radar live/test publishable API key, found on the Get started page.
Run Automatically bool True If enabled, Radar will automatically track users if location permissions have been granted

Was this page helpful?