Guia de solução de problemas para regras de vinculação de gráficos de identidade

À medida que você testa e valida regras de vinculação de gráficos de identidade, pode ter alguns problemas relacionados à assimilação de dados e ao comportamento do gráfico. Leia este documento para saber como solucionar alguns problemas comuns que você pode encontrar ao trabalhar com regras de vinculação de gráficos de identidade.

Visão geral do fluxo de assimilação de dados data-ingestion-flow-overview

O diagrama a seguir é uma representação simplificada de como os dados fluem para o Adobe Experience Platform e os aplicativos. Use este diagrama como referência para ajudá-lo a entender melhor o conteúdo desta página.

É importante observar os seguintes fatores:

Problemas de assimilação de dados data-ingestion-issues

Minhas identidades não estão sendo assimiladas no Serviço de identidade my-identities-are-not-getting-ingested-into-identity-service

Há várias razões pelas quais isso pode acontecer, incluindo, mas não limitado ao seguinte:

No contexto das regras de vinculação de gráficos de identidade, um registro pode ser rejeitado do Serviço de identidade porque o evento de entrada tem duas ou mais identidades com o mesmo namespace exclusivo, mas com valor de identidade diferente. Esse cenário geralmente ocorre devido a erros de implementação.

Considere o seguinte evento com duas suposições:

O evento a seguir retornará uma mensagem de erro indicando que a assimilação falhou.

{
  "_id": "random_string",
  "eventType": "web browsing event",
  "identityMap": {
    "ECID": [
      {
        "id": "11111111111111111111111111111111111111",
        "primary": false
      }
    ],
    "CRMID": [
      {
        "id": "Alice",
        "primary": true
      }
    ]
  },
  "CRMID": "Bob",
  "timestamp": "2024-08-17T15:22:51+00:00",
  "web": {
    "webPageDetails": {
      "URL": "https://www.adobe.com/acrobat.html",
      "name": "Adobe Acrobat"
    }
  }
}

Etapas de solução de problemas

Para resolver esse erro, primeiro você deve coletar as seguintes informações:

Em seguida, use o Serviço de consulta do Adobe Experience Platform e execute a seguinte consulta:

  SELECT key, col.id as identityValue, timestamp, _id, identityMap, *
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id = 'identity_value'

Após executar a consulta, localize o registro de evento que você esperava gerar um gráfico e, em seguida, valide se os valores de identidade são diferentes na mesma linha. Veja a imagem a seguir para ver um exemplo:

ExperienceEvents pós-autenticação estão sendo atribuídos ao perfil autenticado incorreto

A prioridade de namespace desempenha um papel importante em como os fragmentos de evento determinam a identidade principal.

Para que eventos de usuário autenticados sejam vinculados ao namespace de pessoa, todos os eventos autenticados devem conter o namespace de pessoa (CRMID). Isso significa que mesmo depois que um usuário fizer logon, o namespace da pessoa ainda deverá estar presente em cada evento autenticado.

Você pode continuar a ver o sinalizador primary=true 'eventos' ao pesquisar um perfil no visualizador de perfil. No entanto, isso é ignorado e não será usado pelo Perfil.

As AAIDs são bloqueadas por padrão. Portanto, se você estiver usando o conector de origem do Adobe Analytics, certifique-se de que a ECID tenha uma prioridade maior do que a ECID, para que os eventos não autenticados tenham uma identidade principal de ECID.

Etapas de solução de problemas

Meus fragmentos de evento de experiência não estão sendo assimilados no Perfil my-experience-event-fragments-are-not-getting-ingested-into-profile

Há vários motivos que contribuem para que os fragmentos de evento de experiência não sejam assimilados no Perfil, incluindo, mas não limitados a:

No contexto da prioridade de namespace, o Perfil rejeitará:

Etapas de solução de problemas

Se os dados forem enviados ao data lake, mas não ao Perfil, e você acreditar que isso se deve ao envio de duas ou mais identidades com a maior prioridade de namespace em um único evento, poderá executar a seguinte consulta para validar se há dois valores de identidade diferentes enviados para o mesmo namespace:

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE col.id != _testimsorg.identification.core.email and key = 'Email'

Você também pode executar a seguinte consulta para verificar se a assimilação no perfil não está acontecendo porque o namespace mais alto tem uma cadeia de caracteres vazia:

  SELECT identityMap, key, col.id as identityValue, _testimsorg.identification.core.email, _id, timestamp
  FROM (SELECT key, explode(value), *
  FROM (SELECT explode(identityMap), *
  FROM dataset_name)) WHERE (col.id = '' or _testimsorg.identification.core.email = '') and key = 'Email'

Essas duas consultas presumem que:

Problemas relacionados ao comportamento do gráfico graph-behavior-related-issues

Esta seção descreve problemas comuns que podem ser encontrados em relação ao comportamento do gráfico de identidade.

ExperienceEvents não autenticados estão sendo anexados ao perfil autenticado incorreto

O algoritmo de otimização de identidade respeitará os links estabelecidos mais recentemente e removerá os links mais antigos. Portanto, é possível que, uma vez habilitado esse recurso, as ECIDs possam ser reatribuídas (vinculadas novamente) de uma pessoa a outra. Para entender o histórico de como uma identidade é vinculada ao longo do tempo, siga as etapas abaixo:

Etapas de solução de problemas

Primeiro, você deve coletar as seguintes informações:

Os símbolos de identidade (namespaceCode) fazem distinção entre maiúsculas e minúsculas. Para recuperar todos os símbolos de identidade de um determinado conjunto de dados no identityMap, execute a seguinte consulta:

SELECT distinct explode(*)FROM (SELECT map_keys(identityMap) FROM dataset_name)

Se você não souber o valor de identidade do identificador de cookie e quiser procurar por uma ID de cookie que teria sido vinculada a vários identificadores de pessoa, será necessário executar a seguinte consulta. Essa consulta considera a ECID como o namespace do cookie e a CRMID como o namespace da pessoa.

  SELECT identityMap['ECID'][0]['id'], count(distinct identityMap['CRMID'][0]['id']) as crmidCount FROM dataset_name GROUP BY identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

  SELECT identityMap['ECID'][0]['id'], count(distinct personID) as crmidCount FROM dataset_name group by identityMap['ECID'][0]['id'] ORDER BY crmidCount desc

Agora que você identificou os valores de cookie vinculados a várias IDs de pessoa, pegue um dos resultados e use-o na seguinte consulta para obter uma exibição cronológica de quando esse valor de cookie foi vinculado a um identificador de pessoa diferente:

  SELECT identityMap['CRMID'][0]['id'] as personEntity, *
  FROM dataset_name
  WHERE identitymap['ECID'][0].id ='identity_value'
  ORDER BY timestamp desc

SELECT _experience.analytics.customDimensions.eVars.eVar10 as personEntity, *
FROM dataset_name
WHERE identitymap['ECID'][0].id ='identity_value'
ORDER BY timestamp desc

O algoritmo de otimização de identidade não está "funcionando" como esperado

Etapas de solução de problemas

Consulte a documentação sobre o algoritmo de otimização de identidade, bem como os tipos de estruturas de gráfico com suporte.

Você também pode usar a ferramenta de simulação de gráficos na interface para simular eventos e definir suas próprias configurações de prioridade de namespace e namespace exclusivas. Isso pode ajudar a fornecer uma compreensão da linha de base de como o algoritmo de otimização de identidade deve se comportar.

Se os resultados da simulação corresponderem às expectativas de comportamento do gráfico, você poderá verificar se as configurações de identidade correspondem às configurações definidas na simulação.

Ainda vejo gráficos recolhidos em minha sandbox, mesmo após definir as configurações de identidade

Os gráficos de identidade seguirão seu namespace exclusivo e sua prioridade de namespace configurados após salvar as configurações. Quaisquer gráficos "recolhidos" existentes antes de salvar suas novas configurações não serão afetados, até que novos dados sejam assimilados de modo que o gráfico recolhido seja atualizado. A identidade principal dos fragmentos de evento no Perfil de cliente em tempo real não será atualizada mesmo após as alterações de prioridade do namespace.

Etapas de solução de problemas

Você pode usar o visualizador de gráficos de identidade para verificar se o gráfico foi assimilado antes ou depois das configurações. Examine o carimbo de data/hora atualizado pela última vez em Propriedades do link para ver quando o Serviço de Identidade assimilou o gráfico. Se o carimbo de data e hora for anterior à configuração, isso sugere que o gráfico "recolhido" foi criado antes da ativação do recurso.

Quero saber quantos gráficos "recolhidos" existem em minha sandbox

Use o painel de identidade para obter insights sobre o estado do gráfico de identidade, como a contagem de identidades e gráficos. Consulte a métrica "Contagem de gráficos com vários namespaces" para obter uma contagem de gráficos que foram recolhidos, ou seja, gráficos que contêm duas ou mais identidades com o mesmo namespace. Supondo que a sandbox não tenha dados e você tenha configurado um namespace (por exemplo, CRMID) para ser exclusivo, a expectativa é que haja zero gráficos que tenham dois ou mais CRMIDs. No exemplo abaixo, há dois gráficos que contêm dois ou mais endereços de email.

Você pode encontrar um detalhamento detalhado no conjunto de dados de exportação de instantâneo de perfil no data lake executando a consulta abaixo:

  SELECT key, identityCountInGraph, count(identityCountInGraph) as graphCount
  FROM (SELECT key, cardinality(value) as identityCountInGraph
  FROM (SELECT explode(identityMap)
  FROM dataset_name
  WHERE cardinality(identityMap) > 1)) /* by definition, graphs have 2 or more identities */
  WHERE key not in ('ecid', 'aaid', 'idfa', 'gaid') /* filter out common device/cookie namespaces */
  GROUP BY 1, 2
  ORDER BY 1, 2 asc

Você pode usar a seguinte consulta no conjunto de dados de exportação de instantâneo de perfil para obter identidades de amostra de gráficos "recolhidos".

  SELECT identityMap
  FROM dataset_name
  WHERE cardinality(identityMap['CRMID'])>1 /* any graphs with 2+ CRMID. Change CRMID namespace if needed */

Perguntas frequentes faq

Esta seção descreve uma lista de respostas às perguntas frequentes sobre as regras de vinculação do gráfico de identidade.

Algoritmo de otimização de identidade identity-optimization-algorithm

Leia esta seção para obter respostas a perguntas frequentes sobre o algoritmo de otimização de identidade.

Tenho uma CRMID para cada uma das minhas unidades de negócios (CRMID B2C, CRMID B2B), mas não tenho um namespace exclusivo em todos os meus perfis. O que acontecerá se eu marcar a CRMID B2C e a CRMID B2B como exclusivas e ativar minhas configurações de identidade?

Este cenário não é compatível. Portanto, você pode ver gráficos recolhidos nos casos em que um usuário usa sua CRMID B2C para fazer logon e outro usuário usa sua CRMID B2B para fazer logon. Para obter mais informações, leia a seção sobre requisito de namespace para uma única pessoa na página de implementação.

O algoritmo de otimização de identidade "corrige" os gráficos recolhidos existentes?

Os gráficos recolhidos existentes serão afetados ("fixos") pelo algoritmo de gráfico somente se esses gráficos forem atualizados depois que você salvar as novas configurações.

Se duas pessoas entrarem e saírem usando o mesmo dispositivo, o que acontece com os eventos? Todos os eventos serão transferidos para o último usuário autenticado?

Para obter mais informações, leia o manual sobre como determinar a identidade principal para eventos de experiência.

Como as jornadas no Adobe Journey Optimizer serão afetadas quando a ECID for transferida de uma pessoa para outra?

A CRMID do último usuário autenticado será vinculada à ECID (dispositivo compartilhado). As ECIDs podem ser reatribuídas de uma pessoa para outra com base no comportamento do usuário. O impacto dependerá de como a jornada será construída, portanto, é importante que os clientes testem a jornada em um ambiente de sandbox de desenvolvimento para validar o comportamento.

Os principais pontos a serem destacados são os seguintes:

Prioridade do namespace

Leia esta seção para obter respostas a perguntas frequentes sobre prioridade de namespace.

Ativei minhas configurações de identidade. O que acontece com minhas configurações se eu quiser adicionar um namespace personalizado depois que as configurações forem ativadas?

Há dois "buckets" de namespaces: namespaces de pessoa e namespaces de dispositivo/cookie. O namespace personalizado recém-criado terá a prioridade mais baixa em cada "bucket" para que esse novo namespace personalizado não afete a assimilação de dados existente.

Se o Perfil do cliente em tempo real não estiver mais usando o sinalizador "principal" no identityMap, esse valor ainda precisará ser enviado?

Sim, o sinalizador "primário" em identityMap é usado por outros serviços. Para obter mais informações, leia o manual sobre as implicações da prioridade de namespace em outros serviços de Experience Platform.

A prioridade de namespace será aplicada aos conjuntos de dados de registro de Perfil no Perfil do cliente em tempo real?

Não. A prioridade de namespace será aplicada somente aos conjuntos de dados de Evento de experiência que usam a Classe XDM ExperienceEvent.

Como esse recurso funciona em conjunto com as medidas de proteção de gráfico de identidade de 50 identidades por gráfico? A prioridade de namespace afeta esta garantia definida pelo sistema?

O algoritmo de otimização de identidade será aplicado primeiro para garantir a representação da entidade da pessoa. Posteriormente, se o gráfico tentar exceder a proteção de gráfico de identidade (50 identidades por gráfico), essa lógica será aplicada. A prioridade de namespace não afeta a lógica de exclusão da garantia de identidade/gráfico 50.

Testes

Leia esta seção para obter respostas a perguntas frequentes sobre recursos de teste e depuração nas regras de vinculação do gráfico de identidade.

Quais são alguns dos cenários que devo testar em um ambiente de sandbox de desenvolvimento?

De modo geral, testar uma sandbox de desenvolvimento deve imitar os casos de uso que você pretende executar em sua sandbox de produção. Consulte a tabela a seguir para obter algumas áreas principais a serem validadas ao realizar testes abrangentes:

Como posso validar se esse recurso está funcionando como esperado?

Use a ferramenta de simulação de gráficos para validar se o recurso está funcionando em um nível de gráfico individual.

Para validar o recurso em um nível de sandbox, consulte a seção Contagem de gráficos com vários namespaces no painel de identidade.