DocumentazioneExperience PlatformTutorial sull’app mobile

Raccogliere dati di identità

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

Creato per:

  • Principiante
  • Intermedio
  • Sviluppatore

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

Il servizio Adobe Experience Platform Identity consente di ottenere una visione migliore dei clienti e dei loro comportamenti collegando le identità tra dispositivi e sistemi, consentendo di offrire 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, l’SDK di Mobile genera un’identità univoca nel proprio spazio dei nomi, denominata ID Experience Cloud (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 quando imposta lo stato di privacy globale dell’SDK di Mobile in modo che la rinuncia venga negata. 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à

Aggiorna identità

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

  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 all'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)
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 all’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à.

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

  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)

Convalidare con Assurance

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

  2. Nell’app Luma

    1. Selezionare la scheda Home e spostare l'icona Assurance a sinistra.

    2. Seleziona la Icona {width="15"} in alto a destra.

      {width="300"}

    3. Specifica un indirizzo e-mail e un ID del sistema di gestione delle relazioni con i clienti, oppure

    4. Seleziona {width="15"} per generare in modo casuale E-mail e ID CRM.

    5. Seleziona Accesso.

      {width="300"}

  3. Cerca nell'interfaccia Web Assurance l'evento Identità aggiornamento identità di Edge dal fornitore com.adobe.griffon.mobile.

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

Convalida con grafico delle identità

Dopo aver completato i passaggi della lezione di Experience Platform, puoi confermare l'acquisizione delle identità nel visualizzatore del grafico delle identità di 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à

INFO
L’app non contiene codice per reimpostare l’ECID, il che significa che 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, tuttavia, 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à nell’Edge Network e (se configurata) con Adobe Experience Platform.
Grazie per aver dedicato il tuo tempo all’apprendimento dell’SDK di Adobe Experience Platform Mobile. Se hai domande, vuoi condividere commenti generali o suggerimenti su contenuti futuri, condividili in questo Experience League post di discussione della community

Successivo: Raccolta dati profilo

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