---
title: Add Web In-App message
slug: docs/add-web-in-app-message
docTags: 
createdAt: 2024-04-11T11:57:55.398Z
---

AJO web in-app messages are notifications or announcements visible within the AJO web application. Much like their mobile counterparts, these messages inform users about updates, new features, promotions, or pertinent information concerning the web application. They aim to engage users and prompt them to take actions like exploring new features or participating in promotions, all directly within the web application.

## High-Level Instructions

1. Ensure you have the latest DSN schemas and a vertical website set up, such as Luma.
2. With AEP Data Collection, edit the website datastream to include **Offer Decisioning&#x20;**&#x61;nd **Adobe Journey Optimizer.**
3. Create the new in-app campaign in AJO and create the channel configurations as mentioned below.
4. Set the triggering criteria to: (Sent data to Platform event happens) AND (XDM event type is web.webpagedetails.pageViews)
5. Activate the campaign. It will take a few minutes, but the in-app message should start appearing. Start the user experience with the exact URL that matches the base URL. For example, **dsn.adobe.com/web/abc-1234&#x20;**&#x72;ather than **dsn.adobe.com/web/abc-1234/home**

## Create a Web In App Surface (Example Steps)

You can follow the steps below to create an in-app channel configuration for your website and a specific page which is mandatory step to show web in-app message.

1. Go to the AJO and **Channel > Channel Configurations.**
2. Click on **Create Channel Configuration.**
3. So, in our case, we wanted to display a web in-app message when the customer visited the help page on their website.
4. So we will provide a **name, Description, and&#x20;**&#x53;elect Channe&#x6C;**&#x20;- In-app messaging,&#x20;**&#x4D;arketing action - **Cross Site targeting, Onsite personalization, Onsite Advertising, &#x20;**&#x53;elect platfor&#x6D;**&#x20;as web.&#x20;**&#x55;nder Web, select **Single Page** and put the **page URL** for the help page where you want to display the in-app message.([https://www.vodafone.de/privat/hilfe.html](https://www.vodafone.de/privat/hilfe.html))

## To trigger on just a specific page

Follow the steps above. For example, the full triggering criteria could look like:&#x20;

**A triggering rule example like below:**

**(Sent data to Platform event happens) AND ( XDM value web.webPageDetails.name contains Vodafone Help or Vodafone-Hilfe)**

## Step-by-step guide

Below are the steps to implement AJO Web in-app messages using the Demo System Next web projects.



::::VerticalSplit{layout="right"}
:::VerticalSplitItem
1\. Create a new Luma web project using the Quick Setup and selecting the **Luma - Basic** preset
:::

:::VerticalSplitItem


![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/3DiqcRAulhjZ9cJA8_qVK_cleanshot-2024-04-11-at-143657.png)
:::
::::

::::VerticalSplit{layout="right"}
:::VerticalSplitItem
2\. Open the Home menu of your Experience Platform sandbox and navigate to Datastreams. Edit the Service **Adobe Experience Platform,** check **Offer Decisioning&#x20;**&#x61;nd **Adobe Journey Optimizer,&#x20;**&#x61;nd then Save.
:::

:::VerticalSplitItem


![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/5mpAUNKmM3SQmZ76LtAMs_cleanshot-2024-04-11-at-140953.png)
:::
::::

::::VerticalSplit{layout="right"}
:::VerticalSplitItem
3\. Navigate to Journey Optimizer using the solution switch (top right) and create a new Web In-app message Campaign. On the app surface, select the **App Surface you created above**. Click **Create**
:::

:::VerticalSplitItem


![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/cgBOhA7zqV3L2voAWT3o7_cleanshot-2024-04-11-at-141323.png)
:::
::::

::::VerticalSplit{layout="right"}
:::VerticalSplitItem
4\. In the Audience section, enter a name, e.g., Sample In-App Flash Sale, and keep it for all app users using the ECID identity type.&#x20;

Edit the **Triggers**, set the Show message If as follows:&#x20;

**(Sent data to Platform event happens) AND (XDM event type is web.webpagedetails.pageViews) AND (XDM Value web.webpagedetails.name equals gear)**


:::

:::VerticalSplitItem


![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/HA1iQXqWz2K3vW8eOIw7X_cleanshot-2024-04-11-at-142638.png)
:::
::::

::::VerticalSplit{layout="right"}
:::VerticalSplitItem
5\. Edit your in-app message content by adding the **Media URL**, **Header**, **Body**, **Buttons,&#x20;**&#x61;nd select a **Message Layout**


:::

:::VerticalSplitItem


![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/Lrx87gcKB0if_GMGjUo_b_cleanshot-2024-04-11-at-142942.png)
:::
::::

::::VerticalSplit{layout="right"}
:::VerticalSplitItem
5\. Edit your in-app message content by adding the **Media URL**, **Header**, **Body**, **Buttons,&#x20;**&#x61;nd select a **Message Layout**. Click on **Review to Activate**.&#x20;

<u>*Note*</u>*: It may take a few minutes to be activated.*


:::

:::VerticalSplitItem


![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/Lrx87gcKB0if_GMGjUo_b_cleanshot-2024-04-11-at-142942.png)
:::
::::

::::VerticalSplit{layout="right"}
:::VerticalSplitItem
6\. Open your DSN Luma Web project, e.g., **dsn.adobe.com/web/abc-1234**, and navigate to the **Gear** page; you should see the in-app message.
:::

:::VerticalSplitItem


![](https://api.archbee.com/api/optimize/bAgVaanSi1tFmfc8PghaH/HUHlHIz7afERDhwqLa9Ct_cleanshot-2024-04-11-at-143450.png)
:::
::::

### Demo Scenario to show In-App message in DSN public projects:



- Luma [In-app support](docId\:RqoKIoZiV2w8UDdPGt0bc) demo description
- Frescopca [In-app support](docId\:KpsBSuNkL7klOY31X1o53) demo description

