Documentation Experience Platform Mobile App Tutorial

Collect profile data

Last update: Tue Dec 05 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Topics:
Mobile SDK

CREATED FOR:

Beginner
Intermediate
Developer

Learn how to collect profile data in a mobile app.

You can use the Profile extension to store attributes about your user on the client. This information can be used later to target and personalize messages during online or offline scenarios, without having to connect to a server for optimal performance. The Profile extension manages the Client-Side Operation Profile (CSOP), provides a way to react to APIs, updates user profile attributes, and shares the user profile attributes with the rest of the system as a generated event.

The Profile data is used by other extensions to perform profile-related actions. An example is the Rules Engine extension that consumes the profile data and runs rules based on the profile data. Learn more about the Profile extension in the documentation

IMPORTANT

The Profile functionality described in this lesson is separate from the Real-Time Customer Profile functionality in Adobe Experience Platform and Platform-based applications.

Prerequisites

Successfully built and run app with SDKs installed and configured.

Learning objectives

In this lesson, you will:

Set or update user attributes.
Retrieve user attributes.

Set and update user attributes

It would be helpful for targeting and / or personalization in the app to quickly know if a user has made a purchase in the past or recently. Let’s set that up in the Luma app.

Navigate to Luma > Luma > Utils > MobileSDK in the Xcode Project navigator and find the func updateUserAttribute(attributeName: String, attributeValue: String) function. Add the following code:

code language-swift

code language-swift
`// Create a profile map, add attributes to the map and update profile using the map var profileMap = [String: Any]() profileMap[attributeName] = attributeValue UserProfile.updateUserAttributes(attributeDict: profileMap)`

// Create a profile map, add attributes to the map and update profile using the map
var profileMap = [String: Any]()
profileMap[attributeName] = attributeValue
UserProfile.updateUserAttributes(attributeDict: profileMap)

This code:

Sets up an empty dictionary named profileMap.
Adds an element to the dictionary using attributeName (for example isPaidUser), and attributeValue (for example yes).
Uses the profileMap dictionary as a value to the attributeDict parameter of the UserProfile.updateUserAttributes API call.

Navigate to Luma > Luma > Views > Products > ProductView in the Xcode Project navigator and find the call to updateUserAttributes (within the code for the Purchases button). Add the following code:

code language-swift
`// Update attributes MobileSDK.shared.updateUserAttribute(attributeName: "isPaidUser", attributeValue: "yes")`

Get user attributes

Once you have updated a user’s attribute, it is available to other Adobe SDKs but you can also retrieve attributes explicitly, to let your app behave the way you want.

Navigate to Luma > Luma > Views > General > HomeView in the Xcode Project navigator and find the .onAppear modifier. Add the following code:

code language-swift

code language-swift
`// Get attributes UserProfile.getUserAttributes(attributeNames: ["isPaidUser"]) { attributes, error in if attributes?.count ?? 0 > 0 { if attributes?["isPaidUser"] as? String == "yes" { showBadgeForUser = true } else { showBadgeForUser = false } } }`

// Get attributes
UserProfile.getUserAttributes(attributeNames: ["isPaidUser"]) { attributes, error in
    if attributes?.count ?? 0 > 0 {
        if attributes?["isPaidUser"] as? String == "yes" {
            showBadgeForUser = true
        }
        else {
            showBadgeForUser = false
        }
    }
}

This code:

Calls the UserProfile.getUserAttributes API with the isPaidUser attribute name as single element in the attributeNames array.
Then checks for the value of the isPaidUser attribute and when yes, places a badge on the icon in the toolbar at the top right.

Additional documentation can be found here.

Validate with Assurance

Review the setup instructions section to connect your simulator or device to Assurance.

Run the app to log in and interact with a product.

Move the Assurance icon to the left.
Select Home in the tab bar.

To open the Login sheet, select the button.

img-md
w-300

To insert a random email and customer id, select the button .

Select Login.

img-md
w-300

Select Products in the tab bar.
Select one product.
Select .
Select .

Select .

img-md
w-300

Return back to Home screen. You should see that a badge has been added .

img-md
w-300

In the Assurance UI, you should see a UserProfileUpdate and getUserAttributes events with the updated profileMap value.

SUCCESS

You have now set up your app to update attributes of profiles in the Edge Network and (when set up) with Adobe Experience Platform.

Thank you for investing your time in learning about Adobe Experience Platform Mobile SDK. If you have questions, want to share general feedback, or have suggestions on future content, share them on this Experience League Community discussion post.

Next: Use Places

recommendation-more-help

9fed61f5-c338-47ad-8005-0b89a5f4af8b