[Beta]{class="badge informative"}

Espelhar e usar dados baseados em modelo

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.

Este guia de início rápido explica como usar o Experience Platform Data Mirror for Customer Journey Analytics para espelhar dados baseados em modelo a partir de uma solução nativa de data warehouse no Adobe Experience Platform. E então usar aqueles dados no Customer Journey Analytics.

Para realizar esse caso de uso, é necessário:

  • Use uma solução nativa de data warehouse para armazenar dados que você deseja espelhar no Experience Platform. Em seguida, use esses dados no Customer Journey Analytics para relatar e analisar.

  • Configure um esquema no Experience Platform para definir o modelo (esquema) dos dados que você deseja espelhar.

  • Use um conector de origem no Experience Platform para obter seus dados espelhados em um conjunto de dados.

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

  • Configurar uma visualização de dados no Customer Journey Analytics para definir métricas e dimensões que você deseja usar no Analysis Workspace.

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

O Experience Platform Data Mirror para Customer Journey Analytics requer esquemas baseados em modelo.

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

Usar uma solução nativa de data warehouse

Este guia de início rápido usa o Google BigQuery como a solução nativa de data warehouse. Outras soluções com suporte são Snowflake e Azure Databricks.

Em Google BigQuery, os seguintes dados de exemplo são armazenados e atualizados regularmente em uma tabela chamada eventdata.

Detalhes de dados de evento de amostra
table 0-row-7 1-row-7 2-row-7 3-row-7 4-row-7 5-row-7 6-row-7 7-row-7 8-row-7 9-row-7 10-row-7 11-row-7 12-row-7 13-row-7 14-row-7 15-row-7 16-row-7 17-row-7 18-row-7 19-row-7 20-row-7 1-align-left 2-align-right 3-align-left 4-align-left 5-align-left 6-align-right 7-align-left 9-align-left 10-align-right 11-align-left 12-align-left 13-align-left 14-align-right 15-align-left 17-align-left 18-align-right 19-align-left 20-align-left 21-align-left 22-align-right 23-align-left 25-align-left 26-align-right 27-align-left 28-align-left 29-align-left 30-align-right 31-align-left 33-align-left 34-align-right 35-align-left 36-align-left 37-align-left 38-align-right 39-align-left 41-align-left 42-align-right 43-align-left 44-align-left 45-align-left 46-align-right 47-align-left 49-align-left 50-align-right 51-align-left 52-align-left 53-align-left 54-align-right 55-align-left 57-align-left 58-align-right 59-align-left 60-align-left 61-align-left 62-align-right 63-align-left 65-align-left 66-align-right 67-align-left 68-align-left 69-align-left 70-align-right 71-align-left 73-align-left 74-align-right 75-align-left 76-align-left 77-align-left 78-align-right 79-align-left 81-align-left 82-align-right 83-align-left 84-align-left 85-align-left 86-align-right 87-align-left 89-align-left 90-align-right 91-align-left 92-align-left 93-align-left 94-align-right 95-align-left 97-align-left 98-align-right 99-align-left 100-align-left 101-align-left 102-align-right 103-align-left 105-align-left 106-align-right 107-align-left 108-align-left 109-align-left 110-align-right 111-align-left 113-align-left 114-align-right 115-align-left 116-align-left 117-align-left 118-align-right 119-align-left 121-align-left 122-align-right 123-align-left 124-align-left 125-align-left 126-align-right 127-align-left 129-align-left 130-align-right 131-align-left 132-align-left 133-align-left 134-align-right 135-align-left 137-align-left 138-align-right 139-align-left 140-align-left 141-align-left 142-align-right 143-align-left 145-align-left 146-align-right 147-align-left 148-align-left 149-align-left 150-align-right 151-align-left 153-align-left 154-align-right 155-align-left 156-align-left 157-align-left 158-align-right 159-align-left 161-align-left 162-align-right 163-align-left 164-align-left 165-align-left 166-align-right 167-align-left
carimbo de data e hora id pagename personid trackingcode ordens valor de receita
03/2025-06T19:15:39+00:00 10001 página inicial person-1abc123 abc123
03/2025-06T19:15:39+00:00 10002 página de confirmação person-1abc123 1 174,25
03/2025-06T19:15:39+00:00 10003 página inicial person-2def123 def123
03/2025-06T19:15:39+00:00 10004 página inicial person-3ghi123 ghi123
03/2025-06T19:15:39+00:00 10005 página de confirmação person-3ghi123 1 149,25
03/2025-06T19:15:39+00:00 10006 página inicial person-4abc456 abc456
03/2025-06T19:15:39+00:00 10007 página inicial person-5def456 def456
03/2025-06T19:15:39+00:00 10008 página inicial pessoa-6ghi456 ghi456
03/2025-06T19:15:39+00:00 10009 página de confirmação pessoa-6ghi456 1 159,25
03/2025-06T19:15:39+00:00 10010 página inicial person-7abc789 abc789
03/2025-06T19:15:39+00:00 10011 página inicial pessoa-8def789 def789
03/2025-06T19:15:39+00:00 10012 página inicial pessoa-9ghi789 ghi789
03/2025-06T19:15:39+00:00 10013 página de confirmação pessoa-9ghi789 1 124,25
03/2025-06T19:15:39+00:00 10014 página inicial person-10abc987 abc987
03/2025-06T19:15:39+00:00 10015 página inicial person-11def987 def987
03/2025-06T19:15:39+00:00 10016 página inicial person-12ghi987 ghi987
03/2025-06T19:15:39+00:00 10017 página inicial person-13abc654 abc654
03/2025-06T19:15:39+00:00 10018 página inicial person-14def654 def654
03/2025-06T19:15:39+00:00 10019 página inicial person-15ghi654 ghi654
03/2025-06T19:15:39+00:00 10020 página de confirmação person-15ghi654 1 174,25

Os dados são armazenados em uma tabela de banco de dados com um schema associado. Para inspecionar a tabela de banco de dados:

  1. Faça logon no Google BigQuery.

  2. Selecione BigQuery > Studio.

  3. Selecione o projeto, o conjunto de dados e a tabela. Na guia Schema, você verá uma visão geral do esquema para os dados do evento.

    Google BigQuery - Esquema

Para inspecionar os dados:

  1. Selecione Consulta.

  2. Execute uma consulta de exemplo no editor de consultas, onde project é o nome do seu projeto e datasets é o nome dos seus conjuntos de dados:

    code language-sql
    SELECT * FROM `project.datasets.eventdata` LIMIT 100
    

    Google BigQuery - Exemplo de consulta

Para o Experience Platform Data Mirror para Customer Journey Analytics, as tabelas na solução nativa de data warehouse devem estar habilitadas para o histórico de alterações. Para verificar se a tabela está ativada para o histórico de alterações:

  1. Execute a seguinte instrução SQL no editor de consultas para verificar a configuração, em que project é o nome do seu projeto e datasets é o nome dos seus conjuntos de dados:

    code language-sql
    SELECT
       table_name,
       MAX(CASE WHEN option_name = 'enable_change_history' THEN option_value END) AS enable_change_history
    FROM `project.datasets.INFORMATION_SCHEMA.TABLE_OPTIONS`
    WHERE table_name = 'eventdata'
    GROUP BY table_name
    ORDER BY table_name;
    
  2. Se o resultado não for TRUE, use a seguinte instrução SQL para habilitar o histórico de alterações, onde project é o nome do seu projeto e datasets é o nome dos seus conjuntos de dados:

    code language-sql
    ALTER TABLE `project.datasets.eventdata`
    SET OPTIONS (enable_change_history = TRUE);
    

Os dados na tabela na solução nativa de data warehouse estão prontos para o Experience Platform Data Mirror para Customer Journey Analytics.

Configurar um esquema

Para espelhar dados no Experience Platform, primeiro defina o esquema para os dados. Todos os dados que você deseja espelhar no Experience Platform e que usam o Experience Platform Data Mirror para Customer Journey Analytics devem estar em conformidade com um esquema baseado em modelo.

Defina um esquema que modele esses dados. Para configurar o esquema:

  1. Na interface da Adobe Experience Platform, no painel à esquerda, selecione Esquemas em Gerenciamento de dados.

  2. Selecione Criar esquema.

  3. No menu suspenso, selecione Baseado em modelo.

  4. Se você vir um pop-up com a opção para selecionar entre Criar manualmente ou Carregar um arquivo DDL:

    1. Selecione Criar manualmente.

      Configuração de esquema - Criar manualmente

    2. Selecione Próximo.

  5. Na interface Esquemas > Criar esquema baseado em modelo:

    1. Insira um nome para exibição do esquema. Por exemplo: Sample Event Feed Schema.

    2. Insira uma Descrição. Por exemplo: Sample event feed schema for a model-based schema.

    3. Selecione Série temporal como o Comportamento do esquema. Você seleciona Série temporal para dados baseados em série temporal e Registro para dados baseados em registro. O comportamento define a estrutura do schema e as propriedades incluídas.

      O Experience Platform Data Mirror for Customer Journey Analytics é usado principalmente para dados de séries de tempo (por exemplo, dados de evento).

      Configuração de esquema

    4. Selecione Concluir.

  6. Na interface Esquemas > Esquema de feed de eventos de amostra, você verá um aviso de que os esquemas baseados em modelo oferecem suporte à assimilação como linhas de alteração.

    Configuração de esquema

    A assimilação como linhas de alteração também é conhecida como captura de dados de alteração (CDC). Para ser compatível com a captura de dados de alteração, o esquema exige:

    • Chave primária.
    • Descritor de versão.
    • Descritor de carimbo de data e hora para dados de série temporal.
  7. Selecione AddCircle ao lado de Esquema do feed de eventos de exemplo para começar a adicionar campos ao esquema. Adicione os seguintes campos com tipo de dados e atributos adicionais ao esquema.

    table 0-row-4 1-row-4 2-row-4 3-row-4 4-row-4 5-row-4 6-row-4 7-row-4
    Nome do campo Nome de exibição Tipo Atributos adicionais
    id Id Inteiro Descritor de versão de SelectBox
    orders Orders Inteiro
    pagename Page Name String
    personid Person Id String SelectBox Chave primária
    SelectBox Identidade
    Selecione CRMID para o namespace de Identidade.
    revenueamount Revenue Amount Duplo
    timestamp Timestamp DateTime SelectBox Descritor de carimbo de data/hora
    trackingcode Tracking Code String
    • O campo id está configurado como Descritor de versão.

      Descritor de versão

    • O campo personid está configurado, junto com carimbo de data/hora como Chave primária. Selecione Adicionar Criar chave primária composta para criar uma chave composta.

      Chave composta

      O campo personid também está configurado como uma Identidade, com CRMID como o Namespace de identidade.

      Descritor de pessoa

    • O campo carimbo de data/hora está configurado, junto com o campo personid como a Chave primária. O campo carimbo de data/hora também está configurado como descritor de carimbo de data/hora. Você só precisa definir um campo como Descritor de carimbo de data/hora para dados baseados em modelo de série temporal.

      Descritor de carimbo de data/hora

    Se você tiver definido corretamente Chave primária, Descritor de versão e Descritor de carimbo de data/hora, o aviso na parte superior da definição do esquema desaparecerá.

  8. Selecione Salvar para salvar o esquema.

Usar um conector de origem

Use um conector de origem para conectar a solução nativa de data warehouse à Experience Platform.

Na interface do Experience Platform:

  1. Selecione Fontes.
  2. Selecione ou procure por Google BigQuery.
  3. Selecione Adicionar dados.

O assistente de Adição de dados o orienta pelas etapas a seguir para conectar os dados da tabela no Google BigQuery ao Experience Platform.

Autenticação

Na etapa Autenticação, selecione:

  • Conta existente quando você já tiver uma configuração de conta para o Google BigQuery. Continue na etapa Selecionar dados.

  • Nova conta quando precisar se conectar ao Google BigQuery.

    1. Especifique um Nome da conta e (opcional) Descrição.

    2. Selecione seu Tipo de autenticação: Autenticação Básica ou Autenticação de Serviço. Com base na sua seleção, forneça a entrada necessária.

    3. Selecionar Conectar à origem

      Google BigQuery - Autenticação

      Sua conexão foi verificada. Um CheckmarkCircleGreen Connected indicou uma conexão bem-sucedida.

    4. Selecione Próximo.

    Consulte a documentação do Experience Platform para obter detalhes sobre como conectar e autenticar quando você usa o Azure Databricks ou o conector Snowflake.

Selecionar dados

Na etapa Selecionar dados:

  1. Selecione a tabela na lista de tabelas. Por exemplo: eventdata.

    Experience Platform - Source Connector - Selecionar dados

    Você verá uma amostra dos dados exibidos para verificação.

  2. Clique em Avançar para continuar.

Detalhes do fluxo de dados

Na etapa detalhes do fluxo de dados:

  1. Selecione Habilitar captura de dados de alteração. Uma caixa de informações Alterar requisito de captura de dados é exibida com mais informações.

  2. Selecione Novo conjunto de dados para Conjunto de dados de destino para criar um novo conjunto de dados que contenha os dados espelhados.

  3. Insira um Nome do conjunto de dados de saída. Por exemplo: event-data-mirror.

  4. Selecione o esquema baseado em modelo criado anteriormente no menu suspenso Esquema. Por exemplo: Exemplo de esquema de feed de eventos.

    Experience Platform - Conector Source - Detalhes do fluxo de dados

  5. Especifique outros detalhes.

  6. Selecione Próximo.

Mapeamento

Na etapa Mapeamento:

  1. Mapeie os campos. Do esquema no Google BigQuery (dados do Source) para os campos no esquema que você definiu no Experience Platform (campos de Destino).

    Experience Platform - Source Connector - Mapeamento

  2. Se todos os campos estiverem mapeados corretamente, selecione Avançar para continuar.

Agendamento

Na etapa Agendamento:

  1. Especifique a Frequência e o Intervalo para agendar a sincronização dos dados espelhados.

  2. Especifique a Hora de início para o agendamento.

    Experience Platform - Source Connector - Agendando

  3. Clique em Avançar para continuar.

Consulte a seção

Na etapa Revisão.

  1. Revise a configuração do conector de origem.

    Experience Platform - Source Connector - Revisão

  2. Selecione Concluir. Você é direcionado para o fluxo de dados configurado.

    Experience Platform - Conector Source - Fluxo de dados

Configurar uma conexão

Neste guia de início rápido, você cria uma nova conexão para usar os dados espelhados do Experience Platform. Como alternativa, adicione os dados espelhados a uma conexão existente.

Na interface do Customer Journey Analytics:

  1. Selecione Conexões do menu Gerenciamento de Dados.

  2. Selecione Criar nova conexão.

  3. Especifique o Nome da conexão, Sandbox, Número médio de eventos diários e outros parâmetros opcionais.

  4. Selecione Adicionar conjuntos de dados.

    1. Na etapa Selecionar conjuntos de dados de Adicionar conjuntos de dados:

      1. Selecione o conjunto de dados que contém os dados espelhados. Por exemplo: event-data-mirror. O conjunto de dados tem Modelo como o tipo de conjunto de dados.

        CJA - Conexões - Adicionar conjunto de dados

      2. Adicione conjuntos de dados adicionais que sejam relevantes para a conexão.

      3. Selecione Próximo.

    2. Na etapa Configurações do conjunto de dados de Adicionar conjuntos de dados:

      Para o conjunto de dados baseado em modelo event-data-mirror

      1. Selecione Evento como o Tipo de conjunto de dados.

      2. Selecione o campo PersonId como a ID da pessoa.

      3. Carimbo de data/hora é preenchido automaticamente como Carimbo de data/hora.

      4. Selecione Outros como o tipo de fonte de dados.

      5. Insira Google BigQuery Event Data como a descrição da fonte de dados.

      6. Especifique outros detalhes, como Importar todos os dados novos e Preencher retroativamente todos os dados existentes.

        CJA - Conexão - Configurações do conjunto de dados

      Opcionalmente, especifique detalhes para outros conjuntos de dados.

    3. Selecione Adicionar conjuntos de dados.

  5. Selecione Salvar.

Depois de criar uma conexão, você poderá executar várias tarefas de gerenciamento. Como seleção e combinação de conjuntos de dados, verificação do status dos conjuntos de dados de uma conexão e do status da assimilação de dados e muito mais.

Configurar uma visualização de dados

Para criar a visualização de dados:

  1. Na interface 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 a conexão na lista Conexão.

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

    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 do conjunto de dados que contém os dados espelhados. Para acessar esses campos:

      1. Selecione Conjuntos de dados de evento.

      2. Selecione Campos adhoc e baseados em modelo.

      3. Arraste e solte campos dos esquemas baseados em modelo para METRICS ou DIMENSIONS.

        Adicionar campo baseado em modelo como componentes

    2. Defina campos derivados para campos que não têm o tipo adequado, não estão no formato adequado ou você deseja modificar por outros motivos. Por exemplo, para Valor de receita.

      1. Selecione Criar campo derivado.

      2. No editor de campo derivado:

        1. Defina um novo campo Revenue Amount (Numeric), como abaixo.

          CJA - Visualização de dados - Campo derivado

        2. Selecione Salvar.

      3. Arraste o novo campo derivado Valor de receita (Numérico) e solte o campo em MÉTRICAS.

        CJA - Visualização de dados - Campos baseados em modelo

    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 Customer Journey Analytics, selecione Workspace no menu superior.

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

  3. Selecione Criar projeto. No pop-up:

    1. Selecione Projeto Workspace em branco.

    2. Selecione Criar.

  4. No espaço de trabalho do Novo projeto, verifique se a sua visualização de dados está selecionada. Este modo de exibição de dados está vinculado à conexão que contém os dados espelhados.

  5. Para criar seu primeiro relatório, arraste e solte dimensões e métricas na Tabela de forma livre do painel Forma livre. Por exemplo, arraste Valor de receita (Numérico) até Arraste uma métrica aqui. E arraste PersonId e solte o campo no cabeçalho da primeira coluna. Faça outros ajustes como achar conveniente.

    O resultado final é uma visão geral dos perfis e suas receitas com base em dados espelhados originados de uma tabela do Google BigQuery.

    Workspace - Projeto de Exemplo

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 espelhados desejava coletar (esquema) de uma solução nativa de data warehouse. E onde armazenar esses dados (conjunto de dados) na Experience Platform. Você configurou o conector de origem apropriado para fornecer os dados espelhados no Experience Platform. Você definiu uma conexão no Customer Journey Analytics para usar os dados do evento espelhados e (opcionalmente) outros dados. Sua definição de visualização de dados permitiu especificar quais dimensões e métricas usar com base nos dados espelhados. E, por fim, você criou seu primeiro projeto visualizando e analisando seus dados espelhados.
recommendation-more-help
080e5213-7aa2-40d6-9dba-18945e892f79