---
title: "Send notifications from Airship"
slug: "integrate-airship-with-apps"
updated: 2023-03-16T05:43:38Z
published: 2023-03-16T05:43:38Z
canonical: "docs.viewlift.com/integrate-airship-with-apps"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.viewlift.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Send notifications from Airship

[Airship](https://www.airship.com/) is a customer engagement platform for mobile apps to help you deliver personalized notifications to users. Airship provides push messaging services and targeting capabilities through user segmentation. We can help you configure Airship with push notifications from your developer account.

Once the SDKs are integrated, your [iOS](https://docs.airship.com/platform/mobile/setup/sdk/ios/) or [Android](https://docs.airship.com/platform/mobile/setup/sdk/android/) native apps will pass user tags from ViewLift tools to Airship as well as forward event data.

Note

- Before your app is able to send notifications, please configure the Airship keys in the Tools Platform. To do this, go to **AppCMS** > **Settings** > **NOTIFICATIONS & ENGAGEMENT CHANNELS**. In the Airship section, enter your secret key  
![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/Engagement-channel-Airship_Viewlift.png)
- Go to advanced settings, and enable the **Churn Tag** option to pass Churn user events from ViewLift to Airship. ![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/image-1636619143989.png)
- Airship currently supports notifications only for mobile apps. Web isn't supported.

### Create Tag Groups

Tags are metadata that you can associate with channels or named users to help you organize and target your audience. Tag groups categorize your tags.

To create a Tag Group:

1. Go to **Settings** > **Project Configuration** and click **Manage** for Tag Groups.
2. Click **Create Tag Group** and enter:  
- **Name**: A friendly name for the tag group that will help you recognize the tag group in other places. Example, User Subscription End date.  
- **Description**: A description of the tag group.  
- **Group** **Key**: The unique ID for the tag group, and how you will reference the tag group in the ViewLift app SDK.
3. (Optional) **Enable Allow these tags to be set only from your server**. This increases security by requiring tag read-write operations to be authenticated with your master secret key.  
![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/image-1636639913186.png)Creating a Tag Group in Urban Airship
4. Click **Save**.  
![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/Tag-groupsviewlift.png)List of Tag Groups you can create with user events and tags

### Named users

Enable Named users tag from **Settings** > **Project Configuration,** click **Manage** to add customer's first name in your push notifications. The **vl_user_id** in ViewLift can be passed to display the names of users in Airship. For more information, see [Named users](https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/named-users/). ![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/named-user.png)

### Look up users in ViewLift Tools

You can get the GUID of a user in the Tools platform and use it to search for a specific user in Airship.

1. In the ViewLift Tools platform, go to the User tab and search for a user you want to verify in Airship.  
![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/sample.png)
2. From the search results, click the user row to display the user details page.
3. From the URL, copy the last part of the URL after "accountNew" as shown in the figure below:  
![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/vl-user-id.png)
4. Place the GUID into Airship by navigating to Audience > [Contact Lookup](https://docs.airship.com/guides/messaging/user-guide/audience/lookup/).

### Create a Test group

Want to test the integration between app SDKs, Airship, and ViewLift Tools? If you are testing for the first time, a test build and the **channel ID** (device token ID) are necessary. You can then create a test audience group. To create a [test group](https://docs.airship.com/guides/messaging/user-guide/audience/preview-test-groups/), go to **Audience** > **Preview and Test Groups > Add user**.

![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/image-1636811530861.png)

![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/test-groups(1).png)Get the device id and paste it into the ID field in Airship

Please reach out to ViewLift Support if you want to test out the integration between the ViewLift Tools and Airship. If you want to test any new tags or new event data which you implemented after the initial configuration, you can test it in the live environment with 'real' push notifications.

### Airship x ViewLift 5 real-world use cases

1, **User (a) receives personalized push notifications to upgrade from monthly to yearly membership.**

You can create user segmentation using tag groups and tags that are getting from ViewLift. Create [audience segmentation](https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/segmentation/) in Airship to categorize monthly users from yearly users. In order to execute this use case and the following, updates to both the app SDKs, Airship SDK, and connection between the two are necessary. Based on that you can consider new custom implementation, ViewLift will engage with the Airship Onboarding team to run through their implementation process.

![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/image-1636811539338.png)Create user segmentation from Audience > Segments

2, **User (b) receives personalized push notifications about shows being filmed in their city.**

ViewLift exposes location settings to Airship. Create a targeted segment with language and country.

![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/image-1636637187474.png)User segmentation by location

![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/personalized.png)

You can add additional filters in the form of an event/[attribute](https://docs.airship.com/guides/messaging/user-guide/audience/segmentation/attributes/) key-value pair.

3. **User (c) receives personalized push notifications that their free trial access ends in 3 days, and is prompted to upgrade.**

By default, ViewLift doesn't fire user information for free trial period. Contact ViewLift Support if you want to capture this event in ViewLift and pass it to Airship. The challenge could be that on a per-user basis you will need to know that their trial ends in 3 days or if you want ViewLift to send the event to Airship 3 days prior to the end of the trial, and use that as a trigger for an ongoing message.

4. **User (d) receives personalized push notifications when they've watched 3 live streams/TVOD content to upgrade to paid membership.**

By default, ViewLift doesn't pass these user tags or events to Airship. You might want to leverage on custom events since these events can be counted. ie, send this message if [custom event](https://docs.airship.com/guides/messaging/user-guide/data/custom-events/#overview) occurs a certain amount of times.

5. **User (e) receives personalized push about new observational shows released after they've watched 5+ amount of shows tagged as 'observational'.**

Create a Category tag group in Airship and tag the 'observational' tag if you have added it in ViewLift Tools. ViewLift will start sending that particular category to Airship once you configure it. Using that you can create a segment with that category tag, and send targeted notifications. Here's example below:

![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/observational-tag.png)Displays the Category info passed from VL to Airship 

### Create deep linking

1. Log in to your Airship account and draft a message.
2. From the **Airship** apps page, click on your account.
3. From the **Messages Overview** page, click the **+** button in the upper-right corner.  
  
![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/create-message(2).png)
4. In the **What would you like to create** page, select **Message**.
5. In the following **Who will receive your message** page, turn on the toggle for the channels on which you want to deliver the message.![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/target-specific-users.png)Send messages to targeted audience. Click All Users if you want to deliver to all users
6. In the **Search for a condition** drop-down, select a condition or search by an attribute. For example, search by **Device Property**.  
![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/search-by-attributes.png)
7. Click **Add a block** to add more user attributes to refine the audience further.
8. After setting up the audience filter, click on the **Content** tab in the main menu on top, and select the message type as **Push Notification**, **In-App Message**, or **Silent Push Notification**. You can combine the message to be delivered both as a push notification as well as an in-app message.
9. Click **Add** **content**.  
![](https://cdn.document360.io/15e0c142-c823-4c77-a8e8-9d32ca937982/Images/Documentation/content-tab(1).png)
10. To deep link a video or series, from the **Actions** tab, select **Deep Link**, and paste the permalink of the video in the **videoname** field. The full app url with the videoname appears in the field below. Try the optional features in the Optional features section as shown in the mock screen above. For more information on how to manage deep linking within your apps, see this Airship's [article](https://docs.airship.com/guides/messaging/user-guide/project/config/deep-links/).
11. Move to the **Delivery** tab on top, and select one of the following type of delivery: **Send now**, **Schedule** or **Recurring**.
12. Go to **Review & Schedule** tab to review your message before hitting the **Send** button.

## Related topics

[Manage Tag Groups](https://docs.airship.com/guides/messaging/user-guide/project/tag-groups/#create-a-tag-group)