Exemples de requêtes query-examples
Cette section répertorie plusieurs exemples couramment utilisés pour interroger les événements d’étape du parcours dans le lac de données.
Assurez-vous que les champs utilisés dans vos requêtes ont des valeurs associées dans le schéma correspondant.
- ID : unique pour toutes les entrées d’événement d’étape. Deux événements d’étape différents ne peuvent pas avoir le même identifiant.
- instanceID : instanceID est le même pour tous les événements d’étape associés à un profil lors de l’exécution d’un parcours. Si un profil entre de nouveau dans le parcours, un instanceID différent sera utilisé. Ce nouvel instanceID sera le même pour tous les événements d’étape de l’instance reprise (du début à la fin).
- profileID : identité du profil correspondant à l’espace de noms du parcours.
note note |
---|
NOTE |
À des fins de dépannage, nous vous recommandons d’utiliser journeyVersionID au lieu de journeyVersionName lors de l’interrogation de parcours. Pour plus d’informations sur les attributs des propriétés de parcours, consultez cette section. |
Cas d’utilisation de base/requêtes courantes common-queries
accordion | ||
---|---|---|
Nombre de profils entrés dans un parcours au cours d’une période donnée | ||
Cette requête donne le nombre de profils distincts étant entrés dans le parcours donné dans la période donnée. Requête du lac de données
|
Exemple
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Requête du lac de données
Cette requête renvoie tous les événements d’étape et de service pour le profil et le parcours donnés pour la période spécifiée dans l’ordre chronologique.
code language-sql |
---|
|
Ces requêtes peuvent être utilisées notamment pour estimer le temps passé dans une activité d’attente. Vous pouvez ainsi vous assurer que l’activité d’attente est correctement configurée.
Requête du lac de données
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Le jeu de données Événements de l’étape du parcours contient tous les événements stepEvents et serviceEvents. Les événements stepEvents sont utilisés dans les rapports, dans la mesure où ils se rapportent aux activités (événement, actions, etc.) des profils d’un parcours. Les événements serviceEvents sont stockés dans le même jeu de données et indiquent des informations supplémentaires à des fins de débogage, comme la raison de l’abandon d’un événement d’expérience.
Voici un exemple de requête permettant de vérifier le détail d’un événement serviceEvent :
Requête du lac de données
code language-sql |
---|
|
Erreurs de message/d’action message-action-errors
accordion | ||||
---|---|---|---|---|
Liste de chaque erreur rencontrée dans les parcours | ||||
Cette requête permet de répertorier chaque erreur rencontrée dans les parcours lors de l’exécution d’un message/d’une action. Requête du lac de données
Exemple
Cette requête renvoie toutes les erreurs différentes qui se sont produites lors de l’exécution d’une action dans un parcours, ainsi que le nombre de fois où elles se sont produites. |
Requêtes basées sur un profil profile-based-queries
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Le résultat doit être supérieur à 0. Cette requête renvoie le nombre exact de fois où un profil a rejoint un parcours.
Méthode 1 : si le nom de votre message n’est pas unique dans le parcours (il est utilisé à plusieurs endroits).
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Le résultat doit être supérieur à 0. Cette requête ne nous indique que si l’action du message a bien été exécutée côté parcours.
Méthode 2 : si le nom de votre message est unique dans le parcours.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie la liste de tous les messages ainsi que leur nombre appelés pour le profil sélectionné.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie la liste de tous les messages ainsi que leur nombre appelés pour le profil sélectionné.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie la liste de tous les noms de parcours ainsi que le nombre de fois où le profil interrogé a rejoint le parcours.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie, pour la période définie, le nombre de profils ayant rejoint le parcours chaque jour. Si un profil a rejoint le parcours via plusieurs identités, il sera comptabilisé deux fois. Si la rentrée est activée, le nombre de profils peut être dupliqué sur plusieurs jours si le profil a rejoint le parcours un autre jour.
Requêtes relatives à la lecture d’audience read-segment-queries
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie la différence de temps, en minutes, entre le moment où le traitement d’export d’audiences a été mis en file d’attente et celui où il s’est terminé.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie tous les identifiants de profil qui ont été ignorés par le parcours, car il s'agissait de doublons.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie tous les identifiants de profil qui ont été ignorés par le parcours, car ils contenaient un espace de noms non valide ou aucune identité pour cet espace de noms.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie tous les identifiants de profil qui ont été ignorés par le parcours, car la carte d'identité était manquante.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie tous les identifiants de profil qui ont été ignorés par le parcours, car la tâche d'exportation a été exécutée en mode test, mais le profil n'a pas défini l'attribut testProfile sur vrai.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie tous les identifiants de profil qui ont été ignorés par le parcours en raison d'une erreur interne.
Requête du lac de données
code language-sql |
---|
|
Elle renvoie tous les événements de service liés à la version de parcours donnée. Nous pouvons suivre la chaîne des opérations :
- création de rubrique
- création de tâche d'exportation
- arrêt de tâche d'exportation (avec des mesures sur les profils exportés)
- arrêt de traitement secondaire
Nous pouvons également détecter des problèmes tels que :
- erreurs lors de la création d’un traitement d’export ou de rubrique (y compris les temporisations sur les appels API d’export d’audience)
- tâches d’export pouvant être bloquées (dans le cas d’une version de parcours donnée où aucun événement n’est associé à la fin de la tâche d’export)
- problèmes secondaires, si nous avons reçu un événement de fin de tâche d'exportation, mais pas de fin de traitement secondaire
IMPORTANT : si aucun événement n'est renvoyé par cette requête, cela peut être dû à l'une des raisons suivantes :
- la version du parcours n'a pas atteint le planning
- si la version de parcours est censée déclencher la tâche d'exportation en appelant l'orchestrateur, un problème est survenu dans le flux en amont : problème sur déploiement de parcours, événement métier ou problème avec le planificateur.
Requête du lac de données
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Si aucun enregistrement n'est renvoyé, cela signifie que :
- une erreur s'est produite lors de la création d'une tâche d'exportation ou rubrique
- la tâche d'exportation est toujours en cours d'exécution
Requête du lac de données
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Cette requête est différente de la précédente.
Elle renvoie les mesures globales d'une version de parcours donnée, quelles que soient les tâches qui ont pu être exécutées pour celle-ci (dans le cas de parcours récurrents, les événements métier ont déclenché les tâches exploitant la réutilisation de rubrique).
Requêtes relatives à la qualification de l’audience segment-qualification-queries
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Cette requête renvoie tous les identifiants de profil qui ont été ignorés par la version de parcours en raison d’une réalisation d’audience incorrecte.
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Cette requête renvoie tous les événements (événements externes/événements de qualification d’audience) qui ont été ignorés pour une autre raison pour un profil.
Requêtes basées sur un événement event-based-queries
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Requêtes courantes basées sur des parcours journey-based-queries
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
La requête renvoie, pour la période définie, le nombre de parcours uniques qui se déclenchent chaque jour. Un seul parcours qui se déclenche plusieurs jours sera comptabilisé une fois par jour.
Requêtes sur les instances du parcours journey-instances-queries
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|
Requête du lac de données
code language-sql |
---|
|
Exemple
code language-sql |
---|
|