DocumentatieExperience PlatformTutorial voor mobiele apps

Profielgegevens verzamelen

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

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar

Leer hoe u profielgegevens kunt verzamelen in een mobiele app.

U kunt de extensie Profiel gebruiken om kenmerken van de gebruiker op de client op te slaan. Deze informatie kan later worden gebruikt om berichten tijdens online of off-line scenario's te richten en te personaliseren, zonder het moeten met een server voor optimale prestaties verbinden.

De extensie Profiel beheert het Client-Side Operation Profile (CSOP), biedt een manier om op API's te reageren, werkt gebruikersprofielkenmerken bij en deelt de gebruikersprofielkenmerken met de rest van het systeem als een gegenereerde gebeurtenis.

De profielgegevens worden door andere extensies gebruikt om acties met betrekking tot profielen uit te voeren. Een voorbeeld is de uitbreiding van de Motor van Regels die de profielgegevens verbruikt en regels in werking stelt die op de profielgegevens worden gebaseerd. Leer meer over de uitbreiding van het Profielin de documentatie

IMPORTANT
De functionaliteit Profiel die in deze les wordt beschreven is los van de Real-Time functionaliteit van het Profiel van de Klant in Adobe Experience Platform en Platform-based toepassingen.

Vereisten

  • App met SDK's geïnstalleerd en geconfigureerd met succes gemaakt en uitgevoerd.

Leerdoelstellingen

In deze les zult u:

  • Gebruikerskenmerken instellen of bijwerken.
  • Gebruikerskenmerken ophalen.

Gebruikerskenmerken instellen en bijwerken

Het is handig om gebruikers te laten kiezen voor een bepaald doel en om de app aan te passen en snel te laten weten of een gebruiker in het verleden of onlangs een aankoop heeft gedaan. Laten we dat instellen in de Luma-app.

iOS

  1. Navigeer naar Luma > Luma > Utils > MobileSDK in de Xcode Project navigator en zoek de func updateUserAttribute(attributeName: String, attributeValue: String) functie. Voeg de volgende code toe:

    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)

    Deze code:

    1. Hiermee wordt een leeg woordenboek met de naam profileMap ingesteld.

    2. Hiermee voegt u een element aan het woordenboek toe met attributeName (bijvoorbeeld isPaidUser ) en attributeValue (bijvoorbeeld yes ).

    3. Gebruikt het profileMap woordenboek als waarde aan de attributeDict parameter van de UserProfile.updateUserAttributesAPI vraag.

  2. Navigeer aan Luma > Luma > Views > Products > ProductView in de navigator van het Project van Xcode en vind de vraag aan updateUserAttributes (binnen de code voor de Aankopen CreditCard knoop). Voeg de volgende code toe:

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

  1. Navigeer aan Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK in de navigator van Android Studio en vind de func updateUserAttribute(attributeName: String, attributeValue: String) functie. Voeg de volgende code toe:

    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)

    Deze code:

    1. Stelt een lege kaart met de naam profileMap in.

    2. Voegt een element aan de kaart toe gebruikend attributeName (bijvoorbeeld isPaidUser), en attributeValue (bijvoorbeeld yes).

    3. Gebruikt de profileMap kaart als waarde aan de attributeDict parameter van de UserProfile.updateUserAttributesAPI vraag.

  2. Navigeer aan Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > views > ProductView.kt en vind de vraag aan updateUserAttributes (binnen de code voor de Aankopen CreditCard knoop). Voeg de volgende code toe:

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

Gebruikerskenmerken ophalen

Nadat u het kenmerk van een gebruiker hebt bijgewerkt, is het beschikbaar voor andere Adobe-SDK's, maar u kunt kenmerken ook expliciet ophalen, zodat de toepassing zich naar wens gedraagt.

iOS

  1. Navigeer naar Luma > Luma > Views > General > HomeView in de Xcode-projectnavigator en zoek de optie .onAppear . Voeg de volgende code toe:

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

    Deze code:

    1. Roept de UserProfile.getUserAttributesAPI met de isPaidUser attribuutnaam als enig element in de attributeNames serie.
    2. Dan controles op de waarde van het isPaidUser attribuut en wanneer yes, een badge op het UserCheckedOut pictogram in de toolbar bij het hoogste recht plaatst.
Android

  1. Navigeer aan Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.androi > views > HomeView.kt in de het projectnavigator van Android Studio en vind de .onAppear bepaling. Voeg de volgende code toe:

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

    Deze code:

    1. Roept de UserProfile.getUserAttributesAPI met de isPaidUser attribuutnaam als enig element in de attributeNames serie.
    2. Vervolgens wordt gecontroleerd op de waarde van het kenmerk isPaidUser . In yes vervangt de code het persoonlijke pictogram door een pictogram met een badge in de werkbalk rechtsboven.

Zie de API verwijzingvoor meer informatie.

Valideren met Assurance

  1. Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.
  2. Voer de app uit om u aan te melden en te communiceren met een product.
iOS

  1. Selecteer Home in de tabbalk.

  2. Het Assurance-pictogram naar links verplaatsen.

  3. Om het Login blad te openen, selecteer de knoop van de Gebruiker .

    {width="300"}

  4. Als u een willekeurige e-mail en een klant-id wilt invoegen, selecteert u de knop A | .

  5. Selecteer Login.

    {width="300"}

  6. Selecteer Products in de tabbalk.

  7. Selecteer één product.

  8. Selecteer Hart .

  9. Selecteer ShoppingCart .

  10. Selecteer CreditCard .

    {width="300"}

  11. Ga terug naar Home screen. U zou moeten zien dat een badge UserCheckedOut is toegevoegd.

    {width="300"}

Android

  1. Selecteer Home in de tabbalk.

  2. Het Assurance-pictogram naar links verplaatsen.

  3. Om het Login blad te openen, selecteer de knoop van de Gebruiker .

    {width="300"}

  4. Selecteer Generate Random Email als u een willekeurige e-mail en een klant-id wilt invoegen.

  5. Selecteer Login.

    {width="300"}

  6. Selecteer Products in de tabbalk.

  7. Selecteer één product.

  8. Selecteer ThumbUp

  9. Selecteer ShoppingCart .

  10. Selecteer CreditCard .

    {width="300"}

  11. Ga terug naar Home screen. U zou moeten zien dat het persoonspictogram wordt bijgewerkt.

    {width="300"}

In de gebruikersinterface van Assurance worden UserProfileUpdate - en getUserAttributes -gebeurtenissen met de bijgewerkte profileMap -waarde weergegeven.

bevestigt profiel {modal="regular"}

SUCCESS
U hebt nu uw app ingesteld om de kenmerken van profielen in de Edge Network en (wanneer deze is ingesteld) in Adobe Experience Platform bij te werken.
Bedankt dat je tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene terugkoppelen willen delen, of suggesties over toekomstige inhoud hebben, hen op deze Communautaire besprekingspost van Experience Leaguedelen.

Volgende: Plaatsen van het Gebruik

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