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.
Quelle est la différence entre id, instanceid et profileid ?
- 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
Nombre de profils ayant rejoint 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
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
Règle ayant empêché un profil de rejoindre un parcours donné
Cette requête renvoie les informations sur l’ensemble de règles et les règles rejetées lorsqu’un profil ne peut pas entrer dans un parcours en raison des règles de limitation ou d’éligibilité.
Exemple
| code language-sql |
|---|
|
Nombre d’erreurs qui se sont produites sur chaque nœud d’un parcours spécifique pendant une certaine période
Cette requête comptabilise les profils distincts qui ont rencontré des erreurs à chaque nœud d’un parcours, regroupés par nom de nœud. Elle inclut tous les types d’erreurs d’exécution d’action et de récupération.
Requête du lac de données
| code language-sql |
|---|
|
Nombre d’événements rejetés d’un parcours spécifique pendant une certaine période
Cette requête compte le nombre total d’événements qui ont été ignorés d’un parcours. Il filtre divers codes d’événement d’ignorance, y compris les erreurs de tâche d’exportation de segments, les abandons du Dispatcher et les abandons de machine d’état.
Requête du lac de données
| code language-sql |
|---|
|
Qu’advient-il d’un profil spécifique dans un parcours spécifique pendant une période spécifique ?
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.
Requête du lac de données
| code language-sql |
|---|
|
Durée écoulée entre deux nœuds
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 |
|---|
|
Vérification des détails d’un événement serviceEvent
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
Rechercher si un profil a rejoint un parcours spécifique
Cette requête vérifie si un profil spécifique a rejoint un parcours en comptant les événements associés à cette combinaison de profil et de parcours.
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.
Rechercher si un message spécifique a été envoyé à un profil
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é.
Rechercher tous les messages reçus par un profil au cours des 30 derniers jours
Cette requête récupère toutes les actions de message exécutées avec succès pour un profil spécifique au cours des 30 derniers jours, regroupées par nom de message.
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é.
Rechercher tous les parcours qu’un profil a rejoint au cours des 30 derniers jours
Cette requête renvoie tous les parcours qu’un profil spécifique a saisis au cours des 30 derniers jours, ainsi que le nombre d’entrées pour chaque parcours.
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.
Nombre de profils qualifiés pour un parcours par jour
Cette requête fournit une répartition quotidienne du nombre de profils distincts entrés dans un parcours sur une période spécifiée.
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.
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
Requêtes relatives à la lecture d’audience read-segment-queries
Temps nécessaire pour terminer un traitement d’export d’audiences
Cette requête calcule la durée d’une tâche d’exportation d’audience en recherchant la différence de temps entre le moment où la tâche a été mise en file d’attente et celui où elle s’est terminée.
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é.
Nombre de profils qui ont été ignorés par le parcours, car il s’agissait de doublons
Cette requête comptabilise le nombre de profils distincts qui ont été ignorés en raison d’erreurs de duplication des instances lors de l’activité Lecture d’audience.
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.
Nombre de profils qui ont été ignorés par le parcours en raison d<>un espace de noms non valide
Cette requête renvoie le nombre de profils qui ont été ignorés, car ils contenaient un espace de noms non valide ou une identité manquante pour l’espace de noms requis.
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.
Nombre de profils qui ont été ignorés par le parcours en raison de l<>absence de carte d<>identité
Cette requête comptabilise les profils qui ont été ignorés, car il leur manquait un mappage d’identité requis pour l’exécution du parcours.
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.
Nombre de profils qui ont été ignorés par le parcours, car celui-ci se trouvait dans le nœud de test et que le profil n<>était pas un profil de test
Cette requête identifie les profils qui ont été ignorés lorsque le parcours était en cours d'exécution en mode test, mais pour le profil, l'attribut testProfile n'était pas défini sur true.
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 true.
Nombre de profils qui ont été ignorés par le parcours en raison d<>une erreur interne
Cette requête renvoie le nombre de profils qui ont été ignorés en raison d’erreurs système internes lors de l’exécution du parcours.
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.
Vue d’ensemble de la lecture d’audience pour une version de parcours donnée
Cette requête fournit une vue d’ensemble complète de l’activité Lecture d’audience, y compris les détails de la tâche d’exportation de segments, les codes d’événement, les statuts et le nombre de profils pour toutes les étapes du processus d’exportation d’audience.
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’export
- arrêt de tâche d’export (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 du 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 le déploiement du parcours, événement métier ou problème avec le planificateur.
Obtention des erreurs de lecture d’audience pour une version de parcours donnée
Cette requête filtre les codes d’événement d’erreur spécifiques liés aux échecs de lecture d’audience, tels que les erreurs de création de rubrique, les erreurs d’appel API, les dépassements de délai et les tâches d’exportation ayant échoué.
Requête du lac de données
| code language-sql |
|---|
|
Obtention de l<>état du traitement des tâches d<>exportation
Cette requête récupère le statut du traitement des tâches d’exportation d’audience, indiquant si elles ont réussi ou échoué avec les mesures d’exportation de profil.
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 de la rubrique ou de la tâche d'exportation
- la tâche d’export est toujours en cours d’exécution
Obtention de mesures sur les profils exportés, y compris les abandons et les mesures de tâches d’export pour chaque tâche d’export
Cette requête combine le nombre de profils ignorés avec les mesures de tâche d'exportation afin de fournir une vue complète des performances d'exportation d'audience pour chaque tâche d'exportation individuelle.
Requête du lac de données
| code language-sql |
|---|
|
Obtention de mesures agrégées (traitements d’export d’audiences et abandons) sur tous les traitements d’export
Cette requête agrège les mesures globales de toutes les tâches d’exportation pour une version de parcours donnée. Cette requête est utile pour les parcours récurrents ou les parcours déclenchés par un événement métier avec réutilisation de rubrique.
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
Profil rejeté en raison d’une réalisation d’audience différente de celle configurée
Cette requête identifie les profils qui ont été ignorés, car leur statut de réalisation de l’audience ne correspondait pas à la configuration Qualification de l’audience du parcours (par exemple, configuré pour « enters », mais profil « sorti »).
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.
Événements de qualification d’audience rejetés pour toute autre raison pour un profil spécifique
Cette requête récupère toutes les qualifications d’audience ou tous les événements externes qui ont été ignorés pour un profil spécifique en raison d’erreurs de service internes.
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
Vérifier si un événement métier a été reçu pour un parcours
Cette requête comptabilise le nombre de fois qu'un événement métier a été reçu par un parcours, regroupé par date, au cours d'une période spécifiée.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Vérifier si l’événement externe d’un profil a été rejeté, car aucun parcours associé n’a été trouvé
Cette requête identifie le moment où un événement externe pour un profil spécifique a été ignoré, car aucun parcours actif ou correspondant n'était configuré pour recevoir cet événement.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
Vérifier si un événement externe d’un profil a été rejeté pour toute autre raison
Cette requête récupère les événements externes qui ont été ignorés pour un profil spécifique en raison d’erreurs de service internes, ainsi que l’identifiant d’événement et le code d’erreur.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
Vérifier le nombre de tous les événements rejetés par stateMachine par errorCode
Cette requête agrège tous les événements ignorés par la machine d’état de parcours, regroupés par code d’erreur afin d’identifier les raisons les plus courantes des abandons.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
Vérifier tous les événements rejetés, car une nouvelle entrée n’était pas autorisée
Cette requête identifie tous les événements qui ont été ignorés car un profil a tenté de rejoindre à nouveau un parcours alors qu’une nouvelle entrée n’était pas autorisée dans la configuration du parcours.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
Requêtes courantes basées sur des parcours journey-based-queries
Nombre de parcours actifs quotidiens
Cette requête renvoie un nombre quotidien de versions de parcours uniques qui avaient une activité, ce qui vous aide à comprendre les modèles d’exécution de parcours au fil du temps.
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
Nombre de profils dans un état spécifique à une heure spécifique
Cette requête utilise des expressions de table communes (CTE) pour identifier les profils qui attendent actuellement à un nœud spécifique dans un parcours en recherchant les profils qui sont passés par le nœud mais qui ne sont pas encore passés aux nœuds suivants.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Nombre de profils qui ont quitté le parcours au cours de la période spécifique
Cette requête comptabilise les instances de parcours qui se sont fermées au cours d’une période spécifiée, y compris les sorties dues à des erreurs de fin, des erreurs, des dépassements de délai ou des erreurs de limitation.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Nombre de profils ayant quitté le parcours pendant la période spécifique avec le nœud/l<>état
Cette requête fournit une répartition détaillée des sorties de parcours, indiquant le nom du nœud et le statut de sortie pour chaque instance de sortie afin d’identifier où et pourquoi les profils ont quitté le parcours.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Requêtes liées aux mesures de performances des actions personnalisées query-custom-action
Nombre total d’appels réussis, d’erreurs et de requêtes pour chaque seconde de chaque point d’entrée sur une période spécifique
Cette requête fournit des mesures de performances pour les actions HTTP personnalisées, notamment le nombre total d’appels, les appels réussis, le nombre d’erreurs par type (4xx, 5xx, les délais d’expiration, limités) et le débit en requêtes par seconde pour chaque point d’entrée.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Série temporelle d’appels réussis, d’erreurs et de débits pour chaque point d’entrée sur une période spécifique
Cette requête fournit les mêmes mesures de performances que la requête précédente, mais organisées sous la forme d’une série temporelle, montrant comment les performances des points d’entrée varient au fil du temps avec une granularité minute par minute.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Latence de réponse de chaque point d’entrée aux 50e, 95e, 99e et 99,9e percentiles sur une période spécifique
Cette requête calcule les centiles du temps de réponse pour les points d’entrée d’action personnalisés, ce qui vous aide à comprendre la distribution de la latence et à identifier les valeurs aberrantes de performance à différents seuils de centile.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Série temporelle de percentiles de latence de réponse pour chaque point d’entrée sur une période spécifique
Cette requête fournit des centiles de latence organisés sous la forme d’une série temporelle, ce qui vous permet de suivre l’évolution des temps de réponse des points d’entrée au fil du temps à différents niveaux de centile.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Temps d’attente en file d’attente sur des points d’entrée encombrés aux 50e et 95e percentiles sur une période spécifique
Cette requête analyse les temps d’attente dans la file d’attente pour les points d’entrée limités, en affichant les temps d’attente des 50e et 95e centiles pour vous aider à comprendre l’impact de la limitation sur vos actions personnalisées.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Série temporelle de percentiles de temps d’attente en file d’attente pour chaque point d’entrée encombré
Cette requête fournit des centiles de temps d’attente de file d’attente sous la forme d’une série temporelle, ce qui vous permet de surveiller l’impact de la limitation sur les temps d’attente au fil du temps pour chaque point d’entrée.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Nombre d’erreurs par type et code pour un point d’entrée spécifique sur une période spécifique
Cette requête fournit une répartition détaillée des erreurs pour un point d’entrée spécifique, regroupées par type d’erreur et code d’erreur, y compris des informations sur les tentatives de reprise.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76