In-app custom HTML
This type of In-app campaign can be created by selecting the Custom HTML option from the In-app section within the Content campaign tab.
Build your message
HTML experts only
Using your own code may affect how the message is shown in different devices, preventing it from adjusting to the screen size (i.e., the "responsiveness" of the message). Make sure to use HTML that is responsive and review our in-app creative guidelines for best results.
In-app message configuration and SDK methods
Initialise the InAppMessage SDK
There are a number of settings you can configure within the script tag shown above for in-app messages:
Set whether or not to hide the status bar. Takes
false; the default is
InAppMessage.hideStatusBar = false;
Turn default fade animation style on or off. Options are
false; the default is
InAppMessage.animationFade = false;
Set the animation style when the in app first appears over, default is fade. Style options are:
InAppMessage.animationSlide = "from-left";
Lock display orientation. Options are
landscape. By default it will not lock.
InAppMessage.lockOrientation = "portrait";
If your In App Message has a form that requires input you must set this as
true; by default it is
InAppMessage.requiresTextInput = true;
The following method must be executed when all configurations above are set:
Add these settings to your custom HTML as shown below.
Close the in-app message
To close your custom In-app message, call the following method:
Open a URL from the in-app message:
To open a URL from your custom In-app message, call the following method
Below is an example of a very simple Custom HTML in-app message with some settings configured, a button that links to a URL and a button to close the in-app message:
Multi-language and variants
It is possible to create a multi-language campaign with different creatives based on the languages selected at the campaign level. It is also possible to do a split test to see which variant has a better engagement. Both options are enabled and configured from the Setup tab.
The languages you have selected, together with the variants selected are shown on the left side of the campaign. To be able to identify with which variant and language you are working, this information is shown on the top of the screen.
This example shows a multi-language campaign for English and Hindi combined with split testing. Currently the content shown is for the English version of variant A.
The Actions button allows you to Apply a template that has been previously created from Content > Templates to a campaign and to copy the content from a specific language & variant. To copy the content, click on Copy From when you are on the variant and language where you want to apply the content. The system will show the available options to copy from.
Preview your message
The preview area displays the current message view, updated as components change. You can select different sizes for phones and tablets, to show the preview of your In-app message in different screen sizes. Click Custom if you want to preview the message on a different model than the ones available. Enter the desired amount of pixels (width and length).
Updated 3 months ago