Subscription lists

How subscription lists work

A subscription list is a record of audience members opted in to receive messages for a defined topic on specified channels. Users control their own membership using opt-in and opt-out methods you provide. You can also add users through the API or opt in all audience members automatically.

Using these lists can help retain customers, since recipients can opt in and out of content per list rather than opting out of all messaging when messaging feels irrelevant or too frequent. For example, a retail brand can create a Weekly Deal Alerts list for email and SMS, and a customer can opt in on either or both channels.

Subscription types

Each list is for either commercial or transactional purposes. You specify the type when creating one and can change it at any time:

• Commercial content advertises or promotes a commercial product or service, including content on a website operated for a commercial purpose.
• Transactional content facilitates an already agreed-upon transaction, or updates a customer about an ongoing transaction.

Only send content that matches the list’s purpose. For transactional messages, verify with your legal team to comply with regulations.

Opt-in requirements

For a user to receive a message from a subscription list, they must be opted in to the list and to messaging on the engagement channelA communication medium supported by the Airship service. Supported channels include app, web, email, SMS, and open channels. Within some channels there may be specific platforms with individual characteristics. Example platforms include Chrome for the web channel and Android for the mobile app channel. the list is for. For commercial lists, they must be opted in to commercial messaging on that channel. For transactional lists, they must not be opted out of transactional messaging on that channel.

If any requirement isn’t met, Airship drops them from the audience. For example, someone subscribed to your commercial email list who is unsubscribed from marketing emails is excluded from your send. They said yes to the topic, but no to the emails.

Auto opt-in

When creating a new list, you can automatically opt in all channels of the types the list is for. Existing channels are opted in immediately when you save the list, and new channels are opted in as they are added to your project.

Auto opt-in cannot be disabled after saving your list. Lists with auto opt-in enabled also cannot be used with the Subscription trigger for Sequences and Automation.

Opt-in and opt-out methods

Set up the following so users can control their own list memberships:

• Preference Centers — Create a page in your app or website, or an Airship-hosted page linked from an email, where users can manage their memberships. See Preference Centers.
• SMS keywords — Include keywords in your messages, telling audience members how to opt in or out. See SMS keywords.
• Buttons — AXP Opt a user in to or out of a subscription list when they tap a button in your message. See Add buttons to message content in Buttons.

You can also add and remove list members using the API. See Populating a list using the API.

Using subscription lists with messaging

Include or exclude members of a subscription list in the audience for messages, feature flagsAn experimentation tool for controlling the availability of content or functionality in your app or website. A flag’s Configurations determine the audience, schedule, and property values to apply when the flag is enabled. Flag properties enable making immediate code updates, bypassing the need for traditional code changes and release processes., A/B tests, and Intelligent Rollouts. Using the API, include "subscription_list": "name_of_list" in the audience object. See Audience Selection in the API reference. You can also include the lists in segmentsA reusable audience group you create by selecting unique or shared user data..

When sending an email to a subscription list, you must include an unsubscribe link for opting out of all email messaging, and can also include a link to opt out of that list only. See Email unsubscribe links.

Subscription opt-in status can start Automations and Sequences and control message delivery:

• Trigger — Start an Automation or Sequence when a user opts in or out of a subscription list. See Subscription in Automation and Sequence triggers.
• Delivery condition — Restrict message delivery based on opt-in status. See Conditions in Create an Automation and Conditions in Add Messages to a Sequence.

Create a list

You can create up to 20 subscription lists per project:

1. Go to Audience, then Lists, then Subscription, and select Create subscription list.
2. Enter a name and description for the list. Both appear in your project’s Preference CentersA page where users can manage their opt-in statuses for the subscription lists in your project. Preference Centers are presented within your app or website or as an Airship-hosted web page..
3. (Optional) Enter a custom list ID. You cannot change the ID after saving the list.
4. Select Next.
5. Enable the channels you want to include in the list.
6. Select a subscription type.
7. (Optional) Check the box to enable auto opt-in. You cannot change this setting after saving the list.
8. Select Save.

After saving a list, you can edit or archive it. Archived lists cannot be used for targeting. Search for lists by name, ID, or description. Select the regenerate icon () to see the number of channelsA device or address registered with Airship to receive messages, such as a mobile app, web browser, email address, or SMS number. It stores opt-in status, device-specific information, and metadata used for targeting. Each channel has a unique channel ID. in the list.

Populating a list using the API

Subscription is tracked per named user, per channel type. A user’s opt-in on email is independent of their opt-in on SMS, but all of that user’s email channels share the same email subscription. Use the Scoped named user batch operations endpoint to subscribe or unsubscribe named users.

View eligible subscriber count over time

You can view the count of unique users subscribed to a list and opted in to notifications. Go to Audience, then Lists, then Subscription, and select the report icon () for a list. The default view is the last 30 days of data. Use the date filter to select a new time frame. To export the data as CSV, TXT, or JSON, select the download icon ().

Reporting is not available for lists enabled for auto opt-in.