Airship (Actions) Destination

Destination Info
Partner Owned
  • This integration is partner owned. Please reach out to the partner's support for any issues.

Airship provides an end-to-end solution for capturing value across the entire customer app lifecycle — from acquisition and activation to engagement and loyalty. It starts with Airship’s market-leading app store optimization (ASO) solutions promoting app discovery and downloads. Then the unified journey orchestration, content creation and experimentation solutions kick in. App teams can quickly design, deploy and iterate no-code native app experiences and cross-channel campaigns — bridging inside-the-app experiences with outside-the-app messaging.

Airship maintains this destination. For any issues with the destination, contact the Airship Support team.

Good to know: This page is about the Actions-framework Airship Segment destination. There’s also a page about the non-Actions Airship destination. Both of these destinations receive data from Segment.

Benefits of Airship (Actions) vs Airship Classic

Airship (Actions) provides the following benefits over the classic Airship destination:

  • Flexibility. Complete flexibility for mapping your data from any Segment event type to one of three Airship endpoints. Make optimal use of data from Segment to trigger Automations, audience segmentation, or to personalize end-users in-app experiences and messages.
  • Additional functionality. Supports email registration, named user association, as well as delete for GDPR compliance. This is in addition to the previously supported custom events, tag management, and attributes.
  • Reporting. Better and more meaningful feedback from the Airship API. This integration calls the Airship API directly, so the endpoint response shows precisely how the integration is performing.

Getting started

  1. From the Segment web app, navigate to Connections > Catalog, and select the Destinations tab in the catalog.
  2. Search for Airship (Actions) and select it.
  3. Click Configure Airship (Actions).
  4. Select an existing Source to connect to Airship (Actions).
  5. Name the destination and choose between filling in the settings manually or copying from an existing instance.
  6. Click Create Destination.
  7. Enter your Access Token and App Key. You can get your access token and app key by going to your Airship project and navigating to Settings > Partner Integrations and selecting Segment. Following the instructions there will create a Tag Group, Attributes, and provide the Access Token and App Key.
  8. Select the appropriate data center.

Destination Settings

Setting Description
Access Token Required.

Create in the Airship Go dashboard in Settings->Partner Integrations->Segment

App Key Required.

The App Key identifies the Airship Project to which API requests are made.

Data Center Required.

US or EU

Available Presets

Airship (Actions) has the following presets:

Preset Name Trigger Default Action
Custom Events Event type = "track"
Custom Events
Set Attributes Event type = "identify"
Set Attributes

Available Actions

Build your own Mappings. Combine supported triggers with the following Airship-supported actions:

Mapping limits per destination

Individual destination instances have support a maximum of 50 mappings.

Custom Events

Set Custom Events on Users

Custom Events is a Cloud action. The default Trigger is: type = "track"

Click to show / hide fields

Field Description
Airship Named User ID* Type: STRING

The identifier assigned in Airship as the Named User

Name* Type: STRING

Event Name

Occurred* Type: DATETIME

When the event occurred.

Event Properties Type: OBJECT

Properties of the event

Batch Data to Airship Type: BOOLEAN

If true, Segment will batch events before sending to Airship. Limit 100 events per request.

Manage Tags

Associate tags with users in your audience for segmentation and automation

Manage Tags is a Cloud action.

Click to show / hide fields

Field Description
Airship Named User ID* Type: STRING

The identifier assigned in Airship as the Named User

Tag Name Type: OBJECT

Tag name to add or remove. Values for each tag should be boolean only. A true value creates a tag, a false value removes a tag. Non-boolean values will be ignored.

Tag Group* Type: STRING

The Tag Group to sync your tags to. This defaults tosegment-integration but can be overridden with this field. Note: the Tag Group used must be valid and exist in Airship.

Set Attributes

Set user attributes in Airship with data from Segment. Some common user attributes are predefined in the attributes field, however note that all must be created in Airship before use. More information here: https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/attributes/project/#adding-attributes

Set Attributes is a Cloud action. The default Trigger is: type = "identify"

Click to show / hide fields

Field Description
Airship Named User ID* Type: STRING

The identifier assigned in Airship as the Named User

Occurred* Type: DATETIME

When the Trait was set

Attributes Type: OBJECT

User Attributes. Attributes should exist in Airship in order to be set, including the predifined ones defaulted here.

Register And Associate

Register an Email address or SMS number and associate it with a Named User ID.

Register And Associate is a Cloud action. The default Trigger is: type = "track" and event="Address Registered"

Click to show / hide fields

Field Description
Channel Type Type: STRING

Email (default) or SMS

SMS Sender Type: STRING

A long or short code the app is configured to send from (if using for SMS).

Airship Named User ID Type: STRING

The identifier assigned in Airship as the Named User

Locale Type: STRING

Locale includes country and language

Timezone Type: STRING

Timezone

Registration Type Type: STRING

Classic or Double

Channel* Type: OBJECT

Information about the email registration.

Named User ID

Named User is an Airship concept for identifying users and associating them with devices and delivery addresses. For more information, see Airship | Named Users. This integration does not perform the association of a Named User to a delivery address, configure that in either the mobile/web SDK or through a custom workflow out of band from this integration.

Engage

You can send computed traits and audiences generated using Engage to this destination as a user property. To learn more about Engage, schedule a demo.

For user-property destinations, an identify call is sent to the destination for each user being added and removed. The property name is the snake_cased version of the audience name, with a true/false value to indicate membership. For example, when a user first completes an order in the last 30 days, Engage sends an Identify call with the property order_completed_last_30days: true. When the user no longer satisfies this condition (for example, it’s been more than 30 days since their last order), Engage sets that value to false.

When you first create an audience, Engage sends an Identify call for every user in that audience. Later audience syncs only send updates for users whose membership has changed since the last sync.

Real-time to batch destination sync frequency

Real-time audience syncs to Airship (Actions) may take six or more hours for the initial sync to complete. Upon completion, a sync frequency of two to three hours is expected.

Settings

Segment lets you change these destination settings from the Segment app without having to touch any code.

Setting Description
Access Token
(required)
password. Create in the Airship Go dashboard in Settings->Partner Integrations->Segment
App Key
(required)
string. The App Key identifies the Airship Project to which API requests are made.
Data Center
(required)
select, defaults to US.

US or EU

This page was last modified: 02 Nov 2023



Get started with Segment

Segment is the easiest way to integrate your websites & mobile apps data to over 300 analytics and growth tools.
or
Create free account