Mixpanel

Radar can send events and user properties to Mixpanel.

Use the Mixpanel integration to enrich behavioral events with location context, measure the ROI of location-based features, and build location-based user segments.

The Mixpanel integration is available on the Team plan or higher.

Configuration#

On the Mixpanel Project Settings page, copy the token from the Management tab. Then, on the Radar Integrations page under Mixpanel, set Enabled to Yes and paste your token. Note that you can set separate tokens for the Test and Live environments.

Whenever events are generated, Radar will send custom events and user properties to Mixpanel.

By default, Radar userId maps to Mixpanel distinct ID for logged in users. However, you can specify a custom mapping by setting Radar metadata.mixpanelDistinctId. For example, on iOS:

Radar.setMetadata(["mixpanelDistinctId": distinctIdValue])

User mapping#

Note that Radar uses the special string "(null)" to represent null user property values.

Radar User Field	Mixpanel User Property	Type	Example Value	Context Type
`location.coordinates[1]`	`$latitude`	number	`39.525665`
`location.coordinates[0]`	`$lontigude`	number	`-76.350663`
`metadata.mixpanelDistinctId` or `userId`	`Distinct ID`	string	`"1"`
`location.coordinates[0]`	`Radar Location Longitude`	number	`-76.350663`
`location.coordinates[1]`	`Radar Location Latitude`	number	`39.525665`
`_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
`insights.state.home`	`Radar Insights State Home`	boolean	`false`	Insights
`insights.state.office`	`Radar Insights State Office`	boolean	`false`	Insights
`insights.state.traveling`	`Radar Insights State Traveling`	boolean	`true`	Insights
`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

Event mapping#

Radar Event	Context Type	Mixpanel Event
`user.entered_geofence`	Geofences	`Radar Geofence Entered`
`user.exited_geofence`	Geofences	`Radar Geofence Exited`
`user.entered_place`	Places	`Radar Place Entered`
`user.exited_place`	Places	`Radar Place Exited`
`user.entered_home`	Insights	`Radar Home Entered`
`user.exited_home`	Insights	`Radar Home Exited`
`user.entered_office`	Insights	`Radar Office Entered`
`user.exited_office`	Insights	`Radar Office Exited`
`user.started_traveling`	Insights	`Radar Traveling Started`
`user.stopped_traveling`	Insights	`Radar Traveling Stopped`
`user.entered_region_country`	Regions	`Radar Country Entered`
`user.exited_region_country`	Regions	`Radar Country Exited`
`user.entered_region_state`	Regions	`Radar State Entered`
`user.exited_region_state`	Regions	`Radar State Exited`
`user.entered_region_dma`	Regions	`Radar DMA Entered`
`user.exited_region_dma`	Regions	`Radar DMA Exited`
`user.started_trip`	Trip Tracking	`Radar Started Trip`
`user.updated_trip`	Trip Tracking	`Radar Updated Trip`
`user.approaching_trip_destination`	Trip Tracking	`Radar Approaching Trip Destination`
`user.arrived_at_trip_destination`	Trip Tracking	`Radar Arrived at Trip Destination`
`user.stopped_trip`	Trip Tracking	`Radar Stopped Trip`

Radar Geofence Entered#

Radar Event Field	Mixpanel Event Property	Type	Example
`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"`

Radar Geofence Exited#

Radar Event Field	Mixpanel Event Property	Type	Example
`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`

Radar Place Entered#

Radar Event Field	Mixpanel Event Property	Type	Example
`place._id`	`Place ID`	string	`"59302bcf8f27e8a156bd4f91"`
`place.name`	`Place Name`	string	`"Starbucks"`
`place.chain.slug`	`Place Chain ID`	string	`"starbucks"`
`place.chain.name`	`Place Chain Name`	string	`"Starbucks"`
`place.categories`	`Place Categories`	array[string]	`["food-beverage", "cafe", "coffee-shop"]`
`confidence`	`Confidence`	string	`"high"`

Radar Place Exited#

Radar Event Field	Mixpanel Event Property	Type	Example
`place._id`	`Place ID`	string	`"59302bcf8f27e8a156bd4f91"`
`place.name`	`Place Name`	string	`"Starbucks"`
`place.chain.slug`	`Place Chain ID`	string	`"starbucks"`
`place.chain.name`	`Place Chain Name`	string	`"Starbucks"`
`place.categories`	`Place Categories`	array[string]	`["food-beverage", "cafe", "coffee-shop"]`
`confidence`	`Confidence`	string	`"high"`
`duration`	`Duration`	number (minutes)	`42.1`

Radar Home Entered#

Radar Event Field	Mixpanel Event Property	Type	Example
`confidence`	`Confidence`	string	`"high"`

Radar Home Exited#

Radar Event Field	Mixpanel Event Property	Type	Example
`confidence`	`Confidence`	string	`"high"`

Radar Office Entered#

Radar Event Field	Mixpanel Event Property	Type	Example
`confidence`	`Confidence`	string	`"high"`

Radar Office Exited#

Radar Event Field	Mixpanel Event Property	Type	Example
`confidence`	`Confidence`	string	`"high"`

Radar Traveling Started#

Radar Event Field	Mixpanel Event Property	Type	Example
`confidence`	`Confidence`	string	`"high"`

Radar Traveling Stopped#

Radar Event Field	Mixpanel Event Property	Type	Example
`confidence`	`Confidence`	string	`"high"`

Radar Country Entered#

Radar Event Field	Mixpanel Event Property	Type	Example Value
`region.code`	`Region Code`	string	`"US"`
`region.name`	`Region Name`	string	`"United States"`
`confidence`	`Confidence`	string	`"high"`

Radar Country Exited#

Radar Event Field	Mixpanel Event Property	Type	Example Value
`region.code`	`Region Code`	string	`"US"`
`region.name`	`Region Name`	string	`"United States"`
`confidence`	`Confidence`	string	`"high"`

Radar State Entered#

Radar Event Field	Mixpanel Event Property	Type	Example Value
`region.code`	`Region Code`	string	`"MD"`
`region.name`	`Region Name`	string	`"Maryland"`
`confidence`	`Confidence`	string	`"high"`

Radar State Exited#

Radar Event Field	Mixpanel Event Property	Type	Example Value
`region.code`	`Region Code`	string	`"MD"`
`region.name`	`Region Name`	string	`"Maryland"`
`confidence`	`Confidence`	string	`"high"`

Radar DMA Entered#

Radar Event Field	Mixpanel Event Property	Type	Example Value
`region.code`	`Region Code`	string	`"26"`
`region.name`	`Region Name`	string	`"Baltimore"`
`confidence`	`Confidence`	string	`"high"`

Radar DMA Exited#

Radar Event Field	Mixpanel Event Property	Type	Example Value
`region.code`	`Region Code`	string	`"26"`
`region.name`	`Region Name`	string	`"Baltimore"`
`confidence`	`Confidence`	string	`"high"`

Radar Started Trip#

Radar Event Attribute	Mixpanel Event Property	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"`

Radar Updated Trip#

Radar Event Attribute	Mixpanel Event Property	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"`

Radar Approaching Trip Destination#

Radar Event Attribute	Mixpanel Event Property	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"`

Radar Arrived at Trip Destination#

Radar Event Attribute	Mixpanel Event Property	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"`

Radar Stopped Trip#

Radar Event Attribute	Mixpanel Event Property	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"`