Verbinding maken en valideren

Met deze gebruiksaanwijzing stelt u de verbinding van het gereedschap BI naar Customer Journey Analytics in, geeft u de beschikbare gegevensweergaven weer en selecteert u een gegevensweergave die u wilt gebruiken.

Customer Journey Analytics

De instructies verwijzen naar een voorbeeldomgeving met de volgende objecten:

  • Gegevensweergave: C&C - Data View 🅐 .
  • Dimensies: Product Name 🅑 en Product Category 🅒 .
  • Metrisch: Purchase Revenue 🅓 en Purchases 🅔 .
  • Filter: Fishing Products 🅕 .

de opstelling van de Basis van Customer Journey Analytics

Wanneer u de gebruiksgevallen doorloopt, vervangt u deze voorbeeldobjecten door objecten die geschikt zijn voor uw specifieke omgeving.

BI-gereedschappen
tabs
Desktop van Power BI
  1. Open de vereiste referenties en parameters via de gebruikersinterface van de Experience Platform Query Service.

    1. Navigeer naar uw Experience Platform-sandbox.

    2. Selecteer Vragen Queries van het linkerspoor.

    3. Selecteer de tab Credentials in de interface van Queries .

    4. Selecteer prod:cja in de vervolgkeuzelijst Database .

      de dienstgeloofsbrieven van de Vraag

  2. Start Power BI Desktop.

    1. Selecteer Get data from other sources in de hoofdinterface.

    2. In het dialoogvenster Get Data :
      gegevensbestand PowerBI PostgreSQL

      1. Zoek en selecteer PostgreSQL database .
      2. Selecteer Connect.
    3. In het dialoogvenster PostgreSQL database :
      de Server en montages van het Gegevensbestand van de Desktop PowerBI

      1. Gebruik Exemplaar om de Host en Port waarden van het paneel van Experience Platform Query te kopiëren en te kleven Expiring Credentials, die door : als waarde voor Server wordt gescheiden. Bijvoorbeeld: examplecompany.platform-query.adobe.io:80 .
      2. Gebruik Exemplaar om de Database waarde van het Experience Platform Query Expiring Credentials paneel te kopiëren en te kleven. Voeg ?FLATTEN toe aan de waarde die u plakt. Bijvoorbeeld prod:cja?FLATTEN .
      3. Selecteer DirectQuery als de Data connectivity mode .
      4. Selecteer OK.
    4. In het dialoogvenster PostgreSQL database - Database :
      Gebruiker en Wachtwoord van de Desktop PowerBI

      1. Gebruik Exemplaar om de Username en Password waarden van het Experience Platform Query te kopiëren Expiring Credentials paneel in User name en Password gebieden. Als u a ​ niet-uitbreidende credentie ​ gebruikt, gebruik het wachtwoord van uw niet-uitbreidende referentie.
      2. Zorg ervoor dat het vervolgkeuzemenu voor Select which level to apply these settings to is ingesteld op de Server die u eerder hebt gedefinieerd.
      3. Selecteer Connect.
    5. In het dialoogvenster Navigator worden de gegevensweergaven opgehaald. Dit kan enige tijd duren. Zodra teruggewonnen, ziet u het volgende in de Desktop van Power BI.
      de Gegevens van de Lading van de Desktop van Power BI

      1. Selecteer public.cc_data_view in de lijst in het linkerdeelvenster.

      2. U hebt twee opties:

        1. Selecteer Load om door te gaan en de installatie te voltooien.
        2. Selecteer Transform Data . Er wordt een dialoogvenster weergegeven waarin u desgewenst transformaties kunt toepassen als onderdeel van de configuratie.
          Gegevens van de Transformatie van de Desktop van Power BI
          • Selecteer Close & Apply.
    6. Na enige tijd wordt public.cc_data_view weergegeven in het deelvenster Data . Selecteer ChevronRight om afmetingen en metriek te tonen.
      Gegevens van de Server van de Desktop van Power BI geladen

Naar FLATTEN of niet

Power BI Desktop ondersteunt de volgende scenario's voor de parameter FLATTEN . Zie ​ genestelde gegevens ​ voor meer informatie afvlakken.

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
FLATTEN, parameter Voorbeeld Ondersteund Opmerkingen
Geen prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle geadviseerde optie om te gebruiken!
%3FFLATTEN prod:cja%3FFLATTEN CloseCircle Fout in weergave Power BI Desktop: We couldn’t authenticate with the credentials provided. Please try again.

Meer informatie

Desktop Tableau
  1. Open de vereiste referenties en parameters via de gebruikersinterface van de Experience Platform Query Service.

    1. Navigeer naar uw Experience Platform-sandbox.

    2. Selecteer Vragen Queries van het linkerspoor.

    3. Selecteer de tab Credentials in de interface van Queries .

    4. Selecteer prod:cja in de vervolgkeuzelijst Database .

      de dienstgeloofsbrieven van de Vraag

  2. Start Tableau.

    1. Selecteer PostgreSQL in de linkertrack onder To a Server . Als deze optie niet beschikbaar is, selecteert u More… en selecteert u PostgreSQL in het menu Installed Connectors .
      Verbindingen van Tableau

    2. Ga in het dialoogvenster PostgreSQL op het tabblad General naar:
      Teken van Tableau binnen dialoog

      1. Gebruik Exemplaar om Host van het paneel van Experience Platform Query te kopiëren en te kleven Expiring Credentials aan Server.
      2. Gebruik Exemplaar om Port van het paneel van Experience Platform Query te kopiëren en te kleven Expiring Credentials aan Port.
      3. Gebruik Exemplaar om Database van het paneel van Experience Platform Query te kopiëren en te kleven Expiring Credentials aan Database. Voeg %3FFLATTEN toe aan de waarde die u plakt. Bijvoorbeeld: prod:cja%3FFLATTEN .
      4. Selecteer Username and Password in de vervolgkeuzelijst Authentication .
      5. Gebruik Exemplaar om Username van het paneel van Experience Platform Query te kopiëren en te kleven Expiring Credentials aan Username.
      6. Gebruik Exemplaar om Password van het paneel van Experience Platform Query te kopiëren en te kleven Expiring Credentials aan Password. Als u a ​ niet-uitbreidende credentie ​ gebruikt, gebruik het wachtwoord van uw niet-uitbreidende referentie.
      7. Controleer of Require SSL is ingeschakeld.
      8. Selecteer Sign In.

      U ziet een dialoogvenster Progressing Request terwijl Tableau Desktop de verbinding valideert.

    3. In het hoofdvenster ziet u op de pagina Data Source in het linkervenster:

      • De naam van de verbinding, onder Connections .
      • De naam van de database, onder Database .
      • Een lijst met tabellen, onder Table .
        Verbonden Tableau
      1. Sleep het item cc_data_view en zet het neer in de hoofdweergave die Drag tables hier leest.
    4. In het hoofdvenster worden de details van de gegevensweergave van cc_data_view weergegeven.
      Verbonden Tableau

Naar FLATTEN of niet

Tableau Desktop ondersteunt de volgende scenario's voor de parameter FLATTEN . Zie ​ genestelde gegevens ​ voor meer informatie afvlakken.

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
FLATTEN, parameter Voorbeeld Ondersteund Opmerkingen
Geen prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle geadviseerde optie om te gebruiken. Opmerking: %3FFLATTEN is een URL-gecodeerde versie van ?FLATTEN .

Meer informatie

Leider
  1. Open de vereiste referenties en parameters via de gebruikersinterface van de Experience Platform Query Service.

    1. Navigeer naar uw Experience Platform-sandbox.

    2. Selecteer Vragen Queries van het linkerspoor.

    3. Selecteer de tab Credentials in de interface van Queries .

    4. Selecteer prod:cja in de vervolgkeuzelijst Database .

      de dienstgeloofsbrieven van de Vraag

  2. Aanmelden bij Looker

    1. Selecteer Admin in het linkerspoor.

    2. Selecteer Connections.

    3. Selecteer Add Connection.

    4. In de lus Connect your database to Looker screen .

      Leider verbindt met gegevensbestand

      1. Voer een Name in voor uw verbinding, bijvoorbeeld Example Looker Connection .
      2. Zorg ervoor dat All Projects is geselecteerd als de Connection Scope .
      3. Selecteer PostgreSQL 9.5+ als Dialect.
      4. Gebruik Exemplaar om de Host waarde van het paneel van Experience Platform Query te kopiëren en te kleven Expiring Credentials, als waarde voor Host. Bijvoorbeeld: examplecompany.platform-query.adobe.io .
      5. Gebruik Exemplaar om de Port waarde van het paneel van Experience Platform Query te kopiëren en te kleven Expiring Credentials, als waarde voor Port. Bijvoorbeeld: 80 .
      6. Gebruik Exemplaar om de Database waarde van het Experience Platform Query Expiring Credentials paneel als waarde voor Database te kopiëren en te kleven. Voeg %3FFLATTEN toe aan de waarde die u plakt. Bijvoorbeeld prod:cja%3FFLATTEN .
      7. Gebruik Exemplaar om de Username waarde van het Experience Platform Query Expiring Credentials paneel als waarde voor Username te kopiëren en te kleven.
      8. Gebruik Exemplaar om de Password waarde van het Experience Platform Query Expiring Credentials paneel als waarde voor Password te kopiëren en te kleven.
      9. Selecteer Expand all bij Optional Settings .
      10. Stel Max connections per knooppunt in op 5 .
      11. Controleer of SSL is ingeschakeld.
      12. Selecteer Test om de verbinding te testen. U ziet dat een banner boven aan het scherm wordt weergegeven met een bericht als Success, can connect JDBC … .
      13. Selecteer Connect om de verbinding tot stand te brengen en op te slaan.
    5. De nieuwe verbinding wordt weergegeven in de interface Connections .

    6. Selecteer in Admin om naar de hoofdnavigatie in de linkertrack te gaan.

    7. Selecteer Develop.

    8. Selecteer Projects.

    9. Selecteer New Model in projecten LookML.

    10. Om ervoor te zorgen dat u geen invloed hebt op andere gebruikers. Selecteer Modus voor ontwikkeling openen als u hierom wordt gevraagd.

    11. In de Create Model -ervaring:

      1. In ➊ Select Database Connection:

        1. Selecteer uw databaseverbinding in Select database connection . Bijvoorbeeld: example_looker_connection .
        2. Geef uw project een naam in Create a new LookML Project for this model . Voor example: example_looker_project .
        3. Selecteer Next.
      2. In ➋ Select Tables:

        1. Selecteer public en zorg ervoor dat de Customer Journey Analytics-gegevensweergave is geselecteerd. Bijvoorbeeld: SelectBox cc_data_view.
        2. Selecteer Next.
      3. In ➌ Select Primary Keys:

        1. Selecteer Next.
      4. In ➍ Select Explores to Create:

        1. Zorg ervoor dat u de weergave selecteert. Bijvoorbeeld: cc_data_view.view .
        2. Selecteer Next.
      5. In ➎ Enter Model Name:

        1. Geef het model een naam. Bijvoorbeeld: example_looker_model .
      6. Selecteer Complete and Explore Data.

    U wordt omgeleid naar de Explore interface van Looker, klaar om de gegevens te onderzoeken.

Naar FLATTEN of niet

De markering ondersteunt de volgende scenario's voor de parameter FLATTEN . Zie ​ genestelde gegevens ​ voor meer informatie afvlakken.

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
FLATTEN, parameter Voorbeeld Ondersteund Opmerkingen
Geen prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle geadviseerde optie om te gebruiken. Opmerking: %3FFLATTEN is een URL-gecodeerde versie van ?FLATTEN .

Meer informatie

Jupyter Notitieboekje
  1. Open de vereiste referenties en parameters via de gebruikersinterface van de Experience Platform Query Service.

    1. Navigeer naar uw Experience Platform-sandbox.

    2. Selecteer Vragen Queries van het linkerspoor.

    3. Selecteer de tab Credentials in de interface van Queries .

    4. Selecteer prod:cja in de vervolgkeuzelijst Database .

      de dienstgeloofsbrieven van de Vraag

  2. Zorg ervoor dat u een speciale virtuele Python-omgeving hebt ingesteld voor het uitvoeren van uw Jupyter-laptopomgeving.

  3. Controleer of u de vereiste bibliotheken in uw virtuele omgeving hebt geïnstalleerd:

    • ipython-sql: pip install ipython-sql.
    • psycopg2-binary: pip install psycopg-binary.
    • sqlalchemy: pip install sqlalchemy .
  4. Start Jupyter-laptop vanuit uw virtuele omgeving: jupyter notebook .

  5. Creeer een nieuwe notitieboekje, of download ​ deze steekproefnotitieboekje ​.

  6. Voer in de eerste cel de volgende gegevens in en voer deze uit:

    code language-none
    %config SqlMagic.style = '_DEPRECATED_DEFAULT'
    
  7. In een nieuwe cel, ga de config parameters voor uw verbinding in. Gebruik Exemplaar om waarden van het Experience Platform Query Expiring Credentials paneel aan de waarden te kopiëren en te kleven die voor de config parameters worden vereist. Bijvoorbeeld:

    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. Voer de cel uit.

  9. Gebruik Exemplaar om het wachtwoord van het Experience Platform Query te kopiëren en te kleven Expiring Credentials paneel aan het Password gebied in Jupyter Notitieboekje.

    Stap 1 van Config van het Notitieboekje van Jupter

  10. Voer in een nieuwe cel de instructies in om de SQL-extensie, de vereiste bibliotheek en de verbinding met Customer Journey Analytics te laden.

    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
    

    Voer de shell uit. Er wordt geen uitvoer weergegeven, maar de cel moet zonder waarschuwing worden uitgevoerd.

    Stap 4 van Config van het Notitieboekje van de Jupyer 1

  11. In een nieuwe vraag, ga de verklaringen in om een lijst van beschikbare gegevensmeningen te krijgen die op de verbinding worden gebaseerd.

    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;
    

    Voer de shell uit. U zou uitvoersimulator aan het hieronder opgenomen schermschot moeten zien.

    Stap 5 van Config van het Notitieboekje van Jupyter

    De cc_data_view wordt weergegeven in de lijst met gegevensweergaven.

Naar FLATTEN of niet

Jupyter-laptop ondersteunt de volgende scenario's voor de parameter FLATTEN . Zie ​ genestelde gegevens ​ voor meer informatie afvlakken.

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
FLATTEN, parameter Voorbeeld Ondersteund Opmerkingen
Geen prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CloseCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle geadviseerde optie om te gebruiken. Opmerking: %3FFLATTEN is een URL-gecodeerde versie van ?FLATTEN .

Meer informatie

RStudio
  1. Open de vereiste referenties en parameters via de gebruikersinterface van de Experience Platform Query Service.

    1. Navigeer naar uw Experience Platform-sandbox.

    2. Selecteer Vragen Queries van het linkerspoor.

    3. Selecteer de tab Credentials in de interface van Queries .

    4. Selecteer prod:cja in de vervolgkeuzelijst Database .

      de dienstgeloofsbrieven van de Vraag

  2. Start RStudio.

  3. Creeer een nieuw dossier van de Markering R, of download ​ dit voorbeeld of markeringsdossier ​.

  4. Voer in het eerste segment de volgende instructies in tussen {r} ` en ` . Gebruik Exemplaar om waarden van het Experience Platform Query Expiring Credentials paneel aan de waarden te kopiëren en te kleven die voor de diverse parameters, zoals host worden vereist, dbname, en user. Bijvoorbeeld:

    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. Voer het segment uit. U wordt gevraagd om Host , Database en User . Accepteer gewoon de waarden die u hebt opgegeven als onderdeel van de vorige stap.

  6. Gebruik Exemplaar om het wachtwoord van het Experience Platform Query Expiring Credentials paneel aan de Password dialoogherinnering in RStudio te kopiëren en te kleven.

    RStudio config stap 1

  7. Maak een nieuw segment en voer de volgende instructies in tussen ```` {r} en .

    code language-r
    con <- dbConnect(
       RPostgres::Postgres(),
       host = host,
       port = 80,
       dbname = dbname,
       user = user,
       password = password,
       sslmode = 'require'
    )
    
  8. Voer het segment uit. Er wordt geen uitvoer weergegeven als de verbinding is gelukt.

  9. Maak een nieuw segment en voer de volgende instructies in tussen ```` {r} en .

    code language-r
    views <- dbListTables(con)
    print(views)
    
  10. Voer het segment uit. U moet character(0) zien als de enige uitvoer.

  11. Maak een nieuw segment en voer de volgende instructies in tussen ```` {r} en .

    code language-r
    glimpse(dv)
    
  12. Voer het segment uit. U zou uitvoersimulator aan het hieronder opgenomen schermschot moeten zien.

    RStudio config stap 2

Naar FLATTEN of niet

RStudio ondersteunt de volgende scenario's voor de parameter FLATTEN . Zie ​ genestelde gegevens ​ voor meer informatie afvlakken.

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
FLATTEN, parameter Voorbeeld Ondersteund Opmerkingen
Geen prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle geadviseerde optie om te gebruiken.
%3FFLATTEN prod:cja%3FFLATTEN CloseCircle

Meer informatie

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