Lytics

The Lytics integration is available on the Enterprise plan.

Radar can send events and user state to Lytics.

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

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
locationAuthorization	radarLocationAuthorization	string	"GRANTED_FOREGROUND"
locationAccuracyAuthorization	radarLocationAccuracyAuthorization	string	"FULL"
_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
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
trip.externalId	radarTripExternalId	string	"299"	Trip Tracking
trip.destinationGeofenceTag	radarTripDestinationGeofenceTag	string	"store"	Trip Tracking
trip.destinationGeofenceExternalId	radarTripDestinationGeofenceExternalId	string	"123"	Trip Tracking
beacons[*]._id	radarBeaconIds	array[string]	["5b2c0906f5874b001aecfd8f"]	Beacons
beacons[*].description	radarBeaconDescriptions	array[string]	["Store #123 - Drive-Thru"]	Beacons
beacons[*].tag	radarBeaconTags	array[string]	["drive-thru"]	Beacons
beacons[*].externalId	radarBeaconExternalIds	array[string]	["123"]	Beacons

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"
foreground	foreground	boolean	true

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
foreground	foreground	boolean	true

user.dwelled_in_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)	5
foreground	foreground	boolean	true

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"
foreground	foreground	boolean	true

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
foreground	foreground	boolean	true

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"
foreground	foreground	boolean	true

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"
foreground	foreground	boolean	true

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"
foreground	foreground	boolean	true

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"
foreground	foreground	boolean	true

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"
foreground	foreground	boolean	true

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"
foreground	foreground	boolean	true

user.started_trip

Radar Event Attribute	Lytics Event Data Field	Type	Example Value
trip.externalId	tripExternalId	string	"299"
trip.metadata[{key}]	tripMetadata{key}	{type}	{value}
trip.destinationGeofenceTag	tripDestinationGeofenceTag	string	"store"
trip.destinationGeofenceExternalId	tripDestinationGeofenceExternalId	string	"123"
foreground	foreground	boolean	true

user.updated_trip

Radar Event Attribute	Lytics Event Data Field	Type	Example Value
trip.externalId	tripExternalId	string	"299"
trip.metadata[{key}]	tripMetadata{key}	{type}	{value}
trip.destinationGeofenceTag	tripDestinationGeofenceTag	string	"store"
trip.destinationGeofenceExternalId	tripDestinationGeofenceExternalId	string	"123"
foreground	foreground	boolean	true

user.approaching_trip_destination

Radar Event Attribute	Lytics Event Data Field	Type	Example Value
trip.externalId	tripExternalId	string	"299"
trip.metadata[{key}]	tripMetadata{key}	{type}	{value}
trip.destinationGeofenceTag	tripDestinationGeofenceTag	string	"store"
trip.destinationGeofenceExternalId	tripDestinationGeofenceExternalId	string	"123"
foreground	foreground	boolean	true

user.arrived_at_trip_destination

Radar Event Attribute	Lytics Event Data Field	Type	Example Value
trip.externalId	tripExternalId	string	"299"
trip.metadata[{key}]	tripMetadata{key}	{type}	{value}
trip.destinationGeofenceTag	tripDestinationGeofenceTag	string	"store"
trip.destinationGeofenceExternalId	tripDestinationGeofenceExternalId	string	"123"
foreground	foreground	boolean	true

user.stopped_trip

Radar Event Attribute	Lytics Event Data Field	Type	Example Value
trip.externalId	tripExternalId	string	"299"
trip.metadata[{key}]	tripMetadata{key}	{type}	{value}
trip.destinationGeofenceTag	tripDestinationGeofenceTag	string	"store"
trip.destinationGeofenceExternalId	tripDestinationGeofenceExternalId	string	"123"
foreground	foreground	boolean	true

user.entered_beacon

Radar Event Attribute	Lytics Event Data Field	Type	Example Value
beacon._id	beaconId	string	"5b2c0906f5874b001aecfd8f"
beacon.description	beaconDescription	string	"Store #123 - Drive-Thru"
beacon.tag	beaconTag	string	"drive-thru"
beacon.externalId	beaconExternalId	string	"123"
beacon.metadata[{key}]	beaconMetadata{key}	{type}	{value}
confidence	confidence	string	"high"
foreground	foreground	boolean	true

user.exited_beacon

Radar Event Attribute	Lytics Event Data Field	Type	Example Value
beacon._id	beaconId	string	"5b2c0906f5874b001aecfd8f"
beacon.description	beaconDescription	string	"Store #123 - Drive-Thru"
beacon.tag	beaconTag	string	"drive-thru"
beacon.externalId	beaconExternalId	string	"123"
beacon.metadata[{key}]	beaconMetadata{key}	{type}	{value}
confidence	confidence	string	"high"
duration	duration	number (minutes)	1.42
foreground	foreground	boolean	true