Delivering surveys via Airship In-App Automation

With the Airship SDK installed in your app, you can use the segmentation and targeting tools available in Airship to deliver In-App Automations to a specific portion of your audience based on any trigger or custom segment.

Now, Iterate's integration with Airship allows you to deliver Iterate surveys natively and seamlessly as an In-App Automation, using only the Airship SDK and without any additional setup.

Make sure you've added your Endpoint, App Key, and Access Token in your Iterate settings, as described here.
Next, you'll turn on the toggle in the Airship settings section of your company settings page to 'Enable In-App automation surveys'. Before you do this, you'll need to reach out to our support team via chat to request it to be enabled and give them your MAU count from your Airship dashboard. Once you've done that, turn the toggle on to enable in-app messages.
Create a new survey in Iterate. For the survey type, choose "Send via Airship In-App Automation". Add questions, and if appropriate a prompt message to be shown before the survey. (Don't see this option? Make sure you've enabled the toggle from step 2)
In the "Publish" tab for your survey, download the code.
Create a new In-App Automation message in Airship. Select 'Custom HTML' as the message style.
Fill out the settings for the Automation as you see fit. Once you get to the Content section, upload the code you downloaded in step 4.
On the Design section, set the background color to #00000000 (note that's 8 zeros, not 6). This will make the background fully transparent.
Continue setting up your message as you would any other in-app automation, choosing a trigger, etc.

Using custom fonts
Technical difficulty: easy

If you'd like to use a custom font in your Iterate survey, you can import your custom font and override the default font-family specified in our HTML embed code. Example below

Import your font
The method used to import your font will depend on your file type. Talk to your engineering team to find out which method to use.
```
<style>
@import url('https://fonts.googleapis.com/css2?family=Rubik+Pixels&display=swap');
</style>
```
Override the font-family
```
<style type="text/css">
̶h̶t̶m̶l̶ ̶{̶ ̶
f̶o̶n̶t̶-̶f̶a̶m̶i̶l̶y̶:̶ ̶-̶a̶p̶p̶l̶e̶-̶s̶y̶s̶t̶e̶m̶,̶ ̶B̶l̶i̶n̶k̶M̶a̶c̶S̶y̶s̶t̶e̶m̶F̶o̶n̶t̶,̶ ̶'̶S̶e̶g̶o̶e̶ ̶U̶I̶'̶,̶ ̶R̶o̶b̶o̶t̶o̶,̶ ̶O̶x̶y̶g̶e̶n̶,̶ ̶U̶b̶u̶n̶t̶u̶,̶ ̶C̶a̶n̶t̶a̶r̶e̶l̶l̶,̶ ̶'̶O̶p̶e̶n̶ ̶S̶a̶n̶s̶'̶,̶ ̶'̶H̶e̶l̶v̶e̶t̶i̶c̶a̶ ̶N̶e̶u̶e̶'̶,̶ ̶s̶a̶n̶s̶-̶s̶e̶r̶i̶f̶;̶ ̶
}̶

html {
font-family: 'Rubik Pixels';
}
</style>
```
Passing Airship user attributes to Iterate
Technical difficulty: medium

In some cases, you may want to make attributes from users' profiles in Airship available to Iterate, so that you can use those attributes to help segment and filter your survey responses in the Iterate dashboard, or use the data to personalize your survey using Dynamic Text.

Example: an e-commerce marketplace might want to include an attribute that identifies a user as a "buyer" or a "seller", so they can then filter their survey responses in Iterate to only show buyers or sellers.

By default, Iterate will include only the user's named user id via the integration. If there are additional attributes you'd like to include, you can add them to the HTML code provided in the "Publish" tab of your survey.

To add attributes, enter the name and value in the in the 'Customize user properties' section above the code you downloaded in step 4 above. You'll need to re-download the code after you've modified any properties.

Important Note: Once created, the type of a property (e.g. 'user_id' is a number) cannot be changed. If you need to update the property type you can create a new key (e.g. 'user_id_string') or reach out to [email protected] to help.

You can also add attributes that are specific to this session or survey response, by adding an additional field to the JSON object called responseTraits:
```
"userTraits": {
    "external_id": UAirship.getNamedUser()
},
"responseTraits": {
    "survey_campaign_name": "{{campaign.${name}}}"
}
```
These attributes will be available as filters in the Iterate dashboard, visible when browsing survey responses, and included in exported survey data.

Using custom fonts

Passing Airship user attributes to Iterate