Exemples de requêtes query-examples
Cette section fournit des exemples couramment utilisés pour interroger les événements d’étape de Parcours dans le lac de données. Avant de passer à des cas d’utilisation spécifiques, il est important de comprendre les identifiants clés utilisés dans les données d’événement de parcours.
Assurez-vous que les champs utilisés dans vos requêtes ont des valeurs associées dans le schéma correspondant.
Compréhension des identifiants clés key-identifiers
- 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 dans une exécution de parcours. Si un profil entre à 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
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.
Cette requête renvoie les informations sur l’ensemble de règles et les règles rejetées lorsqu’un profil ne peut pas rejoindre un parcours en raison des règles de limitation ou d’éligibilité.
Exemple
| code language-sql |
|---|
|
Cette requête renvoie les détails de l’événement d’étape pour les profils qui ont été ignorés lors d’un parcours et qui n’ont pas reçu d’action de parcours. Cela permet d’identifier pourquoi les profils ont été ignorés en raison de règles métier telles que les contraintes d’heures calmes.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
Les résultats de la requête affichent les champs clés qui permettent d’identifier la raison des abandons de profil :
-
actionExecutionError - Lorsque la valeur est définie sur
businessRuleProfileDiscarded, cela indique que le profil a été ignoré en raison d’une règle métier. Le champeventTypefournit des détails supplémentaires sur la règle métier spécifique à l'origine de la suppression. -
eventType - Indique le type de règle métier à l'origine de l'abandon :
quietHours: le profil a été ignoré en raison de la configuration des heures calmesforcedDiscardDueToQuietHours: le profil a été ignoré de force, car la limite de mécanisme de sécurisation a été atteinte pour les profils conservés pendant les heures calmes
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 |
|---|
|
Cette requête compte le nombre total d’événements qui ont été supprimés d’un parcours. Elle filtre divers codes d’événement de rejet, y compris les erreurs de traitement d’export de segments, les rejets du Dispatcher et les rejets de machine d’état.
Requête du lac de données
| code language-sql |
|---|
|
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 |
|---|
|
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 du rejet 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.
Exemple de sortie
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ù chaque erreur s’est produite, classées par fréquence. |
Requêtes basées sur un profil profile-based-queries
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.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-1 1-row-1 |
|---|
| EVENT_COUNT |
| 3 |
Cette requête renvoie le nombre exact de fois où un profil est entré dans un parcours. Un résultat supérieur à 0 confirme que le profil est entré dans le parcours.
Méthode 1 : si le nom de votre message n’est pas unique dans le parcours (il est utilisé à plusieurs endroits).
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-1 1-row-1 |
|---|
| MESSAGE_SENT_COUNT |
| 1 |
Un résultat supérieur à 0 confirme l’exécution réussie de l’action de message. 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.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-1 1-row-1 |
|---|
| MESSAGE_SENT_COUNT |
| 1 |
La requête renvoie le nombre de fois où le message a été appelé avec succès pour le profil sélectionné.
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.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 | |
|---|---|
| MESSAGE_NAME | MESSAGE_COUNT |
| Welcome Email | 1 |
| Recommandation de produit | 3 |
| Rappel d’abandon de panier | 2 |
| Newsletter Hebdomadaire | 4 |
La requête renvoie la liste de tous les messages ainsi que leur nombre appelés pour le profil sélectionné.
Cette requête renvoie tous les parcours rejoints par un profil spécifique au cours des 30 derniers jours, ainsi que le nombre d’entrées pour chaque parcours.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-2 1-row-2 2-row-2 3-row-2 | |
|---|---|
| NOM_parcours | ENTRY_COUNT |
| Parcours de bienvenue v2 | 1 |
| Recommandations de produit | 5 |
| Campagne de réengagement | 2 |
La requête renvoie la liste de tous les noms de parcours ainsi que le nombre de fois où le profil interrogé a rejoint chaque parcours.
Cette requête fournit une répartition quotidienne du nombre de profils distincts ayant rejoint un parcours dans une période spécifiée.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| ENTRY_DATE | PROFILES_COUNT |
| 25/11/2024 | 1 245 |
| 24/11/2024 | 1 189 |
| 23/11/2024 | 15 340 |
| 22/11/2024 | 1 205 |
| 21/11/2024 | 1 167 |
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 reprise est activée, le nombre de profils peut être dupliqué sur différents jours s’il est entré à nouveau dans 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
Cette requête calcule la durée d’un traitement d’export d’audience en recherchant la différence de temps entre le moment où le traitement a été mis en file d’attente et celui où il s’est terminé.
| 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é.
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.
| 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.
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.
| 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.
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.
| 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.
Cette requête identifie les profils qui ont été ignorés lorsque le parcours était en cours d’exécution en mode test, mais dont l’attribut testProfile n’était pas défini sur vrai.
| code language-sql |
|---|
|
La requête renvoie tous les identifiants de profil qui ont été ignorés par le parcours, car le traitement d’export a été exécuté en mode test, mais l’attribut testProfile des profils n’était pas défini sur vrai.
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.
| 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.
Cette requête fournit une vue d’ensemble complète de l’activité Lecture d’audience, y compris les détails du traitement d’export de segments, les codes d’événement, les statuts et le nombre de profils pour toutes les étapes du processus d’export 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 de parcours est censée avoir déclenché le traitement d’export en appelant l’orchestrateur, un problème s’est produit dans le flux en amont : problème lors du déploiement de parcours, événement métier ou problème lié au planificateur.
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 temporisations et les traitements d’export ayant échoué.
Requête du lac de données
| code language-sql |
|---|
|
Cette requête récupère le statut des traitements d’export d’audience, indiquant s’ils ont réussi ou échoué avec les mesures d’export de profils.
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’un traitement d’export ou rubrique
- la tâche d’export est toujours en cours d’exécution
Cette requête combine le nombre de profils ignorés avec les mesures de traitement d’export afin de fournir une vue complète des performances d’export d’audience pour chaque traitement d’export.
Requête du lac de données
| code language-sql |
|---|
|
Cette requête agrège les mesures globales de tous les traitements d’export 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
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 de la qualification d’audience du parcours (par exemple, configuré pour « rejoint », 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.
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
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.
| code language-sql |
|---|
|
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.
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
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.
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
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.
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements rejetés dans journey_step_events.
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.
| code language-sql |
|---|
|
Découvrez comment dépanner les types d’événements ignorés dans journey_step_events.
Requêtes pour les profils engageables engageable-profiles-queries
Ces requêtes vous aident à surveiller et à analyser votre nombre de profils engageables. Un profil engageable est un profil unique qui a été engagé par le biais de parcours ou de campagnes au cours des 12 derniers mois. En savoir plus sur Profils engageables et utilisation de la licence.
- Assurez-vous que chaque champ non agrégé est inclus dans la clause
GROUP BY - Évitez de référencer des jeux de données qui n’existent pas dans votre sandbox : confirmez les noms des jeux de données dans l’interface utilisateur de Platform
- Utilisez des
distinctlors du comptage des profils uniques pour éviter les doublons dans les espaces de noms d’identité - Lors de l’utilisation de
LIMIT, placez-le à la fin de la requête aprèsORDER BYclauses .
Cette requête renvoie le nombre de profils distincts qui ont été engagés par un parcours spécifique, ce qui contribue au nombre de profils engageables.
| code language-sql |
|---|
|
Cette requête vous aide à comprendre le nombre de profils uniques qu’un parcours spécifique a contribué au nombre de vos profils engageables au cours des 12 derniers mois.
Cette requête affiche le nombre de profils uniques engagés par chaque parcours dans votre organisation au cours des 12 derniers mois, ce qui vous aide à identifier les parcours qui contribuent le plus au nombre de vos profils engageables.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-3 1-row-3 2-row-3 3-row-3 | ||
|---|---|---|
| PARCOURS_VERSION_ID | NOM_parcours | ENGAGED_PROFILES |
| 67b14482-143e-4f83-9cf5-cfec0fca3d26 | Bienvenue dans Campaign v2 | 125 450 |
| a3c21b89-456d-4e21-b8f3-9a8e7c6d5432 | Parcours de lancement du produit | 98 230 |
| f9e8d7c6-b5a4-3210-9876-543210fedcba | Flux de réengagement | 45 670 |
Cette sortie vous permet d’identifier les parcours qui impliquent le plus de profils et qui contribuent le plus significativement au nombre de profils engageables.
| note note |
|---|
| NOTE |
Cette requête regroupe à la fois les journeyVersionID et les journeyVersionName. Les deux champs doivent être inclus dans la clause GROUP BY, car ils sont sélectionnés dans la requête. L’omission de champs de la clause GROUP BY entraîne l’échec de la requête. |
Cette requête fournit une répartition quotidienne des nouveaux profils engagés, ce qui vous aide à identifier les pics de nombre Profils engageables.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| ENGAGEMENT_DATE | ENGAGED_PROFILES |
| 25/11/2024 | 8 450 |
| 24/11/2024 | 7 820 |
| 23/11/2024 | 125 340 |
| 22/11/2024 | 9 230 |
| 21/11/2024 | 8 670 |
Cette sortie vous permet de surveiller les tendances quotidiennes et d’identifier lorsqu’un grand nombre de profils sont engagés. Dans cet exemple, le 23 novembre montre un pic significatif (125 340 profils) par rapport à l’engagement quotidien type (environ 8 000 profils), ce qui justifierait une enquête pour déterminer quel parcours ou quelle campagne a provoqué l’augmentation de votre nombre de profils engageables.
Cette requête permet d’identifier les parcours qui ont engagé un grand nombre de nouveaux profils au cours des dernières périodes, ce qui peut expliquer des augmentations soudaines du nombre de profils engageables.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-4 1-row-4 2-row-4 3-row-4 | |||
|---|---|---|---|
| PARCOURS_VERSION_ID | NOM_parcours | ENGAGEMENT_DATE | ENGAGED_PROFILES |
| 67b14482-143e-4f83-9cf5-cfec0fca3d26 | Campagne du Vendredi noir | 23/11/2024 | 125 340 |
| a3c21b89-456d-4e21-b8f3-9a8e7c6d5432 | Parcours de lancement du produit | 22/11/2024 | 45 230 |
| f9e8d7c6-b5a4-3210-9876-543210fedcba | Newsletter des fêtes | 21/11/2024 | 32 150 |
Cette requête filtre les parcours qui ont impliqué plus de 1 000 profils par jour au cours des 7 derniers jours. La sortie indique quels parcours et dates spécifiques sont responsables des engagements de profil volumineux. Ajustez le seuil de la clause de HAVING en fonction de vos besoins (par exemple, remplacez > 1000 par > 10000 pour des seuils plus élevés).
Cette requête fournit un nombre de profils uniques engagés dans tous les parcours au cours des 12 derniers mois, ce qui vous donne un aperçu de votre engagement basé sur les parcours.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-1 1-row-1 |
|---|
| TOTAL_ENGAGED_PROFILES |
| 2 547 890 |
Ce nombre unique représente le nombre total de profils uniques qui ont été engagés par au moins un parcours au cours des 12 derniers mois.
| note note |
|---|
| NOTE |
| Cette requête comptabilise des identifiants de profil distincts dans le jeu de données d’événements d’étape de parcours. Le nombre réel de profils engageables affiché dans le Tableau de bord d’utilisation de la licence peut différer légèrement, car il inclut également les profils engagés dans des campagnes et d’autres fonctionnalités de Journey Optimizer autres que parcours. |
Requêtes courantes basées sur des parcours journey-based-queries
Cette requête renvoie un nombre quotidien de versions de parcours uniques qui avaient une activité, ce qui vous permet de comprendre les modèles d’exécution de parcours au fil du temps.
| code language-sql |
|---|
|
Exemple de sortie
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| ACTIVITY_DATE | PARCOURS_ACTIFS |
| 25/11/2024 | 12 |
| 24/11/2024 | 15 |
| 23/11/2024 | 14 |
| 22/11/2024 | 11 |
| 21/11/2024 | 13 |
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
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 |
|---|
|
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 achèvements, des erreurs, des temporisations ou des erreurs de limitation.
Requête du lac de données
| code language-sql |
|---|
|
Exemple
| code language-sql |
|---|
|
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
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, temporisations, limitations) 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 |
|---|
|
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 |
|---|
|
Cette requête calcule les centiles du temps de réponse pour les points d’entrée d’action personnalisés, ce qui vous permet de comprendre la distribution de la latence et d’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 |
|---|
|
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 |
|---|
|
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 permettre de 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 |
|---|
|
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 |
|---|
|
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 |
|---|
|