Configuration
User mapping
Event mapping
user.entered_geofence
user.exited_geofence
user.entered_place
user.exited_place
user.entered_home
user.exited_home
user.entered_office
user.exited_office
user.started_traveling
user.stopped_traveling
user.entered_region_country
user.exited_region_country
user.entered_region_state
user.exited_region_state
user.entered_region_dma
user.exited_region_dma
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.
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.
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 |
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" |
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 |
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" |
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 |
Radar Event Field | Lytics Event Data Field | Type | Example |
---|---|---|---|
user.userId |
userUserId |
string | "1" |
user.deviceId |
userDeviceId |
string | "10974a2ee035770b9" |
confidence |
confidence |
string | "high" |
Radar Event Field | Lytics Event Data Field | Type | Example |
---|---|---|---|
user.userId |
userUserId |
string | "1" |
user.deviceId |
userDeviceId |
string | "10974a2ee035770b9" |
confidence |
confidence |
string | "high" |
Radar Event Field | Lytics Event Data Field | Type | Example |
---|---|---|---|
user.userId |
userUserId |
string | "1" |
user.deviceId |
userDeviceId |
string | "10974a2ee035770b9" |
confidence |
confidence |
string | "high" |
Radar Event Field | Lytics Event Data Field | Type | Example |
---|---|---|---|
user.userId |
userUserId |
string | "1" |
user.deviceId |
userDeviceId |
string | "10974a2ee035770b9" |
confidence |
confidence |
string | "high" |
Radar Event Field | Lytics Event Data Field | Type | Example |
---|---|---|---|
user.userId |
userUserId |
string | "1" |
user.deviceId |
userDeviceId |
string | "10974a2ee035770b9" |
confidence |
confidence |
string | "high" |
Radar Event Field | Lytics Event Data Field | Type | Example |
---|---|---|---|
user.userId |
userUserId |
string | "1" |
user.deviceId |
userDeviceId |
string | "10974a2ee035770b9" |
confidence |
confidence |
string | "high" |
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" |
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" |
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" |
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" |
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" |
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" |
Configuration
User mapping
Event mapping
user.entered_geofence
user.exited_geofence
user.entered_place
user.exited_place
user.entered_home
user.exited_home
user.entered_office
user.exited_office
user.started_traveling
user.stopped_traveling
user.entered_region_country
user.exited_region_country
user.entered_region_state
user.exited_region_state
user.entered_region_dma
user.exited_region_dma