Skip to main content

Amplitude

Radar can send events and user properties to Amplitude.

Use the Amplitude integration to enrich behavioral events with location context, measure the ROI of location-based features, and build location-based user segments.

Configuration#

On the Amplitude Manage Project page, copy your API key.

Then, on the Radar Integrations page under Amplitude, set Enabled to Yes and paste your API key. Note that you can set separate API keys for the Test and Live environments.

Whenever events are generated, Radar will send events and user properties to Amplitude.

User mapping#

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

Radar User FieldAmplitude User PropertyTypeExample ValueContext Type
userIduserIdstring"1"
deviceIddeviceIdstring"10974a2ee035770b9"
location.coordinates[0]location_lngnumber-76.350663
location.coordinates[1]location_latnumber39.525665
locationAuthorization[Radar] Location AuthorizationstringGRANTED_FOREGROUND
locationAccuracyAuthorization[Radar] Location Accuracy AuthorizationstringFULL
updatedAttimetimestamp"2018-06-22T15:23:39.000Z"
_id[Radar] IDstring"5b2c0906f5874b001aecfd8d"
segments[*].externalId[Radar] Segment External IDsarray[string]["starbucks-visitors"]
topChains[*].slug[Radar] Top Chain Slugsarray[string]["starbucks", "walmart"]
topChains[*].externalId[Radar] Top Chain External IDsarray[string]["123", "456"]
geofences[*]._id[Radar] Geofence IDsarray[string]["5b2c0906f5874b001aecfd8e"]Geofences
geofences[*].description[Radar] Geofence Descriptionsarray[string]["Store #123"]Geofences
geofences[*].tag[Radar] Geofence Tagsarray[string]["store"]Geofences
geofences[*].externalId[Radar] Geofence External IDsarray[string]["123"]Geofences
place._id[Radar] Place IDstring"59302bcf8f27e8a156bd4f91"Places
place.name[Radar] Place Namestring"Starbucks"Places
place.categories[Radar] Place Categoriesarray[string]["food-beverage", "cafe", "coffee-shop"]Places
place.chain.slug[Radar] Place Chain Slugstring"starbucks"Places
place.chain.name[Radar] Place Chain Namestring"Starbucks"Places
country.code[Radar] Region Country Codestring"US"Regions
country.name[Radar] Region Country Namestring"United States"Regions
state.code[Radar] Region State Codestring"MD"Regions
state.name[Radar] Region State Namestring"Maryland"Regions
dma.code[Radar] Region DMA Codestring"26"Regions
dma.name[Radar] Region DMA Namestring"Baltimore"Regions
postalCode.code[Radar] Region Postal Codestring"21014"Regions
trip.externalId[Radar] Trip External IDstring"299"Trip Tracking
trip.destinationGeofenceTag[Radar] Trip Destination Geofence Tagstring"store"Trip Tracking
trip.destinationGeofenceExternalId[Radar] Trip Destination Geofence External IDstring"123"Trip Tracking
beacons[*]._id[Radar] Beacon IDsarray[string]["5b2c0906f5874b001aecfd8f"]Beacons
beacons[*].description[Radar] Beacon Descriptionsarray[string]["Store #123 - Drive-Thru"]Beacons
beacons[*].tag[Radar] Beacon Tagsarray[string]["drive-thru"]Beacons
beacons[*].externalId[Radar] Beacon External IDsarray[string]["123"]Beacons

Event mapping#

Radar EventContext TypeAmplitude Event
user.entered_geofenceGeofences[Radar] Geofence Entered
user.exited_geofenceGeofences[Radar] Geofence Exited
user.dwelled_in_geofenceGeofences[Radar] Dwelled in Geofence
user.entered_placePlaces[Radar] Place Entered
user.exited_placePlaces[Radar] Place Exited
user.entered_region_countryRegions[Radar] Country Entered
user.exited_region_countryRegions[Radar] Country Exited
user.entered_region_stateRegions[Radar] State Entered
user.exited_region_stateRegions[Radar] State Exited
user.entered_region_dmaRegions[Radar] DMA Entered
user.exited_region_dmaRegions[Radar] DMA Exited
user.started_tripTrip Tracking[Radar] Started Trip
user.updated_tripTrip Tracking[Radar] Updated Trip
user.approaching_trip_destinationTrip Tracking[Radar] Approaching Trip Destination
user.arrived_at_trip_destinationTrip Tracking[Radar] Arrived at Trip Destination
user.stopped_tripTrip Tracking[Radar] Stopped Trip
user.entered_beaconBeacons[Radar] Beacon Entered
user.exited_beaconBeacons[Radar] Beacon Exited

[Radar] Geofence Entered#

Radar Event FieldAmplitude Event PropertyTypeExample Value
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"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Geofence Exited#

Radar Event FieldAmplitude Event PropertyTypeExample Value
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"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue
durationDurationnumber (minutes)42.1

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Dwelled in Geofence#

Radar Event FieldAmplitude Event PropertyTypeExample Value
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"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue
durationDurationnumber (minutes)5

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Place Entered#

Radar Event FieldAmplitude Event PropertyTypeExample Value
place._idPlace IDstring"59302bcf8f27e8a156bd4f91"
place.namePlace Namestring"Starbucks"
place.chain.slugPlace Chain Slugstring"starbucks"
place.chain.namePlace Chain Namestring"Starbucks"
place.categoriesPlace Categoriesarray[string]["food-beverage", "cafe", "coffee-shop"]
confidenceConfidencestring"high"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Place Exited#

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

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Country Entered#

Radar Event FieldAmplitude Event PropertyTypeExample Value
region.codeRegion Codestring"US"
region.nameRegion Namestring"United States"
confidenceConfidencestring"high"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Country Exited#

Radar Event FieldAmplitude Event PropertyTypeExample Value
region.codeRegion Codestring"US"
region.nameRegion Namestring"United States"
confidenceConfidencestring"high"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] State Entered#

Radar Event FieldAmplitude Event PropertyTypeExample Value
region.codeRegion Codestring"MD"
region.nameRegion Namestring"Maryland"
confidenceConfidencestring"high"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] State Exited#

Radar Event FieldAmplitude Event PropertyTypeExample Value
region.codeRegion Codestring"MD"
region.nameRegion Namestring"Maryland"
confidenceConfidencestring"high"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] DMA Entered#

Radar Event FieldAmplitude Event PropertyTypeExample Value
region.codeRegion Codestring"26"
region.nameRegion Namestring"Baltimore"
confidenceConfidencestring"high"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] DMA Exited#

Radar Event FieldAmplitude Event PropertyTypeExample Value
region.codeRegion Codestring"26"
region.nameRegion Namestring"Baltimore"
confidenceConfidencestring"high"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Started Trip#

Radar Event AttributeAmplitude Event PropertyTypeExample Value
trip.externalIdTrip External IDstring"299"
trip.metadata[{key}]Trip Metadata {key}{type}{value}
trip.destinationGeofenceTagTrip Destination Geofence Tagstring"store"
trip.destinationGeofenceExternalIdTrip Destination Geofence External IDstring"123"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Updated Trip#

Radar Event AttributeAmplitude Event PropertyTypeExample Value
trip.externalIdTrip External IDstring"299"
trip.metadata[{key}]Trip Metadata {key}{type}{value}
trip.destinationGeofenceTagTrip Destination Geofence Tagstring"store"
trip.destinationGeofenceExternalIdTrip Destination Geofence External IDstring"123"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Approaching Trip Destination#

Radar Event AttributeAmplitude Event PropertyTypeExample Value
trip.externalIdTrip External IDstring"299"
trip.metadata[{key}]Trip Metadata {key}{type}{value}
trip.destinationGeofenceTagTrip Destination Geofence Tagstring"store"
trip.destinationGeofenceExternalIdTrip Destination Geofence External IDstring"123"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Arrived at Trip Destination#

Radar Event AttributeAmplitude Event PropertyTypeExample Value
trip.externalIdTrip External IDstring"299"
trip.metadata[{key}]Trip Metadata {key}{type}{value}
trip.destinationGeofenceTagTrip Destination Geofence Tagstring"store"
trip.destinationGeofenceExternalIdTrip Destination Geofence External IDstring"123"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Stopped Trip#

Radar Event AttributeAmplitude Event PropertyTypeExample Value
trip.externalIdTrip External IDstring"299"
trip.metadata[{key}]Trip Metadata {key}{type}{value}
trip.destinationGeofenceTagTrip Destination Geofence Tagstring"store"
trip.destinationGeofenceExternalIdTrip Destination Geofence External IDstring"123"
accuracyAccuracynumber (meters)5
foregroundForegroundbooleantrue

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Beacon Entered#

Radar Event AttributeAmplitude Event PropertyTypeExample Value
beacon._idBeacon IDstring"5b2c0906f5874b001aecfd8f"
beacon.descriptionBeacon Descriptionstring"Store #123 - Drive-Thru"
beacon.tagBeacon Tagstring"drive-thru"
beacon.externalIdBeacon External IDstring"123"
beacon.metadata[{key}]Beacon Metadata {key}{type}{value}
confidenceConfidencestring"high"

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"

[Radar] Beacon Exited#

Radar Event AttributeAmplitude Event PropertyTypeExample Value
beacon._idBeacon IDstring"5b2c0906f5874b001aecfd8f"
beacon.descriptionBeacon Descriptionstring"Store #123 - Drive-Thru"
beacon.tagBeacon Tagstring"drive-thru"
beacon.externalIdBeacon External IDstring"123"
beacon.metadata[{key}]Beacon Metadata {key}{type}{value}
confidenceConfidencestring"high"
durationDurationnumber (minutes)1.42

If Regions is enabled, Radar will also send the following attributes:

Radar Event FieldAmplitude Event PropertyTypeExample Value
country.codeCountry Codestring"US"
country.nameCountry Namestring"United States"
state.codeState Codestring"MD"
state.nameState Namestring"Maryland"
dma.codeDMA Codestring"26"
dma.nameDMA Namestring"Baltimore"
postalCode.codePostal Codestring"21014"