Salesforce Marketing Cloud The Salesforce Marketing Cloud integration is available on the
Enterprise plan .
Radar can send events to Salesforce Marketing Cloud to trigger journeys in Journey Builder .
Use the Salesforce Marketing Cloud integration to send location-triggered messages to increase engagement and conversion.
Configuration# On the Salesforce Marketing Cloud Setup menu, under Installed Packages , click New . Add an installed package with the name Radar . On the package details page, add an API Integration component with the Server-to-Server integration type and all permissions for the Automation , Contacts , Cross Cloud Platform , and Data scopes. Copy your Client ID , Client Secret , Authentication Base URI , and REST Base URI .
Then, on the Radar Integrations page under Salesforce Marketing Cloud , set Enabled to Yes and paste these values. When you click Save , Radar will create an event definition and data extension with the specified event definition key (radar-event
by default).
Finally, in the Salesforce Marketing Cloud Journey Builder , create a new journey with an API Event entry source using this event definition and data extension.
By default, Radar userId
maps to Salesforce Marketing Cloud contactKey
for logged in users. However, you can track logged out users or specify custom mappings by setting Radar metadata.salesforceContactKey
. For example, on iOS:
Radar.setMetadata(["salesforceContactKey": contactKey])
Copy Whenever events are generated, Radar will send events to your Salesforce Marketing Cloud data extension to trigger journeys.
Event mapping# user.entered_geofence# Radar Event Field Salesforce Event Attribute Type Example type
type
string "user.entered_geofence"
user.userId
userUserId
string (max length 100) "1"
user.deviceId
userDeviceId
string (max length 100) "10974a2ee035770b9"
geofence._id
geofenceId
string "5b2c0906f5874b001aecfd8e"
geofence.description
geofenceDescription
string (max length 100) "Store #123"
geofence.tag
geofenceTag
string (max length 100) "store"
geofence.externalId
geofenceExternalId
string (max length 100) "123"
geofence.metadata
geofenceMetadata
string (max length 4,000) '{"parking":false}'
confidence
confidence
string "high"
foreground
foreground
boolean true
If Regions is enabled, Radar will also send the following attributes:
Radar Event Field Salesforce Event Attribute Type Example country.code
countryCode
string "US"
country.name
countryName
string "United States"
state.code
stateCode
string "MD"
state.name
stateName
string "Maryland"
dma.code
dmaCode
string "26"
dma.name
dmaName
string "Baltimore"
postalCode.code
postalCode
string "21014"
user.exited_geofence# Radar Event Field Salesforce Event Attribute Type Example type
type
string "user.exited_geofence"
user.userId
userUserId
string (max length 100) "1"
user.deviceId
userDeviceId
string (max length 100) "10974a2ee035770b9"
geofence._id
geofenceId
string "5b2c0906f5874b001aecfd8e"
geofence.description
geofenceDescription
string (max length 100) "Store #123"
geofence.tag
geofenceTag
string (max length 100) "store"
geofence.externalId
geofenceExternalId
string (max length 100) "123"
geofence.metadata
geofenceMetadata
string (max length 4,000) '{"parking":false}'
confidence
confidence
string "high"
duration
duration
number (minutes) 42.1``foreground
foreground
foreground
boolean true
If Regions is enabled, Radar will also send the following attributes:
Radar Event Field Salesforce Event Attribute Type Example country.code
countryCode
string "US"
country.name
countryName
string "United States"
state.code
stateCode
string "MD"
state.name
stateName
string "Maryland"
dma.code
dmaCode
string "26"
dma.name
dmaName
string "Baltimore"
postalCode.code
postalCode
string "21014"
user.dwelled_in_geofence# Radar Event Field Salesforce Event Attribute Type Example type
type
string "user.exited_geofence"
user.userId
userUserId
string (max length 100) "1"
user.deviceId
userDeviceId
string (max length 100) "10974a2ee035770b9"
geofence._id
geofenceId
string "5b2c0906f5874b001aecfd8e"
geofence.description
geofenceDescription
string (max length 100) "Store #123"
geofence.tag
geofenceTag
string (max length 100) "store"
geofence.externalId
geofenceExternalId
string (max length 100) "123"
geofence.metadata
geofenceMetadata
string (max length 4,000) '{"parking":false}'
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 Salesforce Event Attribute Type Example country.code
countryCode
string "US"
country.name
countryName
string "United States"
state.code
stateCode
string "MD"
state.name
stateName
string "Maryland"
dma.code
dmaCode
string "26"
dma.name
dmaName
string "Baltimore"
postalCode.code
postalCode
string "21014"
user.entered_place# Radar Event Field Salesforce Event Attribute Type Example type
type
string "user.entered_place"
user.userId
userUserId
string (max length 100) "1"
user.deviceId
userDeviceId
string (max length 100) "10974a2ee035770b9"
place._id
placeId
string "59302bcf8f27e8a156bd4f91"
place.name
placeName
string "Starbucks"
place.chain.slug
placeChainSlug
string "starbucks"
place.chain.name
placeChainName
string "Starbucks"
place.chain.metadata
placeChainMetadata
string (max length 4,000) '{"parking":false}'
place.categories
placeCategories
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 Salesforce Event Attribute Type Example country.code
countryCode
string "US"
country.name
countryName
string "United States"
state.code
stateCode
string "MD"
state.name
stateName
string "Maryland"
dma.code
dmaCode
string "26"
dma.name
dmaName
string "Baltimore"
postalCode.code
postalCode
string "21014"
user.exited_place# Radar Event Field Salesforce Event Attribute Type Example type
type
string "user.exited_place"
user.userId
userUserId
string (max length 100) "1"
user.deviceId
userDeviceId
string (max length 100) "10974a2ee035770b9"
place._id
placeId
string "59302bcf8f27e8a156bd4f91"
place.name
placeName
string "Starbucks"
place.chain.slug
placeChainSlug
string "starbucks"
place.chain.name
placeChainName
string "Starbucks"
place.chain.metadata
placeChainMetadata
string (max length 4,000) '{"parking":false}'
place.categories
placeCategories
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 Salesforce Event Attribute Type Example country.code
countryCode
string "US"
country.name
countryName
string "United States"
state.code
stateCode
string "MD"
state.name
stateName
string "Maryland"
dma.code
dmaCode
string "26"
dma.name
dmaName
string "Baltimore"
postalCode.code
postalCode
string "21014"
user.entered_region_country# Radar Event Field Salesforce Event Attribute Type Example Value type
type
string "user.entered_region_country"
user.userId
userUserId
string "1"
user.deviceId
userDeviceId
string "10974a2ee035770b9"
region.code
regionCode
string "US"
region.name
regionName
string "United States"
confidence
confidence
string "high"
foreground
foreground
boolean true
user.exited_region_country# Radar Event Field Salesforce Event Attribute Type Example Value type
type
string "user.exited_region_country"
user.userId
userUserId
string "1"
user.deviceId
userDeviceId
string "10974a2ee035770b9"
region.code
regionCode
string "US"
region.name
regionName
string "United States"
confidence
confidence
string "high"
foreground
foreground
boolean true
user.entered_region_state# Radar Event Field Salesforce Event Attribute Type Example Value type
type
string "user.entered_region_state"
user.userId
userUserId
string "1"
user.deviceId
userDeviceId
string "10974a2ee035770b9"
region.code
regionCode
string "MD"
region.name
regionName
string "Maryland"
confidence
confidence
string "high"
foreground
foreground
boolean true
user.exited_region_state# Radar Event Field Salesforce Event Attribute Type Example Value type
type
string "user.exited_region_state"
user.userId
userUserId
string "1"
user.deviceId
userDeviceId
string "10974a2ee035770b9"
region.code
regionCode
string "MD"
region.name
regionName
string "Maryland"
confidence
confidence
string "high"
foreground
foreground
boolean true
user.entered_region_dma# Radar Event Field Salesforce Event Attribute Type Example Value type
type
string "user.entered_region_dma"
user.userId
userUserId
string "1"
user.deviceId
userDeviceId
string "10974a2ee035770b9"
region.code
regionCode
string "26"
region.name
regionName
string "Baltimore"
confidence
confidence
string "high"
foreground
foreground
boolean true
user.exited_region_dma# Radar Event Field Salesforce Event Attribute Type Example Value type
type
string "user.exited_region_dma"
user.userId
userUserId
string "1"
user.deviceId
userDeviceId
string "10974a2ee035770b9"
region.code
regionCode
string "26"
region.name
regionName
string "Baltimore"
confidence
confidence
string "high"
foreground
foreground
boolean true
user.started_trip# Radar Event Attribute Salesforce Event Attribute Type Example Value trip.externalId
tripExternalId
string (max length 100) "299"
trip.metadata
tripMetadata
string (max length 4,000) '{"Car Model":"Green Honda Civic"}'
trip.destinationGeofenceTag
tripDestinationGeofenceTag
string (max length 100) "store"
trip.destinationGeofenceExternalId
tripDestinationGeofenceExternalId
string (max length 100) "123"
foreground
foreground
boolean true
user.updated_trip# Radar Event Attribute Salesforce Event Attribute Type Example Value trip.externalId
tripExternalId
string (max length 100) "299"
trip.metadata
tripMetadata
string (max length 4,000) '{"Car Model":"Green Honda Civic"}'
trip.destinationGeofenceTag
tripDestinationGeofenceTag
string (max length 100) "store"
trip.destinationGeofenceExternalId
tripDestinationGeofenceExternalId
string (max length 100) "123"
foreground
foreground
boolean true
user.approaching_trip_destination# Radar Event Attribute Salesforce Event Attribute Type Example Value trip.externalId
tripExternalId
string (max length 100) "299"
trip.metadata
tripMetadata
string (max length 4,000) '{"Car Model":"Green Honda Civic"}'
trip.destinationGeofenceTag
tripDestinationGeofenceTag
string (max length 100) "store"
trip.destinationGeofenceExternalId
tripDestinationGeofenceExternalId
string (max length 100) "123"
foreground
foreground
boolean true
user.arrived_at_trip_destination# Radar Event Attribute Salesforce Event Attribute Type Example Value trip.externalId
tripExternalId
string (max length 100) "299"
trip.metadata
tripMetadata
string (max length 4,000) '{"Car Model":"Green Honda Civic"}'
trip.destinationGeofenceTag
tripDestinationGeofenceTag
string (max length 100) "store"
trip.destinationGeofenceExternalId
tripDestinationGeofenceExternalId
string (max length 100) "123"
foreground
foreground
boolean true
user.stopped_trip# Radar Event Attribute Salesforce Event Attribute Type Example Value trip.externalId
tripExternalId
string (max length 100) "299"
trip.metadata
tripMetadata
string (max length 4,000) '{"Car Model":"Green Honda Civic"}'
trip.destinationGeofenceTag
tripDestinationGeofenceTag
string (max length 100) "store"
trip.destinationGeofenceExternalId
tripDestinationGeofenceExternalId
string (max length 100) "123"
foreground
foreground
boolean true
user.entered_beacon# Radar Event Attribute Salesforce Event Attribute Type Example Value beacon._id
beaconId
string "5b2c0906f5874b001aecfd8f"
beacon.description
beaconDescription
string (max length 100) "Store #123 - Drive-Thru"
beacon.tag
beaconTag
string (max length 100) "drive-thru"
beacon.externalId
beaconExternalId
string (max length 100) "123"
beacon.metadata
beaconMetadata
string (max length 4,000) '{"type":"parking"}'
confidence
confidence
string "high"
foreground
foreground
boolean true
user.exited_beacon# Radar Event Attribute Salesforce Event Attribute Type Example Value beacon._id
beaconId
string "5b2c0906f5874b001aecfd8f"
beacon.description
beaconDescription
string (max length 100) "Store #123 - Drive-Thru"
beacon.tag
beaconTag
string (max length 100) "drive-thru"
beacon.externalId
beaconExternalId
string (max length 100) "123"
beacon.metadata
beaconMetadata
string (max length 4,000) '{"type":"parking"}'
confidence
confidence
string "high"
duration
duration
number (minutes) 1.42
foreground
foreground
boolean true