Implement ÃÛ¶¹ÊÓƵ Experience Cloud in mobile apps tutorial
Learn how to implement ÃÛ¶¹ÊÓƵ Experience Cloud applications in your mobile app using ÃÛ¶¹ÊÓƵ Experience Platform Mobile SDK.
Experience Platform Mobile SDK is a client-side SDK that allows customers of ÃÛ¶¹ÊÓƵ Experience Cloud to interact with both ÃÛ¶¹ÊÓƵ applications and third-party services through the ÃÛ¶¹ÊÓƵ 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 retail app called Luma. The has functionality that lets you build a realistic implementation. After completing 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 and written in Swift/SwiftUI, but many of the concepts also apply to Androidâ„¢.
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 ÃÛ¶¹ÊÓƵ Experience Platform Assurance.
-
Add the following ÃÛ¶¹ÊÓƵ Experience Cloud applications/extensions:
Prerequisites
In these lessons, it is assumed that you have an ÃÛ¶¹ÊÓƵ Id and the required user-level permissions to complete the exercises. If not, you should reach out to your ÃÛ¶¹ÊÓƵ Administrator to request access.
-
In Data Collection, you must have:
-
Platforms—permission item Mobile
-
Property Rights—permission items to Develop, Approve, Publish, Manage Extensions, and Manage Environments.
-
Company Rights—permission items to Manage Properties and, if completing the optional push messaging lesson, Manage App Configurations
For more information on tag permissions, see User permissions for tags in the product documentation.
-
-
In Experience Platform, you must have:
-
Data Modeling—permission items to manage and view schemas.
-
Identity Management—permission items to manage and view identity namespaces.
-
Data Collection—permission 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 will do the related lessons you should also have:
- Data Management—permission 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. For Decision Management, you need the proper permissions to manage offers and decisions as described here.
-
-
For ÃÛ¶¹ÊÓƵ Analytics, you must know which report suites you can use to complete this tutorial.
-
For ÃÛ¶¹ÊÓƵ 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
- Nov. 29, 2023: Major overhaul with new sample app and new lessons for in-app messaging, decision management, and ÃÛ¶¹ÊÓƵ Target.
- Mar. 9, 2022: First publish
Download the Luma app
Two versions of the sample app are available for download. Both version can be downloaded / cloned from . You will find two folders:
- : a project without code or with placehoder code for most of the Experience Platform Mobile SDK code you need use to complete the hands-on exercises in this tutorial.
- : a version with the full implementation for reference.
You can download the final productized version of the app from the App Store.
Let’s get started!
Next: Create an XDM schema