Uso do identityMap na coleção de dados

O objeto de carga identityMap é como você informa à Edge Network quem um visitante está além da ECID de nível de dispositivo. Quando um visitante faz logon, conclui uma compra ou se torna conhecido de alguma outra forma, você pode enviar identificadores de nível de pessoa (ID de CRM, email com hash, ID de fidelidade etc.) juntamente com a ECID. Esses identificadores de nível de pessoa fornecem informações valiosas para serviços downstream para que possam:

Esta página aborda como construir cargas do identityMap, escolher as configurações corretas para cada identidade e lidar com cenários comuns de implementação.

Estrutura de carga útil structure

O identityMap é um objeto JSON em que cada chave de nível superior é um namespace e o valor é uma matriz de descritores de identidade. Você pode incluir um ou mais namespaces em uma única carga, e cada descritor contém três campos: id, authenticatedState e primary.

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

As seções abaixo abordam cada parte do conteúdo em detalhes.

Chaves de namespace namespace-keys

Cada chave de nível superior em identityMap é um namespace de identidade — uma cadeia que classifica o tipo de identificador (por exemplo, CRMID, Email, Phone ou LoyaltyId). Os namespaces devem existir no Serviço de identidade antes de você referenciá-los em uma carga. Você pode incluir várias chaves de namespace no mesmo evento quando tiver mais de um identificador para o visitante.

Não é necessário incluir a ECID como uma chave de namespace. O Edge Network adiciona automaticamente a ECID à carga da identidade. Se você incluir a ECID explicitamente, não marque-a como primary quando uma identidade de nível de pessoa também estiver presente.

id id

O campo id é a própria cadeia de caracteres do identificador — o valor que informa ao Experience Platform qual pessoa ou dispositivo específico essa identidade representa. Cada namespace de identidade espera um formato de valor específico, e o envio de um valor no formato errado cria uma identidade distinta que não pode ser mesclada com a versão formatada corretamente, resultando em perfis fragmentados.

Antes de incluir um valor em identityMap, prepare-o de acordo com o formato que o namespace de destino espera:

Para obter a lista completa de namespaces padrão e suas definições, consulte Visão geral do namespace de identidade.

Coletando id no tempo de execução collect-id

O identificador necessário raramente está disponível diretamente na página. As estratégias comuns de coleta incluem:

authenticatedState authenticated-state

O campo authenticatedState informa aos serviços downstream quanta confiança colocar em uma determinada identidade. Os seguintes valores são válidos para este campo:

primary primary-identity

Toda carga de identityMap deve ter exatamente uma identidade marcada como primary: true. A identidade principal determina qual identidade é usada como âncora para o evento no Experience Platform.

Siga estas diretrizes ao definir a identidade principal:

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email": [
      {
        "id": "user@example.com",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

Envio do identityMap na implementação send-identity

alloy("sendEvent", {
  xdm: {
    identityMap: {
      CRMID: [
        {
          id: "abc-123-xyz",
          authenticatedState: "authenticated",
          primary: true
        }
      ]
    },
    eventType: "web.webpagedetails.pageViews"
  }
});

Cenários comuns common-scenarios

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "loggedOut",
        "primary": false
      }
    ]
  }
}

{
  "identityMap": {
    "CRMID": [
      {
        "id": "abc-123-xyz",
        "authenticatedState": "authenticated",
        "primary": true
      }
    ],
    "Email_LC_SHA256": [
      {
        "id": "a1b2c3d4e5f6...",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ],
    "LoyaltyId": [
      {
        "id": "LOY-98765",
        "authenticatedState": "authenticated",
        "primary": false
      }
    ]
  }
}

Como o identityMap afeta o gráfico de identidade identity-graph

Toda carga do identityMap que chega à Experience Platform é processada pelo Serviço de Identidade, que vincula as identidades enviadas a um gráfico de identidade. Os namespaces que você inclui, como você define authenticatedState e qual identidade você marca como primary, moldam diretamente como o Serviço de Identidade cria e mescla esses gráficos.

Comportamentos principais a serem observados:

Se sua implementação usar regras de vinculação de gráficos de identidade (como a prioridade de namespace ou o algoritmo de otimização de identidade), revise o guia de implementação para entender como essas regras interagem com as identidades enviadas por meio do identityMap.