Look Up Devices and Identifiers

Various identifiers and a device lookup tool are located in a messaging project's Audience menu. Additional methods are provided for locating identifiers outside of the Airship dashboard.

Android Channel ID List

A channel ID is an Airship-specific unique identifier used to address a channel instance, e.g., a mobile app, web browser, email address. When an end user runs your application for the first time, a channel ID is created and returned to Airship. As of the Android 5.0 SDK, Airship Push Identifiers (APIDs) are known as Android Channel IDs.

Open your messaging project from the dashboard, then navigate to Audience » Android Channel IDs. The page lists all Android channel IDs associated with your app and returns the following information per Android channel ID:

Created date
Last Registration date
Status
Alias
Tags
FCM Registration ID

Device Lookup

Information about an individual device can be found by looking up a Channel ID An Airship-specific unique identifier used to address a channel instance, e.g., a mobile app, web browser, email address. , Named User A customer-provided identifier used for mapping multiple devices and channels to a particular user. , or Device Token An identifier used to identify an instance of your app running on an iOS device. Device tokens are provided by Apple Push Notification Service (APNs) and must be included in a push notification request targeting the associated device. .

  1. Open your messaging project from the dashboard, then go to Audience » Device Lookup.
  2. Enter a device identifier into the search field. Results update as you type. If a valid identifier was entered, information about associated devices is displayed below the search field. This example shows the results for named user ID kristina, including Created and Last Modified dates for the named user itself, as well as information for the device associated with the named user.
  3. Click the device pane to open a modal window containing detail about the device, organized on tabs: Channel Detail, Channel Tags, Device Properties, and Tag Groups.

Depending on the ID type queried and data available, results may include:

Channel ID, Named User ID, or Device Token
Installation, Opted In, and Background status indicators
Created date
Last Registration date
Aliases
Push Address
Tags
Timezone
Language Country
Language
[OS] Model
[OS] Version
[OS] UA SDK Version
[OS] App Version
Location Enabled status
Push Notification Opt-in status
Background Enabled status
Channel Type
Web SDK Version
Browser Name
Browser Type
Browser Version

 Note

If you are an Optimal Send Time customer, that data is included in results.

Device Token List

A device token is an identifier for the Apple Push Notification System (APNs) for an iOS device (iPhone or iPad). As an Airship customer, you need not concern yourself with device tokens, as we will create a channel ID that acts as your primary identifier for addressing devices. If a device token should change for an underlying app, we will map the channel to the new device token.

Open your messaging project from the dashboard, then go to Audience » Device Tokens. The page lists all iOS device tokens associated with your app and returns the following information per device token:

Created date
Last Registration date
Status
Alias
Tags

Find Your Mobile App Channel ID

You must first build into your mobile app a mechanism to expose the device's Channel ID An Airship-specific unique identifier used to address a channel instance, e.g., a mobile app, web browser, email address. to the console.

You can view the console with these tools:

If you didn't write the device identifier to the console, you can use the steps here to help retrieve it: Using Charles Proxy to profile an Airship Implementation.

 Tip

Even if you're comfortable with using Charles Proxy, you may want to speak with your developer before you attempt to retrieve your Channel ID yourself. Your app may have been designed with a hidden feature that allows you to quickly retrieve your ID, saving you the difficulty of working with Charles Proxy.

Find Your Web Browser Channel ID

A channel ID is an Airship-specific unique identifier used to address a channel instance, e.g., a mobile app, web browser, email address. To access your web channel ID, you will need to open the Developer console in your browser and paste in a small amount of code. Instructions for Google Chrome and Mozilla Firefox are provided.

  1. Open the console via keyboard shortcut or the menu.

    Google Chrome Keyboard Shortcuts: In macOS you can go directly to the console with Cmd+Opt+J. In Windows, the shortcut is Ctrl+Shift+J.

    Google Chrome Menu: Click the three dots to the right of the address bar, select More tools... » Developer tools, then select the Console tab.

    Mozilla Firefox Keyboard Shortcuts: In macOS you can go directly to the console with Cmd+Opt+K. In Windows, the shortcut is Ctrl+Shift+K.

    Mozilla Firefox Menu: Click the three horizontal lines to the right of the address bar, click the Developer icon, then select Web Console. It will open to the Web Console tab.

  2. Paste UA.then(sdk => {console.log(sdk.channel.id)}) in the console, then hit Enter. The resulting line is the channel ID.