Skip to main content

AWS Pinpoint

Radar can send events and user attributes to AWS Pinpoint.

Use the Pinpoint integration to send location-triggered and location-targeted messages to increase engagement and conversion.

Configuration#

In the Pinpoint console page, under All projects, find your Project name and the corresponding Project ID. You will also need to get your access key and secret access key, which you can find under the AWS Identity and Access Management (IAM) console under Access Keys. Note that you will need to provide AWS keys that have IAM permissions for Pinpoint operations.

Then, on the Radar Integrations page under AWS Pinpoint, set Enabled to Yes and paste your AWS access key, your AWS secret key, and your Pinpoint Project ID. You can set separate access keys and project IDs for each of your Radar Test and Live environments. Finally, select your AWS region.

Whenever events are generated, Radar will send custom events and user attributes to Pinpoint. Events and user attributes from iOS devices will be sent using your iOS app identifiers, and events and user attributes from Android devices will be sent using your Android app identifiers.

To map a Radar user to a Pinpoint endpoint ID, you must specify a custom mapping by setting Radar metadata.awsPinpointEndpointId. For example, on iOS:

// track users with custom userId mapping (not required if using default mapping)Radar.setMetadata(["awsPinpointEndpointId": endpointid])

User mapping#

Note that Radar uses the string [] to represent null user attribute values.

Radar User FieldPinpoint User AttributeTypeExample ValueContext Type
userIdUserIdstring"1"
_idRadarIdarray[string]["5b2c0906f5874b001aecfd8d"]
location.coordinates[1]RadarLocationLatitudearray[string][39.525665]
location.coordinates[0]RadarLocationLongitudearray[string][-76.350663]
locationAuthorizationRadarLocationAuthorizationarray[string]["GRANTED_FOREGROUND"]
locationAccuracyAuthorizationRadarLocationAccuracyAuthorizationarray[string]["FULL"]
updatedAtRadarUpdatedAtarray[string]["2018-06-22T15:23:39.000Z"]
segments[*].externalIdRadarSegmentExternalIdsarray[string]["starbucks-visitors"]
topChains[*].slugRadarTopChainSlugsarray[string]["starbucks", "walmart"]
topChains[*].externalIdRadarTopChainExternalIdsarray[string]["123", "456"]
geofences[*]._idRadarGeofenceIdsarray[string]["5b2c0906f5874b001aecfd8e"]Geofences
geofences[*].descriptionRadarGeofenceDescriptionsarray[string]["Store #123"]Geofences
geofences[*].tagRadarGeofenceTagsarray[string]["store"]Geofences
geofences[*].externalIdRadarGeofenceExternalIdsarray[string]["123"]Geofences
place._idRadarPlaceIdarray[string]["59302bcf8f27e8a156bd4f91"]Places
place.nameRadarPlaceNamearray[string]["Starbucks"]Places
place.categoriesRadarPlaceCategoriesarray[string]["food-beverage", "cafe", "coffee-shop"]Places
place.chain.slugRadarPlaceChainIdarray[string]["starbucks"]Places
place.chain.nameRadarPlaceChainNamearray[string]["Starbucks"]Places
country.codeRadarRegionCountryCodearray[string]["US"]Regions
country.nameRadarRegionCountryNamearray[string]["United States"]Regions
state.codeRadarRegionStateCodearray[string]["MD"]Regions
state.nameRadarRegionStateNamearray[string]["Maryland"]Regions
dma.codeRadarRegionDmaCodearray[string]["26"]Regions
dma.nameRadarRegionDmaNamearray[string]["Baltimore"]Regions
postalCode.codeRadarRegionPostalCodearray[string]["21014"]Regions
trip.externalIdRadarTripExternalIdarray[string]["299"]Trip Tracking
trip.destinationGeofenceTagRadarTripDestinationGeofenceTagarray[string]["store"]Trip Tracking
trip.destinationGeofenceExternalIdRadarTripDestinationGeofenceExternalIdarray[string]["123"]Trip Tracking
beacons[*]._idRadarBeaconIdsarray[string]["5b2c0906f5874b001aecfd8f"]Beacons
beacons[*].descriptionRadarBeaconDescriptionsarray[string]["Store #123 - Drive-Thru"]Beacons
beacons[*].tagRadarBeaconTagsarray[string]["drive-thru"]Beacons
beacons[*].externalIdRadarBeaconExternalIdsarray[string]["123"]Beacons

Event mapping#

user.entered_geofence#

Radar Event FieldPinpoint Event AttributeTypeExample Value
geofence._idGeofenceIdstring"5b2c0906f5874b001aecfd8e"
geofence.descriptionGeofenceDescriptionstring"Store #123"
geofence.tagGeofenceTagstring"store"
geofence.externalIdGeofenceExternalIdstring"123"
geofence.metadata[{key}]GeofenceMetadata{key}string"value"
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

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

Radar Event FieldPinpoint Event AttributeTypeExample Value
country.codeCountryCodestring"US"
country.nameCountryNamestring"United States"
state.codeStateCodestring"MD"
state.nameStateNamestring"Maryland"
dma.codeDmaCodestring"26"
dma.nameDmaNamestring"Baltimore"
postalCode.codePostalCodestring"21014"

user.exited_geofence#

Radar Event FieldPinpoint Event AttributeTypeExample Value
geofence._idGeofenceIdstring"5b2c0906f5874b001aecfd8e"
geofence.descriptionGeofenceDescriptionstring"Store #123"
geofence.tagGeofenceTagstring"store"
geofence.externalIdGeofenceExternalIdstring"123"
geofence.metadata[{key}]GeofenceMetadata{key}string"value"
confidenceConfidencestring"high"
durationDurationstring"42.1"
foregroundForegroundbooleantrue

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

Radar Event FieldPinpoint Event AttributeTypeExample Value
country.codeCountryCodestring"US"
country.nameCountryNamestring"United States"
state.codeStateCodestring"MD"
state.nameStateNamestring"Maryland"
dma.codeDmaCodestring"26"
dma.nameDmaNamestring"Baltimore"
postalCode.codePostalCodestring"21014"

user.dwelled_in_geofence#

Radar Event FieldPinpoint Event AttributeTypeExample Value
geofence._idGeofenceIdstring"5b2c0906f5874b001aecfd8e"
geofence.descriptionGeofenceDescriptionstring"Store #123"
geofence.tagGeofenceTagstring"store"
geofence.externalIdGeofenceExternalIdstring"123"
geofence.metadata[{key}]GeofenceMetadata{key}string"value"
confidenceConfidencestring"high"
durationDurationstring"5"
foregroundForegroundbooleantrue

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

Radar Event FieldPinpoint Event AttributeTypeExample Value
country.codeCountryCodestring"US"
country.nameCountryNamestring"United States"
state.codeStateCodestring"MD"
state.nameStateNamestring"Maryland"
dma.codeDmaCodestring"26"
dma.nameDmaNamestring"Baltimore"
postalCode.codePostalCodestring"21014"

user.entered_place#

Radar Event FieldPinpoint Event AttributeTypeExample Value
place._idPlaceIdstring"59302bcf8f27e8a156bd4f91"
place.namePlaceNamestring"Starbucks"
place.chain.slugPlaceChainIdstring"starbucks"
place.chain.namePlaceChainNamestring"Starbucks"
place.chain.externalIdPlaceChainExternalIdstring"123"
place.chain.metadata[{key}]PlaceChainMetadata{key}string"value"
place.categoriesPlaceCategoriesstring (comma-separated)"food-beverage,cafe,coffee-shop"
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

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

Radar Event FieldPinpoint Event AttributeTypeExample Value
country.codeCountryCodestring"US"
country.nameCountryNamestring"United States"
state.codeStateCodestring"MD"
state.nameStateNamestring"Maryland"
dma.codeDmaCodestring"26"
dma.nameDmaNamestring"Baltimore"
postalCode.codePostalCodestring"21014"

user.exited_place#

Radar Event FieldPinpoint Event AttributeTypeExample Value
place._idPlaceIdstring"59302bcf8f27e8a156bd4f91"
place.namePlaceNamestring"Starbucks"
place.chain.slugPlaceChainIdstring"starbucks"
place.chain.namePlaceChainNamestring"Starbucks"
place.chain.externalIdPlaceChainExternalIdstring"123"
place.chain.metadata[{key}]PlaceChainMetadata{key}string"string"
place.categoriesPlaceCategoriesstring (comma-separated)"food-beverage,cafe,coffee-shop"
confidenceConfidencestring"high"
durationDurationstring"42.1"
foregroundForegroundbooleantrue

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

Radar Event FieldPinpoint Event AttributeTypeExample Value
country.codeCountryCodestring"US"
country.nameCountryNamestring"United States"
state.codeStateCodestring"MD"
state.nameStateNamestring"Maryland"
dma.codeDmaCodestring"26"
dma.nameDmaNamestring"Baltimore"
postalCode.codePostalCodestring"21014"

user.entered_region_country#

Radar Event AttributePinpoint Event AttributeTypeExample Value
region.codeRegionCodestring"US"
region.nameRegionNamestring"United States"
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

user.exited_region_country#

Radar Event AttributePinpoint Event AttributeTypeExample Value
region.codeRegionCodestring"US"
region.nameRegionNamestring"United States"
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

user.entered_region_state#

Radar Event AttributePinpoint Event AttributeTypeExample Value
region.codeRegionCodestring"MD"
region.nameRegionNamestring"Maryland"
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

user.exited_region_state#

Radar Event AttributePinpoint Event AttributeTypeExample Value
region.codeRegionCodestring"MD"
region.nameRegionNamestring"Maryland"
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

user.entered_region_dma#

Radar Event AttributePinpoint Event AttributeTypeExample Value
region.codeRegionCodestring"26"
region.nameRegionNamestring"Baltimore"
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

user.exited_region_dma#

Radar Event AttributePinpoint Event AttributeTypeExample Value
region.codeRegionCodestring"26"
region.nameRegionNamestring"Baltimore"
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

user.started_trip#

Radar Event AttributePinpoint Event AttributeTypeExample Value
trip.externalIdTripExternalIdstring"299"
trip.metadata[{key}]TripMetadata{key}string"value"
trip.destinationGeofenceTagTripDestinationGeofenceTagstring"store"
trip.destinationGeofenceExternalIdTripDestinationGeofenceExternalIdstring"123"
foregroundForegroundbooleantrue

user.approaching_trip_destination#

Radar Event AttributePinpoint Event AttributeTypeExample Value
trip.externalIdTripExternalIdstring"299"
trip.metadata[{key}]TripMetadata{key}string"value"
trip.destinationGeofenceTagTripDestinationGeofenceTagstring"store"
trip.destinationGeofenceExternalIdTripDestinationGeofenceExternalIdstring"123"
foregroundForegroundbooleantrue

user.arrived_at_trip_destination#

Radar Event AttributePinpoint Event AttributeTypeExample Value
trip.externalIdTripExternalIdstring"299"
trip.metadata[{key}]TripMetadata{key}string"value"
trip.destinationGeofenceTagTripDestinationGeofenceTagstring"store"
trip.destinationGeofenceExternalIdTripDestinationGeofenceExternalIdstring"123"
foregroundForegroundbooleantrue

user.stopped_trip#

Radar Event AttributePinpoint Event AttributeTypeExample Value
trip.externalIdTripExternalIdstring"299"
trip.metadata[{key}]TripMetadata{key}string"value"
trip.destinationGeofenceTagTripDestinationGeofenceTagstring"store"
trip.destinationGeofenceExternalIdTripDestinationGeofenceExternalIdstring"123"
foregroundForegroundbooleantrue

user.entered_beacon#

Radar Event AttributePinpoint Event AttributeTypeExample Value
beacon._idBeaconIdstring"5b2c0906f5874b001aecfd8f"
beacon.descriptionBeaconDescriptionstring"Store #123 - Drive-Thru"
beacon.tagBeaconTagstring"drive-thru"
beacon.externalIdBeaconExternalIdstring"123"
beacon.metadata[{key}]BeaconMetadata{key}{type}{value}
confidenceConfidencestring"high"
foregroundForegroundbooleantrue

user.exited_beacon#

Radar Event AttributePinpoint Event AttributeTypeExample Value
beacon._idBeaconIdstring"5b2c0906f5874b001aecfd8f"
beacon.descriptionBeaconDescriptionstring"Store #123 - Drive-Thru"
beacon.tagBeaconTagstring"drive-thru"
beacon.externalIdBeaconExternalIdstring"123"
beacon.metadata[{key}]BeaconMetadata{key}{type}{value}
confidenceConfidencestring"high"
durationDurationnumber (minutes)1.42
foregroundForegroundbooleantrue