Guia de implementação para Identity Graph Linking Rules
Leia este documento para obter um guia passo a passo que você pode seguir ao implementar seus dados com o Adobe Experience Platform Identity Service.
Estrutura passo a passo:
- Pré-requisitos completos para a implementação
- Criar os namespaces de identidade necessários
- Use a ferramenta de simulação de gráficos para se familiarizar com o Algoritmo de otimização de identidade
- Use a interface das configurações de identidade para designar seus namespaces exclusivos e configurar classificações de prioridade para seus namespaces
- Criar um esquema do Experience Data Model (XDM)
- Criar um conjunto de dados
- Assimilar seus dados na Experience Platform
Pré-requisitos para implementação prerequisites-for-implementation
Esta seção descreve as etapas de pré-requisito que devem ser concluídas antes de implementar o Identity Graph Linking Rules para seus dados.
Namespace exclusivo
Requisito de namespace para uma única pessoa single-person-namespace-requirement
Você deve garantir que o namespace exclusivo com a maior prioridade esteja sempre presente em todos os perfis conhecidos. Isso permite que o Serviço de identidade detecte o identificador de pessoa apropriado em um determinado gráfico.
Sem um namespace exclusivo para representar seus identificadores de pessoa, você pode acabar com um gráfico que se vincula a identificadores de pessoa diferentes para a mesma ECID. Neste exemplo, B2BCRM e B2CCRM estão vinculados à mesma ECID ao mesmo tempo. Este gráfico sugere que Tom, usando sua conta de login B2C, compartilhou um dispositivo com Summer, usando sua conta de login B2B. No entanto, o sistema reconhecerá que este é um perfil (colapso de gráfico).
Dado um namespace exclusivo (neste caso, uma CRMID em vez de dois namespaces diferentes), o Serviço de identidade pode discernir o identificador de pessoa que foi associado pela última vez à ECID. Neste exemplo, como existe uma CRMID exclusiva, o Serviço de identidade pode reconhecer um cenário de "dispositivo compartilhado", em que duas entidades estão compartilhando o mesmo dispositivo.
Configuração de prioridade de namespace
Se você estiver usando o conector de origem do Adobe Analytics para assimilar dados, deverá dar às ECIDs uma prioridade mais alta do que a Adobe Analytics ID (AAID), pois o Serviço de Identidade bloqueia a AAID. Ao priorizar a ECID, você pode instruir o Perfil do cliente em tempo real para armazenar eventos não autenticados na ECID em vez da AAID.
Eventos de experiência XDM xdm-experience-events
Durante o processo de pré-implementação, certifique-se de que os eventos autenticados que seu sistema enviará para a Experience Platform sempre contenham um único identificador de pessoa, como um CRMID.
- (Recomendado) Eventos autenticados com um identificador de pessoa exclusivo.
- (Não recomendado) Eventos autenticados com dois identificadores de pessoa exclusivos. Se você tiver mais de um identificador de pessoa exclusivo, poderá encontrar um colapso de gráfico indesejado.
- (Não recomendado) Eventos autenticados sem identificadores de pessoa exclusivos. Se você não tiver identificadores de pessoa exclusivos, os eventos não autenticados e autenticados serão armazenados na ECID.
code language-json |
---|
|
Se o sistema enviar dois identificadores de pessoa, a implementação pode falhar o requisito de namespace de pessoa única. Por exemplo, se o identityMap na implementação do SDK da Web contiver um CRMID, uma customerID e um namespace ECID, não há garantia de que cada evento conterá CRMID e customerID.
Você deve não enviar uma carga como a seguir:
code language-json |
---|
|
No entanto, é importante observar que, embora seja possível enviar dois identificadores de pessoa, não há garantia de que um colapso de gráfico indesejado será evitado devido a erros de implementação ou dados. Considere o seguinte cenário:
timestamp1
= João faz logon -> capturas do sistemaCRMID: John, ECID: 111
. No entanto,customerID: John
não está presente nesta carga do evento.timestamp2
= Jane faz logon -> capturas de sistemacustomerID: Jane, ECID: 111
. No entanto,CRMID: Jane
não está presente nesta carga do evento.
Portanto, é prática recomendada enviar apenas um identificador de pessoa com seus eventos autenticados.
Na simulação do gráfico, essa assimilação pode ser semelhante a:
Neste exemplo, você pode supor que o evento a seguir foi enviado para o Experience Platform enquanto John (o usuário final) estava navegando em seu site enquanto estava autenticado. No entanto, apesar de estar autenticado, o Experience Platform não consegue identificar John devido à falta de identificadores de pessoas no evento. Portanto, esse evento é interpretado como um usuário anônimo que navega no site Adobe Business, em vez de reconhecê-lo como uma atividade online associada especificamente a John.
code language-json |
---|
|
Definir permissões set-permissions
A primeira etapa do processo de implementação do Serviço de identidade é garantir que sua conta da Experience Platform seja adicionada a uma função que seja provisionada com as permissões necessárias. O administrador pode configurar permissões para sua conta navegando até a interface de permissões no Adobe Experience Cloud. A partir daí, sua conta deve ser adicionada a uma função com as seguintes permissões:
- Exibir Configurações de Identidade: aplique esta permissão para poder exibir namespaces exclusivos e a prioridade de namespace na página de procura de namespace de identidade.
- Editar configurações de identidade: aplique esta permissão para poder editar e salvar suas configurações de identidade.
Para obter mais informações sobre permissões, leia o guia de permissões.
Criar namespaces de identidade namespace
Se os dados exigirem, primeiro crie os namespaces apropriados para sua organização. Para obter etapas sobre como criar um namespace personalizado, leia o manual sobre criação de um namespace personalizado na interface.
Usar ferramenta de simulação de gráfico graph-simulation
Em seguida, navegue até a ferramenta de simulação de gráficos, no espaço de trabalho da interface do usuário do Serviço de Identidade. Você pode usar a ferramenta de simulação de gráficos para simular gráficos de identidade, criados com uma variedade de diferentes configurações de namespace único e prioridade de namespace.
Ao criar diferentes configurações, você pode usar a ferramenta de simulação de gráficos para conhecer e entender melhor como o Algoritmo de otimização de identidade e determinadas configurações podem afetar o comportamento do gráfico.
Definir configurações de identidade identity-settings
Assim que tiver uma ideia melhor de como deseja que o gráfico se comporte, navegue até a interface de configurações de identidade no espaço de trabalho da interface do usuário do Serviço de Identidade. Para acessar a interface de configurações de identidade, selecione Identidades na navegação à esquerda e selecione Configurações.
Use a interface de configurações de identidade para designar seus namespaces exclusivos e configurar seus namespaces por ordem de prioridade.
Para obter mais informações, leia o guia da interface do usuário de configurações de identidade.
Criar um esquema do XDM schema
Com os namespaces exclusivos e as prioridades de namespace estabelecidas, agora é possível prosseguir para a configuração necessária para assimilar seus dados. Primeiro, você deve criar um esquema XDM. Dependendo dos seus dados, talvez seja necessário criar um esquema para o Perfil individual XDM e o ExperienceEvent XDM.
Para assimilar dados no Perfil do cliente em tempo real, você deve garantir que seu esquema contenha pelo menos um campo que tenha sido designado como a identidade principal. Ao configurar uma identidade principal, é possível ativar um determinado esquema para assimilação de perfil.
Para obter instruções sobre como criar um esquema, leia o manual sobre criação de um esquema XDM na interface.
Criar um conjunto de dados dataset
Em seguida, crie um conjunto de dados para fornecer uma estrutura para os dados que você vai assimilar. Um conjunto de dados é uma construção de armazenamento e gerenciamento para uma coleção de dados, normalmente uma tabela, que contém um esquema (colunas) e campos (linhas). Os conjuntos de dados funcionam em conjunto com esquemas e, para assimilar dados no Perfil do cliente em tempo real, seu conjunto de dados deve estar habilitado para assimilação de perfil. Para que seu conjunto de dados seja ativado para o Perfil, ele deve fazer referência a um esquema que esteja ativado para assimilação de Perfil.
Para obter instruções sobre como criar um conjunto de dados, leia o guia da interface do conjunto de dados.
Assimilar seus dados ingest
Nesse ponto, você deve ter o seguinte:
- As permissões necessárias para acessar os recursos do Serviço de identidade.
- Namespaces para seus dados.
- Namespaces exclusivos designados e prioridades configuradas para seus namespaces.
- Pelo menos um esquema XDM. (Dependendo dos seus dados e do caso de uso específico, talvez seja necessário criar esquemas de evento de perfil e de experiência.)
- Um conjunto de dados baseado no seu esquema.
Depois de ter todos os itens listados acima, você pode começar a assimilar seus dados na Experience Platform. Você pode realizar a assimilação de dados de várias maneiras diferentes. Você pode usar os seguintes serviços para trazer seus dados para a Experience Platform:
Para qualquer comentário, use a opção comentários sobre o Beta no espaço de trabalho da interface do usuário do Serviço de Identidade.
Validar seus gráficos validate
Use o painel de identidade para obter insights sobre o estado dos gráficos de identidade, como a contagem geral de identidades e as tendências de contagem de gráficos, a contagem de identidades por namespace e a contagem de gráficos por tamanho do gráfico. Você também pode usar o painel de identidade para exibir tendências em gráficos com duas ou mais identidades, organizadas por namespace.
Selecione as reticências (...
) e selecione Exibir mais para obter mais informações e validar se não há gráficos recolhidos.
Use a janela exibida para exibir informações sobre os gráficos recolhidos. Neste exemplo, email e telefone são marcados como namespace exclusivo, portanto, não há gráficos recolhidos na sandbox.
Apêndice appendix
Leia esta seção para obter informações adicionais que você pode consultar ao implementar suas configurações de identidade e namespaces exclusivos.
Perdendo o cenário de ID de logon dangling-loginid-scenario
O gráfico a seguir simula um cenário de ID de logon "pendente". Neste exemplo, duas IDs de logon diferentes são vinculadas à mesma ECID. No entanto, {loginID: ID_C}
não está vinculado ao CRMID. Portanto, não há como o Serviço de identidade detectar que essas duas IDs de logon representam duas entidades diferentes.
Neste exemplo, {loginID: ID_C}
é deixado pendente e desvinculado a um CRMID. Assim, a entidade de pessoa à qual essa ID de logon deve ser associada é deixada ambígua.
Neste exemplo, {loginID: ID_C}
está vinculado a {CRMID: Tom}
. Portanto, o sistema pode discernir que essa ID de logon está associada ao Tom.
Neste exemplo, {loginID: ID_C}
está vinculado a {CRMID: Summer}
. Portanto, o sistema pode discernir que essa ID de logon está associada a outra entidade de pessoa, neste caso, o Verão.
Este exemplo também mostra que Tom e Summer são entidades de pessoas diferentes que estão compartilhando um dispositivo, representado por {ECID: 111}
.
Próximas etapas
Para obter mais informações sobre Identity Graph Linking Rules, leia a seguinte documentação: