Use Channel Coordination

Channel Coordination is a group of strategies you can use to target users where they are most likely to receive your message.

See the feature guide: Channel Coordination.

 Note

Fan Out A channel coordination strategy that refers to targeting a user on all known channels at the same time. is part of Airship core functionality. The other channel coordination strategies require the Orchestration add-on. Please contact Airship Sales to enable Orchestration for your account.

Prerequisites

  1. Contact Airship Support or our Sales team to provision your project for Orchestration. You will be asked to provide your app key:
  2. Open your messaging project, then go to Settings » APIs & Integrations and copy your App Key. Provide the app key for each project you want to enable to Orchestration.
  3. Implement Named User A customer-provided identifier used for mapping multiple devices and channels to a particular user. . Follow the steps in How To Implement Named Users.

Fan Out

Fan Out is a channel coordination strategy that refers to targeting a user on all known channels at the same time in order to maximize chances they receive the message. This approach is suitable for highly urgent messages, where the user will not be sensitive to feeling over-messaged.

In the Audience step of the Message or A/B Test composers:

  1. Select the channels to include in your audience.
  2. Select Target Specific Users.
  3. Under Search, enter the named user, then select from the listed results.

In the API, you will enumerate all configured messaging platforms using the device_types selector:

POST /api/push HTTP/1.1
Authorization: Basic <master authorization string>
Content-Type: application/json
Accept: application/vnd.urbanairship+json; version=3;

{
   "audience": {
      "named_user": "ozymandias"
   },
   "notification": {
        "alert": "Look upon which works now?"
    },
    "device_types": [
       "ios",
       "android",
       "sms",
       "web"
    ]
}

Last Active

Last Active is a channel coordination strategy that refers to targeting a user on their most recently used channel. In many cases user recency is the best indicator of preference.
 Note

Last Active is not available for use with SMS notifications.

In the Audience step of the Message or A/B Test composers:

  1. Select the channels to include in your audience.
  2. Select Target Specific Users.
  3. Search for last_active, then select the Orchestration tag group result. You can also click and select the Orchestration tag group to filter your results.

In the API, use the last_active tag in the ua:orchestration tag group:

POST /api/push HTTP/1.1
Authorization: Basic <master authorization string>
Content-Type: application/json
Accept: application/vnd.urbanairship+json; version=3;

{
   "audience": {
      "tag": "last_active",
      "group": "ua:orchestration"
   },
   "notification": {
      "alert": "Hi, last active!"
   },
    "device_types": [
       "ios",
       "android",
       "sms",
       "web"
    ]
}

Example Response:

HTTP/1.1 202 Accepted
Content-Type: application/json; charset=utf-8
Data-Attribute: push_ids

{
   "ok": true,
   "operation_id": "df6a6b50-9843-0304-d5a5-743f246a4946",
   "push_ids": [
      "9d78a53b-b16a-c58f-b78d-181d5e242078"
   ]
}

Priority Channel

Priority Channel is a channel coordination strategy that refers to targeting the highest priority channel associated with each user. If a user is not opted-in on the highest priority channel, then priority channel will select the next-highest priority channel on which a user is opted-in. If a user has multiple opted-in channels on a given channel, e.g., both an iPad and iPhone on iOS, the message will be sent to both channels.

Before you can target users based on channel priority, you must set the priority order in your project. You must have at least two channels configured and enabled.

Configure Channel Priority Order

Set the priority order of your project's configured and enabled channels:

  1. Open your messaging project from the dashboard, then go to Settings » Configuration » Channel Priority.
  2. Check the Enable box next to any channel you would like to include, and click the arrows to change their order.
  3. Click Save.
 Note

  • When choosing the App channel as priority, we will deliver to any iOS, Android, or Amazon devices that are opted-in to notifications.

  • Open Channels are listed using the name entered when adding the service in Settings » Channels » Open Channels.

 Note

Additional processing time may be required to set the priority_platform tag for larger audiences. The priority_platform tag will be available for use after several minutes for smaller audiences and up to several hours for audiences of 1 million or more.

Target Priority Channels

In the Audience step of the Message or A/B Test composers:

  1. Select the channels to include in your audience.
  2. Select Target Specific Users.
  3. Search for priority_platform, then select the Orchestration tag group result. You can also click and select the Orchestration tag group to filter your results.

In the API, use the priority_platform tag in the ua:orchestration tag group:

POST /api/push HTTP/1.1
Authorization: Basic <master authorization string>
Content-Type: application/json
Accept: application/vnd.urbanairship+json; version=3;

{
   "audience": {
      "tag": "priority_platform",
      "group": "ua:orchestration"
   },
   "notification": {
      "alert": "Hi, priority channel!"
   },
   "device_types": [
      "ios",
      "android",
      "sms",
      "web"
   ]
}

Example Response:

HTTP/1.1 202 Accepted
Content-Type: application/json; charset=utf-8
Data-Attribute: push_ids

{
   "ok": true,
   "operation_id": "df6a6b50-9843-0304-d5a5-743f246a4946",
   "push_ids": [
      "9d78a53b-b16a-c58f-b78d-181d5e242078"
   ]
}

User Preference

User Preference is a channel coordination strategy that refers to targeting a user on their preferred channel. This is understood to provide the optimal customer experience.

Before you can target users based on a their channel preference, you first need to set tags expressing that preference. In order to set a preferred channel for a user, they must be opted in on at least two messaging channels, e.g., iOS and web.

Set User Preference Tags

You will set a "user_preferred" tag in the "ua:orchestration" tag group on one channel per named user.

  1. List all channels for your named user by using the Named User Lookup API.

  2. Once you parse the results to gather the Channel IDs, you maintain the "user_preferred" tag on each channel, using our Tags API:

POST /api/channels/tags HTTP/1.1
Authorization: Basic <master authorization string>
Accept: application/vnd.urbanairship+json; version=3;
Content-Type: application/json

{
   "audience": {
      "ios_channel": "b8f9b663-0a3b-cf45-587a-be880946e881"
   },
   "add": {
      "ua:orchestration": [
         "user_preferred"
      ]
   }
}

Target Preferred Channels

In the Audience step of the Message or A/B Test composers:

  1. Select the channels to include in your audience.
  2. Select Target Specific Users.
  3. Search for user_preferred, then select the Orchestration tag group result. You can also click and select the Orchestration tag group to filter your results.

In the API, use the user_preferred tag in the ua:orchestration tag group:

POST /api/push HTTP/1.1
Authorization: Basic <master authorization string>
Content-Type: application/json
Accept: application/vnd.urbanairship+json; version=3;

{
   "audience": {
      "tag": "user_preferred",
      "group": "ua:orchestration"
   },
   "notification": {
      "alert": "Hi, preferred channel!"
   },
   "device_types": [
      "ios",
      "android",
      "sms",
      "web"
   ]
}

Example Response:

HTTP/1.1 202 Accepted
Content-Type: application/json; charset=utf-8
Data-Attribute: push_ids

{
   "ok": true,
   "operation_id": "df6a6b50-9843-0304-d5a5-743f246a4946",
   "push_ids": [
      "9d78a53b-b16a-c58f-b78d-181d5e242078"
   ]
}

Include Channel Coordination Tags In an Audience Segment

Segments are reusable audience selection criteria. You can use segments when targeting an audience instead of recreating your audience selections every time you send a message. You can include channel coordination tags in your segments.

Follow the steps in the Segments Builder Tutorial to create a new segment, and include a channel coordination tag:

  1. Click Select a tag and choose Orchestration
  2. Search for last_active, priority_platform, or user_preferred.
  3. Complete the steps in the Segments Builder tutorial.