Identiteitsgegevens verzamelen

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.

Meer informatie over de Identiteitsextensie en de identiteitsservice in 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 onderdelen van Identiteitsservice die dienen als indicatoren van de context waarop een identiteit betrekking heeft. Ze onderscheiden bijvoorbeeld een waarde van 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 Identiteiten van de linkse spoorwegnavigatie.

  2. Selecteren Naamruimte maken.

  3. Geef een Weergavenaam van Luma CRM ID en Identiteitssymbool waarde van lumaCRMId.

  4. Selecteren Apparaatoverschrijdende id.

  5. Selecteren Maken.

    naamruimte voor identiteit maken

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. Navigeren naar Luma > Luma > Utils > MobileSDK in de Xcode-projectnavigator 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. Hiermee maakt u een lege IdentityMap object.

      code language-swift
      let identityMap: IdentityMap = IdentityMap()
      
    2. Instellen IdentityItem objecten 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. Hiermee voegt u deze IdentityItem objecten naar de IdentityMap object.

      code language-swift
      identityMap.add(item:emailIdentity, withNamespace: "Email")
      identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")
      
    4. Hiermee verzendt u de IdentityItem object als onderdeel van het Identity.updateIdentities API-aanroep naar het Edge-netwerk.

      code language-swift
      Identity.updateIdentities(with: identityMap)
      
  2. Navigeren naar Luma > Luma > Views > General > Aanmeldingsblad in de Xcode-projectnavigator en zoek de uit te voeren code wanneer u de Aanmelden knop. Voeg de volgende code toe:

    code language-swift
    // Update identities
    MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
NOTE
U kunt meerdere identiteiten in één keer verzenden updateIdentities vraag. U kunt eerder verzonden identiteiten ook wijzigen.

Een identiteit verwijderen

U kunt de Identity.removeIdentity API om de identiteit uit de opgeslagen client-side identiteitskaart te verwijderen. De uitbreiding van de Identiteit houdt op verzendend het herkenningsteken naar het Netwerk van de Rand. Het gebruik van deze API verwijdert de id niet uit de identiteitsgrafiek aan de serverzijde. Zie Identiteitsgrafieken weergeven voor meer informatie over identiteitsgrafieken.

  1. Navigeren naar Luma > Luma > Utils > MobileSDK in de Xcode-projectnavigator en voeg de volgende code toe aan 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. Navigeren naar Luma > Luma > Views > General > Aanmeldingsblad in de Xcode-projectnavigator en zoek de uit te voeren code wanneer u de Afmelden knop. Voeg de volgende code toe:

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

Valideren met betrouwbaarheid

  1. Controleer de installatie-instructies om de simulator of het apparaat aan te sluiten op Betrouwbaarheid.

  2. In de app Luma

    1. Selecteer de Home en verplaatst u het pictogram Verzekering naar links.

    2. Selecteer de+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+van rechtsboven.

      img-md
      w-300
    3. Geef een e-mailadres en een CRM-id op, of

    4. Selecteren+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+om willekeurig een E-mail en CRM-id.

    5. Selecteren Aanmelden.

      img-md
      w-300
  3. Kijk in de Assurance-webinterface voor de Identiteitsupdates rand gebeurtenis van de com.adobe.griffon.mobile leverancier.

  4. Selecteer de gebeurtenis en bekijk de gegevens in het dialoogvenster ACPExtensionEventData object. U moet de identiteiten zien die u hebt bijgewerkt.
    update identiteiten valideren

Valideren met identiteitsgrafiek

Nadat u de stappen in het dialoogvenster Experience Platform leskunt u de identiteitsopname bevestigen in de identiteitsgrafiek van platforms:

  1. Selecteren Identiteiten in de UI voor gegevensverzameling.

  2. Selecteren Naamgrafiek in de bovenste balk.

  3. Enter Luma CRM ID als de Naamruimte identiteit en uw CRM-id (bijvoorbeeld 24e620e255734d8489820e74f357b5c8) als Identiteitswaarde.

  4. U ziet de Identiteiten vermeld.

    identiteitsgrafiek valideren

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. Als u de reset van id's wilt implementeren, raadpleegt u de Identity.resetIdentities en MobileCore.resetIdentities API-aanroepen. Houd er echter rekening mee dat wanneer u een id voor pushmeldingen gebruikt (zie Pushmeldingen verzenden), wordt die id een andere 'sticky'-profielid op het apparaat.
SUCCESS
U hebt nu uw app ingesteld om de identiteiten in het Edge-netwerk bij te werken en (wanneer deze is ingesteld) met Adobe Experience Platform.
Bedankt dat u tijd hebt geïnvesteerd in het leren van Adobe Experience Platform Mobile SDK. Als u vragen hebt, algemene feedback wilt delen of suggesties voor toekomstige inhoud wilt hebben, deelt u deze over deze Experience League Communautaire discussiestuk

Volgende: Profielgegevens verzamelen

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