Habilitar compilação

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.

Você habilita a compilação como parte das configurações do conjunto de dados para um conjunto de dados de evento quando cria uma conexão ou quando edita uma conexão.

Pré-requisitos

Você precisa verificar e atender aos pré-requisitos do método de compilação especificado: compilação em campo ou compilação 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:

  • Se você for usar campos de esquema XDM para ID persistente ou ID de pessoa, 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

      Consulte 7 dias de dados nos quais o campo de ID persistente 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 95%.

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

      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}';
      

      Em que:

      • {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

      • Para a compilação baseada em gráficos, verifique se o gráfico de identidade contém fragmentos que vinculam valores de ID do namespace de ID persistente e do namespace de ID de pessoa escolhidos. Você pode executar um teste acessando o Visualizador de gráficos de identidade da Experience Platform e consultando o gráfico por alguns valores de ID persistentes de amostra. Verifique se esses valores de ID persistente estão vinculados aos valores de ID de pessoa no gráfico.

      • Para a compilação em campo, 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. Idealmente, essa porcentagem deve ficar acima de 5%.

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

        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}';
        

        Em que:

        • {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 enable-identity-stitching

Você pode habilitar a identificação de identidade ao adicionar ou editar um conjunto de dados de evento em uma conexão baseada em pessoa. A identificação de identidade não está disponível para conexões baseadas em conta.

Configurações do conjunto de dados

Para habilitar a compilação, na seção de configurações de conjuntos de dados do Caixa de diálogo Adicionar conjuntos de dados ou Editar conjunto de dados:

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

  1. Selecione Habilitar identificação de identidade.

    Se você habilitar ou desabilitar a compilação de um conjunto de dados de evento salvo na conexão, a caixa de diálogo Alterar ID de pessoa exibirá as implicações de uma alteração da ID de pessoa. 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.

  2. 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:

    • Selecione Usar namespace de identidade primário para usar o namespace de identidade primário.
    • Selecione um namespace no menu suspenso Namespace.
  3. 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:

    • Selecione 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. Esta configuração faz parte dos pré-requisitos baseados em gráficos antes que você possa usar o gráfico de identidade para compilação. Selecione Continuar para continuar.

    • Selecione um namespace no menu suspenso Namespace.
  4. Selecione uma janela de repetição no menu suspenso Janela de repetição. As opções disponíveis dependem do pacote do Customer Journey Analytics ao qual você está habilitado.

  5. Selecione Avançar para visualizar o conjunto de dados do evento que está sujeito à compilação.

Pré-visualização de conjuntos de dados

AVAILABILITY
A interface aprimorada visualização do conjunto de dados (incluindo Métricas de compilação e IDs inválidas) descrita nesta seção está na fase de teste limitado da versão e pode ainda não estar disponível em seu ambiente. Se não estiver disponível, você verá a visualização do conjunto de dados como parte da interface configurações do conjunto de dados. 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.

Além da interface padrão de visualização de conjuntos de dados, ao adicionar ou editar conjuntos de dados em uma conexão baseada em pessoa, dois painéis de informações adicionais estão disponíveis.

NOTE
Para clientes que têm o Customer Journey Analytics implantado no AWS, essa funcionalidade aguarda a versão.

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

Compilação de métricas

Métricas de compilação estão sendo calculadas usando um conjunto de amostras de dados, de quaisquer dados assimilados nos últimos 7 dias. Este conjunto de amostras de dados geralmente difere dos dados de amostra usados na tabela Preview. As métricas de compilação fornecem detalhes para:

  • Cobertura da ID de pessoa: a cobertura da ID de pessoa selecionada usada para identificação durante o processo de compilação (em tempo real e repetição).

    • Para obter os melhores resultados de compilação em campo, uma ID de pessoa (informações do usuário) deve ser enviada em pelo menos um evento para cada ID persistente (informações do dispositivo).
    • Para obter os melhores resultados de compilação com base em gráfico, uma relação (ID persistente, ID de pessoa) deve estar presente no gráfico de identidade para cada ID persistente.

    A cobertura de ID de pessoa é mostrada como uma porcentagem e comparada com o que é recomendado em um desenvolvimento estável ou em uma configuração de produção. Quanto maior for o valor dessa cobertura, melhores resultados de compilação serão obtidos com a ID de pessoa selecionada.

  • Cobertura de ID persistente: esse valor é usado para identificação durante o processo de compilação (em tempo real e repetição), caso um valor de ID de pessoa não possa ser detectado. Eventos sem ID persistente e sem ID de pessoa são descartados dos dados. Para obter melhores resultados de compilação, uma ID persistente deve estar presente em todos os eventos.

    A cobertura de ID persistente é mostrada como uma porcentagem e comparada com o mínimo recomendado em um desenvolvimento estável ou em uma configuração de produção.

IDs inválidas

INFO
IDs inválidas também são chamadas de BAVIDs na interface do Customer Journey Analytics.

No Customer Journey Analytics, uma ID incorreta é um identificador:

  • com um valor de ID específico que se origina de uma ID persistente ou de um campo de ID de pessoa em conjuntos de dados habilitados para compilação, e
  • O está em mais de um milhão (1.000.000) eventos nos dados de conexão, no prazo de um mês.

Quando um valor de ID é marcado como uma ID incorreta, os eventos futuros que contêm esse valor de ID são descartados dos dados de conexão e não são exibidos no relatório.

Exemplos de casos de uso de IDs inválidas:

  • Você tem valores personalizados ou de espaço reservado no campo de ID de pessoa (por exemplo, undefined). Esses valores também podem afetar a compilação e relatório da qualidade dos dados.
  • Em uma configuração de compilação em campo, se várias pessoas compartilharem um dispositivo e o número total de transições entre usuários exceder 50.000. Nesse cenário, o processo de compilação para de usar as informações de ID de pessoa para esse dispositivo e, em vez disso, usa apenas informações de ID persistentes. Consequentemente, todos os eventos do conjunto de dados desse dispositivo são enviados para os dados de conexão com a identidade de ID persistente, com uma grande chance de causar uma situação de IDs inválidas.
NOTE
As Métricas de compilação, incluindo IDs inválidas, são calculadas com base em um conjunto limitado de dados. Para identificar a presença de IDs inválidas em um conjunto de dados que você planeja usar para compilação, consulte a nota técnica de IDs inválidas.

Salvar

Depois de salvar uma conexão, o processo de compilação para conjuntos de dados habilitados para compilação é iniciado assim que a assimilação de dados para esses conjuntos de dados é iniciada.

CAUTION
Para conjuntos de dados habilitados para compilação na interface de Conexões, o status de preenchimento retroativo é imediata e incorretamente relatado como Status verde _x _preenchimentos retroativos concluídos​para o número de preenchimentos retroativos concluídos. Use outras maneiras de verificar se os dados do conjunto de dados compilado são preenchidos retroativamente.

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.

Migração

A compilação ativada na interface de Conexões pode coexistir sem problemas com a compilação baseada em solicitação.

Por exemplo, você tem conjuntos de dados compilados com base na Web no lago de dados como resultado de solicitações de compilação anteriores ou atuais. Você pode adicionar dados compilados de um conjunto de dados da central de atendimento usando a interface Conexões para combinar esses dados com os dados baseados na Web.

Eventualmente, a Adobe migrará seus conjuntos de dados compilados com base em solicitação para a nova experiência de compilação em conexões.

recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79