Skip to main content

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 FieldMixpanel User PropertyTypeExample ValueContext Type
location.coordinates[1]$latitudenumber39.525665
location.coordinates[0]$lontigudenumber-76.350663
metadata.mixpanelDistinctId or userIdDistinct IDstring"1"
location.coordinates[0]Radar Location Longitudenumber-76.350663
location.coordinates[1]Radar Location Latitudenumber39.525665
_idRadar IDstring"5b2c0906f5874b001aecfd8d"
updatedAtRadar Updated Attimestamp"2018-06-22T15:23:39.000Z"
segments[*].externalIdRadar Segment External IDsarray[string]["starbucks-visitors"]
topChains[*].slugRadar Top Chain Slugsarray[string]["starbucks", "walmart"]
topChains[*].externalIdRadar Top Chain External IDsarray[string]["123", "456"]
geofences[*]._idRadar Geofence IDsarray[string]["5b2c0906f5874b001aecfd8e"]Geofences
geofences[*].descriptionRadar Geofence Descriptionsarray[string]["Store #123"]Geofences
geofences[*].tagRadar Geofence Tagsarray[string]["store"]Geofences
geofences[*].externalIdRadar Geofence External IDsarray[string]["123"]Geofences
place._idRadar Place IDstring"59302bcf8f27e8a156bd4f91"Places
place.nameRadar Place Namestring"Starbucks"Places
place.categoriesRadar Place Categoriesarray[string]["food-beverage", "cafe", "coffee-shop"]Places
place.chain.slugRadar Place Chain Slugstring"starbucks"Places
place.chain.nameRadar Place Chain Namestring"Starbucks"Places
insights.state.homeRadar Insights State HomebooleanfalseInsights
insights.state.officeRadar Insights State OfficebooleanfalseInsights
insights.state.travelingRadar Insights State TravelingbooleantrueInsights
country.codeRadar Region Country Codestring"US"Regions
country.nameRadar Region Country Namestring"United States"Regions
state.codeRadar Region State Codestring"MD"Regions
state.nameRadar Region State Namestring"Maryland"Regions
dma.codeRadar Region DMA Codestring"26"Regions
dma.nameRadar Region DMA Namestring"Baltimore"Regions
postalCode.codeRadar Region Postal Codestring"21014"Regions

Event mapping#

Radar EventContext TypeMixpanel Event
user.entered_geofenceGeofencesRadar Geofence Entered
user.exited_geofenceGeofencesRadar Geofence Exited
user.entered_placePlacesRadar Place Entered
user.exited_placePlacesRadar Place Exited
user.entered_homeInsightsRadar Home Entered
user.exited_homeInsightsRadar Home Exited
user.entered_officeInsightsRadar Office Entered
user.exited_officeInsightsRadar Office Exited
user.started_travelingInsightsRadar Traveling Started
user.stopped_travelingInsightsRadar Traveling Stopped
user.entered_region_countryRegionsRadar Country Entered
user.exited_region_countryRegionsRadar Country Exited
user.entered_region_stateRegionsRadar State Entered
user.exited_region_stateRegionsRadar State Exited
user.entered_region_dmaRegionsRadar DMA Entered
user.exited_region_dmaRegionsRadar DMA Exited

Radar Geofence Entered#

Radar Event FieldMixpanel Event PropertyTypeExample
geofence._idGeofence IDstring"5b2c0906f5874b001aecfd8e"
geofence.descriptionGeofence Descriptionstring"Store #123"
geofence.tagGeofence Tagstring"store"
geofence.externalIdGeofence External IDstring"123"
geofence.metadata[{key}]Geofence Metadata {key}{type}{value}
confidenceConfidencestring"high"

Radar Geofence Exited#

Radar Event FieldMixpanel Event PropertyTypeExample
geofence._idGeofence IDstring"5b2c0906f5874b001aecfd8e"
geofence.descriptionGeofence Descriptionstring"Store #123"
geofence.tagGeofence Tagstring"store"
geofence.externalIdGeofence External IDstring"123"
geofence.metadata[{key}]Geofence Metadata {key}{type}{value}
confidenceConfidencestring"high"
durationDurationnumber (minutes)42.1

Radar Place Entered#

Radar Event FieldMixpanel Event PropertyTypeExample
place._idPlace IDstring"59302bcf8f27e8a156bd4f91"
place.namePlace Namestring"Starbucks"
place.chain.slugPlace Chain IDstring"starbucks"
place.chain.namePlace Chain Namestring"Starbucks"
place.categoriesPlace Categoriesarray[string]["food-beverage", "cafe", "coffee-shop"]
confidenceConfidencestring"high"

Radar Place Exited#

Radar Event FieldMixpanel Event PropertyTypeExample
place._idPlace IDstring"59302bcf8f27e8a156bd4f91"
place.namePlace Namestring"Starbucks"
place.chain.slugPlace Chain IDstring"starbucks"
place.chain.namePlace Chain Namestring"Starbucks"
place.categoriesPlace Categoriesarray[string]["food-beverage", "cafe", "coffee-shop"]
confidenceConfidencestring"high"
durationDurationnumber (minutes)42.1

Radar Home Entered#

Radar Event FieldMixpanel Event PropertyTypeExample
confidenceConfidencestring"high"

Radar Home Exited#

Radar Event FieldMixpanel Event PropertyTypeExample
confidenceConfidencestring"high"

Radar Office Entered#

Radar Event FieldMixpanel Event PropertyTypeExample
confidenceConfidencestring"high"

Radar Office Exited#

Radar Event FieldMixpanel Event PropertyTypeExample
confidenceConfidencestring"high"

Radar Traveling Started#

Radar Event FieldMixpanel Event PropertyTypeExample
confidenceConfidencestring"high"

Radar Traveling Stopped#

Radar Event FieldMixpanel Event PropertyTypeExample
confidenceConfidencestring"high"

Radar Country Entered#

Radar Event FieldMixpanel Event PropertyTypeExample Value
region.codeRegion Codestring"US"
region.nameRegion Namestring"United States"
confidenceConfidencestring"high"

Radar Country Exited#

Radar Event FieldMixpanel Event PropertyTypeExample Value
region.codeRegion Codestring"US"
region.nameRegion Namestring"United States"
confidenceConfidencestring"high"

Radar State Entered#

Radar Event FieldMixpanel Event PropertyTypeExample Value
region.codeRegion Codestring"MD"
region.nameRegion Namestring"Maryland"
confidenceConfidencestring"high"

Radar State Exited#

Radar Event FieldMixpanel Event PropertyTypeExample Value
region.codeRegion Codestring"MD"
region.nameRegion Namestring"Maryland"
confidenceConfidencestring"high"

Radar DMA Entered#

Radar Event FieldMixpanel Event PropertyTypeExample Value
region.codeRegion Codestring"26"
region.nameRegion Namestring"Baltimore"
confidenceConfidencestring"high"

Radar DMA Exited#

Radar Event FieldMixpanel Event PropertyTypeExample Value
region.codeRegion Codestring"26"
region.nameRegion Namestring"Baltimore"
confidenceConfidencestring"high"