DocumentatieExperience PlatformTutorial voor mobiele apps

Identiteitsgegevens verzamelen

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

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar

Leer hoe u identiteitsgegevens kunt verzamelen in een mobiele app.

Met Adobe Experience Platform Identity Service kunt u uw klanten en hun gedrag beter zien. De services bieden een brug tussen identiteiten op verschillende apparaten en systemen en bieden u de mogelijkheid om in real-time effectieve, persoonlijke digitale ervaringen te bieden. Identiteitsvelden en naamruimten zijn de lijm die verschillende gegevensbronnen samenvoegt om het 360 graden klantenprofiel in real time te bouwen.

Leer meer over de uitbreiding van de Identiteiten de identiteitsdienstin de documentatie.

Vereisten

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

Leerdoelstellingen

In deze les zult u:

  • Stel een naamruimte voor een aangepaste identiteit in.
  • Identiteiten bijwerken.
  • Valideer de identiteitsgrafiek.
  • ECID en andere identiteiten ophalen.

Een aangepaste naamruimte voor identiteiten instellen

Identiteitsnaamruimten zijn componenten van Dienst van de Identiteitdie als indicatoren van de context dienen waarop een identiteit betrekking heeft. Ze onderscheiden bijvoorbeeld de waarde name@email.com als e-mailadres of 443522 als een numerieke CRM-id.

NOTE
De Mobile SDK genereert een unieke identiteit in een eigen naamruimte, de naam Experience Cloud ID (ECID), wanneer de toepassing wordt geïnstalleerd. Deze ECID wordt opgeslagen in permanent geheugen op het mobiele apparaat en wordt bij elke hit verzonden. De ECID wordt verwijderd wanneer de gebruiker de app verwijdert of wanneer de gebruiker de algemene privacystatus van Mobile SDK instelt op Weigeren. In de voorbeeldtoepassing Luma moet u de toepassing verwijderen en opnieuw installeren om een nieuw profiel met een eigen unieke ECID te maken.

Een nieuwe naamruimte maken:

  1. Selecteer in de interface Gegevensverzameling de optie Identities bij de navigatie links/rechts.

  2. Selecteer Create identity namespace.

  3. Geef Display name van Luma CRM ID en Identity symbol de waarde lumaCRMId op.

  4. Selecteer Cross-device ID.

  5. Selecteer Create.

    creeer identiteit namespace {modal="regular"}

Identiteiten bijwerken

U wilt zowel de standaardidentiteit (e-mail) als de aangepaste identiteit (Luma CRM-id) bijwerken wanneer de gebruiker zich aanmeldt bij de app.

iOS

  1. Navigeer naar Luma > Luma > Utils > MobileSDK in de Xcode Project navigator en zoek de func updateIdentities(emailAddress: String, crmId: String) functie-implementatie. Voeg de volgende code toe aan de functie.

    code language-swift 
    // Set up identity map, add identities to map and update identities
let identityMap: IdentityMap = IdentityMap()

let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
identityMap.add(item:emailIdentity, withNamespace: "Email")
identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")

Identity.updateIdentities(with: identityMap)

    Deze code:

    1. Maakt een leeg IdentityMap -object.

      code language-swift 
      let identityMap: IdentityMap = IdentityMap()

    2. Stelt IdentityItem -objecten in voor e-mail- en CRM-id.

      code language-swift 
      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)

    3. Voegt deze IdentityItem -objecten toe aan het IdentityMap -object.

      code language-swift 
      identityMap.add(item:emailIdentity, withNamespace: "Email")
identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")

    4. Verzendt het IdentityItem -object als onderdeel van de Identity.updateIdentities API-aanroep naar de Edge Network.

      code language-swift 
      Identity.updateIdentities(with: identityMap)

  2. Navigeer naar Luma > Luma > Views > General > LoginSheet in de Xcode-projectnavigator en zoek de uit te voeren code wanneer u de knop Login selecteert. Voeg de volgende code toe:

    code language-swift 
    // Update identities
MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
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 fun updateIdentities(emailAddress: String, crmId: String) functie implementatie. Voeg de volgende code toe aan de functie.

    code language-kotlin 
    // Set up identity map, add identities to map and update identities
val identityMap = IdentityMap()

val emailIdentity = IdentityItem(emailAddress, AuthenticatedState.AUTHENTICATED, true)
val crmIdentity = IdentityItem(crmId, AuthenticatedState.AUTHENTICATED, true)
identityMap.addItem(emailIdentity, "Email")
identityMap.addItem(crmIdentity, "lumaCRMId")

Identity.updateIdentities(identityMap)

    Deze code:

    1. Maakt een leeg IdentityMap -object.

      code language-kotlin 
      val identityMap = IdentityMap()

    2. Stelt IdentityItem -objecten in voor e-mail- en CRM-id.

      code language-kotlin 
      val emailIdentity = IdentityItem(emailAddress, AuthenticatedState.AUTHENTICATED, true)
val crmIdentity = IdentityItem(crmId, AuthenticatedState.AUTHENTICATED, true)

    3. Voegt deze IdentityItem -objecten toe aan het IdentityMap -object.

      code language-kotlin 
      identityMap.addItem(emailIdentity, "Email")
identityMap.addItem(crmIdentity, "lumaCRMId")

    4. Verzendt het IdentityItem -object als onderdeel van de Identity.updateIdentities API-aanroep naar de Edge Network.

      code language-kotlin 
      Identity.updateIdentities(identityMap)

  2. Navigeer aan Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > views > LoginSheet.kt in de navigator van Android Studio en vind de uit te voeren code wanneer het selecteren van de Login knoop. Voeg de volgende code toe:

    code language-kotlin 
    // Update identities
MobileSDK.shared.updateIdentities(
   MobileSDK.shared.currentEmailId.value,
   MobileSDK.shared.currentCRMId.value
)
NOTE
U kunt meerdere identiteiten verzenden in één updateIdentities oproep. U kunt eerder verzonden identiteiten ook wijzigen.

Een identiteit verwijderen

U kunt Identity.removeIdentity gebruikenAPI om de identiteit uit de opgeslagen cliënt-zijidentiteitskaart te verwijderen. De identiteitsextensie verzendt de id niet meer naar de Edge Network. Het gebruik van deze API verwijdert de id niet uit de identiteitsgrafiek aan de serverzijde. Zie identiteitsgrafieken van de Meningvoor meer informatie over identiteitsgrafieken.

iOS

  1. Navigeer naar Luma > Luma > Utils > MobileSDK in de Xcode Project navigator en voeg de volgende code toe aan de func removeIdentities(emailAddress: String, crmId: String) functie:

    code language-swift 
    // Remove identities and reset email and CRM Id to their defaults
Identity.removeIdentity(item: IdentityItem(id: emailAddress), withNamespace: "Email")
Identity.removeIdentity(item: IdentityItem(id: crmId), withNamespace: "lumaCRMId")
currentEmailId = "testUser@gmail.com"
currentCRMId = "b642b4217b34b1e8d3bd915fc65c4452"

  2. Navigeer naar Luma > Luma > Views > General > LoginSheet in de Xcode-projectnavigator en zoek de uit te voeren code wanneer u de knop Logout selecteert. Voeg de volgende code toe:

    code language-swift 
    // Remove identities
MobileSDK.shared.removeIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
Android

  1. Navigeer aan Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK in de navigator van Android Studio en voeg de volgende code aan de fun removeIdentities(emailAddress: String, crmId: String) functie toe:

    code language-kotlin 
    // Remove identities and reset email and CRM Id to their defaults
Identity.removeIdentity(IdentityItem(emailAddress), "Email")
Identity.removeIdentity(IdentityItem(crmId), "lumaCRMId")
currentEmailId.value = "testUser@gmail.com"
currentCRMId.value = "112ca06ed53d3db37e4cea49cc45b71e"

1.Navigeer naar app > kotlin+java > com.adobe.luma.tutorial.android > views > LoginSheet.kt in de Android Studio-navigator en zoek naar de code die moet worden uitgevoerd wanneer u de knop Logout selecteert. Voeg de volgende code toe:

code language-kotlin 
// Remove identities
MobileSDK.shared.removeIdentities(
   MobileSDK.shared.currentEmailId.value,
   MobileSDK.shared.currentCRMId.value
)

Valideren met Assurance

  1. Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat met Assurance te verbinden.

  2. In de app Luma

    1. Selecteer de tab Home en verplaats het Assurance-pictogram naar links.
    2. Selecteer het pictogram van de Gebruiker van het hoogste recht.
iOS
{width="300"}
Android
{width="300"}

In het Identities -scherm:

  1. Geef een e-mailadres en een CRM-id op, of
  2. Selecteer A | (iOS) of Generate Random Email (Android) om een Email en CRM ID willekeurig te genereren.
  3. Selecteer Login.
iOS
{width="300"}
Android
{width="300"}

Terug in Assurance:

  1. Ga naar de Assurance-webinterface voor de Edge Identity Update Identities -gebeurtenis van de com.adobe.griffon.mobile -leverancier.

  2. Selecteer de gebeurtenis en bekijk de gegevens in het ACPExtensionEventData -object. U moet de identiteiten zien die u hebt bijgewerkt.

    bevestigt identiteitsupdate {modal="regular"}

Valideren met identiteitsgrafiek

Zodra u de stappen in de les van Experience Platformvoltooit, kunt u de identiteit bevestigen vangen in de kijker van de identiteitsgrafiek van Experience Platform:

  1. Selecteer Identities in de gebruikersinterface voor gegevensverzameling.

  2. Selecteer Identity Graph in de bovenste balk.

  3. Voer Luma CRM ID in als de Identity namespace en uw CRM-id (bijvoorbeeld 24e620e255734d8489820e74f357b5c8 ) als de Identity value .

  4. U ziet de Identities weergegeven.

    bevestigt identiteitsgrafiek {modal="regular"}

INFO
De toepassing bevat geen code om de ECID opnieuw in te stellen. U kunt de ECID alleen opnieuw instellen (en daadwerkelijk een nieuw profiel met een nieuwe ECID maken) door de toepassing te verwijderen en opnieuw te installeren. Om het terugstellen van herkenningstekens uit te voeren, zie Identity.resetIdentitiesen MobileCore.resetIdentitiesAPI vraag. Ben zich ervan bewust dat wanneer u een herkenningsteken van het duw- bericht gebruikt (zie Verzendende dupberichten), dat herkenningsteken een andere "kleverige"profielherkenningsteken op het apparaat wordt.
SUCCESS
U hebt nu een app ingesteld om de identiteiten 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: verzamel profielgegevens

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