Documentation / Product / Integrations / Radar

Radar: Event Integration

The Radar event integration with Lytics imports Radar's location context data in real-time which surface as user profile fields which can be used in the Lytics audience builder. Lytics Audiences using Radar data can be used to activate location-based experiences in real-time. This document covers the following topics:

Integration Details

The integration is an event integration configured in the Radar application which sends Radar data to the Lytics streams radar_events and radar_users.

Fields

See Radar's Lytics documentation reference for details on how Radar data is received by Lytics streams. The tables below describe how that raw data the streams are mapped as user fields on the Lytics profile.

Note: Unique identifiers are not included in the default mapping for these streams. As mentioned below in the configuration step, during the integrations setup process please discuss which fields you would like to use as unique identifiers for your Radar data.

The following fields are included in the default mapping of the radar_users stream:

Source FieldLytics User FieldDescriptionType
radarLocationLatituderadar_location_latitudeCurrent Radar Location Latitudestring
radarLocationLongituderadar_location_longitudeCurrent Radar Location Longitudestring
radarUpdatedAtradar_updated_atCurrent Radar Location Updatedate
radarGeofenceIdsradar_geofence_idsCurrent Radar Geofence Ids[]string
radarGeofenceDescriptionsradar_geofence_descriptionsCurrent Radar Geofence Descriptions[]string
radarGeofenceTagsradar_geofence_tagsCurrent Radar Geofence Tags[]string
radarGeofenceExternalIdsradar_geofence_external_idsCurrent Radar Geofence External Ids[]string
radarRegionCountryCoderadar_region_country_codeCurrent Radar Region Country Codestring
radarRegionCountryNameradar_region_country_nameCurrent Radar Region Country Namestring
radarRegionStateCoderadar_region_state_codeCurrent Radar Region State Codestring
radarRegionStateNameradar_region_state_nameCurrent Radar Region State Namestring
radarRegionPostalCoderadar_region_postal_codeCurrent Radar Region Postal Codestring
radarRegionDMACoderadar_region_dma_codeCurrent Radar Region DMA Codestring
radarRegionDMANameradar_region_dma_nameCurrent Radar Region DMA Namestring
radarPlaceIdradar_place_idCurrent Radar Place Idstring
radarPlaceNameradar_place_nameCurrent Radar Place Namestring
radarPlaceFacebookIdradar_place_facebook_idCurrent Radar Place Facebook Idstring
radarPlaceCategoriesradar_place_categoriesCurrent Radar Place Categories[]string
radarPlaceChainSlugradar_place_chain_slugCurrent Radar Place Chain Slugstring
radarPlaceChainNameradar_place_chain_nameCurrent Radar Place Chain Namestring
radarPlaceChainExternalIdradar_place_chain_external_idCurrent Radar Place Chain External Idstring
radarInsightsStateHomeradar_insights_state_homeRadar Insights State Homestring
radarInsightsStateOfficeradar_insights_state_officeRadar Insights State Officestring
radarInsightsStateTravelingradar_insights_state_travelingRadar Insights State Travelingstring


The following fields are included in the default mapping of the radar_events stream:

Source FieldLytics User FieldDescriptionType
geofenceId
last_entered_ts_by_geofenceId
last_exited_ts_by_geofenceId
Last Entered Timestamp by Geofence Id
map[string]date
map[string]date
geofenceDescriptionlast_entered_ts_by_geofenceDescription
last_exited_ts_by_geofenceDescription
Last Entered Timestamp by Geofence Description
map[string]date
map[string]date
geofenceExternalIdlast_entered_ts_by_geofenceExtId
last_exited_ts_by_geofenceExtId
Last Entered Timestamp by Geofence External ID
Last Exited Timestamp by Geofence External ID
map[string]date
map[string]date
geofenceTaglast_geofence_tagsLast Geofence Tags[]string
placeIdlast_entered_ts_by_placeId
last_exited_ts_by_placeId
Last Entered Timestamp by Place ID
Last Exited Timestamp by Place ID
map[string]date
map[string]date
placeNamelast_entered_ts_by_placeName
last_exited_ts_by_placeName
Last Entered Timestamp by Place Name
Last Exited Timestamp by Place Name
map[string]date
map[string]date
placeCategorieslast_place_categoriesLast Place Categories[]string
timestamplast_entered_home
last_exited_home
last_entered_office
last_started_traveling
last_stopped_traveling
Last Entered Home
Last Exited Home
Last Entered Office
Last Started Traveling
Last Stopped Traveling
date
date
date
date
date
regionCodelast_entered_ts_by_regionCode
last_exited_ts_by_regionCode
Last Entered Timestamp by Country Code
Last Exited Timestamp by Country Code
map[string]date
map[string]date
regionCodelast_entered_ts_by_regionCode
last_exited_ts_by_regionCode
Last Entered Timestamp by State Code
Last Exited Timestamp by State Code
map[string]date
map[string]date
regionCodelast_entered_ts_by_regionCode
last_exited_ts_by_regionCode
Last Entered Timestamp by Region DMA
Last Exited Timestamp by Region DMA
map[string]date
map[string]date
regionNamelast_entered_ts_by_regionName
last_exited_ts_by_regionName
Last Entered Timestamp by Country
Last Exited Timestamp by Country
map[string]date
map[string]date
regionNamelast_entered_ts_by_regionName
last_exited_ts_by_regionName
Last Entered Timestamp by State
Last Exited Timestamp by State
map[string]date
map[string]date
regionNamelast_entered_ts_by_regionName
last_exited_ts_by_regionName
Last Entered Timestamp by Region DMA
Last Exited Timestamp by Region DMA
map[string]date
map[string]date

Configuration

Listed below are instructions on how to setup and configure the Radar event integration.

  1. Contact your Lytics account manager to enable the Radar integration. Please include details regarding the fields you would like to use as unique identifiers for this integration.
  2. Generate an API token with the Data Manager role and no expiration date.
  3. In the Radar app, follow the configuration steps described in the Radar documentation for this integration.

Once the integration is enabled, you should see data being received in the radar_events and the radar_users streams.

radar_events stream