Legacy Push Notification - Device Registrations

The Device Registrations screen is mainly used as part of the set-up process for the Push Notification marketing Channel. A Push Notification is a message that gets sent from theCheetah Digitalplatform to your branded app on a consumer's mobile device. When a consumer installs your app and subscribes to Push Notifications, the app must communicate the device ID and application ID back toCheetah Digital. The Device Registrations screen allows you to "map" that information from the consumer to the proper Table and field in your marketing database.

Prior to creating a Device Registration, the following steps must already be completed:

  • Your app (or apps) must be registered withinCheetah Digital; seeMobile Push Application Groups for more details.

  • You must have a dedicated Table that will be used to store information about the consumer's mobile device; see Tables for more details.

For more information on how to configure the Push Notification channel, please see the Push Notification Channel Setup Help topic.

Access

The Device Registrations screen is accessible by the following method:

  • From the Admin Banner Bar, select Settings > Campaign Settings > Device Registrations

Features

Create a New Device Registration

When a recipient downloads and installs your mobile app, Cheetah Digital will receive and record the device's attributes. These attributes include app installation time, the mobile device's ID (the distinct combination of a recipient’s app and device), the device token, the name and platform (iOS | android) of the app, the device status and message status.

The Device Registrations tab displays all the above attributes along with the following statuses:

Device Status - indicates if the device registration status is Valid (successful) or Invalid (not currently registered)

Message Status - indicates if the audience member has elected to receive push and in-App Messages. It can be one of the following:

  • Unknown -The user has not yet confirmed their permissions.

  • Quiet - The user can receive push notifications in quiet mode - i.e. the application will not actively alert the user.

  • Active - The user has allowed push notifications.

  • Disabled - The user has blocked push notifications.

In order to send a message, the Device status must be Valid and Message status must be Active or Quiet.

Whenever the recipient signs in to your mobile app, the device and message status are sent and updated in Cheetah Digital.

Copy a Device Registration

To copy an existing item to use as the basis for a new item:

  1. Search for the desired item (see Search for an Item for more details).

  2. Click on the item name. The main item screen is displayed and populated with the details of the selected item.

  3. In the Tool Ribbon, click Edit > Save As. A Save as dialog box is displayed.

  4. Enter a name for the new item.

  5. By default, the new item will be saved in the same folder location as the base item. Optionally, click the magnifying glass icon to browse to and select a different folder location.

  6. Click save a copy. The system creates a copy of the selected item.

View or Edit a Device Registration

To view or edit a Device Registration:

  1. Search for the desired Device Registration (see Search for an Item for more details on the available search methods).

  2. Click on the Device Registration name. The Device Registration screen is displayed and populated with the details of the selected Device Registration.

  3. Optionally, to view detailed information about the Device Registration, select the Push Registration Export tab in the Tool Ribbon. The Item Details screen is displayed, showing who created the item, who modified it last, and what the last actions taken on the item were. On this screen, click Related Items in the Function Menu to see other items in the system that reference or utilize this Device Registration. When finished, click the Edit tab in the Tool Ribbon to return to the main edit screen.

  4. Optionally, you can assign one or more tags to your Device Registration. To assign a tag, click on the Add tag field in the Edit section of the Tool Ribbon. The system displays a pop-up menu of all the existing tags. You can select one of these tags, or type in a new one and press Enter. You can repeat this process to add more tags. To remove a tag, click the X icon next to the tag label.  

  5. Optionally, to rename the Device Registration, click Edit > Rename. A Rename Item dialog box is displayed. Enter a new name for the Device Registration, then click save new name.

  6. Optionally, make any necessary changes to Device Registration by selecting a different field on the Source Table where you want to store the Push Registration ID and / or the Platform Name.

  7. When finished, click Edit > Save in the Tool Ribbon.

Delete a Device Registration

To delete an item:

  1. Search for the desired item (see Search for an Item for more details).

  2. Click on the item name. The main item screen is displayed and populated with the details of the selected item.

  3. In the Tool Ribbon, click Edit > Delete. A confirmation dialog box is displayed.

  4. Click delete item to confirm the deletion.

Foldered items are moved to the Recycle Bin. Non-foldered items are permanently deleted.