The Agillic App Channel allows you to execute a Push Message to your recipients mobile devices. Within the Channels dropdown you'll find App Push and Push. This article will focus on how to set up an App Push Message, but if you need any information regarding setting up a Push Notification, you can find more information here.
This article will provide you with a guide on how to set up an App Push Message. If you need more general information about the benefits on using the App Channel and some concrete use cases you can read more about that here. In order to enable the App Channel and SDK you can find a guide here.
- How to create an App Push Message
- How to add content to the App Push Message
- Previewing and Testing your App Push Message
- Suggested Next Steps
The Channels Dropdown
How to create an App Push Message
- Log in to Staging.
- Mouse-over the Channels dropdown and select 'App Push'.
- Click on 'New App Push' or 'New Folder' depending on if you want to create a folder that can contain your App Push.
- To get an overview of the existing folders click on the left hand navigation menu in the upper left corner and unfold the sidebar.
- It's possible to create a new App Push Message when clicking on the '+' icon in the top right corner of the sidebar.
- It's possible to create a new folder directly from the bottom of the sidebar.
- Fill in the name of your new App Push Message and then click 'Create'.
- Your App Push Message is now created and is ready to have content added.
How to create a new App Push Message
How to add content to the App Push Message
Now your App Push Message is ready to have content added.
- Add a headline (optional) within the 'Headline' field. This field supports both Promotions and Dynamic Content Fields (Person Data, Global Data, or a Unique Lookup).
- Add text to the 'Message' field.
- It's possible to add both Promotions and Dynamic Content Fields (Person Data, Global Data, or a Unique Lookup) to the message. It's possible to do so both within the shortcuts beneath the Message field or from the righthand sidebar, which will appear when you click on the 'Headline' or 'Message' field.
- If you want to add an Image you can do so by sliding the icon next to 'IMAGE'. When enabling this you can add a customised image from Assets, External Links customisable with Plain text Promotions Fields and Content Fields (Person Data, Global Data, or a Unique Lookup).
You can only use images if your app supports rich push content. Images will appear on devices with the minimum required OS version (iOS 10+ and Android 4.1+). You can either add an image from the Assets Manager or an External image in either JPG/JPEG or PNG format. We recommend using landscape orientation recommended (2:1 e.g. 1080x540px).
- Click 'Save' in the upper right corner.
Remember to test your App Push Message before sending it to live recipients. Read below how to test it.
Adding Content to Your App Push Message
Adding an On-click Action
You can define an On-Click Action to send the recipient to a specific place within the app or to a website page when they click on the message on their device. If 'On-click Action' is not switched on and defined the app will just open up on the app’s default start screen when the recipient clicks on the message.
If you want to use a specific On-click Action you can do so by following these steps:
- Switche on 'On-click Action'.
- Insert a Custom App Action by adding a Deeplink or URL.
(This can be anything from a custom URL, like 'https://MyCustomLink/CUSTOMER_EMAIL' to a custom app action like 'app://OpenMyCustomizedOfferMenu/CUSTOMER_EMAIL')
- You can customise the on-click action with either Promotions or Dynamic Content Fields (Person Data, Global Data, or a Unique Lookup).
- If you save an empty On-click action it will be disabled.
Adding a Language Version
You can add Language Versions to your Push Message, which allows you to create different translations of the Push Message. In order to add Language Versions to your Push Message you will need to define the languages. You can read about how to do that here.
When your languages have been defines you can add them to your Push Message.
- In the upper left corner open the 'Default' dropdown.
- Within the dropdown select 'Add language versions to this Push message'.
- A popup will appear and here you can select a language and press 'Ok'.
- When hovering over the language dropdown, the new language(s) will now appear.
- You are now able to select one of the languages selected below. All languages will have been generated with the same content as the default language version and you can now translate them appropriately.
Note that some features are not affected by Language versions. This includes Promotions and enabling or disabling the Image or On-click toogles which have to be done within the default version.
Adding a Language Version to a Push Message
Previewing and Testing your App Push Message
In order to test your App Push Message you can Test and Preview it with any given Recipient ID.
Testing and Previewing your App Push Message
Previewing the App Push Message
Once you have finished your App Push Message, a fast way to test the layout of the Push Message is to preview it directly within the App Push Message editor. When previewing the App Push Message with a recipient ID it will show you how the message will be viewed by this specific recipient. When using Promotions or Dynamic Content Fields (Person Data, Global Data, or a Unique Lookup) it's useful to view how the message will look for the specific recipient.
Within the 'Preview as' field you type in a specific Recipient ID, for example a Test Recipient ID, in order to preview the App Push Message with customised data. If you choose a Recipient with no data in order to show specific Promotions or Dynamic Content Fields, the preview will show the data previously shown.
Testing the App Push Message
When clicking 'Test' it's possible to send a test App Push Message to any test recipient who has a device ID. In order for the Recipient to receive the test Push Notifications, they need to register in the App first. When the recipient have registered within the App, they should have a valid push token within the AGILLIC_REGISTRATION OTM table as describes above.
When testing the App Push Message within the editor in channels, you click 'Test' in the upper left corner. Hereafter you search for the recipient you want to send the test to, and if you need to see how the message will look for a specific recipient you can search for this specific recipient ID. Within 'App to test with' you choose the App ID set up on your instance you want to test with. After clicking 'Send test' a pop-up will appear with the result and your test recipient will have received the push message.
Sending a test App Push Message
Suggested Next Steps