Set up Assurance

Navigate to Luma > Luma > SceneDelegate in your Xcode’s Project navigator.

Add the following code to func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>:

// Called when the app in background is opened with a deep link.
if let deepLinkURL = URLContexts.first?.url {
    // Start the Assurance session
    Assurance.startSession(url: deepLinkURL)
}

This code starts an assurance session when the app is in the background and opened using a deep link.

Open the project in Xcode.

Select Luma in the Project navigator.

Select the Luma target.

Select the Signing & Capabilities tab.

Define a Bundle Identifier.

{modal="regular"}

Go to your project in Xcode.

Select Luma in the Project navigator.

Select the Luma target.

Select the Info tab.

To add a base URL, scroll down to URL Types and select the + button.

Set Identifier to the Bundle Identifier of your choice and set a URL Schemes of your choice .

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

In the Allow “Luma App” to use your location dialog, select Allow While Using App.

{width="300"}

In the “Luma App” Would Like to Send You Notifications dialog, select Allow.

{width="300"}

Select Continue… to allow the app to track your activity.

{width="300"}

In the Allow “Luma App” to track your activity across other companies’ apps and websites dialog, select Allow.

{width="300"}

Go to the Data Collection UI.

Select Assurance from the left rail.

Select Create Session.

Select Start.

Provide a Session Name such as Luma Mobile App Session and the Base URL, which is the URL Schemes you entered in Xcode, followed by :// For example: lumatutorialswiftui://

Select Next.

In the Create New Session modal dialog:

If you’re using a physical device:

• Select Scan QR Code. To open the app, use the camera on your physical device to scan the QR code and tap the link.

  

If you are using a simulator:

1. Select Copy Link.
2. Copy the deep link using and use the deep link to open the app with Safari in the simulator.
   

When the app loads, you are presented with a modal dialog asking you to enter the PIN shown in step 7.

{width="300"}

Enter the PIN and select Connect.

If the connection was successful, you see:

• An Assurance icon floating on top of your app.

  {width="300"}

• Experience Cloud updates coming through in the Assurance UI, showing:

  1. Experience Events coming from the app.

  2. Details of a selected event.

  3. The device and timeline.

     

Select Configure.

Select for Extension Versions.

Select Save.

Select Extension Versions to see an overview of the latest extensions available and the extensions used in your version of the app.

To update your extension versions (for example, Messaging and Optimize) select the package (extension) from Package Dependencies (for example, AEPMessaging) and from the context menu select Update Package. Xcode will update the package dependencies.