Connetti e convalida

Questo caso d’uso imposta la connessione dallo strumento BI a Customer Journey Analytics, elenca le visualizzazioni dati disponibili e seleziona una visualizzazione dati da utilizzare.

Customer Journey Analytics

Le istruzioni fanno riferimento a un ambiente di esempio con i seguenti oggetti:

  • Visualizzazione dati: C&C - Visualizzazione dati 🅐.
  • Dimensioni: Nome prodotto 🅑 e Categoria prodotto 🅒.
  • Metriche: Ricavi da acquisto 🅓 e Acquisti 🅔.
  • Filtro: Prodotti della pesca 🅕.

Configurazione base Customer Journey Analytics

Nei casi d’uso, sostituisci questi oggetti di esempio con oggetti appropriati per il tuo ambiente specifico.

Strumenti BI
tabs
Desktop Power BI
  1. Accedi alle credenziali e ai parametri richiesti dall’interfaccia utente di Experience Platform Query Service.

    1. Passa alla sandbox di Experience Platform.

    2. Seleziona Query Query dalla barra a sinistra.

    3. Selezionare la scheda Credenziali nell'interfaccia Query.

    4. Selezionare prod:cja dal menu a discesa Database.

      Esegui query sulle credenziali del servizio

  2. Avviare Power BI Desktop.

    1. Dall'interfaccia principale, selezionare Ottieni dati da altre origini.

    2. Nella finestra di dialogo Ottieni dati:
      Database PostgreSQL di Power BI

      1. Cerca e seleziona Database PostgreSQL.
      2. Seleziona Connetti.
    3. Nella finestra di dialogo Database PostgreSQL:
      Impostazioni server desktop e database PowerBI

      1. Utilizza Copia per copiare e incollare i valori Host e Porta dal pannello Query Credenziali in scadenza di Experience Platform, separati da : come valore per Server. Ad esempio: examplecompany.platform-query.adobe.io:80.
      2. Utilizza Copia per copiare e incollare il valore Database dal pannello Query Credenziali in scadenza di Experience Platform. Aggiungere ?FLATTEN al valore incollato. Ad esempio: prod:cja?FLATTEN.
      3. Selezionare DirectQuery come Modalità di connettività dati.
      4. Selezionare OK.
    4. Nella finestra di dialogo Database PostgreSQL - Database:
      Utente e password di PowerBI Desktop

      1. Utilizza Copia per copiare i valori Nome utente e Password dal pannello Experience Platform Query Credenziali in scadenza nei campi Nome utente e Password. Se si utilizza una credenziale senza scadenza, utilizzare la password delle credenziali senza scadenza.
      2. Verificare che il menu a discesa per Selezionare il livello a cui applicare queste impostazioni sia impostato sul server definito in precedenza.
      3. Seleziona Connetti.
    5. Nella finestra di dialogo Navigator, le visualizzazioni dati vengono recuperate. Questo recupero può richiedere del tempo. Una volta recuperato, in Power BI Desktop viene visualizzato quanto segue.
      Dati caricamento desktop Power BI

      1. Seleziona public.cc_data_view dall'elenco nel pannello a sinistra.

      2. Sono disponibili due opzioni:

        1. Seleziona Carica per continuare e completare l'installazione.
        2. Selezionare Trasforma dati. Viene visualizzata una finestra di dialogo in cui è possibile applicare le trasformazioni come parte della configurazione.
          Dati trasformazione desktop Power BI
          • Seleziona Chiudi e applica.
    6. Dopo un po', nel riquadro Dati viene visualizzato public.cc_data_view. Seleziona ChevronRight per visualizzare dimensioni e metriche.
      Dati server desktop Power BI caricati

Per APPIATTIRE o meno

Power BI Desktop supporta i seguenti scenari per il parametro FLATTEN. Per ulteriori informazioni, vedere Flatten nested data.

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
Parametro FLATTEN Esempio Supportati Osservazioni
Nessuno prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle Opzione consigliata da utilizzare!
%3FFLATTEN prod:cja%3FFLATTEN ChiudiCerchio Power BI Desktop visualizza l'errore: Impossibile eseguire l'autenticazione con le credenziali fornite. Riprova.

Ulteriori informazioni

Desktop Tableau
  1. Accedi alle credenziali e ai parametri richiesti dall’interfaccia utente di Experience Platform Query Service.

    1. Passa alla sandbox di Experience Platform.

    2. Seleziona Query Query dalla barra a sinistra.

    3. Selezionare la scheda Credenziali nell'interfaccia Query.

    4. Selezionare prod:cja dal menu a discesa Database.

      Esegui query sulle credenziali del servizio

  2. Avvia Tableau.

    1. Seleziona PostgreSQL dalla barra a sinistra sotto A un server. Se non disponibile, selezionare Altro… e selezionare PostgreSQL dai Connettori installati.
      Connettori Tableau

    2. Nella scheda Generale della finestra di dialogo PostgreSQL:
      Finestra di dialogo Accesso a Tableau

      1. Utilizza Copia per copiare e incollare l'Host dal pannello Query Credenziali in scadenza di Experience Platform nel Server.
      2. Utilizza Copia per copiare e incollare la Porta dal pannello Experience Platform Query Credenziali in scadenza alla Porta.
      3. Utilizza Copia per copiare e incollare il Database dal pannello Experience Platform Query Credenziali in scadenza nel Database. Aggiungere %3FFLATTEN al valore incollato. Ad esempio: prod:cja%3FFLATTEN.
      4. Selezionare Nome utente e password dal menu a discesa Autenticazione.
      5. Utilizza Copia per copiare e incollare il Nome utente dal pannello Query Credenziali in scadenza di Experience Platform nel Nome utente.
      6. Utilizza Copia per copiare e incollare la Password dal pannello Query Credenziali in scadenza di Experience Platform nella Password. Se si utilizza una credenziale senza scadenza, utilizzare la password delle credenziali senza scadenza.
      7. Verificare che sia selezionato Richiedi SSL.
      8. Seleziona Accedi.

      Viene visualizzata una finestra di dialogo Richiesta in corso mentre Tableau Desktop convalida la connessione.

    3. Nella finestra principale, puoi vedere nella pagina Data Source, nel riquadro a sinistra:

      • Il nome della connessione, sotto Connessioni.
      • Il nome del database, sotto Database.
      • Un elenco di tabelle, sotto Tabella.
        Tableau connesso
      1. Trascina la voce cc_data_view e rilascia la voce nella visualizzazione principale che riporta Trascina qui le tabelle.
    4. Nella finestra principale vengono visualizzati i dettagli della visualizzazione dati cc_data_view.
      Tableau connesso

Per APPIATTIRE o meno

Tableau Desktop supporta i seguenti scenari per il parametro FLATTEN. Per ulteriori informazioni, vedere Flatten nested data.

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
Parametro FLATTEN Esempio Supportati Osservazioni
Nessuno prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle Opzione consigliata da utilizzare. %3FFLATTEN è la versione con codifica URL di ?FLATTEN.

Ulteriori informazioni

Ricerca
  1. Accedi alle credenziali e ai parametri richiesti dall’interfaccia utente di Experience Platform Query Service.

    1. Passa alla sandbox di Experience Platform.

    2. Seleziona Query Query dalla barra a sinistra.

    3. Selezionare la scheda Credenziali nell'interfaccia Query.

    4. Selezionare prod:cja dal menu a discesa Database.

      Esegui query sulle credenziali del servizio

  2. Accedi a Looker

    1. Seleziona Amministratore dalla barra a sinistra.

    2. Seleziona Connessioni.

    3. Selezionare Aggiungi connessione.

    4. In Connetti il database alla schermata Looker.

      Connessione al database

      1. Immetti un Nome per la connessione, ad esempio Example Looker Connection.
      2. Assicurarsi che Tutti i progetti sia selezionato come Ambito connessione.
      3. Selezionare PostgreSQL 9.5+ come Dialetto.
      4. Utilizza Copia per copiare e incollare il valore Host dal pannello Query Credenziali in scadenza di Experience Platform come valore per Host. Ad esempio: examplecompany.platform-query.adobe.io.
      5. Utilizza Copia per copiare e incollare il valore Porta dal pannello Query Credenziali in scadenza di Experience Platform come valore per Porta. Ad esempio: 80.
      6. Utilizza Copia per copiare e incollare il valore Database dal pannello Experience Platform Query Credenziali in scadenza come valore per Database. Aggiungere %3FFLATTEN al valore incollato. Ad esempio: prod:cja%3FFLATTEN.
      7. Utilizza Copia per copiare e incollare il valore Nome utente dal pannello Query Credenziali in scadenza di Experience Platform come valore per Nome utente.
      8. Utilizza Copia per copiare e incollare il valore Password dal pannello Query Credenziali in scadenza di Experience Platform come valore per Password.
      9. Seleziona Espandi tutto in Impostazioni facoltative.
      10. Imposta Numero massimo di connessioni per nodo su 5.
      11. Verificare che SSL sia abilitato.
      12. Seleziona Test per verificare la connessione. Dovresti vedere un banner nella parte superiore della schermata con un messaggio come Operazione riuscita, può connettere JDBC ….
      13. Seleziona Connetti per stabilire e salvare la connessione.
    5. La nuova connessione viene visualizzata nell'interfaccia Connessioni.

    6. Seleziona da Amministratore per passare alla navigazione principale nella barra a sinistra.

    7. Selezionare Sviluppo.

    8. Seleziona Progetti.

    9. Selezionare Nuovo modello nei progetti LookML.

    10. Per evitare di influenzare altri utenti. quando richiesto, seleziona Entra in modalità di sviluppo.

    11. Nell'esperienza Crea modello:

      1. In ➊Selezionare Connessione Database:

        1. Selezionare la connessione al database in Seleziona connessione al database. Esempio: example_looker_connection.
        2. Assegna un nome al progetto in Crea un nuovo progetto LookML per questo modello. Per example: example_looker_project.
        3. Seleziona Avanti.
      2. In ➋Seleziona Tabelle:

        1. Seleziona public, quindi assicurati che la visualizzazione dati di Customer Journey Analytics sia selezionata. Ad esempio: SelectBox cc_data_view.
        2. Seleziona Avanti.
      3. In ➌Seleziona Chiavi Primarie:

        1. Seleziona Avanti.
      4. In ➍selezionare Esplora da creare:

        1. Accertati di selezionare la vista. Ad esempio: cc_data_view.view.
        2. Seleziona Avanti.
      5. In ➎Immettere Il Nome Modello:

        1. Assegna un nome al modello. Ad esempio: example_looker_model.
      6. Selezionare Completa ed esplora dati.

    Sei stato reindirizzato all'interfaccia Esplora di Looker, pronto per esplorare i dati.

Per APPIATTIRE o meno

Looker supporta i seguenti scenari per il parametro FLATTEN. Per ulteriori informazioni, vedere Flatten nested data.

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
Parametro FLATTEN Esempio Supportati Osservazioni
Nessuno prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle Opzione consigliata da utilizzare. %3FFLATTEN è la versione con codifica URL di ?FLATTEN.

Ulteriori informazioni

Blocco appunti Jupyter
  1. Accedi alle credenziali e ai parametri richiesti dall’interfaccia utente di Experience Platform Query Service.

    1. Passa alla sandbox di Experience Platform.

    2. Seleziona Query Query dalla barra a sinistra.

    3. Selezionare la scheda Credenziali nell'interfaccia Query.

    4. Selezionare prod:cja dal menu a discesa Database.

      Esegui query sulle credenziali del servizio

  2. Assicurati di aver configurato un ambiente virtuale Python dedicato per l’esecuzione dell’ambiente Jupyter Notebook.

  3. Verifica di aver installato le librerie richieste nell’ambiente virtuale:

    • ipython-sql: pip install ipython-sql.
    • psycopg2-binary: pip install psycopg-binary.
    • sqlalchemy: pip install sqlalchemy.
  4. Avviare Jupyter Notebook dall'ambiente virtuale: jupyter notebook.

  5. Crea un nuovo blocco appunti o scarica questo blocco appunti di esempio.

  6. Nella prima cella, immetti ed esegui:

    code language-none
    %config SqlMagic.style = '_DEPRECATED_DEFAULT'
    
  7. In una nuova cella, immetti i parametri di configurazione per la connessione. Utilizza Copia per copiare e incollare i valori dal pannello Experience Platform Query Credenziali in scadenza nei valori richiesti per i parametri di configurazione. Ad esempio:

    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. Eseguire la cella.

  9. Utilizza Copia per copiare e incollare la password dal pannello Query Credenziali in scadenza di Experience Platform nel campo Password di Jupyter Notebook.

    Configurazione blocco appunti Jupter Passaggio 1

  10. In una nuova cella, immettere le istruzioni per caricare l'estensione SQL, la libreria richiesta e connettersi a 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
    

    Eseguite la shell. Non dovrebbe essere visualizzato alcun output, ma la cella dovrebbe essere eseguita senza alcun avviso.

    Configurazione blocco appunti Jupyer Passaggio 4

  11. In una nuova chiamata, immetti le istruzioni per ottenere un elenco delle visualizzazioni dati disponibili in base alla connessione.

    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;
    

    Eseguite la shell. Dovresti visualizzare un output simile alla schermata seguente.

    Configurazione Jupyter Notebook Passaggio 5

    Dovresti visualizzare la cc_data_view nell'elenco delle visualizzazioni dati.

Per APPIATTIRE o meno

Jupyter Notebook supporta i seguenti scenari per il parametro FLATTEN. Per ulteriori informazioni, vedere Flatten nested data.

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
Parametro FLATTEN Esempio Supportati Osservazioni
Nessuno prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN ChiudiCerchio
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle Opzione consigliata da utilizzare. %3FFLATTEN è la versione con codifica URL di ?FLATTEN.

Ulteriori informazioni

StudioRS
  1. Accedi alle credenziali e ai parametri richiesti dall’interfaccia utente di Experience Platform Query Service.

    1. Passa alla sandbox di Experience Platform.

    2. Seleziona Query Query dalla barra a sinistra.

    3. Selezionare la scheda Credenziali nell'interfaccia Query.

    4. Selezionare prod:cja dal menu a discesa Database.

      Esegui query sulle credenziali del servizio

  2. Avviare Studio.

  3. Crea un nuovo file Markdown R o scarica questo file Markdown R di esempio.

  4. Nel primo blocco immettere le istruzioni seguenti comprese tra {r} ` e ` . Utilizza Copia per copiare e incollare i valori dal pannello Query Credenziali in scadenza di Experience Platform nei valori richiesti per i vari parametri, come host, dbname e user. Ad esempio:

    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. Esegui il blocco. Ti viene richiesto di Host, Database e Utente. È sufficiente accettare i valori forniti nel passaggio precedente.

  6. Utilizza Copia per copiare e incollare la password dal pannello Experience Platform Query Credenziali in scadenza alla finestra di dialogo Password in RStudio.

    Passaggio di configurazione RStudio 1

  7. Creare un nuovo blocco e immettere le istruzioni seguenti tra ```` {r} e .

    code language-r
    con <- dbConnect(
       RPostgres::Postgres(),
       host = host,
       port = 80,
       dbname = dbname,
       user = user,
       password = password,
       sslmode = 'require'
    )
    
  8. Esegui il blocco. Se la connessione ha esito positivo, non verrà visualizzato alcun output.

  9. Creare un nuovo blocco e immettere le istruzioni seguenti tra ```` {r} e .

    code language-r
    views <- dbListTables(con)
    print(views)
    
  10. Esegui il blocco. Dovresti vedere character(0) come unico output.

  11. Creare un nuovo blocco e immettere le istruzioni seguenti tra ```` {r} e .

    code language-r
    glimpse(dv)
    
  12. Esegui il blocco. Dovresti visualizzare un output simile alla schermata seguente.

    Passaggio di configurazione RStudio 2

Per APPIATTIRE o meno

Studio supporta i seguenti scenari per il parametro FLATTEN. Per ulteriori informazioni, vedere Flatten nested data.

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
Parametro FLATTEN Esempio Supportati Osservazioni
Nessuno prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle Opzione consigliata da utilizzare.
%3FFLATTEN prod:cja%3FFLATTEN ChiudiCerchio

Ulteriori informazioni

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