The Exponea connector creates Exponea customer records from your WiFi visitors data. You can choose which data you want from the portal and which data field to map it to in Exponea. Additionally, you can create and attribute WiFi visits to an event in Exponea.
Set Up Exponea
-
Within Exponea, select Project settings > Access Management > API.
-
Add a new key and add a name, e.g. WiFi connector.
-
Within Group permissions > Customer Properties tick Get and Set within New properties and Other. This gives your API key permission to write to and create new customer properties which you need to configure in the portal.
-
Within the Events tab, tick Get and Set within New properties and Other. Make a note of the following:
-
Project token
-
API base URL
-
Public key
Secret key
-
Set Up the Exponea Connector
-
Within Management > Connectors on the Exponea connector click Add.
-
Complete the fields as follows:
Connector name
Enter a name for the connector.
Exponea project token
Enter the details from Exponea.
Exponea public key
Exponea private key
Exponea base url
Allow lower levels to setup this connector Enables lower levels to set up the connector.
Override type
Additional
Lower levels can set up their own connector in addition to this one. This applied to all venues within the scope.
Replacement
Lower levels can override this connector. This only applies to this connector.
-
Click Validate, when validated you must map the data from the portal to the data in Exponea.
Portal journey data field
From the drop-down choose the portal data field you want to map.
Exponea data field
You must type in the Exponea data fields. If your input does not match exactly the entity in Exponea it creates a new Exponea data field.
-
Click Add map for each data field you want to map, if you want to add an event in Exponea to each customer record, select the Add event toggle and complete the fields as appropriate.
-
Click Save.
Data sent to Exponea
Data sent is based on the connector configuration in the Portal where the user can determine which Portal data values they want to map to CRM / contact properties within their Exponea instance. The following Purple data is made available for the user to map.
Users
Data Type | Data | Description |
(integer) |
id |
The user's numeric ID |
(string|null) |
title |
The user's title, e.g. Mr., Mrs. |
(string) |
firstName |
The user's forename |
(string) |
lastName |
The user's surname |
(string) |
|
The user's email address |
(string) |
mobile |
The user's mobile telephone number |
(string) |
locale |
The user's locale, e.g. en GB |
(integer) |
age |
The user's age in years |
(string|null) |
gender |
The user's gender as a single letter, e.g. M, F |
(string) |
authenticationMethod |
The authentication method that the user used to |
(string) |
postCode |
The user's postal code |
(string) |
dateOfBirth |
The user's date of birth in YYYY-mm-dd format |
(Boolean) |
marketingStatus |
Whether the user is opted in to marketing |
(string) |
journeyTime |
The user's journey date in YYYY-mm-dd format |
(string) |
mobileCountry |
The country code of the user’s mobile phone |
(string) |
location |
The user’s location. Note this value is currently |
Venue
Data Type | Data | Description |
(integer) |
id |
The venue's numeric ID |
(string) |
postCode |
The venue's postal code |
(string) |
|
The venue's primary contact email |
(string) |
name |
The venue's name |
(string) |
address1 |
The first line of the venue's address |
(string) |
address2 |
The second line of the venue's address |
(string) |
telephone |
The venue's telephone number |
(string) |
description |
The venue's description |
(string) |
country |
The venue's two letter country code, e.g. GB |
(string) |
town |
The venue's town (city) |
(string) |
sector |
The venue's industry sector |
(string) |
thirdPartyID |
The venue's foreign system id, e.g. VEN-00000001 |
Company
Data Type | Data | Description |
(integer) |
id |
The company's numeric ID |
(string) |
name |
The company's name |
(string) |
sector |
The company's industry sector |
(string) |
town |
The company's town (city) |
(string) |
country |
The company's two letter country code, e.g. GB |
(string) |
address1 |
The first line of the company's address |
(string) |
address2 |
The second line of the company's address |
(string) |
|
The company's primary contact email |
(string) |
mobile |
The company's primary contact mobile telephone number |
(string) |
telephone |
The company's primary contact telephone number |
(string) |
ownerLastName |
The company owner's surname |
(string) |
ownerFirstName |
The company owner's forename |
(string) |
postCode |
The company's postal code |