Guia de implementação para regras de vinculação do gráfico de identidade

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 para implementação prerequisites-for-implementation

Esta seção descreve as etapas de pré-requisito que você deve concluir antes de implementar as regras de vinculação do gráfico de identidade 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 cada perfil. Isso permite que o Serviço de identidade detecte o identificador de pessoa apropriado em um determinado gráfico.

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

Durante o processo de pré-implementação, você deve garantir que os eventos autenticados que seu sistema enviará para o Experience Platform sempre contenham um identificador de pessoa, como CRMID.

{
  "_id": "test_id",
  "identityMap": {
      "ECID": [
          {
              "id": "62486695051193343923965772747993477018",
              "primary": false
          }
      ],
      "CRMID": [
          {
              "id": "John",
              "primary": true
          }
      ]
  },
  "timestamp": "2024-09-24T15:02:32+00:00",
  "web": {
      "webPageDetails": {
          "URL": "https://business.adobe.com/",
          "name": "Adobe Business"
      }
  }
}

{
    "_id": "test_id",
    "identityMap": {
        "ECID": [
            {
                "id": "62486695051193343923965772747993477018",
                "primary": false
            }
        ]
    },
    "timestamp": "2024-09-24T15:02:32+00:00",
    "web": {
        "webPageDetails": {
            "URL": "https://business.adobe.com/",
            "name": "Adobe Business"
        }
    }
}

Não envie uma string vazia como um valor de identidade ao enviar eventos usando eventos de experiência XDM. Se o valor de identidade do namespace com a prioridade mais alta for uma cadeia de caracteres vazia, o registro será ignorado no Perfil do cliente em tempo real. Isso se aplica a identityMap e a campos marcados como uma identidade.

    "identityMap": {
        "ECID": [
            {
                "id": "24165048599243194405404369473457348936",
                "primary": false
            }
        ],
        "Phone": [
            {
                "id": "",
                "primary": true
            }
        ]
    }

Você deve garantir que tenha uma identidade totalmente qualificada ao enviar eventos usando eventos de experiência XDM.

    "identityMap": {
        "ECID": [
            {
                "id": "24165048599243194405404369473457348936",
                "primary": false
            }
        ]
    }

Definir permissões set-permissions

A primeira etapa do processo de implementação do Serviço de identidade é garantir que sua conta Experience Platform seja adicionada a uma função que esteja 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:

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 configurações diferentes, 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 como seu gráfico se comporta.

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. Quando terminar de aplicar as configurações, aguarde pelo menos seis horas para continuar a assimilar dados, pois levará pelo menos seis horas para que as novas configurações sejam refletidas no Serviço de identidade.

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:

Depois de ter todos os itens listados acima, você pode começar a assimilar seus dados no 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 o 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.

Próximas etapas

Para obter mais informações sobre regras de vinculação de gráficos de identidade, leia a seguinte documentação: