Marketing Cloud integration

Connect Woosmap Geofencing with Salesforce Marketing Cloud

Marketing Cloud Integration
Send Marketing Cloud

Woosmap Geofencing SDK can send events to Salesforce Marketing Cloud from different context types: Geofences, POI, Visits and ZOI.

Whenever location events trigger, you can send custom events with associated properties to your App via a listener method. Your App can then pass them to Salesforce Marketing Cloud.

Marketing Cloud Integration

To push event data to the Salesforce Marketing Cloud API, and trigger an Entry Event , subscribe to SDK callbacks and implement API calls in it, or simply initialize the Marketing Cloud connector to let the Geofencing SDK run API call to push event data.

Initialize the Marketing Cloud connector

The SDK needs some input like credentials and object key to perform the API call to Salesforce Marketing Cloud API.

Input to initialize the SFMC connector

Parameters	Description	Required
`authenticationBaseURI`	Authentication Base URI	Required
`restBaseURI`	REST Base URI	Required
`client_id`	`client_id` (`journey_read` and `list_and_subscribers_read` rights are required)	Required
`client_secret`	`client_secret` (`journey_read` and `list_and_subscribers_read` rights are required)	Required
`contactKey`	The ID that uniquely identifies a subscriber/contact	Required
`regionEnteredEventDefinitionKey`	`EventDefinitionKey` for the Woosmap event `woos_geofence_entered_event`
`regionExitedEventDefinitionKey`	`EventDefinitionKey` for the Woosmap event `woos_geofence_exited_event`
`poiEventDefinitionKey`	`EventDefinitionKey` for the Woosmap event `woos_POI_event`
`zoiClassifiedEnteredEventDefinitionKey`	`EventDefinitionKey` for the Woosmap event `woos_zoi_classified_entered_event`
`zoiClassifiedExitedEventDefinitionKey`	`EventDefinitionKey` for the Woosmap event `woos_zoi_classified_exited_event`
`visitEventDefinitionKey`	`EventDefinitionKey` for the Woosmap event `woos_Visit_event`

Android - Initialize the connector implementation

        HashMap<String, String> SFMCInfo = new HashMap<String, String>();

SFMCInfo.put("authenticationBaseURI","https://mcdmfc5rbyc0pxgr4nlpqqy0j-x1.auth.marketingcloudapis.com");
SFMCInfo.put("restBaseURI","https://mcdmfc5rbyc0pxgr4nlpqqy0j-x1.rest.marketingcloudapis.com");
SFMCInfo.put("client_id", "xxxxxxxxxxxxxxx");
SFMCInfo.put("client_secret", "xxxxxxxxxxxxxxx");
SFMCInfo.put("contactKey","ID001");
SFMCInfo.put("regionEnteredEventDefinitionKey","APIEvent-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");
SFMCInfo.put("regionExitedEventDefinitionKey","APIEvent-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx");

WoosmapSettings.SFMCCredentials = SFMCInfo;

iOS - Initialize the connector implementation

        WoosmapGeofenceManager.shared.setSFMCCredentials(credentials : [ 
      "authenticationBaseURI": "https://mcdmfc5rbyc0pxgr4nlpqqy0j-x1.auth.marketingcloudapis.com",
      "restBaseURI": "https://mcdmfc5rbyc0pxgr4nlpqqy0j-x1.rest.marketingcloudapis.com",
      "client_id": "xxxxxxxxxxxxxxx",
      "client_secret": "xxxxxxxxxxxxx",
      "contactKey":"ID001",
      "regionEnteredEventDefinitionKey":"APIEvent-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "regionExitedEventDefinitionKey":"APIEvent-xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
])

Send Marketing Cloud

Geofences Events

Enter eventName: woos_geofence_entered_event
Exit eventName: woos_geofence_exited_event

Event data specification

Field name	Type	Only if the region is a POI
`date`	Datetime
`id`	String
`latitude`	Double
`longitude`	Double
`radius`	Double
`name`	String	X
`idStore`	String	X
`city`	String	X
`zipCode`	String	X
`country_code`	String	X
`address`	String	X
`tags`	String	X
`types`	String	X
`user_properties.[field_name]`	String	X

POI Events

eventName: woos_POI_event

Event data specification

Field name	Type
`date`	Datetime
`name`	String
`idStore`	String
`city`	String
`zipCode`	String
`distance`	String
`country_code`	String
`address`	String
`tags`	String
`types`	String
`user_properties.[field_name]`	String

Visits Events

eventName: woos_Visit_event

Event data specification

Field name	Type
`date`	Datetime
`arrivalDate`	String
`departureDate`	String
`id`	String
`latitude`	String
`longitude`	String

ZOI Events

Enter eventName: woos_zoi_classified_entered_event
Exit eventName: woos_zoi_classified_exited_event

Event data specification

Field name	Type
`date`	Datetime
`id`	String
`latitude`	Double
`longitude`	Double
`radius`	Double

‹ Airship Batch ›

Was this article helpful?

Have more questions? Submit a request