Prerequisites and configuration inapp-configuration
Configuration steps inapp-steps
To send In-app messages in your journeys and campaigns with Journey Optimizer, you need to go through the following configuration steps.
- Make sure you have the correct permissions on Journey Optimizer campaigns before starting, even if you plan to only use in-app messages in journeys. Campaign permissions are still required. Learn more.
A specific permission must be granted to access the App Surfaces menu in Adobe Experience Platform Data Collection. Learn more in this video. - Enable Adobe Journey Optimizer in your Adobe Experience Platform Data Collection datastream, and check your default merge policy in Adobe Experience Platform, as detailed in the Delivery prerequisites below.
- Create and configure an App surface in Adobe Experience Platform Data Collection, as detailed in this section.
- If you are using content experiments, make sure to follow the requirements listed in this section.
Once done, you can create, configure and sent your first In-app message. Learn how to achieve this in this section.
Delivery prerequisites delivery-prerequisites
For the In-app messages to be delivered correctly, the following settings must be defined:
-
In the Adobe Experience Platform Data Collection, make sure you have a datastream defined such as under the Adobe Experience Platform service you have the Adobe Experience Platform Edge and Adobe Journey Optimizer option enabled.
This ensures that the Journey Optimizer inbound events are correctly handled by the Adobe Experience Platform Edge. Learn more
-
In Adobe Experience Platform, make sure you have the default merge policy with the Active-On-Edge Merge Policy option enabled. To do this, select a policy under the Customer > Profiles > Merge Policies Experience Platform menu. Learn more
This merge policy is used by Journey Optimizer inbound channels to correctly activate and publish inbound campaigns on the edge. Learn more
note note NOTE When using a custom Dataset preference merge policy, make sure to add the Journey Inbound dataset within the specified merge policy. 
Channel configuration prerequisites channel-prerequisites
-
Access the App surfaces menu and click Create App surface.
-
Add a name to your App surface.
-
From the Apple iOS drop-down, configure your mobile application for Apple iOS.
accordion Learn more -
Type-in your iOS Bundle ID. Refer to Apple documentation for more information on Bundle ID.
-
(optional) Choose the Sandbox where you want to send push notifications from. Note that choosing a specific Sandbox requires the necessary access permissions.
For more information on sandbox management, refer to this page.
-
Enable the Push credentials option to drag and drop your .p8 auth key file if needed.
You can also enable the Manually enter push credentials option to copy and paste your APNs auth key directly.
-
Enter your Key ID and Team ID.
-
-
From the Android drop-down, configure your mobile application for Android.
accordion Learn more -
Type-in your Android package name. Refer to Android documentation for more information on Package name.
-
(optional) Choose the Sandbox where you want to send push notifications from. Note that choosing a specific Sandbox requires the necessary access permissions.
For more information on sandbox management, refer to this page.
-
Enable the Push credentials option to drag and drop your .json private key file if needed.
You can also enable the Manually enter push credentials option to copy and paste your FCM private key directly.
-
-
Click Save when you finished the configuration of your App surface.
Your App surface will now be available when creating a new campaign with an In-app message. Learn more
-
After creating your app surface, you now need to create a mobile property.
Refer to this page for the detailed procedure.
-
From the Extensions menu of your newly created property, install the following extensions:
- Adobe Experience Platform Edge Network
- Adobe Journey Optimizer
- AEP Assurance
- Consent
- Identity
- Mobile Core
- Profile
Refer to this page for the detailed procedure.
The In-app channel is now configured. You can start sending In-app messages to your users.
Content experiment prerequisites experiment-prerequisites
To enable content experiments for In-app channel, you need to make sure the dataset used in your In-app implementation datastream is also included in your reporting configuration.
In other words, when configuring experiment reporting, if you add a dataset that is not present in your web datastream, web data will not display in the content experiment reports.
Learn how to add datasets for content experiment reporting in this section.
If you are not using the following pre-defined field groups for your dataset schema: AEP Web SDK ExperienceEvent and Consumer Experience Event (as defined in this page), make sure to add the following field groups: Experience Event - Proposition Interactions, Application Details, Commerce Details, and Web Details. These are needed by the Journey Optimizer content experiment reporting as they are tracking which experiments and treatments each profile is participating in.
How-to video video
The video below shows how to assign the Manage app configuration permission to access the App surfaces menu.
Related topics: