Conexión y validación

Este caso de uso configura la conexión de la herramienta BI a Customer Journey Analytics, enumera las vistas de datos disponibles y selecciona una vista de datos para usar.

Customer Journey Analytics

Las instrucciones hacen referencia a un entorno de ejemplo con los siguientes objetos:

  • Vista de datos: C&C - Vista de datos 🅐.
  • Dimensiones: Nombre de producto 🅑 y Categoría de producto 🅒.
  • Métricas: Ingresos de compras 🅓 y Compras 🅔.
  • Filtro: Productos de pesca 🅕.

Configuración de base de Customer Journey Analytics

Cuando revise los casos de uso, reemplace estos objetos de ejemplo por objetos adecuados para su entorno específico.

Herramientas de BI
tabs
Escritorio de Power BI
  1. Acceda a las credenciales y los parámetros necesarios desde la interfaz de usuario del servicio de consultas de Experience Platform.

    1. Vaya a la zona protegida de Experience Platform.

    2. Seleccione Consultas Consultas del carril izquierdo.

    3. Seleccione la ficha Credenciales en la interfaz de Consultas.

    4. Seleccione prod:cja del menú desplegable Base de datos.

      Credenciales del servicio de consulta

  2. Inicie Power BI Desktop.

    1. En la interfaz principal, seleccione Obtener datos de otras fuentes.

    2. En el diálogo Obtener datos:
      Base de datos PostgreSQL de Power BI

      1. Busque y seleccione base de datos PostgreSQL.
      2. Seleccione Conectar.
    3. En el diálogo Base de datos PostgreSQL:
      Configuración de base de datos y servidor de escritorio de PowerBI

      1. Use Copiar para copiar y pegar los valores de Host y Puerto del panel Consulta Credenciales que caducan de Experience Platform, separados por : como valor de Servidor. Por ejemplo: examplecompany.platform-query.adobe.io:80.
      2. Use Copiar para copiar y pegar el valor Base de datos del panel Consulta Credenciales que caducan de Experience Platform. Agregue ?FLATTEN al valor que pegue. Por ejemplo, prod:cja?FLATTEN.
      3. Seleccione DirectQuery como modo de conectividad de datos.
      4. Seleccione Aceptar.
    4. En el cuadro de diálogo Base de datos PostgreSQL - Base de datos:
      Usuario y contraseña de PowerBI Desktop

      1. Use Copiar para copiar los valores de Nombre de usuario y Contraseña del panel Consulta Credenciales que caducan de Experience Platform en los campos Nombre de usuario y Contraseña. Si usa una credencial que no caduca, use la contraseña de la credencial que no caduca.
      2. Asegúrese de que el menú desplegable de Seleccione el nivel en el que aplicar esta configuración a está establecido en el Servidor que ha definido anteriormente.
      3. Seleccione Conectar.
    5. En el cuadro de diálogo Navegador, se recuperan las vistas de datos. Esta recuperación puede tardar un poco. Una vez recuperado, verá lo siguiente en Power BI Desktop.
      Datos de carga de escritorio de Power BI

      1. Seleccione public.cc_data_view de la lista del panel izquierdo.

      2. Tiene dos opciones:

        1. Seleccione Cargar para continuar y finalizar la instalación.
        2. Seleccione Transformar datos. Verá un cuadro de diálogo en el que, opcionalmente, puede aplicar transformaciones como parte de la configuración.
          Datos de transformación de escritorio de Power BI
          • Seleccione Cerrar y aplicar.
    6. Después de un tiempo, public.cc_data_view se mostrará en el panel Datos. Seleccione ChevronRight para mostrar dimensiones y métricas.
      Datos Cargados Del Servidor De Escritorio De Power BI

Para ACOPLAR o no

Power BI Desktop admite los siguientes escenarios para el parámetro FLATTEN. Consulte Acoplar datos anidados para obtener más información.

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 Ejemplo Admitido Observaciones
Ninguno prod:cja Círculo de verificación
?FLATTEN prod:cja?FLATTEN Círculo de verificación Opción recomendada para usar!
%3FFLATTEN prod:cja%3FFLATTEN CerrarCírculo Power BI Desktop muestra un error: No se pudo autenticar con las credenciales proporcionadas. Inténtelo de nuevo.

Más información

Escritorio Tableau
  1. Acceda a las credenciales y los parámetros necesarios desde la interfaz de usuario del servicio de consultas de Experience Platform.

    1. Vaya a la zona protegida de Experience Platform.

    2. Seleccione Consultas Consultas del carril izquierdo.

    3. Seleccione la ficha Credenciales en la interfaz de Consultas.

    4. Seleccione prod:cja del menú desplegable Base de datos.

      Credenciales del servicio de consulta

  2. Inicie Tableau.

    1. Seleccione PostgreSQL del carril izquierdo debajo de A un servidor. Si no está disponible, seleccione Más… y seleccione PostgreSQL de los Conectores instalados.
      Conectores Tableau

    2. En el cuadro de diálogo PostgreSQL, en la ficha General:
      Cuadro de diálogo de inicio de sesión en Tableau

      1. Use Copiar para copiar y pegar el host del panel Consulta Credenciales que caducan de Experience Platform en el Servidor.
      2. Use Copiar para copiar y pegar el puerto del panel Consulta Credenciales que caducan de Experience Platform en el puerto.
      3. Use Copiar para copiar y pegar la base de datos del panel Consulta Credenciales que caducan de Experience Platform en la base de datos. Agregue %3FFLATTEN al valor que pegue. Por ejemplo: prod:cja%3FFLATTEN.
      4. Seleccione Nombre de usuario y Contraseña del menú desplegable Autenticación.
      5. Use Copiar para copiar y pegar el nombre de usuario del panel Consulta Credenciales de caducidad de Experience Platform en el nombre de usuario.
      6. Use Copiar para copiar y pegar la contraseña del panel Consulta Credenciales que caducan de Experience Platform en Contraseña. Si usa una credencial que no caduca, use la contraseña de la credencial que no caduca.
      7. Asegúrese de comprobar Requerir SSL.
      8. Seleccione Iniciar sesión.

      Verá un cuadro de diálogo Solicitud en curso mientras Tableau Desktop valida la conexión.

    3. En la ventana principal, verá en la página Source de datos, en el panel izquierdo:

      • Nombre de la conexión, debajo de Connections.
      • Nombre de la base de datos, debajo de Database.
      • Una lista de tablas, debajo de Tabla.
        Tableau conectado
      1. Arrastre la entrada cc_data_view y suéltela en la vista principal que dice Arrastrar tablas aquí.
    4. La ventana principal muestra detalles de la vista de datos cc_data_view.
      Tableau conectado

Para ACOPLAR o no

Tableau Desktop admite los siguientes escenarios para el parámetro FLATTEN. Consulte Acoplar datos anidados para obtener más información.

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 Ejemplo Admitido Observaciones
Ninguno prod:cja Círculo de verificación
?FLATTEN prod:cja?FLATTEN Círculo de verificación
%3FFLATTEN prod:cja%3FFLATTEN Círculo de verificación Opción recomendada para usar. Tenga en cuenta que %3FFLATTEN es una versión de ?FLATTEN con codificación de dirección URL.

Más información

Buscador
  1. Acceda a las credenciales y los parámetros necesarios desde la interfaz de usuario del servicio de consultas de Experience Platform.

    1. Vaya a la zona protegida de Experience Platform.

    2. Seleccione Consultas Consultas del carril izquierdo.

    3. Seleccione la ficha Credenciales en la interfaz de Consultas.

    4. Seleccione prod:cja del menú desplegable Base de datos.

      Credenciales del servicio de consulta

  2. Iniciar sesión en Looker

    1. Seleccione Admin en el carril izquierdo.

    2. Seleccione Conexiones.

    3. Seleccione Añadir conexión.

    4. En Conecte la base de datos a la pantalla de búsqueda.

      Conexión del buscador a la base de datos

      1. Escriba un Nombre para la conexión, por ejemplo Example Looker Connection.
      2. Asegúrese de que Todos los proyectos esté seleccionado como el Ámbito de conexión.
      3. Seleccione PostgreSQL 9.5+ como dialecto.
      4. Use Copiar para copiar y pegar el valor Host del panel Consulta Credenciales que caducan de Experience Platform como valor de Host. Por ejemplo: examplecompany.platform-query.adobe.io.
      5. Use Copiar para copiar y pegar el valor Puerto del panel Consulta Credenciales que caducan de Experience Platform como valor de Puerto. Por ejemplo: 80.
      6. Use Copiar para copiar y pegar el valor Base de datos del panel Consulta Credenciales que caducan de Experience Platform como valor de Base de datos. Agregue %3FFLATTEN al valor que pegue. Por ejemplo, prod:cja%3FFLATTEN.
      7. Use Copiar para copiar y pegar el valor Nombre de usuario del panel Consulta Credenciales que caducan de Experience Platform como valor de Nombre de usuario.
      8. Use Copiar para copiar y pegar el valor Contraseña del panel Consulta Credenciales que caducan de Experience Platform como valor de Contraseña.
      9. Seleccione Expandir todo en Configuración opcional.
      10. Establezca Conexiones máximas por nodo en 5.
      11. Asegúrese de que SSL esté habilitado.
      12. Seleccione Probar para probar la conexión. Debería ver un banner en la parte superior de la pantalla con un mensaje como Success, can connect JDBC ….
      13. Seleccione Conectar para establecer y guardar la conexión.
    5. Verá la nueva conexión en la interfaz Connections.

    6. Seleccione de Admin para ir a la navegación principal en el carril izquierdo.

    7. Seleccione Desarrollar.

    8. Seleccionar proyectos.

    9. Seleccione Nuevo modelo en Proyectos LookML.

    10. Para asegurarse de que no afecta a otros usuarios. seleccione Introducir modo de desarrollo cuando se le solicite.

    11. En la experiencia Crear modelo:

      1. En ➊, seleccione Conexión A Base De Datos:

        1. Seleccione la conexión de base de datos en Seleccionar conexión de base de datos. Por ejemplo: example_looker_connection.
        2. Asigne un nombre al proyecto en Crear un nuevo proyecto LookML para este modelo. Para example: example_looker_project.
        3. Seleccione Siguiente.
      2. En ➋, seleccione Tablas:

        1. Seleccione público y asegúrese de que la vista de datos de Customer Journey Analytics esté seleccionada. Por ejemplo: SelectBox cc_data_view.
        2. Seleccione Siguiente.
      3. En ➌, Seleccione Claves Principales:

        1. Seleccione Siguiente.
      4. En ➍, seleccione Exploraciones para crear:

        1. Asegúrese de seleccionar la vista. Por ejemplo: cc_data_view.view.
        2. Seleccione Siguiente.
      5. En ➎, escriba el nombre de modelo:

        1. Asigne un nombre al modelo. Por ejemplo: example_looker_model.
      6. Seleccione Completar y explorar datos.

    Se le redirigirá a la interfaz Explorar de Looker, lista para explorar los datos.

Para ACOPLAR o no

Looker admite los siguientes escenarios para el parámetro FLATTEN. Consulte Acoplar datos anidados para obtener más información.

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 Ejemplo Admitido Observaciones
Ninguno prod:cja Círculo de verificación
?FLATTEN prod:cja?FLATTEN Círculo de verificación
%3FFLATTEN prod:cja%3FFLATTEN Círculo de verificación Opción recomendada para usar. Tenga en cuenta que %3FFLATTEN es una versión de ?FLATTEN con codificación de dirección URL.

Más información

Jupyter Notebook
  1. Acceda a las credenciales y los parámetros necesarios desde la interfaz de usuario del servicio de consultas de Experience Platform.

    1. Vaya a la zona protegida de Experience Platform.

    2. Seleccione Consultas Consultas del carril izquierdo.

    3. Seleccione la ficha Credenciales en la interfaz de Consultas.

    4. Seleccione prod:cja del menú desplegable Base de datos.

      Credenciales del servicio de consulta

  2. Asegúrese de haber configurado un entorno virtual de Python dedicado para ejecutar el entorno de Jupyter Notebook.

  3. Asegúrese de que ha instalado las bibliotecas necesarias en su entorno virtual:

    • ipython-sql: pip install ipython-sql.
    • psycopg2-binario: pip install psycopg-binary.
    • alquimia SQL: pip install sqlalchemy.
  4. Inicie Jupyter Notebook desde su entorno virtual: jupyter notebook.

  5. Cree un nuevo bloc de notas o descargue este bloc de notas de ejemplo.

  6. En la primera celda, introduzca y ejecute:

    code language-none
    %config SqlMagic.style = '_DEPRECATED_DEFAULT'
    
  7. En una celda nueva, introduzca los parámetros de configuración para la conexión. Use Copiar para copiar y pegar los valores del panel Consulta Credenciales que caducan de Experience Platform en los valores necesarios para los parámetros de configuración. Por ejemplo:

    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)
    
  8. Ejecute la celda.

  9. Use Copiar para copiar y pegar la contraseña del panel Consulta Credenciales que caducan de Experience Platform en el campo Contraseña de Jupyter Notebook.

    Paso 1 de configuración de Jupter Notebook

  10. En una celda nueva, introduzca las instrucciones para cargar la extensión SQL, la biblioteca necesaria y conectarse con 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
    

    Ejecute el shell. No debería ver ningún resultado, pero la celda debería ejecutarse sin ninguna advertencia.

    Paso de configuración de Jupyer Notebook 4

  11. En una nueva llamada, introduzca las instrucciones para obtener una lista de las vistas de datos disponibles en función de la conexión.

    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;
    

    Ejecute el shell. Debería ver un resultado similar al de la captura de pantalla siguiente.

    Paso de configuración de Jupyter Notebook 5

    Debería ver cc_data_view en la lista de vistas de datos.

Para ACOPLAR o no

Jupyter Notebook admite los siguientes escenarios para el parámetro FLATTEN. Consulte Acoplar datos anidados para obtener más información.

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 Ejemplo Admitido Observaciones
Ninguno prod:cja Círculo de verificación
?FLATTEN prod:cja?FLATTEN CerrarCírculo
%3FFLATTEN prod:cja%3FFLATTEN Círculo de verificación Opción recomendada para usar. Tenga en cuenta que %3FFLATTEN es una versión de ?FLATTEN con codificación de dirección URL.

Más información

EstudioRS
  1. Acceda a las credenciales y los parámetros necesarios desde la interfaz de usuario del servicio de consultas de Experience Platform.

    1. Vaya a la zona protegida de Experience Platform.

    2. Seleccione Consultas Consultas del carril izquierdo.

    3. Seleccione la ficha Credenciales en la interfaz de Consultas.

    4. Seleccione prod:cja del menú desplegable Base de datos.

      Credenciales del servicio de consulta

  2. Inicie RStudio.

  3. Cree un nuevo archivo R Markdown o descargue este archivo R markdown de ejemplo.

  4. En su primer fragmento, escriba las siguientes instrucciones entre {r} ` y ` . Use Copiar para copiar y pegar valores del panel Consulta Credenciales que caducan de Experience Platform en los valores necesarios para los distintos parámetros, como host, dbname y user. Por ejemplo:

    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")
    
  5. Ejecuta el fragmento. Se le pedirá Host, Base de datos y Usuario. Simplemente acepte los valores proporcionados como parte del paso anterior.

  6. Use Copiar para copiar y pegar la contraseña del panel Consulta Credenciales que caducan de Experience Platform en el símbolo del sistema de Contraseña en RStudio.

    Paso de configuración de RStudio 1

  7. Cree un nuevo fragmento e introduzca las siguientes instrucciones entre ```` {r} y .

    code language-r
    con <- dbConnect(
       RPostgres::Postgres(),
       host = host,
       port = 80,
       dbname = dbname,
       user = user,
       password = password,
       sslmode = 'require'
    )
    
  8. Ejecuta el fragmento. No debería ver ninguna salida si la conexión se ha realizado correctamente.

  9. Cree un nuevo fragmento e introduzca las siguientes instrucciones entre ```` {r} y .

    code language-r
    views <- dbListTables(con)
    print(views)
    
  10. Ejecuta el fragmento. Debería ver character(0) como el único resultado.

  11. Cree un nuevo fragmento e introduzca las siguientes instrucciones entre ```` {r} y .

    code language-r
    glimpse(dv)
    
  12. Ejecuta el fragmento. Debería ver un resultado similar al de la captura de pantalla siguiente.

    Paso de configuración de RStudio 2

Para ACOPLAR o no

RSstudio admite los siguientes escenarios para el parámetro FLATTEN. Consulte Acoplar datos anidados para obtener más información.

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 Ejemplo Admitido Observaciones
Ninguno prod:cja Círculo de verificación
?FLATTEN prod:cja?FLATTEN Círculo de verificación Opción recomendada para usar.
%3FFLATTEN prod:cja%3FFLATTEN CerrarCírculo

Más información

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