> ## Documentation Index
> Fetch the complete documentation index at: https://radarlabs-joeross-add-chain-to-chain-list.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce Marketing Cloud

<Info>
  The Salesforce Marketing Cloud integration is available on the [**Enterprise plan**](https://radar.com/pricing).
</Info>

Radar can send events to [Salesforce Marketing Cloud](https://www.salesforce.com/products/marketing-cloud/overview/) 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](https://dashboard.radar.com/integrations#salesforce) 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). Whenever events are generated, Radar will send events to your Salesforce Marketing Cloud data extension to trigger journeys.

In Salesforce Marketing Cloud's *Contact Builder*, under *Data Designer*, connect the Radar data extension to your data model by linking the Customer Data's *Contact Key* field to the Radar Data Extension's *contactKey* field in a one to many relationship.

To map a Radar user to a Salesforce Marketing Cloud contact, you must specify a custom mapping by setting Radar `metadata.salesforceContactKey`.

<CodeGroup>
  ```swift Swift theme={null}
  let contactKey = SFMCSdk.mp.contactKey()
  Radar.setMetadata(["salesforceContactKey": contactKey])
  ```

  ```kotlin Kotlin theme={null}
  SFMCSdk.requestSdk { sdk ->
      sdk.mp {
          val contactKey = it.moduleIdentity.profileId
          Radar.setMetadata(JSONObject().put("salesforceContactKey",contactKey))
      }
  }
  ```
</CodeGroup>

## Verify integration data delivery

To test that the integration is configured correctly and can deliver data, use the [Simulator](https://dashboard.radar.com/geofencing/simulate) to generate events. Click *View* on an event row and scroll down to the *Logs* section on the details page to verify delivery. Perform a similar process via a test app build with Radar location tracking enabled by spoofing location or moving into the relevant boundary.

<img src="https://mintcdn.com/radarlabs-joeross-add-chain-to-chain-list/oy3gbO0ckA1_ZmBj/images/salesforce-verify-integration.gif?s=18ea41d6b084af9f14d99e7a081f1954" alt="Salesforce Verify Integration Gi" width="1582" height="780" data-path="images/salesforce-verify-integration.gif" />

Additionally, check the Radar data extension in Salesforce's *Contact Builder* to verify records are delivering.

All integration delivery can be monitored via the integration's event logs by clicking *View event logs* on the [Integrations page](https://dashboard.radar.com/integrations#salesforce).

## Example use cases

### Send a personalized push notification when a user arrives at a store[#](#send-a-personalized-push-notification-when-a-user-arrives-at-a-store)

1. Create [Geofences](/geofencing/geofences#create-geofences) in Radar with the geofence tag set to `store`. The geofence tag will be used to trigger messages for the subset of geofence entries where this tag is present.
2. Create a Salesforce Journey triggered by an API Event from the Radar data extension. The Radar data extension will be filtered on `user.entered_geofence` as the `type` attribute and `store` as the `geofenceTag` attribute.

<img src="https://mintcdn.com/radarlabs-joeross-add-chain-to-chain-list/oy3gbO0ckA1_ZmBj/images/salesforce-radar-triggered-message.png?fit=max&auto=format&n=oy3gbO0ckA1_ZmBj&q=85&s=5376134561b4dad5a7df85d203c8847b" alt="Salesforce Radar Triggered Message Pn" width="3840" height="1956" data-path="images/salesforce-radar-triggered-message.png" />

### Message all users who have been nearby a store

1. Create [Geofences](/geofencing/geofences#create-geofences) in Radar to represent nearby store boundaries with geofence tag set to `nearby-store`. The geofence tag will be used to target messages for the subset of geofences where this tag has been present on an event in the last 7 days.
2. Create a Salesforce Mobile List filtered on the Radar data extension attributes of `type` equal to `user.entered_geofence`, `geofenceTag` equal to `nearby` and `createdAt` set to the last 7 days.
3. Create a Salesforce MobilePush Message with audience targeting set to the Salesforce Mobile List created in the step above.

<img src="https://mintcdn.com/radarlabs-joeross-add-chain-to-chain-list/oy3gbO0ckA1_ZmBj/images/salesforce-message-all-users.png?fit=max&auto=format&n=oy3gbO0ckA1_ZmBj&q=85&s=bdf9c27479d6a26bba170a574ded500f" alt="Salesforce Message All Users Pn" width="3840" height="1954" data-path="images/salesforce-message-all-users.png" />

## 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](/geofencing/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](/geofencing/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](/geofencing/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](/geofencing/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](/geofencing/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` |