[Beta]{class="badge informative"}
Espelhar e usar dados baseados em modelo
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.
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.
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:
-
Faça logon no Google BigQuery.
-
Selecione BigQuery > Studio.
-
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.
Para inspecionar os dados:
-
Selecione Consulta.
-
Execute uma consulta de exemplo no editor de consultas, onde
project
é o nome do seu projeto edatasets
é o nome dos seus conjuntos de dados:code language-sql SELECT * FROM `project.datasets.eventdata` LIMIT 100
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:
-
Execute a seguinte instrução SQL no editor de consultas para verificar a configuração, em que
project
é o nome do seu projeto edatasets
é 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;
-
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 edatasets
é 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:
-
Na interface da Adobe Experience Platform, no painel à esquerda, selecione Esquemas em Gerenciamento de dados.
-
Selecione Criar esquema.
-
No menu suspenso, selecione Baseado em modelo.
-
Se você vir um pop-up com a opção para selecionar entre Criar manualmente ou Carregar um arquivo DDL:
-
Selecione Criar manualmente.
-
Selecione Próximo.
-
-
Na interface Esquemas > Criar esquema baseado em modelo:
-
Insira um nome para exibição do esquema. Por exemplo:
Sample Event Feed Schema
. -
Insira uma Descrição. Por exemplo:
Sample event feed schema for a model-based schema
. -
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).
-
Selecione Concluir.
-
-
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.
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.
-
Selecione
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 orders
Orders
Inteiro pagename
Page Name
String personid
Person Id
String
Selecione CRMID para o namespace de Identidade.revenueamount
Revenue Amount
Duplo timestamp
Timestamp
DateTime trackingcode
Tracking Code
String -
O campo id está configurado como Descritor de versão.
-
O campo personid está configurado, junto com carimbo de data/hora como Chave primária. Selecione
O campo personid também está configurado como uma Identidade, com CRMID como o Namespace de identidade.
-
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.
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á.
-
-
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:
- Selecione Fontes.
- Selecione ou procure por Google BigQuery.
- 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.
-
Especifique um Nome da conta e (opcional) Descrição.
-
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.
-
Selecionar Conectar à origem
Sua conexão foi verificada. Um
-
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:
-
Selecione a tabela na lista de tabelas. Por exemplo: eventdata.
Você verá uma amostra dos dados exibidos para verificação.
-
Clique em Avançar para continuar.
Detalhes do fluxo de dados
Na etapa detalhes do fluxo de dados:
-
Selecione Habilitar captura de dados de alteração. Uma caixa de informações Alterar requisito de captura de dados é exibida com mais informações.
-
Selecione Novo conjunto de dados para Conjunto de dados de destino para criar um novo conjunto de dados que contenha os dados espelhados.
-
Insira um Nome do conjunto de dados de saída. Por exemplo:
event-data-mirror
. -
Selecione o esquema baseado em modelo criado anteriormente no menu suspenso Esquema. Por exemplo: Exemplo de esquema de feed de eventos.
-
Especifique outros detalhes.
-
Selecione Próximo.
Mapeamento
Na etapa Mapeamento:
-
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).
-
Se todos os campos estiverem mapeados corretamente, selecione Avançar para continuar.
Agendamento
Na etapa Agendamento:
-
Especifique a Frequência e o Intervalo para agendar a sincronização dos dados espelhados.
-
Especifique a Hora de início para o agendamento.
-
Clique em Avançar para continuar.
Consulte a seção
Na etapa Revisão.
-
Revise a configuração do conector de origem.
-
Selecione Concluir. Você é direcionado para o fluxo de dados configurado.
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:
-
Selecione Conexões do menu Gerenciamento de Dados.
-
Selecione Criar nova conexão.
-
Especifique o Nome da conexão, Sandbox, Número médio de eventos diários e outros parâmetros opcionais.
-
Selecione Adicionar conjuntos de dados.
-
Na etapa Selecionar conjuntos de dados de Adicionar conjuntos de dados:
-
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.
-
Adicione conjuntos de dados adicionais que sejam relevantes para a conexão.
-
Selecione Próximo.
-
-
Na etapa Configurações do conjunto de dados de Adicionar conjuntos de dados:
Para o conjunto de dados baseado em modelo event-data-mirror
-
Selecione Evento como o Tipo de conjunto de dados.
-
Selecione o campo PersonId como a ID da pessoa.
-
Carimbo de data/hora é preenchido automaticamente como Carimbo de data/hora.
-
Selecione Outros como o tipo de fonte de dados.
-
Insira
Google BigQuery Event Data
como a descrição da fonte de dados. -
Especifique outros detalhes, como Importar todos os dados novos e Preencher retroativamente todos os dados existentes.
Opcionalmente, especifique detalhes para outros conjuntos de dados.
-
-
Selecione Adicionar conjuntos de dados.
-
-
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:
-
Na interface do Customer Journey Analytics, selecione Visualizações de dados, opcionalmente em Gerenciamento de dados, no menu superior.
-
Selecione Criar nova visualização de dados.
-
Na etapa Configurar:
-
Selecione a conexão na lista Conexão.
-
Nomeie e (opcionalmente) descreva a conexão.
-
Selecione Salvar e continuar.
-
-
Na etapa Componentes:
-
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:
-
Selecione Conjuntos de dados de evento.
-
Selecione Campos adhoc e baseados em modelo.
-
Arraste e solte campos dos esquemas baseados em modelo para METRICS ou DIMENSIONS.
-
-
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.
-
Selecione Criar campo derivado.
-
No editor de campo derivado:
-
Defina um novo campo
Revenue Amount (Numeric)
, como abaixo. -
Selecione Salvar.
-
-
Arraste o novo campo derivado Valor de receita (Numérico) e solte o campo em MÉTRICAS.
-
-
Selecione Salvar e continuar.
-
-
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:
-
Na interface do Customer Journey Analytics, selecione Workspace no menu superior.
-
Selecione Projetos no painel de navegação esquerdo.
-
Selecione Criar projeto. No pop-up:
-
Selecione Projeto Workspace em branco.
-
Selecione Criar.
-
-
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.
-
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.
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.