Create and send in-app messages

From the Data Collection interface, select App Surfaces in the left-hand panel.

To create a configuration, select Create App Surface.

Enter a Name for the configuration, for example Luma App Tutorial .

From Mobile Application Configuration, select Apple iOS.

Enter the mobile app Bundle Id in the App ID (iOS Bundle ID) field. For example, com.adobe.luma.tutorial.swiftui.

Select Save.

In the Data Collection UI, select Datastreams, and select your datastream, for example Luma Mobile App.

Select for Experience Platform and select Edit from the context menu.

In the Datastreams > > Adobe Experience Platform screen, ensure Adobe Journey Optimizer is selected. See Adobe Experience Platform settings for more information.

To save your datastream configuration, select Save.

In Xcode, ensure that AEP Messaging is added to the list of packages in Package Dependencies. See Swift Package Manager.

Navigate to Luma > Luma > AppDelegate in the Xcode Project navigator.

Ensure AEPMessaging is part of your list of imports.

import AEPMessaging

Ensure Messaging.self is part of the array of extensions that you are registering.

let extensions = [
    AEPIdentity.Identity.self,
    Lifecycle.self,
    Signal.self,
    Edge.self,
    AEPEdgeIdentity.Identity.self,
    Consent.self,
    UserProfile.self,
    Places.self,
    Messaging.self,
    Optimize.self,
    Assurance.self
]

Review the setup instructions section to connect your simulator or device to Assurance.

In the Assurance UI, select Configure.

Select the button next to In-App Messaging.

Select Save.

Select In-App Messaging from the left navigation.

Select the Validation tab. Confirm that you aren’t getting any errors.

In the Journey Optimizer UI, select Campaigns from the left rail.

Select Create Campaign.

In the Create Campaign screen:

1. Select In-app message and select an app surface from the App surface list, for example Luma Mobile App.
2. Select Create
   

In the Campaign definition screen, at Properties, enter a Name for the campaign, for example Luma - In-App Messaging Campaign, and a Description, for example In-app messaging campaign for Luma app.

Scroll down to Action, and select Edit Content.

In the In-App Message screen:

1. Select Modal as the Message Layout.
2. Enter https://luma.enablementadobe.com/content/dam/luma/en/logos/Luma_Logo.png for the Media URL.
3. Enter a Header, for example Welcome to this Luma In-App Message and enter a Body, for example Triggered by pushing that button in the app....
4. Enter Dismiss as the Button #1 text (primary).
5. Note how the preview is updated.
6. Select Review to activate.
   

In the Review to activate (Luma - In-App Messaging Campaign) screen, select in the Schedule tile.

Back in the Luma - In-App Messaging Campaign screen, select Edit triggers.

In the In-app message trigger dialog, you configure the details of the track action that triggers the in-app message:

1. To remove Application launch event, select .
2. Use Add condition repeatedly to build the following logic for Show message if.
3. Click Done.
   

You have defined a track action, where the Action equals in-app and the Context data with the action is a key value pair of "showMessage" : "true".

Back in the Luma - In-App Messaging Campaign screen, select Review to activate.

In the Review to activate (Luma - In-App Messaging Campaign) screen, select Activate.

You see your Luma - In-App Messaging Campaign with status Live in the Campaigns list.

Go to Luma > Luma > Utils > MobileSDK in the Xcode Project navigator. Find the func sendTrackAction(action: String, data: [String: Any]?) function, and add the following code, which calls the MobileCore.track function, based on the parameters action and data.

// Send trackAction event
MobileCore.track(action: action, data: data)

Go to Luma > Luma > Views > General > ConfigView in the Xcode Project Navigator. Find the code for the In-App Message button and add the following code:

// Setting parameters and calling function to send in-app message
Task {
    MobileSDK.shared.sendTrackAction(action: "in-app", data: ["showMessage": "true"])
}

Rebuild and run the app in the simulator or on a physical device from Xcode, using .

Go to the Settings tab.

Tap In-App Message. You see the in-app message appear in your app.

{width="300/"}