Documentação Customer Journey Analytics Guia do Customer Journey Analytics

Conectar e validar

Last update: Thu Jan 29 2026 00:00:00 GMT+0000 (Coordinated Universal Time)

Tópicos:
Data Views

Criado para:

Usuário

Esse caso de uso configura a conexão da ferramenta de BI com o Customer Journey Analytics, lista as visualizações de dados disponíveis e seleciona uma visualização de dados para usar.

Customer Journey Analytics

As instruções se referem a um ambiente de exemplo com os seguintes objetos:

Exibição de dados: C&C - Exibição de Dados 🅐.
Dimensões: Nome do Produto 🅑 e Categoria do Produto 🅒.
Métricas: Receita de Compra 🅓 e Compras 🅔.
Filtro: Produtos de Pesca 🅕.

Configuração do Customer Journey Analytics Base

Ao analisar os casos de uso, substitua esses objetos de exemplo por objetos apropriados para seu ambiente específico.

Ferramentas de BI

tabs

Power BI Desktop

Acesse as credenciais e os parâmetros necessários da interface do usuário do Experience Platform Query Service.
1. Navegue até a sandbox da Experience Platform.
2. Selecione Consultas no painel esquerdo.
3. Selecione a guia Credenciais na interface Consultas.
4. Selecione prod:cja no menu suspenso Banco de Dados.
Inicie o Power BI Desktop.
1. Na interface principal, selecione Obter dados de outras fontes.
2. Na caixa de diálogo Obter Dados:
  1. Procure e selecione banco de dados PostgreSQL.
  2. Selecione Conectar.
3. Na caixa de diálogo Banco de dados PostgreSQL:
  1. Use para copiar e colar os valores de Host e Porta do painel Consulta Credenciais em Expiração do Experience Platform, separadas por : como o valor do Servidor. Por exemplo: examplecompany.platform-query.adobe.io:80.
  2. Use para copiar e colar o valor do Banco de Dados do painel Consulta Credenciais em Expiração do Experience Platform. Adicione ?FLATTEN ao valor que você colar. Por exemplo, prod:cja?FLATTEN.
  3. Selecione DirectQuery como o modo de conectividade de dados.
  4. Selecione OK.
4. Na caixa de diálogo Banco de dados PostgreSQL - Banco de Dados:
  1. Use para copiar os valores de Nome de Usuário e Senha do painel Consulta Credenciais em Expiração do Experience Platform nos campos Nome de usuário e Senha. Se você estiver usando uma credencial sem expiração, use a senha da sua credencial sem expiração.
  2. Verifique se o menu suspenso do Selecione a qual nível aplicar essas configurações está definido como o Servidor definido anteriormente.
  3. Selecione Conectar.
5. Na caixa de diálogo Navegador, as visualizações de dados são recuperadas. Essa recuperação pode levar algum tempo. Depois de recuperado, você verá o seguinte no Power BI Desktop.
  1. Selecione public.cc_data_view na lista do painel esquerdo.
  2. Você tem duas opções:
    1. Selecione Carregar para continuar e concluir a instalação.
    2. Selecione Transformar Dados. Você verá uma caixa de diálogo em que poderá aplicar transformações opcionalmente como parte da configuração.
      - Selecione Fechar e Aplicar.
6. Após alguns instantes, public.cc_data_view será exibido no painel Dados. Selecione para mostrar dimensões e métricas.

Para NIVELAR ou não

O Power BI Desktop oferece suporte aos seguintes cenários para o parâmetro FLATTEN. Consulte Nivelar dados aninhados para obter mais informações.

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
parâmetro FLATTEN	Exemplo	Suportado	Observações
Nenhum	`prod:cja`
`?FLATTEN`	`prod:cja?FLATTEN`		Opção recomendada para usar!
`%3FFLATTEN`	`prod:cja%3FFLATTEN`		O Power BI Desktop exibe um erro: Não foi possível autenticar com as credenciais fornecidas. Tente novamente.

Mais informações

Tableau Desktop

Acesse as credenciais e os parâmetros necessários da interface do usuário do Experience Platform Query Service.
1. Navegue até a sandbox da Experience Platform.
2. Selecione Consultas no painel esquerdo.
3. Selecione a guia Credenciais na interface Consultas.
4. Selecione prod:cja no menu suspenso Banco de Dados.
Inicie o Tableau.
1. Selecione PostgreSQL no painel esquerdo abaixo de Para um Servidor. Se não estiver disponível, selecione Mais… e selecione PostgreSQL nos Conectores Instalados.
2. Na caixa de diálogo PostgreSQL, na guia General:
  1. Use para copiar e colar o Host do painel Consulta Credenciais em Expiração do Experience Platform no Servidor.
  2. Use para copiar e colar a Porta do painel Consulta Credenciais em Expiração do Experience Platform para a Porta.
  3. Use para copiar e colar o Banco de Dados do painel Consulta Credenciais em Expiração do Experience Platform no Banco de Dados. Adicione %3FFLATTEN ao valor que você colar. Por exemplo: prod:cja%3FFLATTEN.
  4. Selecione Nome de Usuário e Senha no menu suspenso Autenticação.
  5. Use para copiar e colar o Nome de Usuário do painel Consulta Credenciais em Expiração do Experience Platform para o Nome de Usuário.
  6. Use para copiar e colar a Senha do painel Consulta Credenciais em Expiração do Experience Platform para a Senha. Se você estiver usando uma credencial sem expiração, use a senha da sua credencial sem expiração.
  7. Verifique se Exigir SSL está marcado.
  8. Selecione Fazer logon.
  Você verá uma caixa de diálogo Solicitação em andamento enquanto o Tableau Desktop valida a conexão.
3. Na janela principal, você vê na página Data Source, no painel esquerdo:
  - O nome da conexão, abaixo de Conexões.
  - O nome do banco de dados, abaixo de Banco de Dados.
  - Uma lista de tabelas, abaixo de Tabela.
  1. Arraste a entrada cc_data_view e solte a entrada na exibição principal onde se lê Arraste tabelas aqui.
4. A janela principal exibe detalhes da exibição de dados do cc_data_view.

Para NIVELAR ou não

O Tableau Desktop oferece suporte aos seguintes cenários para o parâmetro FLATTEN. Consulte Nivelar dados aninhados para obter mais informações.

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
parâmetro FLATTEN	Exemplo	Suportado	Observações
Nenhum	`prod:cja`
`?FLATTEN`	`prod:cja?FLATTEN`
`%3FFLATTEN`	`prod:cja%3FFLATTEN`		Opção recomendada para usar. Observe que `%3FFLATTEN` é a versão de `?FLATTEN` codificada em URL.

Mais informações

Pesquisador

Acesse as credenciais e os parâmetros necessários da interface do usuário do Experience Platform Query Service.
1. Navegue até a sandbox da Experience Platform.
2. Selecione Consultas no painel esquerdo.
3. Selecione a guia Credenciais na interface Consultas.
4. Selecione prod:cja no menu suspenso Banco de Dados.
Fazer logon no Looker
1. Selecione Admin no painel esquerdo.
2. Selecione Conexões.
3. Selecione Adicionar conexão.
4. Na tela Conectar o banco de dados ao Pesquisador.
  1. Digite um Nome para sua conexão, por exemplo Example Looker Connection.
  2. Verifique se Todos os Projetos está selecionado como Escopo de Conexão.
  3. Selecione PostgreSQL 9.5+ como o Dialeto.
  4. Use para copiar e colar o valor de Host do painel Consulta Credenciais em Expiração do Experience Platform, como o valor de Host. Por exemplo: examplecompany.platform-query.adobe.io.
  5. Use para copiar e colar o valor de Porta do painel Consulta Credenciais em Expiração do Experience Platform, como o valor de Porta. Por exemplo: 80.
  6. Use para copiar e colar o valor do Banco de Dados do painel Consulta Credenciais em Expiração do Experience Platform como o valor do Banco de Dados. Adicione %3FFLATTEN ao valor que você colar. Por exemplo, prod:cja%3FFLATTEN.
  7. Use para copiar e colar o valor de Nome de Usuário do painel Consulta Credenciais em Expiração do Experience Platform como o valor de Nome de Usuário.
  8. Use para copiar e colar o valor de Senha do painel Consulta Credenciais em Expiração do Experience Platform como o valor de Senha.
  9. Selecione Expandir tudo em Configurações Opcionais.
  10. Defina Máximo de conexões por nó como 5.
  11. Verifique se SSL está habilitado.
  12. Selecione Testar para testar a conexão. Você deve ver um banner aparecer na parte superior da tela com uma mensagem como Sucesso, pode conectar JDBC ….
  13. Selecione Conectar para estabelecer e salvar a conexão.
5. Você vê a nova conexão na interface Conexões.
6. Selecione Esquerda de Administrador para ir para a navegação principal no painel esquerdo.
7. Selecione Desenvolver.
8. Selecione Projetos.
9. Selecione Novo Modelo em Projetos LookML.
10. Para garantir que você não afete outros usuários. selecione Enter Development Mode (Entrar no modo de desenvolvimento) quando solicitado.
11. Na experiência Criar Modelo:
  1. Em ➊, Selecione A Conexão De Banco De Dados:
    1. Selecione sua conexão de banco de dados em Selecionar conexão de banco de dados. Por exemplo: example_looker_connection.
    2. Nomeie seu projeto em Crie um novo Projeto LookML para este modelo. Para example: example_looker_project.
    3. Selecione Próximo.
  2. Em ➋Selecione Tabelas:
    1. Selecione público e certifique-se de que sua visualização de dados do Customer Journey Analytics está selecionada. Por exemplo: cc_data_view.
    2. Selecione Próximo.
  3. Em ➌, Selecione Chaves Primárias:
    1. Selecione Próximo.
  4. Em ➍, Selecione Explorações para Criar:
    1. Certifique-se de selecionar a exibição. Por exemplo: cc_data_view.view.
    2. Selecione Próximo.
  5. Em ➎Insira O Nome Do Modelo:
    1. Dê um nome ao seu modelo. Por exemplo: example_looker_model.
  6. Selecione Concluir e Explorar Dados.
Você foi redirecionado para a interface do Looker Explorar, pronta para explorar os dados.

Para NIVELAR ou não

O pesquisador dá suporte aos seguintes cenários para o parâmetro FLATTEN. Consulte Nivelar dados aninhados para obter mais informações.

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
parâmetro FLATTEN	Exemplo	Suportado	Observações
Nenhum	`prod:cja`
`?FLATTEN`	`prod:cja?FLATTEN`
`%3FFLATTEN`	`prod:cja%3FFLATTEN`		Opção recomendada para usar. Observe que `%3FFLATTEN` é a versão de `?FLATTEN` codificada em URL.

Mais informações

Jupyter Notebook

Acesse as credenciais e os parâmetros necessários da interface do usuário do Experience Platform Query Service.
1. Navegue até a sandbox da Experience Platform.
2. Selecione Consultas no painel esquerdo.
3. Selecione a guia Credenciais na interface Consultas.
4. Selecione prod:cja no menu suspenso Banco de Dados.
Configure um ambiente virtual Python dedicado para executar seu ambiente Jupyter Notebook.
Verifique se você instalou as bibliotecas necessárias em seu ambiente virtual:
- ipython-sql: pip install ipython-sql.
- psycopg2-binary: pip install psycopg-binary.
- sqlalchemy: pip install sqlalchemy.
Inicie o Jupyter Notebook a partir de seu ambiente virtual: jupyter notebook.
Crie um novo bloco de anotações ou baixe este bloco de anotações de exemplo.

Na primeira célula, insira e execute:

code language-none
`%config SqlMagic.style = '_DEPRECATED_DEFAULT'`

Em uma nova célula, insira os parâmetros de configuração da sua conexão. Use para copiar e colar valores do painel Consulta Credenciais em Expiração do Experience Platform nos valores necessários para os parâmetros de configuração. Por exemplo:

code language-none

import ipywidgets as widgets
from IPython.display import display

config_host = widgets.Text(description='Host:', value='example.platform-query-stage.adobe.io',
                        layout=widgets.Layout(width="600px"))
display(config_host)
config_port = widgets.IntText(description='Port:', value=80,
                           layout=widgets.Layout(width="200px"))
display(config_port)
config_db = widgets.Text(description='Database:', value='prod:cja',
                      layout=widgets.Layout(width="300px"))
display(config_db)
config_username = widgets.Text(description='Username:', value='EC582F955C8A79F70A49420E@AdobeOrg',
                            layout=widgets.Layout(width="600px"))
display(config_username)
config_password = widgets.Password(description='Password:', value='***',
                                layout=widgets.Layout(width="600px"))
display(config_password)

Execute a célula.
Use para copiar e colar a senha do painel Consulta Credenciais em Expiração do Experience Platform no campo Senha do Jupyter Notebook.

da Configuração do Jupter Notebook

Em uma nova célula, insira as instruções para carregar a extensão SQL, a biblioteca necessária e conectar-se ao Customer Journey Analytics.

code language-python
`%load_ext sql from sqlalchemy import create_engine %sql postgresql://{config_username.value}:{config_password.value}@{config_host.value}:{config_port.value}/{config_db.value}?sslmode=require`

Execute o shell. Você não deve ver nenhuma saída, mas a célula deve ser executada sem nenhum aviso.

Etapa 4 da Configuração do Jupyer Notebook

Em uma nova chamada, insira as instruções para obter uma lista de visualizações de dados disponíveis com base na conexão.

code language-python

%%sql
SELECT n.nspname as "Schema",
   c.relname as "Name",
   CASE c.relkind WHEN 'r' THEN 'table' WHEN 'v' THEN 'view' WHEN 'm' THEN 'materialized view' WHEN 'i' THEN 'index' WHEN 'S' THEN 'sequence' WHEN 's' THEN 'special' WHEN 't' THEN 'TOAST table' WHEN 'f' THEN 'foreign table' WHEN 'p' THEN 'partitioned table' WHEN 'I' THEN 'partitioned index' END as "Type",
   pg_catalog.pg_get_userbyid(c.relowner) as "Owner"
FROM pg_catalog.pg_class c
LEFT JOIN pg_catalog.pg_namespace n ON n.oid = c.relnamespace
WHERE c.relkind IN ('v','')
   AND n.nspname <> 'pg_catalog'
   AND n.nspname !~ '^pg_toast'
   AND n.nspname <> 'information_schema'
   AND pg_catalog.pg_table_is_visible(c.oid)
   AND c.relname NOT LIKE '%test%'
   AND c.relname NOT LIKE '%ajo%'
ORDER BY 1,2;

Execute o shell. Você deve ver a saída simular na captura de tela abaixo.

Etapa 5 da Configuração do Jupyter Notebook

Você deve ver o cc_data_view na lista de visualizações de dados.

Para NIVELAR ou não

O Jupyter Notebook dá suporte aos seguintes cenários para o parâmetro FLATTEN. Consulte Nivelar dados aninhados para obter mais informações.

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
parâmetro FLATTEN	Exemplo	Suportado	Observações
Nenhum	`prod:cja`
`?FLATTEN`	`prod:cja?FLATTEN`
`%3FFLATTEN`	`prod:cja%3FFLATTEN`		Opção recomendada para usar. Observe que `%3FFLATTEN` é a versão de `?FLATTEN` codificada em URL.

Mais informações

RStudio

Acesse as credenciais e os parâmetros necessários da interface do usuário do Experience Platform Query Service.
1. Navegue até a sandbox da Experience Platform.
2. Selecione Consultas no painel esquerdo.
3. Selecione a guia Credenciais na interface Consultas.
4. Selecione prod:cja no menu suspenso Banco de Dados.
Iniciar RStudio.
Crie um novo arquivo do R Markdown ou baixe este arquivo de exemplo do R Markdown.

Na primeira parte, insira as seguintes instruções entre {r} ` e ` . Use para copiar e colar valores do painel Consulta Credenciais em Expiração do Experience Platform para os valores necessários para os vários parâmetros, como host, dbname e user. Por exemplo:

code language-r

library(rstudioapi)
library(DBI)
library(dplyr)
library(tidyr)
library(RPostgres)
library(ggplot2)

host <- rstudioapi::showPrompt(title = "Host", message = "Host", default = "orangestagingco.platform-query-stage.adobe.io")
dbname <- rstudioapi::showPrompt(title = "Database", message = "Database", default = "prod:cja?FLATTEN")
user <- rstudioapi::showPrompt(title = "Username", message = "Username", default = "EC582F955C8A79F70A49420E@AdobeOrg")
password <- rstudioapi::askForPassword(prompt = "Password")

Execute o pedaço. Você é solicitado a fornecer Host, Banco de Dados e Usuário. Basta aceitar os valores fornecidos como parte da etapa anterior.
Use para copiar e colar a senha do painel Consulta Credenciais em Expiração do Experience Platform no prompt da caixa de diálogo Senha do RStudio.

Crie uma nova parte e insira as seguintes instruções entre ```` {r} e .

code language-r
`con <- dbConnect( RPostgres::Postgres(), host = host, port = 80, dbname = dbname, user = user, password = password, sslmode = 'require' )`

Execute o pedaço. Você não deve ver nenhuma saída se a conexão for bem-sucedida.

Crie uma nova parte e insira as seguintes instruções entre ```` {r} e .

code language-r
`views <- dbListTables(con) print(views)`

Execute o pedaço. Você deve ver character(0) como a única saída.

Crie uma nova parte e insira as seguintes instruções entre ```` {r} e .

code language-r
`glimpse(dv)`

Execute o pedaço. Você deve ver a saída simular na captura de tela abaixo.

da configuração do Studio

Para NIVELAR ou não

O RStudio oferece suporte aos seguintes cenários para o parâmetro FLATTEN. Consulte Nivelar dados aninhados para obter mais informações.

table 0-row-4 1-row-4 2-row-4 3-row-4 3-align-center 8-align-center 13-align-center 18-align-center
parâmetro FLATTEN	Exemplo	Suportado	Observações
Nenhum	`prod:cja`
`?FLATTEN`	`prod:cja?FLATTEN`		Opção recomendada para usar.
`%3FFLATTEN`	`prod:cja%3FFLATTEN`

Mais informações

recommendation-more-help

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