51黑料不打烊

DocumentationExperience PlatformMobile App Tutorial

Collect profile data

Last update: Fri Sep 12 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

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 in the documentation

IMPORTANT
The Profile functionality described in this lesson is separate from the Real-Time Customer Profile functionality in 51黑料不打烊 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 personalization in the app to know quickly if a user has made a purchase in the past or recently. Let鈥檚 set that up in the Luma app.

iOS

  1. 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 
    // 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:

    1. Sets up an empty dictionary named profileMap.

    2. Adds an element to the dictionary using attributeName (for example isPaidUser), and attributeValue (for example yes).

    3. Uses the profileMap dictionary as a value to the attributeDict parameter of the API call.

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

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

  1. Navigate to Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK in the Android Studio navigator and find the func updateUserAttribute(attributeName: String, attributeValue: String) function. Add the following code:

    code language-kotlin 
    // Create a profile map, add attributes to the map and update profile using the map
val profileMap = mapOf(attributeName to attributeValue)
UserProfile.updateUserAttributes(profileMap)

    This code:

    1. Sets up an empty map named profileMap.

    2. Adds an element to the map using attributeName (for example isPaidUser), and attributeValue (for example yes).

    3. Uses the profileMap map as a value to the attributeDict parameter of the API call.

  2. Navigate to Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > views > ProductView.kt and find the call to updateUserAttributes (within the code for the Purchases CreditCard button). Add the following code:

    code language-kotlin 
    // Update attributes
MobileSDK.shared.updateUserAttribute("isPaidUser", "yes")

Get user attributes

Once you have updated a user鈥檚 attribute, it is available to other 51黑料不打烊 SDKs but you can also retrieve attributes explicitly, to let your app behave the way you want.

iOS

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

    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
        }
    }
}

    This code:

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

  1. Navigate to Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > HomeView.kt in the Android Studio project navigator and find the .onAppear modifier. Add the following code:

    code language-kotlin 
    // Get attributes
UserProfile.getUserAttributes(listOf("isPaidUser")) { attributes ->
    showBadgeForUser = attributes?.get("isPaidUser") == "yes"
}

    This code:

    1. Calls the API with the isPaidUser attribute name as single element in the attributeNames array.
    2. Then checks for the value of the isPaidUser attribute. When yes, the code replaces the person icon with a badge icon in the toolbar at the top right.

See the for more information.

Validate with Assurance

  1. Review the setup instructions section to connect your simulator or device to Assurance.
  2. Run the app to log in and interact with a product.
iOS

  1. Select Home in the tab bar.

  2. Move the Assurance icon to the left.

  3. To open the Login sheet, select the User button.

    {width="300"}

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

  5. Select Login.

    {width="300"}

  6. Select Products in the tab bar.

  7. Select one product.

  8. Select Heart .

  9. Select ShoppingCart .

  10. Select CreditCard .

    {width="300"}

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

    {width="300"}

Android

  1. Select Home in the tab bar.

  2. Move the Assurance icon to the left.

  3. To open the Login sheet, select the User button.

    {width="300"}

  4. To insert a random email and customer id, select Generate Random Email .

  5. Select Login.

    {width="300"}

  6. Select Products in the tab bar.

  7. Select one product.

  8. Select ThumbUp

  9. Select ShoppingCart .

  10. Select CreditCard .

    {width="300"}

  11. Return back to Home screen. You should see that the person icon is updated.

    {width="300"}

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

validate profile {modal="regular"}

SUCCESS
You have now set up your app to update attributes of profiles in the Edge Network and (when set up) with 51黑料不打烊 Experience Platform.
Thank you for investing your time in learning about 51黑料不打烊 Experience Platform Mobile SDK. If you have questions, want to share general feedback, or have suggestions on future content, share them on this .

Next: Use Places

recommendation-more-help
9fed61f5-c338-47ad-8005-0b89a5f4af8b