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

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"