Compilação em campo

Na compilação em campo, você especifica um conjunto de dados de evento, bem como a ID persistente (cookie) e a ID de pessoa para esse conjunto de dados. A compilação em campo tenta disponibilizar as informações da ID de pessoa para a análise de dados da Customer Journey Analytics, em todos os eventos anônimos que vêm com uma ID persistente específica. Essas informações são recuperadas das linhas que têm uma ID de pessoa para essa ID persistente específica.

Se as informações de ID de pessoa não puderem ser recuperadas para um evento, a ID persistente será usada para esse evento não compilado. Como resultado, em uma visualização de dados associada a uma conexão que contém o conjunto de dados habilitado para compilação, o componente de ID de pessoa contém o valor da ID de pessoa ou o valor da ID persistente no nível do evento.

Você pode usar a compilação em campo ao usar o Customer Journey Analytics como uma solução independente (sem acesso ao Serviço de identidade da Experience Platform e ao gráfico de identidade associado). Ou quando não quiser usar o gráfico de identidade disponível.

Compilação em campo

IdentityMap

A compilação em campo oferece suporte ao uso do grupo de campos do identityMap nos seguintes cenários:

  • Uso da identidade princiapl em namespaces identityMap para definir a persistentID:

    • Se várias identidades primárias forem encontradas em namespaces diferentes, as identidades nos namespaces serão classificadas lexicograficamente e a primeira identidade será selecionada.
    • Se várias identidades primárias forem encontradas em um único namespace, a primeira identidade primária lexicográfica disponível será selecionada.

    No exemplo abaixo, os namespaces e as identidades resultam em uma lista ordenada de identidades primárias e, por fim, na identidade selecionada.

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
    Namespaces Lista de identidades
    ECID
    code language-none
    [
      {"id": "ecid-3"},
      {"id": "ecid-2", "primary": true},
      {"id": "ecid-1", "primary": true}
     ]
    
    CCID
    code language-none
    [
      {"id": "ccid-1"},
      {"id": "ccid-2", "primary": true}
    ]
    
    table 0-row-2 1-row-2 layout-auto html-authored
    Lista de identidades classificadas Identidade selecionada
    code language-none
    PrimaryIdentities [
      {"id": "ccid-2", "namespace": "CCID"},
      {"id": "ecid-1", "namespace": "ECID"},
      {"id": "ecid-2", "namespace": "ECID"}
    ]
    NonPrimaryIdentities [
      {"id": "ccid-1", "namespace": "CCID"},
      {"id": "ecid-3", "namespace": "ECID"}
    ]
    
    code language-none
    "id": "ccid-2",
    "namespace": "CCID"
    
  • Uso do namespace identityMap para definir a ID persistente, a ID de pessoa ou ambas:

    • Se vários valores de ID persistente ou ID de pessoa forem encontrados em um namespace identityMap, o primeiro valor lexicográfico disponível será usado.
    • Os namespaces da ID persistente e da ID de pessoa devem ser mutuamente exclusivos.

    No exemplo abaixo, você selecionou ECID como o namespace a ser usado. Essa seleção resulta em uma lista de identidades classificadas e, por fim, na identidade selecionada.

    table 0-row-2 1-row-2 2-row-2 layout-auto html-authored
    Namespaces Lista de identidades
    ECID
    code language-none
    [
      {"id": "ecid-3"},
      {"id": "ecid-2", "primary": true},
      {"id": "ecid-1", "primary": true}
    ]
    
    CCID
    code language-none
    [
      {"id": "ccid-1"},
      {"id": "ccid-2", "primary": true}
    ]
    
    table 0-row-2 1-row-2 layout-auto html-authored
    Lista de identidades classificadas Identidade selecionada
    code language-none
    [
      "id": "ecid-1",
      "id": "ecid-2",
      "id": "ecid-3"
    ]
    
    code language-none
    "id": "ecid-1",
    "namespace": "ECID"
    

Como a compilação em campo funciona

A compilação faz um mínimo de duas passagens de dados em um determinado conjunto de dados.

  • Compilação em tempo real: tenta compilar cada ocorrência (evento) à medida que elas chegam. As ocorrências de dispositivos que são novos para o conjunto de dados (nunca foram autenticadas) normalmente não são compiladas neste nível. As ocorrências de dispositivos já reconhecidos são compiladas imediatamente.

  • Repetir compilação: repete dados com base em identificadores exclusivos (IDs de pessoa). É nesse estágio que as ocorrências de dispositivos anteriormente desconhecidos (IDs persistentes) se tornam compiladas (para IDs de pessoa). Dois parâmetros determinam a repetição: frequência e janela de pesquisa. A Adobe oferece as seguintes combinações desses parâmetros:

    • Pesquisa diária em uma frequência diária: os dados são repetidos todos os dias com uma janela de pesquisa de 24 horas. Essa opção tem a vantagem de as repetições serem muito mais frequentes, mas as pessoas não autenticadas devem se autenticar no mesmo dia em que visitam o site.
    • Pesquisa semanal em uma frequência semanal: os dados são repetidos uma vez por semana com uma janela de pesquisa semanal (consulte opções). Essa opção tem uma vantagem que permite que sessões não autenticadas tenham um tempo muito mais tolerante para autenticação. No entanto, os dados não compilados com menos de uma semana não são reprocessados até a próxima repetição semanal.
    • Pesquisa quinzenal em uma frequência semanal: os dados são repetidos uma vez por semana com uma janela de pesquisa quinzenal (consulte opções). Essa opção tem uma vantagem que permite que sessões não autenticadas tenham um tempo muito mais tolerante para autenticação. No entanto, os dados não compilados com menos de duas semanas não são reprocessados até a próxima repetição semanal.
    • Pesquisa mensal em uma frequência semanal: os dados são repetidos todas as semanas com uma janela de pesquisa mensal (consulte opções). Essa opção tem uma vantagem que permite que sessões não autenticadas tenham um tempo muito mais tolerante para autenticação. No entanto, os dados não compilados com menos de um mês não são reprocessados até a próxima repetição semanal.
  • Privacidade: quando solicitações relacionadas à privacidade são recebidas, além de remover a identidade solicitada, qualquer compilação dessa identidade em eventos não autenticados deve ser desfeita.

    note important
    IMPORTANT
    O processo de descompilação, como parte das solicitações de privacidade, mudou no início de 2025. O processo de descompilação atual compila novamente os eventos usando a versão mais recente de identidades conhecidas. Essa reatribuição de eventos para outra identidade pode ter consequências legais indesejáveis. Para solucionar essas preocupações, a partir de 2025, o novo processo de descompilação atualiza os eventos que são objeto da solicitação de privacidade com a ID persistente.

Os dados além da janela de pesquisa não são repetidos. Um perfil deve ser autenticado em uma determinada janela de pesquisa para que uma visita não autenticada e uma visita autenticada sejam identificadas juntas. Depois que um dispositivo é reconhecido, ele é compilado em tempo real a partir desse ponto.

Etapa 1: compilação em tempo real

A compilação em tempo real tenta compilar cada evento após a coleção em dispositivos e canais conhecidos.

Detalhes

Considere o exemplo a seguir, em que Bob registra eventos diferentes como parte de um conjunto de dados de evento.

Dados conforme apresentados no dia da coleta:

table 0-row-5 1-row-5 2-row-5 3-row-5 4-row-5 5-row-5 6-row-5 7-row-5 8-row-5 9-row-5 10-row-5 11-row-5 12-row-5 13-row-5
Evento Carimbo de data e hora ID persistente (ID do cookie) ID da pessoa ID resultante (após a compilação em tempo real)
1 2023-05-12 12:01 246 ArrowRight - 246
2 2023-05-12 12:02 246 Bob ArrowRight Bob
3 2023-05-12 12:03 246 Bob ArrowRight Bob ArrowDown
4 2023-05-12 12:04 246 - Bob
5 2023-05-12 12:05 246 Bob ArrowRight Bob Arrow Down
6 2023-05-12 12:06 246 - Bob
7 2023-05-12 12:07 246 Bob ArrowRight Bob
8 2023-05-12 12:03 3579 ArrowRight - 3579
9 2023-05-12 12:09 3579 ArrowRight - 3579
10 2023-05-12 12:02 81911 ArrowRight - 81911
11 2023-05-12 12:05 81911 Bob ArrowRight Bob ArrowDown
12 2023-05-12 12:12 81911 - Bob
3 dispositivos 4 pessoas:
246, Bob, 3579, 81911

Os eventos não autenticados e autenticados em novos dispositivos são contados como pessoas separadas (temporariamente). Eventos não autenticados em dispositivos reconhecidos são compilados em tempo real.

A atribuição funciona quando a variável personalizada de identificação está vinculada a um dispositivo. No exemplo acima, todos os eventos, exceto os eventos 1, 8, 9 e 10, são compilados em tempo real (todos usam o identificador Bob). A compilação em tempo real “resolve” a ID resultante para o evento 4, 6 e 12.

Os dados atrasados (dados com um carimbo de data e hora superior a 24 horas) são tratados com base no “melhor esforço”, priorizando a compilação de dados atuais para obter a mais alta qualidade.

Etapa 2: repetir a compilação

Em intervalos regulares (uma vez por semana ou uma vez por dia, dependendo da janela de pesquisa escolhida), repetir a compilação recalcula os dados históricos com base nos dispositivos que agora ele reconhece. Se um dispositivo enviar dados inicialmente sem estar autenticado e, em seguida, fizer logon, a repetição da compilação vincula esses eventos não autenticados à pessoa correta.

Detalhes

A tabela a seguir representa os mesmos dados acima, mas mostra números diferentes com base na repetição dos dados.

Os mesmos dados após a repetição:

table 0-row-6 1-row-6 2-row-6 3-row-6 4-row-6 5-row-6 6-row-6 7-row-6 8-row-6 9-row-6 10-row-6 11-row-6 12-row-6 13-row-6 layout-auto
Evento Carimbo de data e hora ID persistente (ID do cookie) ID da pessoa ID resultante (após a compilação em tempo real) ID resultante (após a repetição)
1 2023-05-12 12:01 246 - 246 Bob
2 2023-05-12 12:02 246 Bob ArrowRight Bob Bob ArrowUp
3 2023-05-12 12:03 246 Bob ArrowRight Bob Bob
4 2023-05-12 12:04 246 - Bob Bob
5 2023-05-12 12:05 246 Bob ArrowRight Bob ArrowDown Bob
6 2023-05-12 12:06 246 - Bob Bob
7 2023-05-12 12:07 246 Bob ArrowRight Bob Bob
8 2023-05-12 12:03 3579 ArrowRight - 3579 3579
9 2023-05-12 12:09 3579 ArrowRight - 3579 3579
10 2023-05-12 12:02 81911 - 81911 Bob
11 2023-05-12 12:05 81911 Bob ArrowRight Bob ArrowDown Bob ArrowUp
12 2023-05-12 12:12 81911 - Bob Bob
3 dispositivos 4 pessoas:
246, Bob, 3579, 81911
2 pessoas:
Bob, 3579

A atribuição funciona quando a variável personalizada de identificação está vinculada a um dispositivo. No exemplo acima, os eventos 1 e 10 são compilados como resultado da repetição, deixando apenas os eventos 8 e 9 não compilados. E reduzindo a métrica de pessoas (cumulativa) para 2.

Etapa 3: solicitação de privacidade

Ao receber uma solicitação de privacidade, qualquer informação de identificador definida pelo processo de compilação para o valor de ID de pessoa é atualizada em todos os registros para um valor de ID persistente para o usuário sujeito à solicitação de privacidade.

Detalhes

A tabela a seguir representa os mesmos dados acima, mas mostra o efeito que uma solicitação de privacidade para Bob tem nos dados após o processamento. As linhas em que Bob é autenticado são removidas (2, 3, 5, 7 e 11) juntamente com a remoção de Bob como uma ID de pessoa nas outras linhas.

Os mesmos dados após uma solicitação de privacidade para Bob:

table 0-row-8 1-row-8 2-row-8 3-row-8 4-row-8 5-row-8 6-row-8 7-row-8 8-row-8 9-row-8 10-row-8 11-row-8 12-row-8 13-row-8
Evento Carimbo de data e hora ID persistente (ID do cookie) ID da pessoa ID resultante (após a compilação em tempo real) ID resultante (após a repetição) ID da pessoa ID resultante (após solicitação de privacidade)
1 2023-05-12 12:01 246 - 246 Bob - 246
2 2023-05-12 12:02 246 Bob ArrowRight Bob Bob Arrow Up RemoveCircle 246
3 2023-05-12 12:03 246 Bob ArrowRight Bob ArrowDown Bob RemoveCircle 246
4 2023-05-12 12:04 246 - Bob Bob - 246
5 2023-05-12 12:05 246 Bob ArrowRight Bob ArrowDown Bob RemoveCircle 246
6 2023-05-12 12:06 246 - Bob Bob - 246
7 2023-05-12 12:07 246 Bob ArrowRight Bob Bob RemoveCircle 246
8 2023-05-12 12:03 3579 ArrowRight - 3579 3579 - 3579
9 2023-05-12 12:09 3579 ArrowRight - 3579 3579 - 3579
10 2023-05-12 12:02 81911 - 81911 Bob - 81911
11 2023-05-12 12:05 81911 Bob ArrowRight Bob ArrowDown Bob ArrowUp RemoveCircle 81911
12 2023-05-12 12:12 81911 - Bob Bob - 81911
3 dispositivos 4 pessoas:
246, Bob, 3579, 81911
2 pessoas:
Bob, 3579
3 pessoas:
246, 3579, 81911

Pré-requisitos

Os seguintes pré-requisitos se aplicam especificamente à compilação em campo:

  • O conjunto de dados do evento na Adobe Experience Platform, ao qual você deseja aplicar a compilação, deve ter duas colunas que ajudem a identificar perfis:

    • Uma ID persistente, um identificador disponível em cada linha. Por exemplo, uma ID de visitante gerada por uma biblioteca AppMeasurement do Adobe Analytics ou uma ECID gerada pelo Adobe Experience Platform Identity Service.
    • Uma ID de pessoa, um identificador disponível apenas em algumas linhas. Por exemplo, um nome de usuário ou endereço de email com hash quando um perfil é autenticado. Você pode usar praticamente qualquer identificador que desejar. A compilação considera que esse campo mantém as informações reais da ID de pessoa. Para obter melhores resultados de compilação, uma ID de pessoa deve ser enviada nos eventos do conjunto de dados pelo menos uma vez para cada ID persistente. Se você planeja incluir esse conjunto de dados em uma conexão do Customer Journey Analytics, é preferível que os outros conjuntos de dados também tenham um identificador comum semelhante.

Limitações

As seguintes limitações se aplicam especificamente à compilação em campo:

  • Os recursos atuais de rechaveamento são limitados a uma etapa (ID persistente para ID de pessoa). O rechaveamento de várias etapas (por exemplo, ID persistente para uma ID de pessoa e, em seguida, para outra ID de pessoa) não é aceito.
  • Se várias pessoas compartilharem um dispositivo e o número total de transições entre usuários exceder 50.000, o Customer Journey Analytics interromperá a compilação de dados para esse dispositivo.
  • Não há suporte para mapas de ID personalizados usados em sua organização.
  • A compilação diferencia maiúsculas e minúsculas. Para conjuntos de dados gerados por meio do conector de origem do Analytics, a Adobe recomenda revisar quaisquer regras VISTA ou regras de processamento que se aplicam ao campo de ID de pessoa. A revisão garante que nenhuma dessas regras introduza novas formas da mesma ID. Por exemplo, você deve garantir que nenhuma regra VISTA ou de processamento introduza letras minúsculas no campo de ID de pessoa em apenas uma parte dos eventos.
  • A compilação não combina nem concatena campos.
  • O campo de ID de pessoa deve conter um único tipo de ID (ou seja, IDs de um único namespace). Por exemplo, o campo ID de pessoa não deve conter uma combinação de IDs de logon e IDs de email.
  • Se vários eventos ocorrerem com o mesmo carimbo de data e hora para a mesma ID persistente, mas com valores diferentes no campo de ID de pessoa, a compilação seleciona a ID por ordem alfabética. Portanto, se a ID persistente A tiver dois eventos com o mesmo carimbo de data e hora e um dos eventos especificar Bob e o outro especificar Ann, a compilação em campo escolherá Ann.
  • Tenha cuidado com cenários em que as IDs de pessoa contêm valores de espaço reservado, por exemplo Undefined. Consulte as Perguntas frequentes para obter mais informações.
  • Não é possível usar o mesmo namespace para a ID persistente e a ID de pessoa. Os namespaces precisam ser mutuamente exclusivos.
recommendation-more-help
analytics-platform-help-main