DokumentationExperience PlatformSjälvstudiekurs om mobila appar

Samla in identitetsdata

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Ämnen:

Skapat för:

  • Nybörjare
  • Mellanliggande
  • Utvecklare

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ä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 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 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

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

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

  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)

Validera med Assurance

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

  2. I Luma-appen

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

    2. Välj Ikonen {width="15"} uppifrån till höger.

      {width="300"}

    3. Ange en e-postadress och ett CRM-ID, eller

    4. Välj {width="15"} om du vill generera en Email och CRM ID slumpmässigt.

    5. Välj Login.

      {width="300"}

  3. Sök efter händelsen Edge Identity Update Identities från leverantören com.adobe.griffon.mobile i kontrollwebbgränssnittet.

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

Validera med identitetsdiagram

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

  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

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ällningen av identifierare finns i API-anropen för Identity.resetIdentities och MobileCore.resetIdentities. Tänk dock 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 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 i det här Experience League-diskussionsinlägget

Nästa: Samla in profildata

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