Lytics

Radar can send events and user state to Lytics.

Use the Lytics integration to build location-based user segments.

The Lytics integration is available on the Enterprise plan.

Configuration

Before enabling the integration, contact your Lytics account manager. After Lytics is configured, in Lytics, create an API token with no expiration and the Data Manager role.

Then, on the Radar Integrations page under Lytics, set Enabled to Yes, paste your API token. Note that you can set separate API tokens and stream names for the Test and Live environments.

Whenever events are generated, Radar will send events to the radar_events stream and user state to the radar_users stream.

User mapping

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

Radar User Field	Lytics User Data Field	Type	Example Value	Context Type
userId	radarUserId	string	"1"
deviceId	radarDeviceId	string	"10974a2ee035770b9"
location.coordinates[0]	radarLocationLongitude	number	-76.350663
location.coordinates[1]	radarLocationLatitude	number	39.525665
_id	radarId	string	"5b2c0906f5874b001aecfd8d"
updatedAt	radarUpdatedAt	timestamp	"2018-06-22T15:23:39.000Z"
segments[*].externalId	radarSegmentExternalIds	array[string]	["starbucks-visitors"]
topChains[*].slug	radarTopChainSlugs	array[string]	["starbucks", "walmart"]
topChains[*].externalId	radarTopChainExternalIds	array[string]	["123", "456"]
geofences[*]._id	radarGeofenceIds	array[string]	["5b2c0906f5874b001aecfd8e"]	Geofences
geofences[*].description	radarGeofenceDescriptions	array[string]	["Store #123"]	Geofences
geofences[*].tag	radarGeofenceTags	array[string]	["store"]	Geofences
geofences[*].externalId	radarGeofenceExternalIds	array[string]	["123"]	Geofences
place._id	radarPlaceId	string	"59302bcf8f27e8a156bd4f91"	Places
place.name	radarPlaceName	string	"Starbucks"	Places
place.categories	radarPlaceCategories	array[string]	["food-beverage", "cafe", "coffee-shop"]	Places
place.chain.slug	radarPlaceChainSlug	string	"starbucks"	Places
place.chain.name	radarPlaceChainName	string	"Starbucks"	Places
insights.state.home	radarInsightsStateHome	boolean	false	Insights
insights.state.office	radarInsightsStateOffice	boolean	false	Insights
insights.state.traveling	radarInsightsStateTraveling	boolean	true	Insights
country.code	radarRegionCountryCode	string	"US"	Regions
country.name	radarRegionCountryName	string	"United States"	Regions
state.code	radarRegionStateCode	string	"MD"	Regions
state.name	radarRegionStateName	string	"Maryland"	Regions
dma.code	radarRegionDMACode	string	"26"	Regions
dma.name	radarRegionDMAName	string	"Baltimore"	Regions
postalCode.code	radarRegionPostalCode	string	"21014"	Regions

Event mapping

user.entered_geofence

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
geofence._id	geofenceId	string	"5b2c0906f5874b001aecfd8e"
geofence.description	geofenceDescription	string	"Store #123"
geofence.tag	geofenceTag	string	"store"
geofence.externalId	geofenceExternalId	string	"123"
geofence.metadata[{key}]	geofenceMetadata{key}	{type}	{value}
confidence	confidence	string	"high"

user.exited_geofence

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
geofence._id	geofenceId	string	"5b2c0906f5874b001aecfd8e"
geofence.description	geofenceDescription	string	"Store #123"
geofence.tag	geofenceTag	string	"store"
geofence.externalId	geofenceExternalId	string	"123"
geofence.metadata[{key}]	geofenceMetadata{key}	{type}	{value}
confidence	confidence	string	"high"
duration	duration	number (minutes)	42.1

user.entered_place

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
place._id	placeId	string	"59302bcf8f27e8a156bd4f91"
place.name	placeName	string	"Starbucks"
place.chain.slug	placeChainSlug	string	"starbucks"
place.chain.name	placeChainName	string	"Starbucks"
place.categories	placeCategories	array[string]	["food-beverage", "cafe", "coffee-shop"]
confidence	confidence	string	"high"

user.exited_place

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
place._id	placeId	string	"59302bcf8f27e8a156bd4f91"
place.name	placeName	string	"Starbucks"
place.chain.slug	placeChainSlug	string	"starbucks"
place.chain.name	placeChainName	string	"Starbucks"
place.categories	placeCategories	array[string]	["food-beverage", "cafe", "coffee-shop"]
confidence	confidence	string	"high"
duration	duration	number (minutes)	42.1

user.entered_home

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
confidence	confidence	string	"high"

user.exited_home

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
confidence	confidence	string	"high"

user.entered_office

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
confidence	confidence	string	"high"

user.exited_office

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
confidence	confidence	string	"high"

user.started_traveling

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
confidence	confidence	string	"high"

user.stopped_traveling

Radar Event Field	Lytics Event Data Field	Type	Example
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
confidence	confidence	string	"high"

user.entered_region_country

Radar Event Field	Lytics Event Data Field	Type	Example Value
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
region.code	regionCode	string	"US"
region.name	regionName	string	"United States"
confidence	confidence	string	"high"

user.exited_region_country

Radar Event Field	Lytics Event Data Field	Type	Example Value
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
region.code	regionCode	string	"US"
region.name	regionName	string	"United States"
confidence	confidence	string	"high"

user.entered_region_state

Radar Event Field	Lytics Event Data Field	Type	Example Value
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
region.code	regionCode	string	"MD"
region.name	regionName	string	"Maryland"
confidence	confidence	string	"high"

user.exited_region_state

Radar Event Field	Lytics Event Data Field	Type	Example Value
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
region.code	regionCode	string	"MD"
region.name	regionName	string	"Maryland"
confidence	confidence	string	"high"

user.entered_region_dma

Radar Event Field	Lytics Event Data Field	Type	Example Value
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
region.code	regionCode	string	"26"
region.name	regionName	string	"Baltimore"
confidence	confidence	string	"high"

user.exited_region_dma

Radar Event Field	Lytics Event Data Field	Type	Example Value
user.userId	userUserId	string	"1"
user.deviceId	userDeviceId	string	"10974a2ee035770b9"
region.code	regionCode	string	"26"
region.name	regionName	string	"Baltimore"
confidence	confidence	string	"high"