Urban Airship Push - Getting Started

Urban Airship Push - Getting Started

What you need to get started

You’ll need a couple of things before you can set up your Urban Airship action:

  1. An Urban Airship account: If you don’t have one you can sign up on urbanairship.com

  2. The Urban Airship SDK installed and configured in your mobile app(s). You will have the option to create development apps in Urban airship. Your development and production app credentials will both work with Customer.io.

  3. Configure your users to be Urban Airship named users: named users ids are how you will associate your profiles in customer.io with the users in your mobile app and Urban Airship app. See Getting started, part II for more details.

  4. A master secret and Application Key from your Urban Airship app:

Urban Airship - Credentials Menu


Urban Airship - Credentials Page

Note: You can configure multiple apps with Urban Airship, so make sure you are using the credentials associated with your production apps.

The right data in Customer.io: You need to make sure you’re getting the right data from your users. This is a little more complex, and is explained in detail below.

Configure your user data in Customer.io

To make sure that you can reach your customers via push notification, you’ll need to make sure that you have the right data in Customer.io.

Most importantly, your users in Urban Airship must be associated with a named_user_id. Documentation for creating this association can be found here. If your users do not have a named_user_id created with this association they cannot be messaged.

In Customer.io you will need to store the named_user_id you previously defined for your users as an attribute (for example, an attribute called named_user). This id is what we will use as the TO address for your push notifications.

Urban Airship - Profile Data

What is a named user?

A Named User is an identifier managed by Urban Airship. Here's how they describe the value of named users:

It is useful to think of a Named User as an individual consumer who might have more than one mobile device registered with your app. For example, Named User "john_doe_123” might have a personal Android phone and an iPad, on both of which he has opted in for push notifications. If you want to reach John on both devices, associate the Channel (device) identifiers for each device to the Named User "john_doe_123,” and push to the Named User. Notifications will then fan out to each associated device.

This allows you to consistently message a user regardless of whether they switch devices and prevents you from having to manage individual device ids between Urban Airship and Customer.io.

Enabling Urban Airship in Customer.io

From your workspace dashboard, head to Email & Actions in the left panel, and click 'Get Started' next to Urban Airship:

UA - Get Started

What you'll need is your Application Key and Master Secret — as we mentioned, you can get these on app settings page under the APIs & Integrations section in your Urban Airship app. Copy and paste them into the fields in Customer.io:

UA - Credentials

Create your campaign

You're finally ready to create your campaign, and start sending your push notifications!

First, create a campaign in Customer.io that will trigger sending an push notification. Here, we’re using an event triggered campaign with account_upgrade as the trigger. So, once a customer upgrades their account, we want to send them a push notification that gives them a confirmation:

Urban Airship - Event-Triggered Campaign Creation

Add your Urban Airship action to the workflow

Now you can click to add an item to your workflow:

Campaign Setup - Add Workflow Item

Choose an Urban Airship push:

Campaign Setup - Add UA Push

Create a name that is descriptive; your end-users won't see this. Then, click Add Push. We're calling it "Account Upgrade Notification" so we can easily identify its purpose from the Campaign Overview:

If you want to add an A/B test, now's the time! Just click the Add A/B test button on the workflow item, or see more detailed instructions here!

Urban Airship - Name your Urban Airship Push

Next, click Add Content to open the SMS composer and set up your push notification message.

Alt text

Compose your Urban Airship Push

You're now ready to write your SMS. In the Customer.io composer, it consists of two parts:

  1. The "To:" field: The named_user_id that the message is headed to; defined earlier.
  2. The message Body: This is where your message's content goes.

Note: You can use Liquid here to send to specify a a different attribute if you've stored your named_user_id with a different name during setup. Just make sure you have the right attributes for that user. You can see this in action in our example below, or click here to learn more about Liquid in Customer.io.

At this point, your Push composer should look something like this (you can hit Preview to see what your SMS looks like):

Urban Airship - Composer Push Notification

Send test request

To make sure your push notification works, you can send a test message by entering a named_user_id in the test box (shown in the screenshot below), and clicking "Send Test”. This will send a real Push, so make sure you're sending the test to yourself (or a test account)!

Once sent, Customer.io will show you the response from Urban Airship, and you should see Test sent.

Urban Airship - Send Test Request


The push notification should then appear on your phone (or whichever device you chose to send it to)! We have a separate guide for tracking your sent push notifications.

Urban Airship - Test Notification Successful

Thank You!

We’re excited to hear how you end up using Urban Airship with Customer.io Actions. If you have questions, feel free to have a look at the FAQ, or let us know! We're happy to help.

Was this article helpful?