Switching on the Purple / Airship connector means that each time a customer connects to your WiFi, the customer and WiFi data will be automatically sent to your Airship database.
How to get started
The Airship connector can be set up at customer or venue level and will push users’ data into Airship once they have authenticated onto your WiFi.
To get started, log in to your Purple portal. At either customer or venue level, in the navigation bar on the right hand side click on “Management” and choose the final option “Connectors” shown right.
In the Connectors section you will see various optional connectors that can be set up, including the Airship connector. On the Airship connector click on the green plus button as shown left:
Now you will be presented with five fields;
Name of group where to push users
Unit where to push users
You can label “Connector Name” to be anything you like.
Creating an API (PAT) token
You'll need to create an API "Personal Access Token" for them to be able to pass data into your account securely.
To do this. you can either;
invite your contact at Purple as a user to your Airship account and let them do this themselves, or;
you can do this on their behalf and pass the token on to them securely.
To create an API Personal Access Token, follow our guide here >
Airship Account ID
Purple may also require your Airship Account ID. If you're not sure what this is, please request it from our Customer Success team.
To connect to the Airship API you will and “Source ID” from Airship Support: firstname.lastname@example.org.
The source name should be descriptive of the partner providing the data. If directly from Purple, this can be Purple WIFI. If this comes from a reseller of purple, provide the providers name in this field
The group name will define what group within Airship the contacts will be pushed into. We'd recommend something descriptive (i.e. WiFi). If the group doesnt exist in Airship, the API will create it and push contacts in it.
In terms of consent, this will default to what the user has specified in Purple.
You can choose to switch the connector on for all your venues, or just specific venues from the ‘Scope’ section:
Click the ‘Save’ button at the bottom of the page to save the settings and switch the connector on. After all of the above steps have been completed the Airship Connector will now be active and authenticated users will be pushed to your list in Airship.
Once the connector is on, you will be able to see data flowing into your Airship account by checking the groups in Airship under the “Folders & Groups” interface.
What data is sent to Airship?
Contact first name
Contact last name
Contact email address
Contact email opt in
WiFi transaction - Hot Spot name
WiFi transaction - Hot Spot MAC address
WiFi transaction - Connection Interaction
WiFi transaction - Interaction Date
WiFi transaction - Unit
View your data in Airship
To access your Contact Folders in Airship, scroll down to “Contacts” in the main menu and select “Folders and Groups”.
As you can see from the previous screenshot of the setup page - “Name group to push users”. You can of course update this to match any Group you like in Airship.