Raccogliere dati di identità

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 su Estensione identità e servizio identità nella documentazione di.

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 Servizio identità 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 barra di navigazione a sinistra.

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

  3. Fornisci un Nome visualizzato di Luma CRM ID e un Simbolo di identità valore di lumaCRMId.

  4. Seleziona ID multi-dispositivo.

  5. Seleziona Crea.

    crea spazio dei nomi delle identità

Aggiorna identità

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

  1. Accedi a Luma > Luma > Utils > MobileSDK nel Navigatore progetti Xcode e trovare il func updateIdentities(emailAddress: String, crmId: String) implementazione di funzioni. 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 elemento vuoto IdentityMap oggetto.

      code language-swift
      let identityMap: IdentityMap = IdentityMap()
      
    2. Configura IdentityItem oggetti per e-mail e ID CRM.

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

      code language-swift
      identityMap.add(item:emailIdentity, withNamespace: "Email")
      identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")
      
    4. Invia il IdentityItem oggetto come parte del Identity.updateIdentities Chiamata API alla rete Edge.

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

    code language-swift
    // Update identities
    MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
    
NOTE
Puoi inviare più identità in un singolo updateIdentities chiamare. Puoi anche modificare le identità inviate in precedenza.

Rimuovere un’identità

È possibile utilizzare Identity.removeIdentity API per rimuovere l'identità dalla mappa di identità lato client memorizzata. L’estensione Identity interrompe l’invio dell’identificatore alla rete Edge. L’utilizzo di questa API non rimuove l’identificatore dal grafico delle identità lato server. Consulta Visualizzare i grafici delle identità per ulteriori informazioni sui grafici delle identità.

  1. Accedi a Luma > Luma > Utils > MobileSDK nel Navigator del progetto Xcode e aggiungi il seguente codice al func removeIdentities(emailAddress: String, crmId: String) funzione:

    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. Accedi a Luma > Luma > Views > General > FoglioAccesso nel Navigatore progetti Xcode e trova il codice da eseguire quando selezioni il Disconnetti pulsante. Aggiungi il seguente codice:

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

Convalida con garanzia

  1. Rivedi istruzioni di configurazione per collegare il simulatore o il dispositivo ad Assurance.

  2. Nell’app Luma

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

    2. Seleziona la+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+in alto a destra.

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

    4. Seleziona+-------------+ | img-md | +=============+ | w-15 | +-------------+ | | +-------------+per generare in modo casuale un E-mail e ID CRM.

    5. Seleziona Login.

      img-md
      w-300
  3. Cerca nell’interfaccia web Assurance per Identità aggiornamento identità Edge evento da com.adobe.griffon.mobile fornitore.

  4. Seleziona l’evento e rivedi i dati in ACPExtensionEventData oggetto. Dovresti visualizzare le identità aggiornate.
    convalida aggiornamento identità

Convalida con grafico delle identità

Una volta completati i passaggi in 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 delle identità dalla barra superiore.

  3. Invio Luma CRM ID come Spazio dei nomi dell’identità e il tuo ID CRM (ad esempio 24e620e255734d8489820e74f357b5c8) come Valore identità.

  4. Vedete la Identità in elenco.

    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, vedi la sezione Identity.resetIdentities e MobileCore.resetIdentities Chiamate API. Tuttavia, quando utilizzi un identificatore di notifica push, tieni presente quanto segue (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 il tuo tempo all’apprendimento dell’SDK di Adobe Experience Platform Mobile. Se hai domande, vuoi condividere feedback generali o suggerimenti su contenuti futuri, condividili su questo Experience League post di discussione community

Successivo: Raccogliere dati profilo

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