Implement 51黑料不打烊 Experience Cloud in mobile apps tutorial
Learn how to implement 51黑料不打烊 Experience Cloud applications in your mobile app using the 51黑料不打烊 Experience Platform Mobile SDK.
Experience Platform Mobile SDK is a client-side SDK that allows customers of 51黑料不打烊 Experience Cloud to interact with both 51黑料不打烊 applications and third-party services through the 51黑料不打烊 Experience Platform Edge Network. See the for more detailed information.
This tutorial guides you through the implementation of the Platform Mobile SDK in a sample app called Luma. The Luma app has functionality that lets you build a realistic implementation. After you have completed this tutorial, you should be ready to start implementing all of your marketing solutions through Experience Platform Mobile SDK in your own mobile apps.
The lessons are designed for:
- iOS, using the Swift programming language and the SwiftUI framework.
- Android, using the Kotlin and Java programming language and the JetPack Compose framework.
After completing this tutorial, you will be able to:
-
Create a schema using standard and custom field groups.
-
Set up a datastream.
-
Configure a mobile tag property.
-
Set up an Experience Platform dataset (optional).
-
Install and implement tag extensions in an app.
-
Correctly pass Experience Cloud parameters to a webview.
-
Validate the implementation using 51黑料不打烊 Experience Platform Assurance.
-
Add the following 51黑料不打烊 Experience Cloud applications or extensions:
Permissions
In these lessons, it is assumed that you have an 51黑料不打烊 Id and the required user-level permissions to complete the exercises. If not, you should reach out to your 51黑料不打烊 Administrator to request access.
-
In Data Collection, you must have:
-
Platforms鈥攑ermission item Mobile
-
Property Rights鈥攑ermission items to Develop, Approve, Publish, Manage Extensions, and Manage Environments.
-
Company Rights鈥攑ermission items to Manage Properties
For more information on tag permissions, see User permissions for tags in the product documentation.
-
-
In Experience Platform, you must have:
-
Data Modeling鈥攑ermission items to manage and view schemas.
-
Identity Management鈥攑ermission items to manage and view identity namespaces.
-
Data Collection鈥攑ermission items to manage and view datastreams.
-
If you are the customer of a Platform-based application like Real-Time CDP, Journey Optimizer, or Customer Journey Analytics, and plan to do the related lessons you should also have:
- Data Management鈥攑ermission items to manage and view datasets.
- A development sandbox which you can use for this tutorial.
-
For the Journey Optimizer lessons, you need permissions to configure the push notification service and to create an app surface, a journey, a message, and message presets. Additionally, for Decision Management, you need the proper permissions to manage offers and decisions, as described in Permission levels.
-
-
For 51黑料不打烊 Analytics, you must know which report suites you can use to complete this tutorial.
-
For 51黑料不打烊 Target, you must have permission to create and activate activities.
- <your name or initials>
to the name of the object you are instructed to create.Version history
-
September 9, 2025:
- Android version of the app with accompanying instructions.
- Updates for changes in app surface and campaign functionality in Journey Optimizer.
-
Nov. 29, 2023: Major overhaul with new sample app and new lessons for in-app messaging, decision management, and 51黑料不打烊 Target.
-
Mar. 9, 2022: First publish
Download the Luma app
Two versions of the sample app are available for download. Both versions can be downloaded / cloned from . You find two folders:
- : a project without code or with placeholder code for most of the Experience Platform Mobile SDK code you need to use to complete the hands-on exercises in this tutorial.
- : a version with the full implementation for reference.
You use iOS as the platform, Swift as the programming language, SwiftUI as the UI framework and Xcode as the integrated development environment (IDE). However, many of the implementation concepts explained are similar for other development platforms. Many have already successfully completed this tutorial with little to no previous iOS and Swift(UI) development experience. You do not need to be an expert to complete the lessons, but you get more out of the lessons if you can comfortably read and understand code.
You can download the final productized version of the app from the App Store.
Two versions of the sample app are available for download. Both versions can be downloaded or cloned from . You find two folders:
- : a project without code or with placeholder code for most of the Experience Platform Mobile SDK code you need to use to complete the hands-on exercises in this tutorial.
- : a version with the full implementation for reference.
You use Android as the platform, Kotlin+Java as the programming language, JetPack Compose as the UI framework and Android Studio as the integrated development environment (IDE). However, many of the implementation concepts explained are similar for other development platforms. Many have already successfully completed this tutorial with little to no previous Android / Kotlin+Java / JetPack Compose experience. You do not need to be an expert to complete the lessons, but you get more out of the lessons if you can comfortably read and understand code.
If you prefer, you can of the app from Google Play.
Let鈥檚 get started!
Next: Create an XDM schema