Legacy Mobile Push Application Groups

The Mobile Push Application Groups screen is used to register your mobile app (or apps) within Cheetah Digital. You must register your mobile app if you intend to use the Push Notification channel to contact your customers. This step is part of the larger process of setting up the Push Notification channel (see Push Notification Channel Setup for more details on this process).

Apps can be organized into Application Groups, which simplifies the process of sending out notifications. When you create a Push Notification Campaign, the notifications are sent out to an entire Application Group at once. For example, if you have an iOS version and a Google Android version of an app, you could add both versions to the same Application Group, and send out notifications to both versions of the app at the same time.

Separate Application Groups must be created for use with EDP and non-EDP Push Notifications. There are slight differences between EDP Application Groups and non-EDP Application Groups, the main one being that it is not possible to create a separate iOS and Google Android version of an Application Group for EDP.

For more information on the Push Notification features available through the Cheetah Digital platform, please see the document Cheetah Digital -- Push Notification Capabilities.

Access

The Mobile Push Application Groups screen is accessible by the following method:

  • From the Admin Banner Bar, select Settings > Campaign Settings > Mobile Push Application Groups

Create a New Application Group

To create a new Application Group:

  1. Click the new item button (plus-sign icon) above the list of existing Application Groups. The New Mobile Push Application Group pop-up window is displayed.

  2. Enter a name for your new Application Group.

  3. Select whether this Application Group will be used with an EDP or Cheetah Digital (non-EDP) Push Notification Campaign. Click save new item. A blank Mobile Push Application Group screen is displayed. For Cheetah Digital Application Groups, this screen is split into two main sections: Applications Belonging to this Group and Push Payload Schema for this Group. For EDP Application Groups, there is just one section for Push Payload.  

Add New Application (only applicable to Cheetah Digital Application Groups)

For legacy Cheetah Digital Application Groups, follow these steps to add an application to the application group:

  1. Click add application in the tool bar. A new Application Details section is displayed.

  2. From the Platform drop-down menu, select the operating system for your app (Cheetah Digital supports iOS and Android).

    1. iOS: In the Application Name field, enter the name of your app. In the Certificate File field, either enter the filepath to your app's certificate file, or click the Browse button to navigate to and select the certificate file. In the Certificate Password field, enter the password for your certificate file.

    2. Android GCM: Enter the name of your app, and upload the FCM Service Account File (JSON file) by clicking the Choose File button, to use FCM authentication.

  1. Click save. Your app is added to the list within the Applications Belonging to this Group section. This list shows the application name, operating system, and application ID. The application ID is a system-generated identifier that will be needed by the app developer.

  2. Optionally, repeat steps 1 through 3 as needed to add more apps to this Cheetah Digital (non-EDP) Application Group.

Define Push Payload

Push Notifications are delivered to mobile devices as JSON messages. This message contains the basic text of the notification, but it can be used for more advanced features as well. For example, the JSON message can define the portion of the message that appears within the Alert section of the user's device, or a deep link to open the app to a specific page, or play a video, or show order information.

The Push Payload section of this screen provides a JSON editor that can be used to define a JSON form schema. This form schema is a set of instructions that determines the appearance and options that are available when building the content of a Push Notification Campaign. Sample code is included by default, and this is what you will see in the Payload section of a Push Notification Campaign.

For EDP Application Groups, this Push Payload JSON editor will show two tabs for the two operating systems: iOS and Android.

To make changes:

  1. From the Platform toggle, select the operating system (iOS or Android). The template for this operating system is displayed within the JSON editor.

  2. Make any necessary revisions to the JSON schema.

  3. Click Revert to Default on the tool bar if required.

  4. Click Save on the tool bar to save changes.  

View or Edit an Application Group

To view or edit an existing Application Group:

  1. When the screen is displayed, a list of all the current Application Groups is displayed in the left-hand side of the Workspace. Optionally, you can filter this list by typing in all or part of a Group name in the Search by Name field.

  2. Click on the Application Group that you want to view. The Workspace is refreshed to show the details of the selected Application Group. 

  3. For Cheetah Digital (non-EDP) Application Groups, you can modify the Applications in this Application Group by clicking on the Application name. Make any necessary changes, and click save.

Assign an Application Group to a Campaign Source Table

Note: This section does not apply to EDP Application Groups.

When you define a Campaign in Cheetah Digital, you must define the source table (usually something like Customers or Recipients) that the Campaign will use to get its recipients, and to update the Status ID field that controls recipient eligibility to be contacted. For Campaigns in the Push Notification channel, the source table must be linked to the Application Group that you want to use for your Campaign.

Note: Once you assign an Application Group to a table, you can't remove that assignment.

To assign an Application Group to a table:

  1. From the Main menu, select Data > Management > Tables. The Tables screen is displayed.

  2. A list of all the current Tables is displayed in the left-hand side of the Workspace. Optionally, you can filter this list by typing in all or part of a Table name in the Search by Name field.

  3. Click on the table that you'll be using as the source table for your Push Notification Campaign. The Workspace is refreshed to show all of the data fields in the selected table.

  4. Click on the "Push Registration ID" field within this table. The Field details screen is displayed.

  5. Click on the Application Groups section to expand it. This section lists all of the Application Groups defined for your account. Place a check mark next to one or more Application Groups.

  6. In the Tool Ribbon, click save.

The system automatically creates a new Application Group Status ID field for each selected Application Group. The Status ID field uses Status ID Codes to indicate the eligibility of this consumer to be included in a campaign. You'll see this new Status ID field listed on the Table screen with the default name of: "<Field name> <Application Group name> Status ID."