Attentive - Radar

The Attentive integration is available on the Enterprise plan.

Radar can send events and user attributes to Attentive. Use the Attentive integration to send location-triggered and location-targeted messages to increase engagement and conversion.

Configuration

After logging in to the Attentive console, go to Marketplace and click Create app. Fill out the form to create your app, making sure to include the Write permission for Custom Events. Other permissions such as Subscribers, Custom Attributes, and Identity might be needed to assign users to subscription channels and modify their identifiers. Then, on the Radar Integrations page under Attentive, 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 custom events and user mappings to Attentive. Once Attentive is receiving Radar custom events, set up a Segment or Journey to create triggers from those events to send messages. By default, Radar userId maps to Attentive clientUserId. However, you can specify custom mappings by setting Radar metadata.attentiveUserId. For example, on iOS:

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

Event mapping

user.entered_geofence

Radar Event Field	Attentive Event Property	Type	Example Value
`geofence._id`	`geofence_id`	string	`"5b2c0906f5874b001aecfd8e"`
`geofence.description`	`geofence_description`	string	`"Store #123"`
`geofence.tag`	`geofence_tag`	string	`"store"`
`geofence.externalId`	`geofence_external_id`	string	`"123"`
`geofence.metadata[{key}]`	`geofence_metadata_{key}`	type	`{value}`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

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

Radar Event Field	Attentive Event Property	Type	Example Value
`country.code`	`country_code`	string	`"US"`
`country.name`	`country_name`	string	`"United States"`
`state.code`	`state_code`	string	`"MD"`
`state.name`	`state_name`	string	`"Maryland"`
`dma.code`	`dma_code`	string	`"26"`
`dma.name`	`dma_name`	string	`"Baltimore"`
`postalCode.code`	`postal_code`	string	`"21014"`

user.exited_geofence

Radar Event Field	Attentive Event Property	Type	Example Value
`geofence._id`	`geofence_id`	string	`"5b2c0906f5874b001aecfd8e"`
`geofence.description`	`geofence_description`	string	`"Store #123"`
`geofence.tag`	`geofence_tag`	string	`"store"`
`geofence.externalId`	`geofence_external_id`	string	`"123"`
`geofence.metadata[{key}]`	`geofence_metadata_{key}`	type	`{value}`
`confidence`	`confidence`	string	`"high"`
`duration`	`duration`	number (minutes)	`42.1`
`foreground`	`foreground`	boolean	`true`

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

Radar Event Field	Attentive Event Property	Type	Example Value
`country.code`	`country_code`	string	`"US"`
`country.name`	`country_name`	string	`"United States"`
`state.code`	`state_code`	string	`"MD"`
`state.name`	`state_name`	string	`"Maryland"`
`dma.code`	`dma_code`	string	`"26"`
`dma.name`	`dma_name`	string	`"Baltimore"`
`postalCode.code`	`postal_code`	string	`"21014"`

user.dwelled_in_geofence

Radar Event Field	Attentive Event Property	Type	Example Value
`geofence._id`	`geofence_id`	string	`"5b2c0906f5874b001aecfd8e"`
`geofence.description`	`geofence_description`	string	`"Store #123"`
`geofence.tag`	`geofence_tag`	string	`"store"`
`geofence.externalId`	`geofence_external_id`	string	`"123"`
`geofence.metadata[{key}]`	`geofence_metadata_{key}`	type	`{value}`
`confidence`	`confidence`	string	`"high"`
`duration`	`duration`	number (minutes)	`5`
`foreground`	`foreground`	boolean	`true`

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

Radar Event Field	Attentive Event Property	Type	Example Value
`country.code`	`country_code`	string	`"US"`
`country.name`	`country_name`	string	`"United States"`
`state.code`	`state_code`	string	`"MD"`
`state.name`	`state_name`	string	`"Maryland"`
`dma.code`	`dma_code`	string	`"26"`
`dma.name`	`dma_name`	string	`"Baltimore"`
`postalCode.code`	`postal_code`	string	`"21014"`

user.entered_place

Radar Event Field	Attentive Event Property	Type	Example Value
`place._id`	`place_id`	string	`"59302bcf8f27e8a156bd4f91"`
`place.name`	`place_name`	string	`"Starbucks"`
`place.chain.slug`	`place_chain_id`	string	`"starbucks"`
`place.chain.name`	`place_chain_name`	string	`"Starbucks"`
`place.chain.externalId`	`place_chain_external_id`	string	`"123"`
`place.chain.metadata[{key}]`	`place_chain_metadata_{key}`	type	`{value}`
`place.categories`	`place_categories`	string (comma-separated)	`"food-beverage,cafe,coffee-shop"`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

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

Radar Event Field	Attentive Event Property	Type	Example Value
`country.code`	`country_code`	string	`"US"`
`country.name`	`country_name`	string	`"United States"`
`state.code`	`state_code`	string	`"MD"`
`state.name`	`state_name`	string	`"Maryland"`
`dma.code`	`dma_code`	string	`"26"`
`dma.name`	`dma_name`	string	`"Baltimore"`
`postalCode.code`	`postal_code`	string	`"21014"`

user.exited_place

Radar Event Field	Attentive Event Property	Type	Example Value
`place._id`	`place_id`	string	`"59302bcf8f27e8a156bd4f91"`
`place.name`	`place_name`	string	`"Starbucks"`
`place.chain.slug`	`place_chain_id`	string	`"starbucks"`
`place.chain.name`	`place_chain_name`	string	`"Starbucks"`
`place.chain.externalId`	`place_chain_external_id`	string	`"123"`
`place.chain.metadata[{key}]`	`place_chain_metadata_{key}`	type	`{value}`
`place.categories`	`place_categories`	string (comma-separated)	`"food-beverage,cafe,coffee-shop"`
`confidence`	`confidence`	string	`"high"`
`duration`	`duration`	number (minutes)	`42.1`
`foreground`	`foreground`	boolean	`true`

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

Radar Event Field	Attentive Event Property	Type	Example Value
`country.code`	`country_code`	string	`"US"`
`country.name`	`country_name`	string	`"United States"`
`state.code`	`state_code`	string	`"MD"`
`state.name`	`state_name`	string	`"Maryland"`
`dma.code`	`dma_code`	string	`"26"`
`dma.name`	`dma_name`	string	`"Baltimore"`
`postalCode.code`	`postal_code`	string	`"21014"`

user.entered_country

Radar Event Attribute	Attentive Event Property	Type	Example Value
`region.code`	`region_code`	string	`"US"`
`region.name`	`region_name`	string	`"United States"`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

user.exited_country

Radar Event Attribute	Attentive Event Property	Type	Example Value
`region.code`	`region_code`	string	`"US"`
`region.name`	`region_name`	string	`"United States"`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

user.entered_state

Radar Event Attribute	Attentive Event Property	Type	Example Value
`region.code`	`region_code`	string	`"MD"`
`region.name`	`region_name`	string	`"Maryland"`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

user.exited_state

Radar Event Attribute	Attentive Event Property	Type	Example Value
`region.code`	`region_code`	string	`"MD"`
`region.name`	`region_name`	string	`"Maryland"`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

user.entered_dma

Radar Event Attribute	Attentive Event Property	Type	Example Value
`region.code`	`region_code`	string	`"26"`
`region.name`	`region_name`	string	`"Baltimore"`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

user.exited_dma

Radar Event Attribute	Attentive Event Property	Type	Example Value
`region.code`	`region_code`	string	`"26"`
`region.name`	`region_name`	string	`"Baltimore"`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

user.started_trip

Radar Event Attribute	Attentive Event Property	Type	Example Value
`trip.externalId`	`trip_external_id`	string	`"299"`
`trip.metadata[{key}]`	`trip_metadata_{key}`	type	`{value}`
`trip.destinationGeofenceTag`	`trip_destination_geofence_tag`	string	`"store"`
`trip.destinationGeofenceExternalId`	`trip_destination_geofence_external_id`	string	`"123"`
`foreground`	`foreground`	boolean	`true`

user.updated_trip

Radar Event Attribute	Attentive Event Property	Type	Example Value
`trip.externalId`	`trip_external_id`	string	`"299"`
`trip.metadata[{key}]`	`trip_metadata_{key}`	type	`{value}`
`trip.destinationGeofenceTag`	`trip_destination_geofence_tag`	string	`"store"`
`trip.destinationGeofenceExternalId`	`trip_destination_geofence_external_id`	string	`"123"`
`foreground`	`foreground`	boolean	`true`

user.approaching_trip_destination

Radar Event Attribute	Attentive Event Property	Type	Example Value
`trip.externalId`	`trip_external_id`	string	`"299"`
`trip.metadata[{key}]`	`trip_metadata_{key}`	type	`{value}`
`trip.destinationGeofenceTag`	`trip_destination_geofence_tag`	string	`"store"`
`trip.destinationGeofenceExternalId`	`trip_destination_geofence_external_id`	string	`"123"`
`foreground`	`foreground`	boolean	`true`

user.arrived_at_trip_destination

Radar Event Attribute	Attentive Event Property	Type	Example Value
`trip.externalId`	`trip_external_id`	string	`"299"`
`trip.metadata[{key}]`	`trip_metadata_{key}`	type	`{value}`
`trip.destinationGeofenceTag`	`trip_destination_geofence_tag`	string	`"store"`
`trip.destinationGeofenceExternalId`	`trip_destination_geofence_external_id`	string	`"123"`
`foreground`	`foreground`	boolean	`true`

user.stopped_trip

Radar Event Attribute	Attentive Event Property	Type	Example Value
`trip.externalId`	`trip_external_id`	string	`"299"`
`trip.metadata[{key}]`	`trip_metadata_{key}`	type	`{value}`
`trip.destinationGeofenceTag`	`trip_destination_geofence_tag`	string	`"store"`
`trip.destinationGeofenceExternalId`	`trip_destination_geofence_external_id`	string	`"123"`
`foreground`	`foreground`	boolean	`true`

user.entered_beacon

Radar Event Attribute	Attentive Event Property	Type	Example Value
`beacon._id`	`beacon_id`	string	`"5b2c0906f5874b001aecfd8f"`
`beacon.description`	`beacon_description`	string	`"Store #123 - Drive-Thru"`
`beacon.tag`	`beacon_tag`	string	`"drive-thru"`
`beacon.externalId`	`beacon_external_id`	string	`"123"`
`beacon.metadata[{key}]`	`trip_metadata_{key}`	type	`{value}`
`confidence`	`confidence`	string	`"high"`
`foreground`	`foreground`	boolean	`true`

user.exited_beacon

Radar Event Attribute	Attentive Event Property	Type	Example Value
`beacon._id`	`beacon_id`	string	`"5b2c0906f5874b001aecfd8f"`
`beacon.description`	`beacon_description`	string	`"Store #123 - Drive-Thru"`
`beacon.tag`	`beacon_tag`	string	`"drive-thru"`
`beacon.externalId`	`beacon_external_id`	string	`"123"`
`beacon.metadata[{key}]`	`beacon_metadata_{key}`	type	`{value}`
`confidence`	`confidence`	string	`"high"`
`duration`	`radar_duration`	number (minutes)	`1.42`
`foreground`	`foreground`	boolean	`true`

⌘I