This document explains how to find the Channel ID using the Channel Capture Tool, on order to send a Test Push in Android and iOS.

* Please note that contents may change at the discretion of Airship, and it is always best to consult their documents directly:

https://support.urbanairship.com/hc/en-us/articles/360006723352-How-to-find-the-Channel-ID-using-the-Channel-Capture-Tool

 
in this document, we will walk you through preparing your device, obtaining the Channel Capture token, and steps to reveal the Channel ID for your test device.

We recommend that you send a test message to the app on a test device (or a group of test devices) prior to sending to your desired audience to ensure the message functions and displays as expected.

To help find your Channel ID our SDK contains a built-in tool for retrieving your Channel ID called the Channel Capture Tool.

You have two ways to obtain the Channel ID of your specific device:

OPTION 1 - USING A CHANNEL TOKEN

Steps

1. First you will want to submit a support ticket or email with the app key for the application you would like the token for and a request for a Channel Capture Token. Each application will have it's own token which will work for all Android and iOS devices on the application. 
   
   

   If you have production and development versions of the app, each will have its own app key and token. You can include multiple applications in one email.

2. Once we receive the email we will respond with the Channel Capture token for your app. This will be a long string of letters and numbers such as this example:
   
   

   MTcxMTBlM2UwZTI0MzMyOTA3NmMyNjEzMzB4TDA4MzQxBDYyNjE2MzJmMTA

3. Once you have been provided the token, you will want to send this to your device, such as by email or SMS text message so that this token can be copied and saved on the device's clipboard. 
   
   
4. Open the message on your device and long press on the token to copy into your device's clipboard. Be sure to copy the full token and nothing else such as punctuation or white space.
   
   
   
   
5. Open your application on your device.
   
   
6. A pop-up should appear on your screen which shows your Channel ID with options to copy or share.
   
   

IOS -

Channel Capture Tool's capabilities are disabled by default on the individual device. It can be enabled on the device by doing the following (This is in addition to and will not override the application level flag mentioned in requirements):

1. Open the Settings menu on the Device.
2. Scroll down until you find your application listed and tap on it to select
   
   
   
   
3. Turn Off Background App Refresh
   
   
   
4. Follow above steps to copy the Channel Capture Token into the device clipboard and open the app to reveal the Channel ID
5. Remember to Turn Background App Refresh back on

Android -

Channel Capture Tool's capabilities are disabled by default on the individual device. It can be enabled on the device by doing the following (This is in addition to and will not override the application level flag mentioned in requirements):

1. Open the Settings menu on the Device.
2. Go to Apps and Notifications (Maybe just called Applications or Notifications depending on the Android Version and Manufacturer)
   
   
   
   
3. Find and select your application
   
   
   
   
4. Block/Turn off Push Notifications for the application
   
   
   
   
5. Follow above steps to copy the Channel Capture Token into the device clipboard and open the app to reveal the Channel ID
   
   
   
   
6. Remember to unblock notifications once you retrieve your Channel ID

OPTION 2 - VIA "Console" (iOS) and "Android Studio" (Android)

iOS -

i- Make sure you have the Release(!) versions of your apps on the device (Downloaded from the Store or TestFlight)

ii- Make sure there are NO active apps in running in the background on your device (ie: all apps are closed on your device)

iii- Connect your iPhone device to your Mac computer and Launch the "Console" program that comes with the computer

iv- See that your Device is identified on "Console" (you will see it appear in the left hand side) and select it:
​​
​​
v- Launch your app --> You will see data starting to flow in the console

vi- Filter the Console by using the command channel id --> Your individual Channel ID will appear:
​
​

vii- Copy this channel ID to your Clipboard, and proceed to use it in the Airship Dashboard, in order to send the push to your specific device, following this document:
https://applicaster.zendesk.com/hc/en-us/articles/360030407411-Sending-pushes-to-a-single-device-from-Airship-dashboard

Android -

i- Make sure you have the Release(!) versions of your apps on the device (Downloaded from the Store or TestFlight)

ii- Make sure there are NO active apps in running in the background on your device (ie: all apps are closed on your device)

iii- Connect your Android Device to the computer and Launch the "Android Studio" program
​​

iv- Make sure to Allow Access to Phone​​, when prompted on screen:

v- Select the "Logcat" option and start seeing Data Flow.
Make sure you see/select the following:
 (a)- See your device model, indicating you are connected
 (b)- See you are in Logcat mode
 (c)- Make sure you are have selected the "Verbose" option
 (d)- Make sure you have selected the √ "Regex" option
​​

vi- Filter using the command channel id

vii- Launch your app

viii- Your individual channel ID will appear:
​​

ix- Copy this channel ID to your Clipboard, and proceed to use it in the Airship Dashboard.

in order to send the push to your specific device, following this document:
https://applicaster.zendesk.com/hc/en-us/articles/360030407411-Sending-pushes-to-a-single-device-from-Airship-dashboard