DocumentatieExperience PlatformTutorial voor mobiele apps

Identiteitsgegevens verzamelen

Last update: Tue Jul 16 2024 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 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 mobiele SDK genereert een unieke identiteit in een eigen naamruimte, de zogenaamde 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 de 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.

    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)
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 uitbreiding van de Identiteit houdt op verzendend het herkenningsteken 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:

    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 = "112ca06ed53d3db37e4cea49cc45b71e"

  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)

Valideren met betrouwbaarheid

  1. Herzie de sectie van opstellingsinstructiesom uw simulator of apparaat aan Verzekering te verbinden.

  2. In de app Luma

    1. Selecteer de tab Home en verplaats het pictogram Verzekering naar links.

    2. Selecteer de {width="15"} vanaf de rechterbovenhoek.

      {width="300"}

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

    4. Selecteren {width="15"} om een Email en CRM ID willekeurig te genereren.

    5. Selecteer Login.

      {width="300"}

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

  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 het 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 uw app ingesteld om de identiteiten in de Edge Network en (wanneer deze is ingesteld) met Adobe Experience Platform bij te werken.
Bedankt dat u 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 de Experience Leaguedelen

Volgende: verzamel profielgegevens

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