Samla in identitetsdata

Lär dig hur du samlar in identitetsdata i en mobilapp.

Adobe Experience Platform identitetstjänst hjälper er att få en bättre bild av era kunder och deras beteenden genom att överbrygga identiteter mellan olika enheter och system, så att ni kan leverera slagkraftiga, personliga digitala upplevelser i realtid. Identitetsfält och namnutrymmen är den kombination som förenar olika datakällor för att skapa en 360-graders kundprofil i realtid.

Läs mer om Identitetstillägg och identitetstjänst i dokumentationen.

Förutsättningar

  • App med SDK:er har installerats och konfigurerats.

Utbildningsmål

I den här lektionen kommer du att:

  • Konfigurera ett anpassat ID-namnutrymme.
  • Uppdatera identiteter.
  • Validera identitetsdiagrammet.
  • Hämta ECID och andra identiteter.

Konfigurera ett anpassat ID-namnutrymme

Identitetsnamnutrymmen är komponenter i Identitetstjänst som fungerar som indikatorer för det sammanhang som en identitet hör till. De skiljer till exempel på värdet name@email.com som e-postadress eller 443522 som ett numeriskt CRM-ID.

NOTE
Mobile SDK genererar en unik identitet i sitt eget namnutrymme med namnet Experience Cloud ID (ECID) när programmet installeras. Detta ECID lagras i beständigt minne på den mobila enheten och skickas med varje träff. ECID tas bort när användaren avinstallerar programmet eller när användaren ställer in den globala sekretessstatusen för Mobile SDK på avanmälan. I exempelappen Luma bör du ta bort och installera om appen för att skapa en ny profil med ett eget unikt ECID.

Så här skapar du ett nytt identitetsnamnutrymme:

  1. I gränssnittet för datainsamling väljer du Identiteter från vänster-rälsnavigering.

  2. Välj Skapa namnutrymme för identitet.

  3. Ange en Visningsnamn av Luma CRM ID och Identitetssymbol värde för lumaCRMId.

  4. Välj Enhetsoberoende ID.

  5. Välj Skapa.

    skapa namnutrymme för identitet

Uppdatera identiteter

Du vill uppdatera både standardidentiteten (e-post) och den anpassade identiteten (Luma CRM ID) när användaren loggar in i programmet.

  1. Navigera till Luma > Luma > Utils > MobileSDK i Xcode Project navigator och hitta func updateIdentities(emailAddress: String, crmId: String) funktionsimplementering. Lägg till följande kod i funktionen.

    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)
    

    Den här koden:

    1. Skapar en tom IdentityMap -objekt.

      code language-swift
      let identityMap: IdentityMap = IdentityMap()
      
    2. Inställningar IdentityItem objekt för e-post och CRM-ID.

      code language-swift
      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
      let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
      
    3. Lägger till dessa IdentityItem objekt till IdentityMap -objekt.

      code language-swift
      identityMap.add(item:emailIdentity, withNamespace: "Email")
      identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")
      
    4. Skickar IdentityItem objektet som en del av Identity.updateIdentities API-anrop till Edge Network.

      code language-swift
      Identity.updateIdentities(with: identityMap)
      
  2. Navigera till Luma > Luma > Views > General > LoginSheet i Xcode Project navigator och hitta koden som ska köras när du väljer Inloggning -knappen. Lägg till följande kod:

    code language-swift
    // Update identities
    MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
NOTE
Du kan skicka flera identiteter i en enda updateIdentities ring. Du kan också ändra identiteter som du tidigare skickat.

Ta bort en identitet

Du kan använda Identity.removeIdentity API för att ta bort identiteten från den lagrade identitetskartan på klientsidan. Identitetstillägget slutar skicka identifieraren till Edge Network. Om du använder detta API tas inte identifieraren bort från serversidans identitetsdiagram. Se Visa identitetsdiagram om du vill ha mer information om identitetsdiagram.

  1. Navigera till Luma > Luma > Utils > MobileSDK i Xcode Project navigator och lägg till följande kod i func removeIdentities(emailAddress: String, crmId: String) funktion:

    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. Navigera till Luma > Luma > Views > General > LoginSheet i Xcode Project navigator och hitta koden som ska köras när du väljer Utloggning -knappen. Lägg till följande kod:

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

Validera med Assurance

  1. Granska installationsanvisningar för att ansluta simulatorn eller enheten till Assurance.

  2. I Luma-appen

    1. Välj Startsida och flytta Assurance-ikonen till vänster.

    2. Välj+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+ikonen längst upp till höger.

      img-md
      w-300
    3. Ange en e-postadress och ett CRM-ID, eller

    4. Välj+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+till slumpmässigt generera en E-post och CRM-ID.

    5. Välj Inloggning.

      img-md
      w-300
  3. Leta i webbgränssnittet för Assurance efter Edge Identity Update Identities -händelsen från com.adobe.griffon.mobile leverantör.

  4. Markera händelsen och granska data i ACPExtensionEventData -objekt. Du bör se de identiteter som du har uppdaterat.
    validera identitetsuppdatering

Validera med identitetsdiagram

När du är klar med stegen i Experience Platform lektionkan du bekräfta identitetsfångsten i visningsprogrammet för plattformsidentitetsdiagram:

  1. Välj Identiteter i användargränssnittet för datainsamling.

  2. Välj Identitetsdiagram i det övre fältet.

  3. Retur Luma CRM ID som Namnutrymme för identitet och ditt CRM-ID (till exempel 24e620e255734d8489820e74f357b5c8) som Identitetsvärde.

  4. Du ser Identiteter listas.

    validera identitetsdiagram

INFO
Det finns ingen kod i programmet för att återställa ECID, vilket betyder att du bara kan återställa ECID (och effektivt skapa en ny profil med ett nytt ECID) genom en avinstallation och ominstallation av programmet. Information om hur du implementerar återställning av identifierare finns i Identity.resetIdentities och MobileCore.resetIdentities API-anrop. Tänk dock på detta när du använder en push-meddelandeidentifierare (se Skicka push-meddelanden) blir den identifieraren en annan 'klisteristidentifierare' på enheten.
SUCCESS
Du har nu konfigurerat din app för att uppdatera identiteter i Edge Network och (när den har konfigurerats) med Adobe Experience Platform.
Tack för att du lade ned din tid på att lära dig om Adobe Experience Platform Mobile SDK. Om du har frågor, vill dela allmän feedback eller har förslag på framtida innehåll kan du dela dem om detta Experience League diskussionsinlägg

Nästa: Samla in profildata

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