Connexion et validation

Ce cas d’utilisation configure la connexion de l’outil BI à Customer Journey Analytics, répertorie les vues de données disponibles et sélectionne une vue de données à utiliser.

Customer Journey Analytics

Les instructions se rapportent à un exemple d’environnement avec les objets suivants :

  • Vue de données : C&C - Vue de données 🅐.
  • Dimensions : Nom du produit 🅑 et Catégorie de produit 🅒.
  • Mesures : Chiffre d’affaires d’achat 🅓 et Achats 🅔.
  • Filtre : Produits de la pêche 🅕.

Configuration de base de Customer Journey Analytics

Lorsque vous parcourez les cas d’utilisation, remplacez ces exemples d’objets par des objets appropriés à votre environnement spécifique.

Outils de BI
tabs
Bureau Power BI
  1. Accédez aux informations d’identification et aux paramètres requis à partir de l’interface utilisateur d’Experience Platform Query Service.

    1. Accédez à votre sandbox Experience Platform.

    2. Sélectionnez Requêtes Requêtes dans le rail de gauche.

    3. Sélectionnez l’onglet Informations d’identification dans l’interface Requêtes.

    4. Sélectionnez prod:cja dans le menu déroulant Base de données.

      Informations d’identification de Query Service

  2. Démarrez Power BI Desktop.

    1. Dans l’interface principale, sélectionnez Obtenir des données à partir d’autres sources.

    2. Dans la boîte de dialogue Obtenir des données :
      Base de données PowerBI PostgreSQL

      1. Recherchez et sélectionnez Base de données PostgreSQL.
      2. Sélectionnez Connexion.
    3. Dans la boîte de dialogue Base de données PostgreSQL :
      Paramètres du serveur de bureau PowerBI et de la base de données

      1. Utilisez Copier pour copier et coller les valeurs Hôte et Port à partir du panneau Experience Platform Requête Informations d’identification arrivant à expiration, séparées par : comme valeur de Server. Par exemple : examplecompany.platform-query.adobe.io:80.
      2. Utilisez Copier pour copier et coller la valeur Base de données à partir du panneau Experience Platform Requête Informations d’identification arrivant à expiration. Ajoutez ?FLATTEN à la valeur que vous collez. Par exemple : prod:cja?FLATTEN.
      3. Sélectionnez DirectQuery comme mode de connectivité des données.
      4. Sélectionnez OK.
    4. Dans la boîte de dialogue Base de données PostgreSQL - Base de données :
      Utilisateur et mot de passe du bureau PowerBI

      1. Utilisez Copier pour copier les valeurs Nom d’utilisateur et Mot de passe à partir du panneau Experience Platform Requête Informations d’identification arrivant à expiration dans les champs Nom d’utilisateur et Mot de passe. Si vous utilisez des informations d’identification ​ non expirantes, utilisez le mot de passe correspondant.
      2. Assurez-vous que le menu déroulant Sélectionner le niveau auquel appliquer ces paramètres est défini sur le Serveur que vous avez défini précédemment.
      3. Sélectionnez Connexion.
    5. Dans la boîte de dialogue Navigateur, les vues de données sont récupérées. Cette récupération peut prendre un certain temps. Une fois la récupération effectuée, les éléments suivants s’affichent dans Power BI Desktop.
      Données de chargement de bureau Power BI

      1. Sélectionnez public.cc_data_view dans la liste du panneau de gauche.

      2. Vous disposez de deux options :

        1. Sélectionnez Charger pour continuer et terminer la configuration.
        2. Sélectionnez Transformer les données. Une boîte de dialogue s’affiche, dans laquelle vous pouvez éventuellement appliquer des transformations dans le cadre de la configuration.
          Données de transformation de bureau Power BI
          • Sélectionnez Fermer et appliquer.
    6. Au bout d’un certain temps, public.cc_data_view s’affiche dans le volet Data. Sélectionnez ChevronRight pour afficher les dimensions et les mesures.
      Données Du Serveur De Bureau Power BI Chargées

A APLATIR ou non

Power BI Desktop prend en charge les scénarios suivants pour le paramètre FLATTEN. Voir Aplatir les données imbriquées pour plus d’informations.

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
Paramètre FLATTEN Exemple Pris en charge Remarques
Aucun prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle Option recommandée à utiliser !
%3FFLATTEN prod:cja%3FFLATTEN CloseCircle Le Bureau Power BI affiche l’erreur suivante : Nous n’avons pas pu nous authentifier à l’aide des informations d’identification fournies. Veuillez réessayer.

Informations supplémentaires

Tableau Desktop
  1. Accédez aux informations d’identification et aux paramètres requis à partir de l’interface utilisateur d’Experience Platform Query Service.

    1. Accédez à votre sandbox Experience Platform.

    2. Sélectionnez Requêtes Requêtes dans le rail de gauche.

    3. Sélectionnez l’onglet Informations d’identification dans l’interface Requêtes.

    4. Sélectionnez prod:cja dans le menu déroulant Base de données.

      Informations d’identification de Query Service

  2. Démarrez Tableau.

    1. Sélectionnez PostgreSQL dans le rail de gauche sous Vers un serveur. Si elle n’est pas disponible, sélectionnez Plus… et sélectionnez PostgreSQL dans la Connecteurs installés.
      Connecteurs Tableau

    2. Dans la boîte de dialogue PostgreSQL, dans l’onglet Général :
      Boîte de dialogue Connexion Tableau

      1. Utilisez Copier pour copier et coller le Hôte du panneau Requête Informations d’identification arrivant à expiration d’Experience Platform vers le Serveur.
      2. Utilisez Copier pour copier et coller le Port depuis le panneau Experience Platform Requête Informations d’identification arrivant à expiration vers le Port.
      3. Utilisez Copier pour copier et coller la Base de données du panneau Requête Informations d’identification arrivant à expiration d’Experience Platform vers la Base de données. Ajoutez %3FFLATTEN à la valeur que vous collez. Par exemple : prod:cja%3FFLATTEN.
      4. Sélectionnez Nom d’utilisateur et mot de passe dans le menu déroulant Authentification.
      5. Utilisez Copier pour copier et coller le Nom d’utilisateur du panneau Requête Informations d’identification arrivant à expiration d’Experience Platform dans le Nom d’utilisateur.
      6. Utilisez Copier pour copier et coller le Mot de passe du panneau Experience Platform Requête Informations d’identification arrivant à expiration dans le Mot de passe. Si vous utilisez des informations d’identification ​ non expirantes, utilisez le mot de passe correspondant.
      7. Assurez-vous que la case Exiger SSL est cochée.
      8. Sélectionnez Se connecter.

      Une boîte de dialogue Progression de la demande s'affiche alors que Tableau Desktop valide la connexion.

    3. Dans la fenêtre principale, comme dans la page Source de données, dans le volet de gauche :

      • Nom de la connexion, sous Connexions.
      • Nom de la base de données, sous Base de données.
      • Liste des tableaux, sous Tableau.
        Tableau Connected
      1. Faites glisser l’entrée cc_data_view et déposez-la sur la vue principale qui indique Faire glisser des tableaux ici.
    4. La fenêtre principale affiche les détails de la vue de données cc_data_view.
      Tableau Connected

A APLATIR ou non

Tableau Desktop prend en charge les scénarios suivants pour le paramètre FLATTEN. Voir Aplatir les données imbriquées pour plus d’informations.

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
Paramètre FLATTEN Exemple Pris en charge Remarques
Aucun prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle Option recommandée. Notez que %3FFLATTEN est la version codée URL de ?FLATTEN.

Informations supplémentaires

Looker
  1. Accédez aux informations d’identification et aux paramètres requis à partir de l’interface utilisateur d’Experience Platform Query Service.

    1. Accédez à votre sandbox Experience Platform.

    2. Sélectionnez Requêtes Requêtes dans le rail de gauche.

    3. Sélectionnez l’onglet Informations d’identification dans l’interface Requêtes.

    4. Sélectionnez prod:cja dans le menu déroulant Base de données.

      Informations d’identification de Query Service

  2. Connexion à Looker

    1. Sélectionnez Admin dans le rail de gauche.

    2. Sélectionnez Connexions.

    3. Sélectionnez Ajouter une connexion.

    4. Dans l’écran Connexion de la base de données à l’outil de recherche.

      Recherche Connexion à la base de données

      1. Saisissez un Nom pour votre connexion, par exemple Example Looker Connection.
      2. Assurez-vous que Tous les projets est sélectionné comme Portée de la connexion.
      3. Sélectionnez PostgreSQL 9.5+ comme dialecte.
      4. Utilisez Copier pour copier et coller la valeur Hôte du panneau Experience Platform Requête Informations d’identification arrivant à expiration en tant que valeur de Hôte. Par exemple : examplecompany.platform-query.adobe.io.
      5. Utilisez Copier pour copier et coller la valeur Port du panneau Experience Platform Requête Informations d’identification arrivant à expiration en tant que valeur de Port. Par exemple : 80.
      6. Utilisez Copier pour copier et coller la valeur Base de données du panneau Requête Informations d’identification arrivant à expiration d’Experience Platform en tant que valeur de Base de données. Ajoutez %3FFLATTEN à la valeur que vous collez. Par exemple : prod:cja%3FFLATTEN.
      7. Utilisez Copier pour copier et coller la valeur Nom d’utilisateur du panneau Experience Platform Requête Informations d’identification arrivant à expiration en tant que valeur de Nom d’utilisateur.
      8. Utilisez Copier pour copier et coller la valeur Mot de passe du panneau Experience Platform Requête Informations d’identification arrivant à expiration en tant que valeur de Mot de passe.
      9. Sélectionnez Développer tout dans Paramètres facultatifs.
      10. Définissez Connexions max par nœud sur 5.
      11. Assurez-vous que SSL est activé.
      12. Sélectionnez Tester pour tester la connexion. Une bannière devrait s’afficher en haut de l’écran avec un message comme Succès, peut connecter JDBC ….
      13. Sélectionnez Connexion pour établir et enregistrer la connexion.
    5. La nouvelle connexion s’affiche dans l’interface Connexions.

    6. Sélectionnez dans Admin pour accéder à la navigation principale dans le rail de gauche.

    7. Sélectionnez Développer.

    8. Sélectionnez Projets.

    9. Sélectionnez Nouveau modèle dans les projets LookML.

    10. Pour vous assurer que vous n’affectez pas d’autres utilisateurs. Sélectionnez Activer le mode de développement lorsque vous y êtes invité.

    11. Dans l’expérience Créer un modèle :

      1. Dans ➊, Sélectionnez Connexion À La Base De Données :

        1. Sélectionnez votre connexion à la base de données dans Sélectionner la connexion à la base de données. Par exemple : exemple_recherche_connexion.
        2. Nommez votre projet dans Créez un projet LookML pour ce modèle. Par example: example_looker_project.
        3. Sélectionnez Suivant.
      2. Dans ➋Sélectionner Des Tables :

        1. Sélectionnez public puis assurez-vous que la vue de données Customer Journey Analytics est sélectionnée. Par exemple : SelectBox cc_data_view.
        2. Sélectionnez Suivant.
      3. Dans ➌, sélectionnez Clés de Principal :

        1. Sélectionnez Suivant.
      4. Dans ➍, sélectionnez Explorations à créer :

        1. Veillez à sélectionner votre vue. Par exemple : cc_data_view.view.
        2. Sélectionnez Suivant.
      5. Dans ➎, Saisissez Le Nom Du Modèle :

        1. Nommez votre modèle. Par exemple : example_looker_model.
      6. Sélectionnez Terminer et Explorer les données.

    Vous êtes redirigé vers l’interface Explorer de l’outil de recherche, prête à explorer les données.

A APLATIR ou non

Looker prend en charge les scénarios suivants pour le paramètre FLATTEN. Voir Aplatir les données imbriquées pour plus d’informations.

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
Paramètre FLATTEN Exemple Pris en charge Remarques
Aucun prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle Option recommandée. Notez que %3FFLATTEN est la version codée URL de ?FLATTEN.

Informations supplémentaires

Notebook Jupyter
  1. Accédez aux informations d’identification et aux paramètres requis à partir de l’interface utilisateur d’Experience Platform Query Service.

    1. Accédez à votre sandbox Experience Platform.

    2. Sélectionnez Requêtes Requêtes dans le rail de gauche.

    3. Sélectionnez l’onglet Informations d’identification dans l’interface Requêtes.

    4. Sélectionnez prod:cja dans le menu déroulant Base de données.

      Informations d’identification de Query Service

  2. Assurez-vous d’avoir configuré un environnement virtuel Python dédié pour exécuter votre environnement Jupyter Notebook.

  3. Vérifiez que vous avez installé les bibliothèques requises dans votre environnement virtuel :

    • ipython-sql : pip install ipython-sql.
    • psycopg2-binary : pip install psycopg-binary.
    • sqlalchemy : pip install sqlalchemy.
  4. Démarrez Jupyter Notebook à partir de votre environnement virtuel : jupyter notebook.

  5. Créez un nouveau notebook ou téléchargez cet exemple de notebook.

  6. Dans la première cellule, saisissez et exécutez :

    code language-none
    %config SqlMagic.style = '_DEPRECATED_DEFAULT'
    
  7. Dans une nouvelle cellule, saisissez les paramètres de configuration de votre connexion. Utilisez Copier pour copier et coller les valeurs du panneau Experience Platform Requête Informations d’identification arrivant à expiration dans les valeurs requises pour les paramètres de configuration. Par exemple :

    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. Exécutez la cellule.

  9. Utilisez Copier pour copier et coller le mot de passe du panneau Experience Platform Requête Informations d’identification arrivant à expiration dans le champ Mot de passe du notebook Jupyter.

    Étape 1 De La Configuration Du Notebook Jupter

  10. Dans une nouvelle cellule, saisissez les instructions pour charger l’extension SQL, la bibliothèque requise et vous connecter à 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
    

    Exécutez le shell. Vous ne devriez pas voir de sortie mais la cellule devrait s'exécuter sans avertissement.

    Étape 4 De Configuration Du Notebook Jupyer

  11. Dans un nouvel appel, saisissez les instructions pour obtenir une liste des vues de données disponibles en fonction de la connexion.

    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;
    

    Exécutez le shell. Vous devriez voir une sortie similaire à la capture d’écran ci-dessous.

    Étape 5 de configuration du notebook Jupyter

    Vous devriez voir la cc_data_view dans la liste des vues de données.

A APLATIR ou non

Le notebook Jupyter prend en charge les scénarios suivants pour le paramètre FLATTEN. Voir Aplatir les données imbriquées pour plus d’informations.

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
Paramètre FLATTEN Exemple Pris en charge Remarques
Aucun prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CloseCircle
%3FFLATTEN prod:cja%3FFLATTEN CheckmarkCircle Option recommandée. Notez que %3FFLATTEN est la version codée URL de ?FLATTEN.

Informations supplémentaires

RStudio
  1. Accédez aux informations d’identification et aux paramètres requis à partir de l’interface utilisateur d’Experience Platform Query Service.

    1. Accédez à votre sandbox Experience Platform.

    2. Sélectionnez Requêtes Requêtes dans le rail de gauche.

    3. Sélectionnez l’onglet Informations d’identification dans l’interface Requêtes.

    4. Sélectionnez prod:cja dans le menu déroulant Base de données.

      Informations d’identification de Query Service

  2. Démarrez RStudio.

  3. Créez un nouveau fichier R Markdown ou téléchargez cet exemple de fichier R Markdown.

  4. Dans votre premier bloc, saisissez les instructions suivantes entre {r} ` et ` . Utilisez Copier pour copier et coller des valeurs du panneau Experience Platform Requête Informations d’identification arrivant à expiration dans les valeurs requises pour les différents paramètres, tels que host, dbname et user. Par exemple :

    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. Exécutez le bloc. Vous êtes invité à indiquer Hôte, Base de données et Utilisateur. Il vous suffit d’accepter les valeurs que vous avez fournies dans le cadre de l’étape précédente.

  6. Utilisez Copier pour copier et coller le mot de passe du panneau Experience Platform Requête Informations d’identification arrivant à expiration dans l’invite de dialogue Mot de passe de RStudio.

    Étape 1 de la configuration RStudio

  7. Créez un bloc et saisissez les instructions suivantes entre ```` {r} et .

    code language-r
    con <- dbConnect(
       RPostgres::Postgres(),
       host = host,
       port = 80,
       dbname = dbname,
       user = user,
       password = password,
       sslmode = 'require'
    )
    
  8. Exécutez le bloc. Vous ne devriez voir aucune sortie si la connexion est réussie.

  9. Créez un bloc et saisissez les instructions suivantes entre ```` {r} et .

    code language-r
    views <- dbListTables(con)
    print(views)
    
  10. Exécutez le bloc. Vous devriez voir character(0) comme seule sortie.

  11. Créez un bloc et saisissez les instructions suivantes entre ```` {r} et .

    code language-r
    glimpse(dv)
    
  12. Exécutez le bloc. Vous devriez voir une sortie similaire à la capture d’écran ci-dessous.

    Étape 2 de la configuration RStudio

A APLATIR ou non

RStudio prend en charge les scénarios suivants pour le paramètre FLATTEN. Voir Aplatir les données imbriquées pour plus d’informations.

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
Paramètre FLATTEN Exemple Pris en charge Remarques
Aucun prod:cja CheckmarkCircle
?FLATTEN prod:cja?FLATTEN CheckmarkCircle Option recommandée.
%3FFLATTEN prod:cja%3FFLATTEN CloseCircle

Informations supplémentaires

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