DocumentaçãoCustomer Journey AnalyticsGuia do Customer Journey Analytics

Assimilar e usar dados ad hoc

Last update: Fri Oct 10 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Administrador

Este guia de início rápido explica como você pode assimilar dados ad hoc na Experience Platform e, em seguida, usar esses dados no Customer Journey Analytics.

Para isso, é necessário:

  • Crie um conjunto de dados com um arquivo CSV no Experience Platform. Esse fluxo de trabalho define o modelo (esquema) dos dados que você deseja coletar e onde coletar os dados (conjunto de dados).

  • Configurar uma conexão no Customer Journey Analytics. Essa conexão deve (pelo menos) incluir seu conjunto de dados ad hoc do Experience Platform.

  • Configure uma visualização de dados no Customer Journey Analytics para definir métricas e dimensões a partir dos campos em seus dados ad hoc que você deseja usar no Analysis Workspace.

  • Configurar um projeto no Customer Journey Analytics para criar relatórios e visualizações.

NOTE
Este guia de início rápido é um guia simplificado sobre como assimilar dados ad hoc usando no Experience Platform e usar esses dados ad hoc no Customer Journey Analytics. É altamente recomendável estudar as informações adicionais quando referidas.

Criar um conjunto de dados com um arquivo CSV

Para esse início rápido, você deseja usar um arquivo CSV que representa dados de pesquisa e contém informações semelhantes àquelas mostradas abaixo.

_id
tracking_code
ad_group
campaign_name
1
abc123
abc-adgroup
123 Campanha
2
def123
def-adgroup
123 Campanha
3
ghi123
ghi-adgroup
123 Campanha
4
abc456
abc-adgroup
Campanha 456
5
def456
def-adgroup
Campanha 456
NOTE
Use conjuntos de dados e esquemas ad hoc para dados baseados em registro (pesquisa, perfil). Os conjuntos de dados e esquemas ad hoc são menos adequados e não devem ser considerados para dados de séries temporais (evento, resumo).

Não é necessário criar um esquema XDM para dados ad hoc. O Experience Platform é compatível com um fluxo de trabalho que, com base nos dados no arquivo CSV:

  1. Cria um esquema ad hoc automaticamente. Esse esquema está em conformidade com as colunas do arquivo CSV.
  2. Cria um conjunto de dados que contém os dados do arquivo CSV.

Para iniciar o workflow:

  1. Na interface do Experience Platform, no painel à esquerda, selecione Workflows.

  2. Selecione DataAdd Criar conjunto de dados do arquivo CSV.

  3. Selecione Iniciar no painel direito.

  4. No assistente Workflows > Criar conjunto de dados do arquivo CSV:

    1. Na etapa Configurar conjunto de dados:

      1. Insira um Nome para o conjunto de dados. Por exemplo: Sample Data From CSV.

      2. Adicione uma Descrição opcional. Por exemplo: Sample data from a CSV file.

      3. Adicione uma ou mais Marcas opcionais ou selecione uma ou mais Marcas existentes.

        Configurar conjunto de dados ad hoc

      4. Selecione Próximo.

    2. Na etapa Adicionar dados:

      1. Selecione Escolher Arquivos para selecionar seu arquivo CSV do computador ou da rede. Como alternativa, arraste e solte o arquivo de seu local no computador ou na rede para Arraste e solte arquivos. O arquivo foi carregado e Dados de exemplo são exibidos.

      2. Habilite ou desabilite o Diagnóstico de erro e o Habilite a assimilação parcial de acordo com suas preferências. Quando você Habilita a assimilação parcial, é possível definir um Limite de erro %.

        Adicionar dados a um conjunto de dados ad hoc

      3. Selecione Concluir.

Depois que os dados forem preparados e carregados com êxito, você será redirecionado para Conjuntos de dados na interface do Experience Platform.
Você vê a Atividade do conjunto de dados para o seu Dados de Amostra do CSV com o status StatusOrange Processando.

Atividade do conjunto de dados para dados ad hoc

Para inspecionar os dados ad hoc:

  1. Na interface do Experience Platform, no painel à esquerda, selecione Conjuntos de dados.

  2. Selecione a guia Procurar em Conjuntos de Dados. Você deve ver seu conjunto de dados listado.

  3. Selecione o nome do esquema na coluna Esquema. Por exemplo: Dados de Exemplo de CSV…

    Selecionar esquema para o conjunto de dados ad hoc

  4. Na janela pop-up, selecione o Nome do esquema. Por exemplo: Dados de amostra do CSV - esquema adhoc - XXXXXXXXXXX. Você é redirecionado para a interface Esquemas > Dados de amostra do CSV - esquema adhoc - XXXXXXXXXXX.

Nos Esquemas > Dados de amostra do CSV - esquema adhoc - XXXXXXXXXXX interface:

  • Selecione o objeto de nome de locatário mais acima sob Esquemas > Dados de amostra do CSV - esquema adhoc - XXXXXXXXXXX para revelar os campos dentro do objeto. Os campos no objeto representam a estrutura do arquivo CSV. O schema é criado automaticamente com base no upload dos dados ad hoc.

    Esquema ad hoc

    note note
    NOTE
    O fluxo de trabalho define todos os campos no esquema como do tipo String. Não é possível alterar esse tipo em um estágio posterior. Se você precisar de mais flexibilidade na definição de um esquema ad hoc, considere usar a API para criar um esquema ad hoc e usar o fluxo de trabalho Criar conjunto de dados a partir do esquema.

Configurar uma conexão

Para usar o conjunto de dados do Experience Platform no Customer Journey Analytics, crie uma conexão que inclua o conjunto de dados ad hoc resultante do fluxo de trabalho

Uma conexão permite integrar conjuntos de dados do Experience Platform ao Workspace. Para criar relatórios sobre esses conjuntos de dados, primeiro é necessário estabelecer uma conexão entre os conjuntos de dados na Experience Platform e no Workspace.

Para criar sua conexão:

  1. Na interface do usuário do Customer Journey Analytics, selecione Conexões, opcionalmente em Gerenciamento de dados, no menu superior.

  2. Selecione Criar nova conexão.

  3. Na tela Conexão sem título:

    1. Nomeie e descreva sua conexão em Configurações de conexão.

    2. Selecione a sandbox correta na lista Sandbox em Configurações de dados e selecione o número de eventos diários na lista Número médio de eventos diários.

      Configurações de conexão

    3. Selecione Adicionar conjuntos de dados.

  4. Na etapa Selecionar conjuntos de dados em Adicionar conjuntos de dados:

    1. Selecione o conjunto de dados criado anteriormente, por exemplo Dados de Exemplo do CSV, e qualquer outro conjunto de dados que você queira incluir em sua conexão. Os conjuntos de dados ad hoc têm o tipo de conjunto de dados Adhoc.

      Adicionar conjuntos de dados

    2. Selecione Próximo.

  5. Na etapa Configurações de conjuntos de dados em Adicionar conjuntos de dados:

    Para seu conjunto de dados ad hoc:

    1. Selecione o tipo de conjunto de dados ad hoc. Por exemplo: Pesquisa.

    2. Selecione uma Chave a partir das chaves disponíveis definidas no esquema ad hoc.

    3. Selecione uma Chave correspondente de um conjunto de dados de evento que você adicionou como parte de sua conexão.

    4. Selecione a fonte de dados correta na lista Tipo de fonte de dados. Se você especificar Outros, em seguida, adicione uma descrição para a fonte de dados.

    5. Definir Importar todos os novos dados e Preenchimento retroativo de conjunto de dados com dados existentes de acordo com suas preferências.

      Configurar conjuntos de dados

    6. Selecione Adicionar conjuntos de dados.

    7. Selecione Salvar.

Consulte Configurações do conjunto de dados ad hoc para obter mais detalhes sobre as configurações disponíveis para conjuntos de dados ad hoc.

IMPORTANT
Além da recomendação geral para não usar esquemas e conjuntos de dados ad hoc para dados de séries de tempo, você não pode usar o fluxo de trabalho Criar conjunto de dados do CSV para dados de séries de tempo. Esse workflow define todos os campos como sendo do tipo String que você não pode modificar posteriormente. Quando você adiciona um conjunto de dados com base em séries de tempo (evento ou resumo) a uma conexão, esse tipo de conjunto de dados exige a definição de pelo menos um campo do tipo DateTime.
Se você precisar usar dados de série temporal ad hoc, considere usar a API para criar um esquema ad hoc e usar o fluxo de trabalho Criar conjunto de dados a partir do esquema.

Depois de criar uma conexão, você poderá executar várias tarefas de gerenciamento, como selecionar e combinar conjuntos de dados, verificar o status dos conjuntos de dados de uma conexão e o status da assimilação de dados e muito mais.

Configurar uma visualização de dados

Uma visualização de dados é um container específico do Customer Journey Analytics que permite determinar como interpretar dados de uma conexão. Ele especifica todas as dimensões e métricas disponíveis no Analysis Workspace e de quais colunas elas obtêm seus dados. As visualizações de dados são definidas na preparação de relatórios no Analysis Workspace.

Para criar a visualização de dados:

  1. Na interface do usuário do Customer Journey Analytics, selecione Visualizações de dados, opcionalmente em Gerenciamento de dados, no menu superior.

  2. Selecione Criar nova visualização de dados.

  3. Na etapa Configurar:

    1. Selecione sua conexão na lista Conexão.

    2. Nomeie e (opcionalmente) descreva a conexão.

      Configuração da visualização de dados

    3. Selecione Salvar e continuar.

  4. Na etapa Componentes:

    1. Adicione qualquer campo de esquema e/ou componente padrão que você deseja incluir nas caixas de componentes MÉTRICAS ou DIMENSÕES. Adicione campos relevantes a partir do conjunto de dados que contém os dados ad hoc. Para acessar esses campos:

      1. Selecione Conjuntos de dados de evento.

      2. Selecione Campos adhoc e baseados em modelo.

        Visualização de dados - componentes adhoc

      3. Arraste e solte campos dos esquemas ad hoc para MÉTRICAS ou DIMENSÕES.

    2. Opcionalmente, use campos derivados para modificar qualquer um dos campos ad hoc de seu tipo e formato de Cadeia de Caracteres padrão para outro tipo ou formato.

    3. Selecione Salvar e continuar.

  5. Na etapa Configurações:

    Deixe as configurações como estão e selecione Salvar e concluir.

Consulte Visão geral das visualizações de dados para obter mais informações sobre como criar e editar uma visualização de dados. E quais componentes estão disponíveis para você usar na visualização de dados e como usar as configurações de segmento e sessões.

Configurar um projeto

O Analysis Workspace é uma ferramenta de navegador flexível que permite criar análises rapidamente e compartilhar insights com base em seus dados. Os projetos do Espaço de trabalho permitem combinar componentes de dados, tabelas e visualizações para criar a análise e compartilhar com qualquer pessoa na organização.

Para criar o projeto:

  1. Na interface do usuário do Customer Journey Analytics, selecione Projetos no menu superior.

  2. Selecione Projetos no painel de navegação esquerdo.

  3. Selecione Criar projeto.

  4. Selecione Projeto em branco.

  5. Selecione sua visualização de dados na lista.

  6. Para criar seu primeiro relatório, comece a arrastar e soltar dimensões e métricas na Tabela de forma livre do Painel. Incluindo as métricas ou dimensões baseadas em seus dados ad hoc.

Consulte Visão geral do Analysis Workspace para obter mais informações sobre como criar projetos e sua análise usando componentes, visualizações e painéis.

SUCCESS
Você concluiu todas as etapas. Você começou definindo quais dados ad hoc desejava coletar (arquivo CSV). Você usou o fluxo de trabalho para criar um conjunto de dados ad hoc e um esquema desse arquivo CSV. Você definiu uma conexão no Customer Journey Analytics para usar os dados ad hoc assimilados e outros dados. A definição da visualização de dados permite especificar qual dimensão e métricas usar e, por fim, criar seu primeiro projeto visualizando e analisando seus dados.
recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79