Actions are created in JSON (JavaScript Object Notation). Standard actions are pre-populated when the user accesses the Actions page for the first time. You can also add custom actions and give marketers the ability to add other actions defined by their mobile app message developers.

Developers can access the actions and categories JSON in Acoustic Campaign. Go to Development > Mobile Apps > Actions.

Actions types

• Android actions: The actions in the field are available to use in Android push notifications. You can add standard actions or define custom actions for the Android app.
• iOS actions: The actions in the field are available to use in iOS push notifications. You can add standard actions or define custom actions for the iOS app.
• iOS categories: Developers can add a new category to customize the responses available to their app. The notification action categories in the field are available to use in iOS push notifications. Click New category to add a notification action category.

  Note: The notification action categories defined on this page of the UI are static categories, which your app must know how to handle. If your app includes a notification service, marketers may also use dynamic action categories that are created when the message is built. Dynamic categories do not need to be predefined.

Supported action types

Access actions

In Campaign, go to Development > Mobile apps > Actions.

The Actions page opens and includes the following sections:

• Android actions: Standard actions that are created in JSON and pre-populated when the user accesses the Actions page for the first time.
• iOS actions: Standard actions that are created in JSON and pre-populated when the user accesses the Actions page for the first time.
• iOS categories: Select the New category button to configure. These allow a notification to include a category which the app can interpret to decide which actions to display.

Add an action

1. From Android actions, iOS actions, or iOS categories click the New action drop-down menu to choose a standard or custom action from the list.
2. Select the desired action type from the list. The default syntax for standard or custom actions is added to the top of the text area of the push service you selected. Exception: A Show inbox notification action must be added and saved before you add an Inbox template. Configure this action by clicking New action > Show inbox notification.

Modify an action

You can modify Android actions, iOS actions, and iOS categories. After actions are added, the syntax can be modified as needed and you can save your changes.

Note: Any custom actions added are visible to the mobile app message user in the Campaign send experience actions picker when creating a mobile push draft.

Example

You want to provide a default phone number in the "dial" action so marketers don't enter the wrong number by accident:

{ 
   "label": "Call now to buy!", 
   "type": "dial", 
   "value": "+18005551212", 
   "description": "Dials our corporate sales number", 
   "placeholder": "Enter the phone number – not displayed since inputRequired is false", 
   "authenticationRequired": false, 
   "activationMode": false 
}, 

Example

One of your Android app developers has written a custom plugin that handles a "payBill" action. You can add that action to the list of Android actions in the UI so marketers can select it as an action for their messages:

{ 
    "label": "Pay Bill", 
    "type": "payBill", 
    "description": "Customer bill to pay", 
    "customProperties": [ 
        { 
           "id": "greeting", 
           "inputRequired": true, 
           "type": "string", 
           "placeholder": "Greeting", 
           "value": "Thank you for your prompt payment!" 
        }, 
        { 
           "id": "amount", 
           inputRequired": true, 
          "type": "number", 
          "placeholder": "Bill total", 
          "value": 0 
        } 
    ], 
    "authenticationRequired": false, 
    "activationMode": false 
},