Configure and launch
For administrators and mobile app developers, this section shows how to configure and launch mobile and web channels in Adobe Journey Optimizer. It covers prerequisites, permissions, and platform support, then guides you through creating app-specific configurations.
Mobile capabilities in Adobe Journey Optimizer
Understand which mobile capabilities Adobe Journey Optimizer offers for developers, marketers, and product teams, including push messaging, in‑app messaging, and content personalization.
Channel configuration
Mobile push and in-app
Mobile implementations in Journey Optimizer begin with the Adobe Experience Platform Mobile SDK integration in your app. SDKs are essential for data collection and interaction with Adobe Experience Platform (AEP) and its applications, such as Adobe Journey Optimizer (AJO).
What is the Mobile SDK:
The mobile SDK:
- Collects app events (screen views, taps, purchases, lifecycle events, etc.) and sends them to the Adobe Experience Platform Edge Network.
- Manages identity and consent, so Journey Optimizer can safely build and use customer profiles.
- Registers and updates push tokens, and sends push and in‑app tracking events back to Adobe Experience Platform.
- Integrates with the Journey Optimizer mobile extension so messages can be delivered, rendered, and measured end‑to‑end.
Without the Mobile SDK integrated in your app, Journey Optimizer cannot reliably:
- Deliver and track mobile push and in‑app messages.
- Render and track content cards.
- Use real‑time in‑app behavior to trigger journeys and personalize experiences.
Guided channel setup for new implementations
For new Mobile In-App and Push implementations, Guided Channel Setup is the recommended starting point. It reduces the risk of misconfigured datastreams or missing extensions and walks you through SDK validation with Assurance.
- Adobe Journey Optimizer (AJO) provisioned for your org.
- Adobe Experience Platform access with Data Collection and Journey Optimizer permissions.
- Admin rights in AJO for channel and configuration setup.
- Access to your mobile app’s source code (iOS, Android, or cross‑platform framework).
- Your app has the required OS‑level capabilities enabled (for example, push permissions, notification service extensions, background modes).
- If you are using the existing configuration option, please ensure that you are using the current Adobe Experience Platform Mobile SDK versions
Hi, I’m Travis Jordan on the Adobe Journey Optimizer product team. In this video, I’m going to highlight the guided channel setup that enables customers to rapidly set up and validate web and mobile channels in Journey Optimizer. The time it takes to get up and going with web and mobile engagements in Journey Optimizer can be time consuming, requiring multiple steps across multiple products. The guided channel setup improves the time to value by automating dozens of channel setup across data collection, experience platform, and Journey Optimizer. Now let’s jump over to Adobe Journey Optimizer and take a look. For this demo, I will show you how to quickly set up and validate a push channel notification on a sample iOS mobile marketing app. From the home screen on Journey Optimizer, click Begin. This launches the guided channel setup in a new window. Enter a name for your setup. Note, this name is used to name all your resources that are auto-created in subsequent steps.
For organizations with one or more data stream, you will select an existing data stream. If you don’t have a data stream, no worries, we will auto-create one for you. Next, select a platform. You can choose from iOS, Android, or web.
For this demo, we are setting up an iOS app, so I will select iOS.
Now click Auto-create resources to trigger the creation of resources across data collection, experience platform, and Journey Optimizer. This includes the creation of a mobile tag property and the necessary SDKs and extensions, as well as the creation of a channel configuration in Journey Optimizer. To see a full list of the auto-created resources, please reference the documentation.
Success! Your initial configuration is now complete. You’re ready to move on to the setup of the SDK. Click Setup to get started.
On this screen, I will add the necessary dependencies and code to my app. I will now open Xcode on the right side of my screen to do this. I have already added the package dependencies, so I will skip step one and proceed to step two. To import the required extension dependencies, I simply copy and paste that from AJO to Xcode. For step three, I will copy and paste the initialization code into my app. This code launches an experience platform assurance session upon opening my app. Assurance is a powerful technology used behind the scenes to help test and validate the SDK setup, as well as the channel setup in the upcoming steps. Note, this code is critical for testing and validating your app, but should be removed before pushing your app to production. Now that the code has been added to my app, I will click Build in Xcode to simulate the app experience. As you can see, I am prompted to connect to Assurance once my app launches. Click Allow Notifications and then Connect. Now you can see that my app appears in the list of available devices. Click Connect once more.
And there you go. I can now see that my device is connected to Assurance and that the mobile SDK was set up correctly. The green dot and Adobe icon in the upper right corner of my app indicates that I am indeed connected to Assurance and ready to test and validate my app. Click Finish to wrap up and move on to the final step. Lastly, I will add and validate the desired channels for Journey Optimizer. You can add multiple channels for each platform as needed. For this demo, I will just add and validate a mobile push notification. To do this, click Add.
I will first need to retrieve the device token by copying and pasting this line of code into my app.
Now I need to add the push certificate, the key ID and team ID for my app. If you are unfamiliar with these configurations, please refer to the documentation from the tooltips for more information. After rebuilding the app, I will click Send Push Message to ensure everything is working end to end. And there you go. I can now see a sample push message on my device with a notification informing me that everything is properly set up. Click Finish to close this window.
This setup is now complete. I will now share the name of the channel configuration with the team member responsible for creating campaigns and journeys in Journey Optimizer. To do this, click Share. Now I can close this out and exit channel setup.
You are now on your way to creating web and mobile experiences in Adobe Journey Optimizer. To make a connection between this setup and the creation of the marketing content, I simply select the name of the channel configuration that was auto-created under Actions in the campaign or journey UI. Now you are off and going.
This concludes this demo on Guided Channel Setup in Journey Optimizer. Thank you.
For more information see Get started with guided channel setup
Manual configuration of the push channel
This following guides walk you through everything you need to manually configure and use push notifications effectively, from understanding the data flow and integrating with services like Firebase and Apple Push Notification Service (APNs) to setting up mobile apps and testing notifications.
Push notification data flow and components
Learn how to setup and understand key services and workflows involved with push notifications in Journey Optimizer.
Push notification configuration
Learn how to configure your environment to send push notifications with Journey Optimizer
Implement Adobe Experience Cloud in mobile apps tutorial
Learn how to implement the Adobe Experience Cloud mobile applications. This tutorial guides you through an implementation of Experience Cloud applications in a sample Swift or Android app.
Additional ressources
Get the Adobe Experience Platform Mobile SDK
A guide that explains how to install the Adobe Experience Platform Mobile SDK in your application.
Adobe Experience Platform Assurance overview
An overview for the Adobe Experience Platform Assurance mobile extension.
Mobile SDK readiness checklist
Before handing the app to marketers, confirm in Assurance that:
[ ] Events are flowing on the correct datastream and datasets,
[ ]Identity and consent are present on all key events,
[ ] Push tokens and interactions are tracked, and
[ ] At least one test in‑app message or content card has been displayed and recorded as an impression.
Content Cards
Configure content cards support in Mobile SDK
Learn how to integrate content cards in your mobile application using Messaging SDK.
Understand how to configure the WhatsApp channel:
This tutorial walks you through setting up the WhatsApp channel in Adobe Journey Optimizer to enable real-time business messaging.
SMS/MMS/RCS
Configure SMS/MMS/RCS channels with the standard providers (Twilio,Synch or Infobip) or using a custom SMS provider:
Configure SMS API credentials and channel surfaces
Learn how to connect Journey Optimizer to an SMS service provider and how to create an SMS channel surface.
Configure a custom SMS provider
Learn how to configure custom SMS providers in Journey Optimizer, set up API credentials and webhooks, manage opt-in/opt-out keywords, and launch personalized campaigns.
Configure MMS API credentials and channel surfaces
Learn how to connect Journey Optimizer to an MMS service provider and how to create an MMS channel surface.
Set up RCS in Journey Optimizer
Learn how to configure and send branded, interactive RCS messages in Adobe Journey Optimizer using a custom SMS provider. This tutorial walks through setting up API credentials, webhooks, and channel configurations, then building a journey to deliver rich, personalized messaging experiences - all within the native messaging app.
Ensure compliance with privacy laws and platform guidelines.
Implement consent for Platform Mobile SDK implementations
Learn how to implement consent in a mobile app.
Privacy Features in Adobe Journey Optimizer
Learn how to process privacy requests, audit user actions, manage consent, apply governance rules, and leverage advanced security options like Customer Managed Keys.
Data Governance Framework Overview
Understand the governance features in Adobe Experience Platform.
Common implementation pitfalls and how to avoid them
Most mobile issues originate in SDK or data collection configuration, not in the Journey Optimizer journeys or campaigns themselves. Use the table below to identify what’s going wrong, then expand the corresponding section for details.
Pitfalls at a glance
Detailed guidance per pitfall
Open the pitfall that matches your symptoms to see what to check and how to fix it.
What you’ll notice
- Push or in‑app activities do not reach the device.
- Guided Channel Setup or channel validation fails.
- Assurance shows missing Journey Optimizer, Edge, or Identity extensions.
What to check
-
Are you using the minimum Mobile Core and Journey Optimizer extension versions required by Guided Channel Setup?
-
In Assurance, under extensions and events:
- Do you see the expected extensions loaded?
- Are events being sent to the Edge Network and acknowledged?
How to fix
- Upgrade to the supported Mobile SDK and Journey Optimizer extension versions.
- Rebuild the app, reconnect to Assurance, and re‑run Guided Channel Setup.
What you’ll notice
- Events or push tracking batches fail in Platform datasets.
- Data ingestion errors (for example, “Updates are not supported for events”).
- Push or in‑app reports show little or no tracking.
What to check
-
Did anyone change system schemas or datasets created for Journey Optimizer tracking?
-
In your datastream:
- Are experience events mapped to an event dataset?
- Are profile attributes mapped to a profile dataset?
How to fix
- Do not edit system datasets/schemas created by AJO.
- Correct the datastream mapping (events → event dataset, profiles → profile dataset).
- Prefer Guided Channel Setup or the documented datastream steps instead of ad‑hoc changes.
What you’ll notice
- Journeys don’t trigger as expected for app users.
- Personalization doesn’t match the user’s behavior in other channels.
- Events appear in Experience Platform, but profiles look fragmented.
What to check
-
Is Identity for Edge Network implemented and sending a stable primary ID (for example, login ID)?
-
Is Consent for Edge Network implemented and updated when preferences change?
-
In Assurance:
- Do outbound events include consent values?
- Do they include ECID and your primary IDs consistently?
How to fix
- Implement or correct Identity for Edge Network in the app.
- Implement Consent for Edge Network and connect it to your app’s consent UI.
- Retest in Assurance until identity and consent appear on all relevant events.
See: Implement consent for Platform Mobile SDK implementations
What you’ll notice
- Users never receive push notifications, even though campaigns or journeys run.
- Push reports show no opens, dismisses, or interactions.
What to check
-
Does the app register the push token with the Journey Optimizer extension:
- On first install?
- After each app update?
- Whenever the OS refreshes the token?
-
When a user opens or dismisses a notification, do you see tracking events in Assurance?
How to fix
-
Add or correct the code that:
- Registers the token via the Journey Optimizer mobile extension whenever it is created or refreshed.
- Sends push interaction events (open, dismiss, custom actions) via the Mobile SDK.
-
Use Assurance to confirm registration and tracking events are firing as expected.
What you’ll notice
- In‑app messages or content cards never appear, despite active campaigns or journeys.
- Reporting shows 0 impressions.
What to check
-
Are the Journey Optimizer mobile messaging / in‑app extension and Messaging SDK installed and registered in the app?
-
In your tags configuration:
- Do you have rules that trigger requests on the correct events (for example, screen views or custom events)?
-
In Assurance:
- When those events fire, do you see in‑app or content‑card decision requests going out?
- Do you see responses coming back from the Edge Network?
How to fix
-
Install and register the required messaging extensions.
-
Add or correct rules that trigger decisions on your target events (screens, custom events).
-
For content cards, ensure you:
- Fetch cards via the Messaging SDK APIs.
- Render them in your UI.
- Track interactions back via the SDK.
See: