The OneSignal integration is available on the Enterprise plan.
Configuration
On the OneSignal Settings page under Keys & IDs, copy your REST API key. Then, on the Radar Integrations page under OneSignal, 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 call the edit device API and set tags in OneSignal. You can create notifications triggered by tag changes. By default, RadaruserId and deviceId do not map to OneSignal. To map users in Radar to devices in OneSignal, you must send the OneSignal player ID to Radar by setting metadata.oneSignalPlayerId. For example, on iOS:
radar_events. For example, if a user has exited a geofence and entered a place, the value for the radar_events tag would be exited_geofence,entered_place.
| Radar Event | Context Type | Onesignal Tag Value |
|---|---|---|
user.entered_geofence | Geofences | entered_geofence |
user.exited_geofence | Geofences | exited_geofence |
user.dwelled_in_geofence | Geofences | dwelled_in_geofence |
user.entered_place | Places | place_entered |
user.exited_place | Places | place_exited |
user.entered_region_country | Regions | entered_region_country |
user.exited_region_country | Regions | exited_region_country |
user.entered_region_state | Regions | entered_region_state |
user.exited_region_state | Regions | exited_region_state |
user.entered_region_dma | Regions | entered_region_dma |
user.exited_region_dma | Regions | exited_region_dma |
user.started_trip | Trips | started_trip |
user.updated_trip | Trips | updated_trip |
user.approaching_trip_destination | Trips | approaching_trip_destination |
user.arrived_at_trip_destination | Trips | arrived_at_trip_destination |
user.stopped_trip | Trips | stopped_trip |
user.entered_beacon | Beacons | entered_beacon |
user.exited_beacon | Beacons | exited_beacon |
User mapping
| Radar User Field | OneSignal Tag Name | Type | Example Tag | Context Type |
|---|---|---|---|---|
location.coordinates[1] | lat | number | 39.525665 | |
location.coordinates[0] | long | number | -76.350663 | |
locationAuthorization | radar_location_authorization | string | "GRANTED_FOREGROUND" | |
locationAccuracyAuthorization | radar_location_accuracy_authorization | string | "FULL" | |
segments[*].externalId | radar_segment_external_ids | string (comma-separated) | "starbucks-visitors" | |
topChains[*].slug | radar_top_chain_slugs | string (comma-separated) | "starbucks" | |
topChains[*].externalId | radar_top_chain_external_ids | string (comma-separated) | "123" | |
geofences[*]._id | radar_geofence_ids | string (comma-separated) | "5b2c0906f5874b001aecfd8e" | Geofences |
geofences[*].description | radar_geofence_descriptions | string (comma-separated) | "Store #123" | Geofences |
geofences[*].tag | radar_geofence_tags | string (comma-separated) | "store" | Geofences |
geofences[*].externalId | radar_geofence_external_ids | string (comma-separated) | "123" | Geofences |
place._id | radar_place_id | string | "59302bcf8f27e8a156bd4f91" | Places |
place.name | radar_place_name | string | "Starbucks" | Places |
place.categories | radar_place_categories | string | "coffee-shop" | Places |
place.chain.slug | radar_place_chain_slug | string | "starbucks" | Places |
place.chain.name | radar_place_chain_name | string | "Starbucks" | Places |
country.code | radar_region_country_code | string | "US" | Regions |
country.name | radar_region_country_name | string | "United States" | Regions |
state.code | radar_region_state_code | string | "MD" | Regions |
state.name | radar_region_state_name | string | "Maryland" | Regions |
dma.code | radar_region_dma_code | string | "26" | Regions |
dma.name | radar_region_dma_name | string | "Baltimore" | Regions |
postalCode.code | radar_region_postal_code | string | "21014" | Regions |
trip.externalId | radar_trip_external_id | string | "123" | Trip tracking |
trip.destinationGeofenceTag | radar_trip_destination_geofence_tag | string | "store" | Trip tracking |
trip.destinationGeofenceExternalId | radar_trip_destination_geofence_external_id | string | "123" | Trip tracking |
trip.approached | radar_trip_approached | boolean | true | Trip tracking |
trip.arrived | radar_trip_arrived | boolean | false | Trip tracking |
beacons[*]._id | radar_beacon_ids | string (comma-separated) | "5b2c0906f5874b001aecfd8f" | Beacons |
beacons[*].description | radar_beacon_descriptions | string (comma-separated) | "Store #123 - Drive-Thru" | Beacons |
beacons[*].tag | radar_beacon_tags | string (comma-separated) | "drive-thru" | Beacons |
beacons[*].externalId | radar_beacon_external_ids | string (comma-separated) | "123" | Beacons |