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. Tjänsterna överbryggar identiteterna mellan olika enheter och system och gör 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ägget och identitetstjänsten i dokumentationen.

Förhandskrav

  • 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änsten som fungerar som indikatorer för det sammanhang som en identitet relateras till. De särskiljer till exempel värdet name@email.com som en 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 appen 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 anger Mobile SDK globala sekretessstatus som 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 Identities i navigeringen till vänster.

  2. Välj Create identity namespace.

  3. Ange Display name av Luma CRM ID och Identity symbol värdet lumaCRMId.

  4. Välj Cross-device ID.

  5. Välj Create.

    skapa ID-namnområde {modal="regular"}

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.

iOS
  1. Navigera till Luma > Luma > Utils > MobileSDK i Xcode-projektnavigeraren och hitta func updateIdentities(emailAddress: String, crmId: String)-funktionsimplementeringen. 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 ett tomt IdentityMap-objekt.

      code language-swift
      let identityMap: IdentityMap = IdentityMap()
      
    2. Ställer in 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 i IdentityMap-objektet.

      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-anropet till Edge Network.

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

    code language-swift
    // Update identities
    MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
Android
  1. Navigera till Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK i Android Studio-navigatören och hitta fun updateIdentities(emailAddress: String, crmId: String) -funktionsimplementeringen. Lägg till följande kod i funktionen.

    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)
    

    Den här koden:

    1. Skapar ett tomt IdentityMap-objekt.

      code language-kotlin
      val identityMap = IdentityMap()
      
    2. Ställer in IdentityItem objekt för e-post och CRM-ID.

      code language-kotlin
      val emailIdentity = IdentityItem(emailAddress, AuthenticatedState.AUTHENTICATED, true)
      val crmIdentity = IdentityItem(crmId, AuthenticatedState.AUTHENTICATED, true)
      
    3. Lägger till dessa IdentityItem-objekt i IdentityMap-objektet.

      code language-kotlin
      identityMap.addItem(emailIdentity, "Email")
      identityMap.addItem(crmIdentity, "lumaCRMId")
      
    4. Skickar IdentityItem-objektet som en del av Identity.updateIdentities API-anropet till Edge Network.

      code language-kotlin
      Identity.updateIdentities(identityMap)
      
  2. Navigera till Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > views > LoginSheet.kt i Android Studio-navigatorn och leta reda på koden som ska köras när du väljer knappen Login . Lägg till följande kod:

    code language-kotlin
    // Update identities
    MobileSDK.shared.updateIdentities(
       MobileSDK.shared.currentEmailId.value,
       MobileSDK.shared.currentCRMId.value
    )
    
NOTE
Du kan skicka flera identiteter i ett enda updateIdentities-samtal. Du kan också ändra identiteter som du tidigare skickat.

Ta bort en identitet

Du kan använda API:t Identity.removeIdentity 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. Mer information om identitetsdiagram finns i Visa identitetsdiagram.

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

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

    code language-swift
    // Remove identities
    MobileSDK.shared.removeIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
Android
  1. Navigera till Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK i Android Studio-navigatorn och lägg till följande kod i funktionen fun removeIdentities(emailAddress: String, crmId: String):

    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. Navigera till app > kotlin+java > com.adobe.luma.tutorial.android > views > LoginSheet.kt i Android Studio-navigatorn och leta reda på koden som ska köras när du väljer knappen Logout. Lägg till följande kod:

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

Validera med Assurance

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

  2. I Luma-appen

    1. Markera fliken Home och flytta Assurance-ikonen åt vänster.
    2. Välj ikonen Användare i det övre högra hörnet.
iOS
{width="300"}
Android
{width="300"}

På skärmen Identities:

  1. Ange en e-postadress och ett CRM-ID, eller
  2. Välj A | (iOS) eller Generate Random Email (Android) om du vill generera en slumpmässig Email och CRM ID.
  3. Välj Login.
iOS
{width="300"}
Android
{width="300"}

I Assurance:

  1. Kontrollera Assurance webbgränssnitt för händelsen Edge Identity Update Identities från leverantören com.adobe.griffon.mobile.

  2. Markera händelsen och granska data i objektet ACPExtensionEventData. Du bör se de identiteter som du har uppdaterat.

    validera identitetsuppdatering {modal="regular"}

Validera med identitetsdiagram

När du har slutfört stegen i Experience Platform-lektionen kan du bekräfta identitetsfångsten i visningsprogrammet för Experience Platform-identitetsdiagram:

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

  2. Välj Identity Graph i det övre fältet.

  3. Ange Luma CRM ID som Identity namespace och ditt CRM-ID (till exempel 24e620e255734d8489820e74f357b5c8) som Identity value.

  4. Identities visas.

    validera identitetsdiagram {modal="regular"}

INFO
Det finns ingen kod i programmet som kan återställa ECID. Du kan bara återställa ECID (och effektivt skapa en ny profil med ett nytt ECID) genom en avinstallation och en ominstallation av programmet. Information om hur du implementerar återställningen av identifierare finns i API-anropen för Identity.resetIdentities och MobileCore.resetIdentities. Tänk på att när du använder en identifierare för push-meddelanden (se Skicka push-meddelanden) blir den identifieraren en annan profilidentifierare för push-meddelanden på enheten.
SUCCESS
Du har nu konfigurerat din app för att uppdatera identiteter i Edge Network och (när du konfigurerar den) med Adobe Experience Platform.
Tack för att du har lagt 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 i det här Experience League Community-diskussionsinlägget

Nästa: Samla in profildata

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