Airship is an app experience platform that lets you create and deliver powerful in-app experiences with the help of engaging, personalized content and actionable customer insights.
RudderStack supports Airship as a destination to which you can seamlessly send your event data.
Find the open source transformer code for this destination in the GitHub repository.
Once you have confirmed that the source platform supports sending events to Airship, follow these steps:
From your RudderStack dashboard, add the source. Then, from the list of destinations, select Airship.
Assign a name to your destination and click Next.
Connection settings
To successfully configure Airship as a destination, you will need to configure the following settings:
API Key: Enter your Airship token which is required by RudderStack to communicate with your Airship project and authenticate all supported event calls, that is, identify, track, and group.
For detailed steps on obtaining the API key, refer to the FAQ section below.
App Key: Enter your Airship project’s app key which is required for the track calls. You can obtain the app key by going to Settings > Project Details in your Airship dashboard.
For detailed steps on obtaining the Airship app key, refer to the FAQ section below.
EU data center: Enable this setting if you’ve implemented your app in Airship’s European data center.
If you’re unsure which data center you are on, reach out to Airship support.
Identify
The identify call lets you uniquely identify a user and record any associated traits about them like their name, email, etc.
In the above code snippet, RudderStack sends the Boolean values to Airship as tags, whereas the non-Boolean values are sent as attributes.
RudderStack maps some reserved traits to the predefined Airship attributes. Refer to the Traits mapping section below for more information.
Tags
To successfully assign tags to Airship using the RudderStack identify events, you must create a tag group with the group key set to rudderstack_integration in Airship.
For more information on creating a tag group in Airship, refer to the FAQ section below.
This integration supports identify traits of type Boolean only. Airship adds tags for the traits that are set to true and removes tags for the traits set to false.
Attributes
For identify traits that are not mapped to any predefined or custom-defined Airship attributes, you must create and enable those attributes in the Airship dashboard.
Refer to the FAQ section below for more information on creating and enabling attributes in Airship.
Track
The track call lets you capture user events along with the properties associated with them.
RudderStack sends the track events to Airship via their Custom Events API. You can use the event properties to personalize and trigger specific messages for your audience.
You need the Airship project’s App Key for authenticating the track calls.
A sample track call is shown below:
rudderanalytics.track("Product Clicked",{description:"Shoes viewed",brand:"Sneakers",colors:["red","blue"],items:[{text:"New Balance Sneakers",price:"$69.95"},{text:"G.I. Joe Sneakers",price:"$99.95"}]});
The event name sent to Airship must not contain any upper case characters. Otherwise, it is rejected with a 400 status code. RudderStack handles this by converting any upper case characters to lower case and replacing any spaces with an underscore(_).
In the snippet above, the event name Product Clicked is automatically converted to product_clicked before sending to Airship.
RudderStack also maps some event properties to the Airship properties before sending them over to Airship. For more information, refer to the Supported mappings section below.
Group
The group call lets you link an identified user with a group such as a company, organization, or an account, and record any traits associated with that group, e.g., company name, number of employees, etc.
In the above code snippet, RudderStack sends the Boolean values to Airship as tags, whereas the non-Boolean values are sent as attributes.
This integration supports group traits of type Boolean only. Airship adds tags for the traits that are set to true and removes tags for the traits set to false.
To successfully assign tags to Airship using the RudderStack group events, you must create a tag group with the group key set to rudderstack_integration_group in Airship. Similarly, you need to create the relevant attribute identifiers in Airship to set the attributes on the named users.
For more information on creating a tag group or attributes in Airship, refer to the FAQ section below.
Supported mappings
RudderStack maps the following event properties to the Airship properties before sending them over to Airship.
RudderStack property
Airship property
Presence
userId
named_user_id
Required
event
name
Required
properties
properties
Optional
value
value
Optional
interactionId
interaction_id
Optional
interactionType
interaction_type
Optional
sessionId
session_id
Optional
transaction
transaction
Optional
timestamp
occurred
Optional
Traits mapping
RudderStack trait
Airship attribute
address.city
city
address.country
country
address.postalcode
zipcode
address.state
region
createdAt
account_creation
firstName
first_name
lastName
last_name
name
full_name
phone
mobile_phone
FAQ
Where can I obtain the Airship API key?
The Airship API key is required so that RudderStack can communicate with your Airship project. This is a mandatory field to set up the integration.
To obtain your Airship project’s API key, follow these steps:
In your Airship dashboard, go to Settings.
In the Project configuration window, go to Tokens and click Manage.
Then, click Create token.
Assign a name for your token. Under Role, select All access from the dropdown:
Once the token is created, copy and secure the credentials and click Got it.
Where can I obtain the Airship App Key?
To obtain your Airship project’s app key, follow these steps:
In your Airship dashboard, go to Settings.
In the Project configuration window, look for the Project Details pane on the right side.
You will find your project’s app key listed here.
How do I create a custom tag group in Airship?
To create a tag group in Airship, follow these steps:
Go to Settings > Project configuration > Tag Groups and click Manage.
Click Create Tag Group and enter the following settings:
Name: Enter the name for the tag group.
Description: Set additional information about the tag group in this field.
Group Key: Assign a unique ID for the tag group in this field. For example, to assign tags using the RudderStack identify events, you can set this to rudderstack-integration. For assigning tags using the group events, set this to rudderstack-integration-group.
For identify traits that are not mapped to any predefined or custom-defined Airship attributes, you must create and enable those attributes in the Airship dashboard. To do so, follow these steps:
Go to your Airship dashboard.
Navigate to Audience > Attributes.
Click Create Attribute.
Enter the Attribute ID, Name, and select the attribute Type.
This site uses cookies to improve your experience while you navigate through the website. Out of
these
cookies, the cookies that are categorized as necessary are stored on your browser as they are as
essential
for the working of basic functionalities of the website. We also use third-party cookies that
help
us
analyze and understand how you use this website. These cookies will be stored in your browser
only
with
your
consent. You also have the option to opt-out of these cookies. But opting out of some of these
cookies
may
have an effect on your browsing experience.
Necessary
Always Enabled
Necessary cookies are absolutely essential for the website to function properly. This
category only includes cookies that ensures basic functionalities and security
features of the website. These cookies do not store any personal information.
This site uses cookies to improve your experience. If you want to
learn more about cookies and why we use them, visit our cookie
policy. We'll assume you're ok with this, but you can opt-out if you wish Cookie Settings.