Usar compilação

Last update: Tue Oct 28 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Análise entre canais

Criado para:

Administrador

Você pode ativar a compilação em um ou mais conjuntos de dados de evento configurados como parte da conexão. O pacote do Customer Journey Analytics que você licenciou determina o número de conjuntos de dados de evento que podem ser habilitados para compilação.

AVAILABILITY

A funcionalidade descrita neste artigo está na fase de teste limitado da versão e pode não estar disponível ainda em seu ambiente. Essa observação será removida quando a funcionalidade estiver em disponibilidade geral. Para obter informações sobre o processo de lançamento do Customer Journey Analytics, consulte Lançamentos de recursos do Customer Journey Analytics.

Você pode habilitar a compilação como parte das configurações do conjunto de dados para um conjunto de dados de evento ao criar uma conexão ou ao editar uma conexão.

Pré-requisitos

Para ativar a compilação em um conjunto de dados de evento na interface do usuário de conexões:

O esquema no qual o conjunto de dados se baseia deve ter:
- vários campos configurados como uma identidade e que permitem selecionar valores diferentes para uma ID persistente e uma ID de pessoa.
- pelo menos um campo que esteja marcado como identidade principal com um namespace associado caso queira usar o Mapa de identidade e o namespace de identidade principal para ID persistente ou ID de pessoa.
O conjunto de dados do evento deve ser habilitado para o Serviço de identidade caso você queira usar o Gráfico de identidade e a compilação baseada em gráfico.

Verificações de comprovação

Se você atender aos pré-requisitos, talvez queira executar algumas verificações de comprovação nos dados no conjunto de dados do evento antes de ativar a compilação de identidade:

Verifique se as identidades estão marcadas corretamente no esquema para o conjunto de dados do evento. Consulte Visão geral do namespace de identidade.

Verifique a cobertura de identidade para ID persistente e ID de pessoa:

ID persistente: consulta 7 dias de dados, nos quais o campo de ID persistente não é nulo, e é dividido por uma consulta de 7 dias de dados para todos os eventos no conjunto de dados. Esse percentual deve estar acima de 95%.

Exemplo de uma consulta que você pode usar para verificação:

code language-sql

code language-sql
`SELECT COUNT() AS total_events, COUNT({PERSISTENT_ID_FIELD}) AS events_with_persistentid, ROUND(COUNT({PERSISTENT_ID_FIELD}) / COUNT(), 2) AS percent_with_persistentid_not_null FROM {DATASET_TABLE_NAME} WHERE TO_TIMESTAMP(timestamp, '{FORMAT_STRING}') >= TIMESTAMP '{START_DATE}' AND TO_TIMESTAMP(timestamp, 'FORMAT_STRING') < TIMESTAMP '{END_DATE}';`

SELECT
  COUNT(*) AS total_events,
  COUNT({PERSISTENT_ID_FIELD}) AS events_with_persistentid,
  ROUND(COUNT({PERSISTENT_ID_FIELD}) / COUNT(*), 2) AS percent_with_persistentid_not_null
FROM
  {DATASET_TABLE_NAME}
WHERE
  TO_TIMESTAMP(timestamp, '{FORMAT_STRING}') >= TIMESTAMP '{START_DATE}'
  AND TO_TIMESTAMP(timestamp, 'FORMAT_STRING') < TIMESTAMP '{END_DATE}';

Onde:

{PERSISTENT_ID_FIELD} é o campo para a ID persistente. Por exemplo: identityMap.ecid[0].
{DATASET_TABLE_NAME} é o nome da tabela para o conjunto de dados do evento.
{FORMAT_STRING} é a cadeia de caracteres de formato do campo de carimbo de data/hora. Por exemplo: MM/DD/YY HH12:MI AM.
{START_DATE} é a data de início. Por exemplo: 2024-01-01 00:00:00.
{END_DATE} é a data de término em formato padrão. Por exemplo: 2024-01-08 00:00:00.

ID de pessoa - Consulte 7 dias de dados nos quais o campo de ID de pessoa não é nulo e divida por uma consulta de 7 dias de dados para todos os eventos no conjunto de dados. Esse percentual deve estar acima de 5%.

Exemplo de uma consulta que você pode usar para verificação:

code language-sql

code language-sql
`SELECT COUNT() AS total_events, COUNT({PERSON_ID_FIELD}) AS events_with_personid, ROUND(COUNT({PERSON_ID_FIELD}) / COUNT(), 2) AS percent_with_personid_not_null FROM {DATASET_TABLE_NAME} WHERE TO_TIMESTAMP(timestamp, '{FORMAT_STRING}') >= TIMESTAMP '{START_DATE}' AND TO_TIMESTAMP(timestamp, 'FORMAT_STRING') < TIMESTAMP '{END_DATE}';`

SELECT
  COUNT(*) AS total_events,
  COUNT({PERSON_ID_FIELD}) AS events_with_personid,
  ROUND(COUNT({PERSON_ID_FIELD}) / COUNT(*), 2) AS percent_with_personid_not_null
FROM
  {DATASET_TABLE_NAME}
WHERE
  TO_TIMESTAMP(timestamp, '{FORMAT_STRING}') >= TIMESTAMP '{START_DATE}'
  AND TO_TIMESTAMP(timestamp, 'FORMAT_STRING') < TIMESTAMP '{END_DATE}';

Onde:

{PERSON_ID_FIELD} é o campo para a ID de pessoa. Por exemplo: identityMap.crmId[0].
{DATASET_TABLE_NAME} é o nome da tabela para o conjunto de dados do evento.
{FORMAT_STRING} é a cadeia de caracteres de formato do campo de carimbo de data/hora. Por exemplo: MM/DD/YY HH12:MI AM.
{START_DATE} é a data de início. Por exemplo: 2024-01-01 00:00:00.
{END_DATE} é a data de término em formato padrão. Por exemplo: 2024-01-08 00:00:00.

Habilitar compilação de identidades

NOTE

Se Habilitar identificação de identidade não estiver disponível na interface Conexões, use o procedimento de solicitação para habilitar a identificação em um conjunto de dados.

Para habilitar a compilação, na seção de conjunto de dados do evento da caixa de diálogo Adicionar conjuntos de dados ou Editar conjunto de dados:

Opções de identificação ao habilitar a identificação

Selecione Habilitar identificação de identidade.

Se você habilitar a compilação para um conjunto de dados de evento existente, a caixa de diálogo Alterar ID de pessoa exibirá as implicações de uma alteração da ID de pessoa devido ao uso da compilação. Selecione Continuar para continuar.

A caixa de diálogo Habilitar identificação de identidade resume as consequências da identificação. Selecione Continuar para continuar.
Selecione uma ID persistente no menu suspenso ID persistente.

Se você selecionar Mapa de identidade para a ID persistente, será necessário selecionar um namespace. Você tem duas opções:
- Habilitar Usar namespace de identidade primário para usar o namespace de identidade primário.
- Selecione um namespace no menu suspenso Namespace.

Selecione uma ID de pessoa no menu suspenso ID de pessoa.

Se você selecionar Mapa de identidade para a ID de pessoa, será necessário selecionar um namespace. Você tem duas opções:

Habilitar Usar namespace de identidade primário para usar o namespace de identidade primário.
Selecione um namespace no menu suspenso Namespace.

Se você selecionar Gráfico de identidade para a ID de pessoa (para usar a compilação baseada em gráfico), será necessário selecionar um namespace.

note note
NOTE
Certifique-se de que você esteja autorizado a usar o gráfico de identidade.

Antes disso, uma caixa de diálogo Alterar para gráfico de identidade é exibida para garantir que você concluiu a configuração do gráfico de identidade para o conjunto de dados antes de usar o gráfico de identidade para compilação. Selecione Continuar para continuar.

Selecione um namespace no menu suspenso Namespace.

Selecione uma janela de retrospectiva no menu suspenso Janela de retrospectiva. As opções disponíveis dependem do pacote do Customer Journey Analytics ao qual você está habilitado.

Depois de salvar uma conexão que contém conjuntos de dados habilitados para a compilação de identidade, o processo de compilação de cada conjunto de dados começa quando a assimilação de dados desse conjunto de dados começa.

Limitações

Além das limitações de compilação em campo e das limitações de compilação em gráfico, as seguintes limitações se aplicam quando você habilita a compilação na interface Conexões:

Você só pode compilar um conjunto de dados de evento uma vez como parte de uma única conexão. Não é possível definir o mesmo conjunto de dados de evento mais de uma vez e usar uma configuração de compilação separada para cada instância. Se quiser aplicar configurações de compilação diferentes no mesmo conjunto de dados, use uma conexão separada para cada configuração.

recommendation-more-help

080e5213-7aa2-40d6-9dba-18945e892f79