Airship

Use GrowthLoop audiences for Airship lists and messaging.

Connect this destination to export audience membership into Airship as a list, for use in Airship campaigns.

This destination writes to your Airship account and is a good fit when you want to:

  • Send a Named User or channel identifier
  • Make GrowthLoop audiences available for Airship messaging

This maps to GrowthLoop Audiences and Journeys:

Use it forAudiencesJourneys
Sending GrowthLoop audiences to Airship lists✓✓

Prerequisites

Make sure you have:

  • An Airship account. You can request a demo.
  • An Access Token with Audience Modification or All Access. Audience Modification grants read and write permission to audience APIs, including channels, named users, segments, and lists. All Access grants full access except Acoustic integrations.

Set up Airship as a destination

  1. In GrowthLoop, click the Destinations tab on the left sidebar.
  2. Click New Destination in the top right corner.
  3. Search for Airship and click Add Airship.
Select Destination modal showing Airship
  1. Enter the required information, then click Create.
Airship destination setup form
FieldDescription
Destination NameName this destination in GrowthLoop. Use a name so your team recognizes its purpose, like "Airship Push".
Sync FrequencySet the default export frequency (for example, daily or weekly). You can override this setting for individual exports.
RegionThe Airship region for your project.
Access TokenToken from your Airship dashboard with Audience Modification or All Access.

GrowthLoop validates the permissions. Airship then appears in your list of connected destinations.

Airship destination listed after a successful connection

Export to Airship

From within GrowthLoop, export from an audience or from a journey Destination Node. See Export an audience or Build a journey if you need more information on these steps.

After building or selecting an audience, click Export, then search for Airship.

Export modal with Airship selected

In a journey, add a Destination Node under Push and select Airship.

Journey Destination Node with export name, match fields, and personalization signals

Map identifiers

Map at least one identifier. Channel IDs are typically UUIDs.

Match fieldDescription
Named UserAirship Named User ID
IOS ChanneliOS channel ID
Android ChannelAndroid channel ID
Amazon ChannelAmazon channel ID
SMS ChannelSMS channel ID
Email ChannelEmail channel ID
Open ChannelOpen channel ID
Web ChannelWeb channel ID

You can also map custom attributes from the audience or from the journey as additional fields.

Airship match field mapping with Named User and channel identifiers

Configure the export

This is where you set the campaign type and schedule for audience exports. On a journey Destination Node, you set timing on the journey canvas.

SettingAudience exportJourney Destination Node
Export NameDefaults to the audience name.Required. Enter a name so you can find the export in GrowthLoop and Airship.
Campaign typeChoose a one-time or ongoing export.The journey schedule controls when the journey runs and contacts are sent to Airship.
ScheduleSet frequency, start date, end date, and days of the week.Users reach this node when the journey runs. Add a Delay Node or set Criteria Evaluation to control timing.
Airship export settings including name, campaign type, and schedule

Export behavior

This is what GrowthLoop writes when you export an audience.

BehaviorWhat happens
What GrowthLoop writesMembership on an Airship audience list. Direction is GrowthLoop → Airship.
When it runsGrowthLoop sends the export as a batch on the next successful run. An export that starts Now runs within about 15 minutes. Journeys send exports on demand when users reach the Destination Node.
ListGrowthLoop sends membership to an Airship audience list.
IdentifiersAirship matches Named User or channel IDs. Channel values are typically UUIDs.
PersonalizationAdditional fields are supported.
One-time exportsGrowthLoop sends current membership once.
Ongoing exportsGrowthLoop sends updated list membership on each scheduled run.

Confirm the export was successful

When the run finishes, confirm you can use the data in Airship.

  • Audience export: Go to Audience → Lists and look up the exported list.
  • Journey Destination Node: Go to Audience → Lists and look up the list named after the export. Confirm a contact who reached the node is in it.
Airship Audience Lists showing an imported GrowthLoop audience

In GrowthLoop, review counts on the audience Exports tab, or open the Activity tab on the journey Destination Node. See Export an audience or Monitor a journey for more information.

Congrats on successfully exporting to Airship!

Troubleshooting

These are the issues we see most often. You can always email us at [email protected] for help.

ProblemCauseResolution
Connection fails to validateThe access token does not have audience write permissionUse a token with Audience Modification or All Access
Rows fail to matchNo Named User or channel identifier is mappedMap at least one Named User or channel identifier
Rows rejectChannel IDs are not in UUID formatConfirm channel IDs are UUIDs

What’s Next

Export an audience after you connect a destination

Did this page help you?