Mobile Push Application Groups

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 Messaging (non-EDP) Push Notification Campaign. Click save new item. A blank Mobile Push Application Group screen is displayed. For Messaging 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”.  

For Messaging Application Groups, follow these steps to add an application to the 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 (Messaging 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: In the "Application Name" field, enter the name of your app. In the "Google API Key" field, enter your Google API Key.

3. 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.

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

 

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.  

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 Messaging (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.

 

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

When you define a Campaign in Messaging, 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 System Tray, select Data Management > Structures > 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."