Welcome to Purple Support

Exponea

  • Updated

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

  1. Within Exponea, select Project settings > Access Management > API.

  2. Add a new key and add a name, e.g. WiFi connector.

  3. 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.

  4. 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

  1. Within ManagementConnectors on the Exponea connector click Add.

  2. 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.

  3. 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.

  4. 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.

  5. 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)

email

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
authenticate on to the Wi-Fi network

(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
number

(string)

location

The user’s location. Note this value is currently
obtained from Facebook authentication only

 

Venue

Data Type Data Description

(integer)

id

The venue's numeric ID

(string)

postCode

The venue's postal code

(string)

email

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)

email

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

Share online: