Raccogliere dati di identità

Scopri come raccogliere i dati di identità in un’app mobile.

Il servizio Adobe Experience Platform Identity consente di avere una visione migliore dei clienti e dei loro comportamenti. I servizi uniscono le identità tra dispositivi e sistemi, consentendo di fornire esperienze digitali personali e di impatto in tempo reale. I campi di identità e gli spazi dei nomi sono l’associazione che unisce diverse origini di dati per creare il profilo cliente in tempo reale a 360 gradi.

Ulteriori informazioni sull'estensione Identity e sul servizio Identity sono disponibili nella documentazione.

Prerequisiti

  • L'app con gli SDK installati e configurati è stata creata ed eseguita correttamente.

Obiettivi di apprendimento

In questa lezione verranno fornite le seguenti informazioni:

  • Imposta uno spazio dei nomi di identità personalizzato.
  • Aggiornare le identità.
  • Convalida il grafico delle identità.
  • Ottieni ECID e altre identità.

Impostare uno spazio dei nomi di identità personalizzato

Gli spazi dei nomi delle identità sono componenti di Identity Service che fungono da indicatori del contesto a cui si riferisce un'identità. Ad esempio, distinguono un valore di name@email.com come indirizzo e-mail o 443522 come ID CRM numerico.

NOTE
Quando l’app viene installata, Mobile SDK genera un’identità univoca nel proprio spazio dei nomi, denominata Experience Cloud ID (ECID). Questo ECID viene memorizzato nella memoria persistente del dispositivo mobile e inviato con ogni hit. L’ECID viene rimosso quando l’utente disinstalla l’app o imposta lo stato di privacy globale di Mobile SDK in modo che rinunci. Nell’app Luma di esempio, devi rimuovere e reinstallare l’app per creare un nuovo profilo con il proprio ECID univoco.

Per creare un nuovo spazio dei nomi dell’identità:

  1. Nell'interfaccia di Data Collection, seleziona Identità dalla navigazione nella barra a sinistra.

  2. Seleziona Crea uno spazio dei nomi delle identità.

  3. Fornisci un Nome visualizzato di Luma CRM ID e un Valore del simbolo di identitàlumaCRMId.

  4. Seleziona ID multi-dispositivo.

  5. Seleziona Crea.

    crea spazio dei nomi identità {modal="regular"}

Aggiorna identità

Desideri aggiornare sia l’identità standard (e-mail) che quella personalizzata (ID CRM Luma) quando l’utente accede all’app.

iOS
  1. Passa a Luma > Luma > Utils > MobileSDK nel navigatore progetti Xcode e trova l'implementazione della funzione func updateIdentities(emailAddress: String, crmId: String). Aggiungi il codice seguente alla funzione.

    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)
    

    Questo codice:

    1. Crea un oggetto IdentityMap vuoto.

      code language-swift
      let identityMap: IdentityMap = IdentityMap()
      
    2. Imposta IdentityItem oggetti per l'ID di posta elettronica e CRM.

      code language-swift
      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
      let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)
      
    3. Aggiunge questi oggetti IdentityItem all'oggetto IdentityMap.

      code language-swift
      identityMap.add(item:emailIdentity, withNamespace: "Email")
      identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")
      
    4. Invia l'oggetto IdentityItem come parte della chiamata API Identity.updateIdentities ad Edge Network.

      code language-swift
      Identity.updateIdentities(with: identityMap)
      
  2. Passa a Luma > Luma > Views > General > LoginSheet nel navigatore progetti Xcode e trova il codice da eseguire quando selezioni il pulsante Login. Aggiungi il seguente codice:

    code language-swift
    // Update identities
    MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
Android
  1. Passa a Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK nel navigatore di Android Studio e trova l'implementazione della funzione fun updateIdentities(emailAddress: String, crmId: String) . Aggiungi il codice seguente alla funzione.

    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)
    

    Questo codice:

    1. Crea un oggetto IdentityMap vuoto.

      code language-kotlin
      val identityMap = IdentityMap()
      
    2. Imposta IdentityItem oggetti per l'ID di posta elettronica e CRM.

      code language-kotlin
      val emailIdentity = IdentityItem(emailAddress, AuthenticatedState.AUTHENTICATED, true)
      val crmIdentity = IdentityItem(crmId, AuthenticatedState.AUTHENTICATED, true)
      
    3. Aggiunge questi oggetti IdentityItem all'oggetto IdentityMap.

      code language-kotlin
      identityMap.addItem(emailIdentity, "Email")
      identityMap.addItem(crmIdentity, "lumaCRMId")
      
    4. Invia l'oggetto IdentityItem come parte della chiamata API Identity.updateIdentities ad Edge Network.

      code language-kotlin
      Identity.updateIdentities(identityMap)
      
  2. Passa a Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > visualizzazioni > LoginSheet.kt nel navigatore di Android Studio e trova il codice da eseguire quando selezioni il pulsante Login. Aggiungi il seguente codice:

    code language-kotlin
    // Update identities
    MobileSDK.shared.updateIdentities(
       MobileSDK.shared.currentEmailId.value,
       MobileSDK.shared.currentCRMId.value
    )
    
NOTE
È possibile inviare più identità in una singola chiamata updateIdentities. Puoi anche modificare le identità inviate in precedenza.

Rimuovere un’identità

È possibile utilizzare l'API Identity.removeIdentity per rimuovere l'identità dalla mappa delle identità lato client archiviata. L’estensione Identity non invia più l’identificatore ad Edge Network. L’utilizzo di questa API non rimuove l’identificatore dal grafico delle identità lato server. Per ulteriori informazioni sui grafici delle identità, vedere Visualizza grafici delle identità.

iOS
  1. Passa a Luma > Luma > Utils > MobileSDK nel navigatore progetti Xcode e aggiungi il seguente codice alla funzione 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. Passa a Luma > Luma > Views > General > LoginSheet nel Navigator dei progetti Xcode e trova il codice da eseguire quando selezioni il pulsante Logout. Aggiungi il seguente codice:

    code language-swift
    // Remove identities
    MobileSDK.shared.removeIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
Android
  1. Passa a Android ChevronDown > app > kotlin+java > com.adobe.luma.tutorial.android > models > MobileSDK nel navigatore di Android Studio e aggiungi il seguente codice alla funzione 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.Passa a app > kotlin+java > com.adobe.luma.tutorial.android > visualizzazioni > FoglioAccesso.kt nel navigatore di Android Studio e trova il codice da eseguire quando selezioni il pulsante Disconnetti. Aggiungi il seguente codice:

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

Convalidare con Assurance

  1. Consulta la sezione istruzioni di installazione per collegare il simulatore o il dispositivo ad Assurance.

  2. Nell’app Luma

    1. Seleziona la scheda Home e sposta l'icona Assurance a sinistra.
    2. Seleziona l'icona Utente in alto a destra.
iOS
{width="300"}
Android
{width="300"}

Nella schermata Identità:

  1. Specifica un indirizzo e-mail e un ID del sistema di gestione delle relazioni con i clienti, oppure
  2. Seleziona A | (iOS) o Genera e-mail casuale (Android) per generare in modo casuale E-mail e ID CRM.
  3. Seleziona Accesso.
iOS
{width="300"}
Android
{width="300"}

Torna a Assurance:

  1. Controlla l'interfaccia Web di Assurance per l'evento Edge Identity Update Identities dal fornitore com.adobe.griffon.mobile.

  2. Selezionare l'evento e rivedere i dati nell'oggetto ACPExtensionEventData. Dovresti visualizzare le identità aggiornate.

    convalida aggiornamento identità {modal="regular"}

Convalida con grafico delle identità

Dopo aver completato i passaggi della lezione Experience Platform, puoi confermare l'acquisizione delle identità nel visualizzatore del grafo delle identità di Experience Platform:

  1. Seleziona Identità nell'interfaccia utente di Data Collection.

  2. Seleziona Grafico identità dalla barra superiore.

  3. Immetti Luma CRM ID come Spazio dei nomi identità e l'ID del sistema di gestione delle relazioni con i clienti (ad esempio 24e620e255734d8489820e74f357b5c8) come Valore identità.

  4. Sono elencate le identità.

    convalida grafo identità {modal="regular"}

INFO
L’app non contiene codice per reimpostare l’ECID. Puoi reimpostare l’ECID (e creare effettivamente un nuovo profilo con un nuovo ECID) solo tramite una disinstallazione e una reinstallazione dell’applicazione. Per implementare il ripristino degli identificatori, vedere le chiamate API Identity.resetIdentities e MobileCore.resetIdentities. Tieni presente che quando utilizzi un identificatore di notifica push (vedi Invio di notifiche push), tale identificatore diventa un altro identificatore di profilo "permanente" sul dispositivo.
SUCCESS
Ora hai configurato l’app per aggiornare le identità in Edge Network e (se configurata) in Adobe Experience Platform.
Grazie per aver dedicato tempo all'apprendimento di Adobe Experience Platform Mobile SDK. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo post di discussione della community Experience League

Successivo: Raccolta dati profilo

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