DocumentatieExperience PlatformTutorial voor mobiele apps

Identiteitsgegevens verzamelen

Laatst bijgewerkt: 5 juni 2025
  • Onderwerpen:

Gemaakt voor:

  • Beginner
  • tussenpersoon
  • Ontwikkelaar

Leer hoe u identiteitsgegevens kunt verzamelen in een mobiele app.

Met de Adobe Experience Platform Identity Service kunt u uw klanten en hun gedrag beter zien door identiteiten tussen apparaten en systemen te overbruggen, zodat u in real-time een indrukwekkende, persoonlijke digitale ervaring kunt 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 opt-out. 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

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.

  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.

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

      let identityMap: IdentityMap = IdentityMap()

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

      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.

      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.

      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:

    // Update identities
MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
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.

  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:

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

    // Remove identities
MobileSDK.shared.removeIdentities(emailAddress: currentEmailId, crmId: currentCRMId)

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 de vanaf de rechterbovenhoek.

    3. Geef een e-mailadres en een CRM-id op, of

    4. Selecteren om een Email en CRM ID willekeurig te genereren.

    5. Selecteer Login.

  3. Kijk in de Assurance-webinterface voor de Edge Identity Update Identities -gebeurtenis van de com.adobe.griffon.mobile -leverancier.

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

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 Platforms:

  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

INFO
De toepassing bevat geen code om de ECID opnieuw in te stellen. Dit betekent dat u de ECID alleen opnieuw kunt instellen (en daadwerkelijk een nieuw profiel met een nieuwe ECID kunt 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 bewust niettemin, wanneer het gebruiken van een herkenningsteken van het duw- bericht (zie Verzendende duw berichten), 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