DocumentaçãoExperience PlatformTutorial sobre Aplicativos para dispositivos móveis

Coletar dados de identidade

Last update: Thu Jul 18 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined
  • undefined
  • undefined

Saiba como coletar dados de identidade em um aplicativo móvel.

O Serviço de identidade da Adobe Experience Platform ajuda você a obter uma melhor visualização dos clientes e de seus comportamentos, unindo identidades em dispositivos e sistemas, permitindo que você forneça experiências digitais pessoais e de impacto em tempo real. Campos de identidade e namespaces são a cola que une diferentes fontes de dados para criar o perfil do cliente em tempo real de 360 graus.

Saiba mais sobre a Extensão da identidade e o serviço de identidade na documentação.

Pré-requisitos

  • O aplicativo com SDKs instalados e configurados foi criado e executado com sucesso.

Objetivos de aprendizagem

Nesta lição, você vai:

  • Configurar um namespace de identidade personalizado.
  • Atualizar identidades.
  • Valide o gráfico de identidade.
  • Obtenha a ECID e outras identidades.

Configurar um namespace de identidade personalizado

Os namespaces de identidade são componentes do Serviço de Identidade que servem como indicadores do contexto ao qual uma identidade está relacionada. Por exemplo, eles distinguem um valor de name@email.com como um endereço de email ou 443522 como uma ID de CRM numérica.

NOTE
O SDK móvel gera uma identidade exclusiva em seu próprio namespace, chamada de ID de Experience Cloud (ECID) quando o aplicativo é instalado. Essa ECID é armazenada na memória persistente no dispositivo móvel e é enviada com cada ocorrência. A ECID é removida quando o usuário desinstala o aplicativo ou quando o usuário define o status de privacidade global do SDK móvel como recusa. No aplicativo Luma de amostra, você deve remover e reinstalar o aplicativo para criar um novo perfil com sua própria ECID exclusiva.

Para criar um novo namespace de identidade:

  1. Na interface da Coleção de dados, selecione Identidades na navegação do painel esquerdo.

  2. Selecione Criar namespace de identidade.

  3. Forneça um Nome de exibição de Luma CRM ID e um Símbolo de identidade valor de lumaCRMId.

  4. Selecione ID entre dispositivos.

  5. Selecione Criar.

    criar namespace de identidade

Atualizar identidades

Você deseja atualizar a identidade padrão (email) e a identidade personalizada (ID do CRM da Luma) quando o usuário fizer logon no aplicativo.

  1. Navegue até Luma > Luma > Utils > MobileSDK no navegador do Projeto Xcode e localize a implementação da função func updateIdentities(emailAddress: String, crmId: String). Adicione o código a seguir à função.

    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)

    Este código:

    1. Cria um objeto IdentityMap vazio.

      code language-swift 
      let identityMap: IdentityMap = IdentityMap()

    2. Configura objetos IdentityItem para email e ID do CRM.

      code language-swift 
      let emailIdentity = IdentityItem(id: emailAddress, authenticatedState: AuthenticatedState.authenticated)
let crmIdentity = IdentityItem(id: crmId, authenticatedState: AuthenticatedState.authenticated)

    3. Adiciona estes objetos IdentityItem ao objeto IdentityMap.

      code language-swift 
      identityMap.add(item:emailIdentity, withNamespace: "Email")
identityMap.add(item: crmIdentity, withNamespace: "lumaCRMId")

    4. Envia o objeto IdentityItem como parte da chamada de API Identity.updateIdentities para o Edge Network.

      code language-swift 
      Identity.updateIdentities(with: identityMap)

  2. Navegue até Luma > Luma > Views > General > LoginSheet no navegador do Projeto Xcode e localize o código a ser executado ao selecionar o botão Logon. Adicione o seguinte código:

    code language-swift 
    // Update identities
MobileSDK.shared.updateIdentities(emailAddress: currentEmailId, crmId: currentCRMId)
NOTE
Você pode enviar várias identidades em uma única chamada updateIdentities. Você também pode modificar identidades enviadas anteriormente.

Remover uma identidade

Você pode usar a API Identity.removeIdentity para remover a identidade do mapa de identidade armazenado do lado do cliente. A extensão Identity interrompe o envio do identificador para o Edge Network. O uso dessa API não remove o identificador do gráfico de identidade do lado do servidor. Consulte Exibir gráficos de identidade para obter mais informações sobre gráficos de identidade.

  1. Navegue até Luma > Luma > Utils > MobileSDK no navegador do Projeto Xcode e adicione o seguinte código à função 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. Navegue até Luma > Luma > Views > General > LoginSheet no navegador do Projeto Xcode e localize o código a ser executado ao selecionar o botão Logout. Adicione o seguinte código:

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

Validar com garantia

  1. Revise a seção instruções de configuração para conectar seu simulador ou dispositivo ao Assurance.

  2. No aplicativo Luma

    1. Selecione a guia Início e mova o ícone Garantia para a esquerda.

    2. Selecione o Ícone {width="15"} na parte superior direita.

      {width="300"}

    3. Forneça um endereço de email e uma ID de CRM ou

    4. Selecionar {width="15"} para gerar aleatoriamente um Email e uma ID do CRM.

    5. Selecione Logon.

      {width="300"}

  3. Procure na interface da Web do Assurance o evento Identidades de Atualização de Identidade da Edge do fornecedor com.adobe.griffon.mobile.

  4. Selecione o evento e examine os dados no objeto ACPExtensionEventData. Você deve ver as identidades atualizadas.
    validar atualização de identidades

Validar com gráfico de identidade

Depois de concluir as etapas na lição de Experience Platform, você poderá confirmar a captura de identidade no visualizador de gráficos de identidade de Plataformas:

  1. Selecione Identidades na interface da Coleção de Dados.

  2. Selecione Gráfico de identidade na barra superior.

  3. Insira Luma CRM ID como o Namespace de identidade e sua ID do CRM (por exemplo 24e620e255734d8489820e74f357b5c8) como o Valor de identidade.

  4. Você vê as Identidades listadas.

    validar gráfico de identidade

INFO
Não há código no aplicativo para redefinir a ECID, o que significa que você só pode redefinir a ECID (e efetivamente criar um novo perfil com uma nova ECID) por meio de uma desinstalação e uma reinstalação do aplicativo. Para implementar a redefinição de identificadores, consulte as chamadas de API Identity.resetIdentities e MobileCore.resetIdentities. Entretanto, ao usar um identificador de notificação por push (consulte Envio de notificações por push), esse identificador se tornará outro identificador de perfil "fixo" no dispositivo.
SUCCESS
Agora você configurou o aplicativo para atualizar identidades no Edge Network e (quando configurado) com o Adobe Experience Platform.
Obrigado por investir seu tempo aprendendo sobre o Adobe Experience Platform Mobile SDK. Se você tiver dúvidas, quiser compartilhar comentários gerais ou tiver sugestões sobre conteúdo futuro, compartilhe-os nesta postagem de Discussão da Comunidade Experience League

Próximo: Coletar dados de perfil

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