Airship integration

Update customer profiles in Airship with survey responses to create powerful segments, campaigns, and flows.

Updated over a week ago

Iterate integrates with Airship by recording survey responses as custom attributes on user profiles and triggering events, allowing you to create powerful new audiences and segments. You can also deploy Iterate surveys as Airship In-App Automations, meaning you don't need to integrate any new SDKs.

Use Case

Fill in gaps and enrich your customer data by sending out a link to your Iterate survey via any channel in Airship: email, push, or in-app automation. The survey data will include the named user id, which will be used to identify that user. When they fill out the survey, the responses to each question will be set as a custom attribute in Airship.

With Iterate, you can collect nearly any type of data, ranging from personal info (name, age, email) to performance data (NPS, Customer Satisfaction, star ratings), preferences (preferred device, preferred frequency of communication), or personality (favorite book, dog, or cat person). What you ask is entirely up to you and what audiences you want to build.

Getting Started

To connect with Airship, you'll need three things:

  1. Your Endpoint. Select the endpoint associated with your Airship project (go.urbanairship.com for North America and go.airship.eu for Europe). See Airship's API documentation for more details.

  2. App Key. In your Airship project, go to Settings » Project Details and copy your App Key.

  3. Access Token. Create an access token by going to Settings » Tokens » Manage » Create Token. Give your token a name like 'Iterate' and select 'All Access' as the role. See Airship's documentation for details.

Once you have those, log in to your Iterate account, go to your company settings page, select the Airship integration, and enter the details.

Create your survey

Iterate surveys can be delivered via Airship in two ways:

If you plan to distribute your survey outside of Airship (or using Iterate's native SDKs), you can still use our integration to send response data back to Airship. You'll need to pass along your user's named user id (as the Iterate property external_id) as an associated piece of data with your survey, then enable the Airship integration in the Integrations dropdown menu on your survey dashboard.

Learn how to associate data with a user within your survey:

Create Airship Attributes

Airship Attributes are metadata used for audience segmentation and personalization. Before our integration can set the values for an attribute, you need to create the attribute in the Airship UI. Go to Audience » Attributes » Create Attribute, or follow the instructions on the Airship documentation.

Enter a relevant Attribute ID and Name, and select Text as the type.

Then, when you are configuring the integration for a specific survey, you'll see a spot where you need to enter the Attribute ID (not the name) you'd like to have the responses saved to. If the attribute hasn't been created, the data will not be saved in Airship.

Airship Custom Events

Each time a respondent answers a survey question Iterate triggers a server-side custom event within Airship named survey-question-response. Custom events allow you to trigger any number and type of follow-up campaigns.

Events have the following properties:

  • question - The text of the question prompt

  • survey_id - The survey id that the question is present on

  • label - The custom attribute name set for the question

  • response - The user's response to the question as human-readable text

  • Depending on the question type, the event will also include one of these typed fields:

    • response_int - the integer value of the response (e.g. for an NPS question)

    • response_string - the string value of the response, usually the same as the response property

    • response_array - an array of responses, e.g. for a multiple select question.

  • response_properties - Any response properties that were included

Learn more in Airship's documentation: Custom Events.

Our Airship integration is only available on plans that include Premium integrations.

Did this answer your question?