Skip to main content

Airship

Radar can send events and tags to Airship.

Use the Airship integration to send location-triggered and location-targeted messages to increase engagement and conversion, measure the ROI of location-based messaging, and build location-based user segments.

The Airship integration is available on the Team plan or higher.

Configuration#

On the Airship APIs & Integrations page, create a custom event token and copy the app key and access token. Under Partner Integrations, enable Radar to enable auto-population of custom event names and properties in the Airship Automation Composer.

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

Whenever events are generated, Radar will send custom events and tags to Airship. Note that for tags to populate, you must manually create tag groups in Airship first.

If you are using Airship SDK 13.x or earlier with Radar iOS SDK 3.0.4 or earlier or Radar Android SDK 3.0.6 or earlier, the Radar SDK will automatically collect Airship channel ID and Airship session ID. However, if you are using Airship SDK 14.0 or later with Radar iOS SDK 3.0.5 or later or Radar Android SDK 3.0.7 or later, you must set Radar metadata.airshipChannelId and metadata.airshipSessionId manually to collect Airship channel ID and Airship session ID. For example, on iOS:

Radar.setMetadata([
"airshipChannelId": channelId,
"airshipSessionId": sessionId
])

User mapping#

Radar User FieldAirship Tag Group NameTypeExample TagContext Type
location.coordinates[0]radar_location_longitudenumber-76.350663
location.coordinates[1]radar_location_latitudenumber39.525665
updatedAtradar_updated_attimestamp"2018-06-22T15:23:39.000Z"
segments[*].externalIdradar_segment_external_idsstring"starbucks-visitors"
topChains[*].slugradar_top_chain_slugsstring"starbucks"
topChains[*].externalIdradar_top_chain_external_idsstring"123"
geofences[*]._idradar_geofence_idsstring"5b2c0906f5874b001aecfd8e"Geofences
geofences[*].descriptionradar_geofence_descriptionsstring"Store #123"Geofences
geofences[*].tagradar_geofence_tagsstring"store"Geofences
geofences[*].externalIdradar_geofence_external_idsstring"123"Geofences
place._idradar_place_idstring"59302bcf8f27e8a156bd4f91"Places
place.nameradar_place_namestring"Starbucks"Places
place.categoriesradar_place_categoriesstring"coffee-shop"Places
place.chain.slugradar_place_chain_slugstring"starbucks"Places
place.chain.nameradar_place_chain_namestring"Starbucks"Places
insights.state.homeradar_insights_state_homebooleanfalseInsights
insights.state.officeradar_insights_state_officebooleanfalseInsights
insights.state.travelingradar_insights_state_travelingbooleantrueInsights
country.coderadar_region_country_codestring"US"Regions
country.nameradar_region_country_namestring"United States"Regions
state.coderadar_region_state_codestring"MD"Regions
state.nameradar_region_state_namestring"Maryland"Regions
dma.coderadar_region_dma_codestring"26"Regions
dma.nameradar_region_dma_namestring"Baltimore"Regions
postalCode.coderadar_region_postal_codestring"21014"Regions
beacons[*]._idradar_beacon_idsstring"5b2c0906f5874b001aecfd8f"Beacons
beacons[*].descriptionradar_beacons_descriptionsstring"Store #123 - Drive-Thru"Beacons
beacons[*].tagradar_beacon_tagsstring"drive-thru"Beacons
beacons[*].externalIdradar_beacon_external_idsstring"123"Beacons

Event mapping#

Radar EventContext TypeAirship Event
user.entered_geofenceGeofencesradar_geofence_entered
user.exited_geofenceGeofencesradar_geofence_exited
user.entered_placePlacesradar_place_entered
user.exited_placePlacesradar_place_exited
user.entered_homeInsightsradar_home_entered
user.exited_homeInsightsradar_home_exited
user.entered_officeInsightsradar_office_entered
user.exited_officeInsightsradar_office_exited
user.started_travelingInsightsradar_traveling_started
user.stopped_travelingInsightsradar_traveling_stopped
user.entered_region_countryRegionsradar_country_entered
user.exited_region_countryRegionsradar_country_exited
user.entered_region_stateRegionsradar_state_entered
user.exited_region_stateRegionsradar_state_exited
user.entered_region_dmaRegionsradar_dma_entered
user.exited_region_dmaRegionsradar_dma_exited
user.started_tripTrip Trackingradar_started_trip
user.updated_tripTrip Trackingradar_updated_trip
user.approaching_trip_destinationTrip Trackingradar_approaching_trip_destination
user.arrived_at_trip_destinationTrip Trackingradar_arrived_at_trip_destination
user.stopped_tripTrip Trackingradar_stopped_trip
user.entered_beaconBeaconsradar_entered_beacon
user.exited_beaconBeaconsradar_beacon_exited

radar_geofence_entered#

Radar Event FieldAirship Event PropertyTypeExample Value
geofence._idradar_geofence_idstring"5b2c0906f5874b001aecfd8e"
geofence.descriptionradar_geofence_descriptionstring"Store #123"
geofence.tagradar_geofence_tagstring"store"
geofence.externalIdradar_geofence_external_idstring"123"
geofence.metadata[{key}]radar_geofence_metadata_{key}{type}{value}
confidenceradar_confidencestring"high"

radar_geofence_exited#

Radar Event FieldAirship Event PropertyTypeExample Value
geofence._idradar_geofence_idstring"5b2c0906f5874b001aecfd8e"
geofence.descriptionradar_geofence_descriptionstring"Store #123"
geofence.tagradar_geofence_tagstring"store"
geofence.externalIdradar_geofence_external_idstring"123"
geofence.metadata[{key}]radar_geofence_metadata_{key}{type}{value}
confidenceradar_confidencestring"high"
durationradar_durationnumber (minutes)42.1

radar_place_entered#

Radar Event FieldAirship Event PropertyTypeExample Value
place._idradar_place_idstring"59302bcf8f27e8a156bd4f91"
place.nameradar_place_namestring"Starbucks"
place.chain.slugradar_place_chain_slugstring"starbucks"
place.chain.nameradar_place_chain_namestring"Starbucks"
place.categoriesradar_place_categoriesstring (comma-separated)"food-beverage,cafe,coffee-shop"
confidenceradar_confidencestring"high"

radar_place_exited#

Radar Event FieldAirship Event PropertyTypeExample Value
place._idradar_place_idstring"59302bcf8f27e8a156bd4f91"
place.nameradar_place_namestring"Starbucks"
place.chain.slugradar_place_chain_idstring"starbucks"
place.chain.nameradar_place_chain_namestring"Starbucks"
place.categoriesradar_place_categoriesstring (comma-separated)"food-beverage,cafe,coffee-shop"
confidenceradar_confidencestring"high"
durationradar_durationnumber (minutes)42.1

radar_home_entered#

Radar Event FieldAirship Event PropertyTypeExample Value
confidenceradar_confidencestring"high"

radar_home_exited#

Radar Event FieldAirship Event PropertyTypeExample Value
confidenceradar_confidencestring"high"

radar_office_entered#

Radar Event FieldAirship Event PropertyTypeExample Value
confidenceradar_confidencestring"high"

radar_office_exited#

Radar Event FieldAirship Event PropertyTypeExample Value
confidenceradar_confidencestring"high"

radar_traveling_started#

Radar Event FieldAirship Event PropertyTypeExample Value
confidenceradar_confidencestring"high"

radar_traveling_stopped#

Radar Event FieldAirship Event PropertyTypeExample Value
confidenceradar_confidencestring"high"

radar_country_entered#

Radar Event AttributeAirship Event PropertyTypeExample Value
region.coderadar_region_codestring"US"
region.nameradar_region_namestring"United States"
confidenceradar_confidencestring"high"

radar_country_exited#

Radar Event AttributeAirship Event PropertyTypeExample Value
region.coderadar_region_codestring"US"
region.nameradar_region_namestring"United States"
confidenceradar_confidencestring"high"

radar_state_entered#

Radar Event AttributeAirship Event PropertyTypeExample Value
region.coderadar_region_codestring"MD"
region.nameradar_region_namestring"Maryland"
confidenceradar_confidencestring"high"

radar_state_exited#

Radar Event AttributeAirship Event PropertyTypeExample Value
region.coderadar_region_codestring"MD"
region.nameradar_region_namestring"Maryland"
confidenceradar_confidencestring"high"

radar_dma_entered#

Radar Event AttributeAirship Event PropertyTypeExample Value
region.coderadar_region_codestring"26"
region.nameradar_region_namestring"Baltimore"
confidenceradar_confidencestring"high"

radar_dma_exited#

Radar Event AttributeAirship Event PropertyTypeExample Value
region.coderadar_region_codestring"26"
region.nameradar_region_namestring"Baltimore"
confidenceradar_confidencestring"high"

radar_started_trip#

Radar Event AttributeAirship Event PropertyTypeExample Value
trip.externalIdradar_trip_external_idstring"299"
trip.metadata[{key}]radar_trip_metadata_{key}{type}{value}
trip.destinationGeofenceTagradar_trip_destination_geofence_tagstring"store"
trip.destinationGeofenceExternalIdradar_trip_destination_geofence_external_idstring"123"

radar_updated_trip#

Radar Event AttributeAirship Event PropertyTypeExample Value
trip.externalIdradar_trip_external_idstring"299"
trip.metadata[{key}]radar_trip_metadata_{key}{type}{value}
trip.destinationGeofenceTagradar_trip_destination_geofence_tagstring"store"
trip.destinationGeofenceExternalIdradar_trip_destination_geofence_external_idstring"123"

radar_approaching_trip_destination#

Radar Event AttributeAirship Event PropertyTypeExample Value
trip.externalIdradar_trip_external_idstring"299"
trip.metadata[{key}]radar_trip_metadata_{key}{type}{value}
trip.destinationGeofenceTagradar_trip_destination_geofence_tagstring"store"
trip.destinationGeofenceExternalIdradar_trip_destination_geofence_external_idstring"123"

radar_arrived_at_trip_destination#

Radar Event AttributeAirship Event PropertyTypeExample Value
trip.externalIdradar_trip_external_idstring"299"
trip.metadata[{key}]radar_trip_metadata_{key}{type}{value}
trip.destinationGeofenceTagradar_trip_destination_geofence_tagstring"store"
trip.destinationGeofenceExternalIdradar_trip_destination_geofence_external_idstring"123"

radar_stopped_trip#

Radar Event AttributeAirship Event PropertyTypeExample Value
trip.externalIdradar_trip_external_idstring"299"
trip.metadata[{key}]radar_trip_metadata_{key}{type}{value}
trip.destinationGeofenceTagradar_trip_destination_geofence_tagstring"store"
trip.destinationGeofenceExternalIdradar_trip_destination_geofence_external_idstring"123"

radar_beacon_entered#

Radar Event AttributeAirship Event PropertyTypeExample Value
beacon.descriptionradar_beacon_descriptionstring"Store #123 - Drive-Thru"
beacon.tagradar_beacon_tagstring"drive-thru"
beacon.externalIdradar_beacon_external_idstring"123"
beacon.metadata[{key}]radar_trip_metadata_{key}{type}{value}

radar_beacon_exited#

Radar Event AttributeAirship Event PropertyTypeExample Value
beacon.descriptionradar_beacon_descriptionstring"Store #123 - Drive-Thru"
beacon.tagradar_beacon_tagstring"drive-thru"
beacon.externalIdradar_beacon_external_idstring"123"
beacon.metadata[{key}]radar_trip_metadata_{key}{type}{value}
durationradar_durationnumber (minutes)1.42