Welcome to Purple Support

Airship

  • Updated

Airship allows you to create a single customer view from multiple channels of data. The Airship connector can be set up at customer, group, or venue level, and pushes users’ data into Airship to create or update a contact, once they have authenticated into your Wi-Fi. The data is sent every time the device pings an access point.

Set Up the Airship Connector

  1. Within ManagementConnectors on the Airship connector click Add.

  2. Complete the fields as follows:

    Connector Name

    Enter a name for the connector.

    Personal Access Token (PAT)

    To get your PAT, log into your Airship account and navigating to Users > Personal Access Tokens. Click into Settings > API access, then through to access the token manager interface. Select ‘Create token’.

    Account ID attained from Airship

    Request the Account ID from Airship Support: success@airship.co.uk.

    Source Name attained from Airship

    Request the Source Name from Airship Support: success@airship.co.uk.

    Name of group to push users

    Specify where you would like the data to be pushed to in Airship. By default, your main Contacts Folder and Group are labeled ‘Default’ in Airship. To access your Contact Folders in Airship, on the main menu, click Contacts and select Folders and Groups.

    Update these fields to match the required Folder or Group in Airship.

    Communication preferences default to what the user has specified in the portal.

  3. Within Scope, the login level determines what scope is available. The scope determines at what level the palette displays for this connector, choose from the following:

    • Customer level – Displays the customer, groups and all venues. With the ability to select each level.

    • Group level – Displays the selected group and the venues within that group.

    • Venue level – This specific venue.

  4. Click Save.

Data Sent to Airship

The following data is sent to Airship to create or update a contact:

Data Type

Data

Description

(integer)

user ID

The user's ID

(string)

user authentication provider

The authentication method the user authenticated on to the Wi-Fi with

(string)

firstName

The user's forename

(string)

lastName

The user's surname

(string)

email

The user's email address

(string)

postcode

The user's postcode

(string)

country locale

The user's locale

(string)

mobile

The user's mobile telephone number

(string)

gender

The user's gender 

(string)

title

The user's title

(string)

dateOfBirth

The user's date of birth in YYYY-mm-dd format

(string)

marketing status

Whether the user has agreed to receive marketing

The following consent status is sent to Airship for the contact:

Consent Type

Data

Description

Email

marketing status

Whether the user has agreed to receive marketing

SMS

marketing status

Whether the user has agreed to receive marketing

Third party

marketing status

Whether the user has agreed to receive marketing

The following data is sent to the Airship API for the Wi-Fi interaction data for the contact:

Data Type

Data

Description

String

venue name

The venue name

String

device MAC

SHA256 hashed MAC address of
the user’s device

String

venue name

The venue name suffixed with 'Wi-Fi  Splashpage'

Share online:
Was this article helpful?
0 out of 0 found this helpful