Creating In-App Message

In-App notifications allow you to deliver personalized content directly in your mobile app.

An In-App message opens after tapping a mobile push notification, so these two channels are interconnected.

📘

Important

Install SDK to send In-App messages through Reteno

Creating In-App

Go to Messages → Messages In-App. Click the Create In-App button.

Fill in the In-app name field: system name that the recipient will not see.

HTML settings

Open the HTML tab.

You can put your HTML code or use our base code.

Using base code

Copy and paste the base HTML into the code window. Insert your code instead of Your code goes here text.

📘

Note

You can use personalization by merge tags and velocity features in the HTML code of In-App messages.

Custom HTML markup rules

  1. Use buttons instead of anchors

Usage of Anchor HTML elements is forbidden. Use HTML Button instead.

  1. Set data attributes for clickable elements

Each clickable element must have the required data attributes.

  • Code of the button that should open the URL:

    <button  
                    data-target-component-id="1c92f19e-c994-11ed-afa1-0242ac120002"  
                    data-sys-action-type="OPEN_URL"  
                    data-sys-action-params="{"url":"<https://google.com"}>"  
                    class="button">  
    </button>
    
  • Code of the button that should close a widget:

<button
                data-target-component-id="c740db99-cfbb-4857-b790-cb5631c33255"
                data-sys-action-type="CLOSE_WIDGET"
                class="close-button">  
</button>
Attribute nameAttribute value
data-sys-action-typeOne of action:
1) CLOSE_WIDGET
2) CLICK
3)OPEN_URL
CLICK and OPEN_URL are counted in the statistics as clicks, CLOSE_WIDGET — no.
data-target-component-idGenerate a unique element’s UUID (e.g., using Online UUID Generator)
  1. Use Margin Top 50 px (approx) so the content does not overflow the iOS devices panel.

CSS settings

Open the CSS tab and add CSS rules in the code window.

Adding CSS code is optional, but usually custom HTML is displayed incorrectly without CSS.

Multilingual version (optional)

You can create a multilingual message if this option is available in your pricing plan. Click the globe icon in the top panel, specify the default language and add language versions. Fill each version with the content in the corresponding language. You can switch between versions within one template in one click.

Learn more about multilanguage >

Linking Mobile Push with In-App

  1. Create or open a mobile push message, activate the Open In-App by clicking switcher and select an In-App message.

📘

Note

The link and buttons are unavailable for mobile pushes with linked In-App messages.

Mobile pushes with linked In-App messages marked with the chain icon in the system. Hover over the icon to see the name of the linked message.

Testing In-App Message

  1. Click the Test button on the top panel of the mobile push.
  1. Enter an email, contactID, or phone number linked to the mobile push token in a popup window.
  • Under Application, select the app you want to send your push notification. If you have only one app, it will be determined automatically.
  • Under Search, enter email, contactID, or phone number to send your push notification.
    If the contact is an app user, you will see the such status:

It means the provided contact data has a matching mobile token. You can send a test notification to this contact. Otherwise, you will receive the following notification: The contact does not have an application token.

  1. When you receive the test mobile push, click on it to see the linked In-App message.

Analytics

See reports on In-App campaigns in mobile push analytics (messages with the chain icon).

The number of clicked messages refers to In-App messages.