Prévisualiser l’exemple de point d’entrée de statut (aperçu du profil)
Adobe Experience Platform vous permet d’ingérer des données client provenant de plusieurs sources afin de créer un profil robuste et unifié pour chacun de vos clients. Lorsque les données sont ingérées dans Experience Platform, un exemple de tâche est exécuté pour mettre à jour le nombre de profils et d’autres mesures liées aux données du profil client en temps réel.
Les résultats de cet exemple de tâche peuvent être affichés à l’aide du point d’entrée /previewsamplestatus, qui fait partie de l’API Real-Time Customer Profile. Ce point d’entrée peut également être utilisé pour répertorier les distributions de profils à la fois par jeu de données et espace de noms d’identité, ainsi que pour générer plusieurs rapports afin de bénéficier d’une meilleure visibilité sur la composition de la banque de profils de votre organisation. Ce guide décrit les étapes requises pour afficher ces mesures à l’aide du point d’entrée de l’API /previewsamplestatus.
Prise en main
Le point d’entrée dʼAPI utilisé dans ce guide fait partie de lʼ Real-Time Customer Profile API. Avant de continuer, consultez le guide de prise en main pour obtenir des liens vers la documentation associée, un guide de lecture des exemples dʼappels API dans ce document et des informations importantes sur les en-têtes requis pour réussir des appels à nʼimporte quel API dʼExperience Platform.
Fragments de profil contre profils fusionnés
Ce guide fait référence à la fois aux « fragments de profil » et aux « profils fusionnés ». Il est important de comprendre la différence entre ces termes avant de continuer.
Chaque profil client est composé de plusieurs fragments de profil qui ont été fusionnés dans le but de former une vue unique pour ce client. Par exemple, si un client interagit avec votre marque sur plusieurs canaux, votre organisation dispose probablement de plusieurs fragments de profil associés à ce client unique apparaissant dans plusieurs jeux de données.
Lorsque des fragments de profil sont ingérés dans Experience Platform, ils sont fusionnés (en fonction d’une politique de fusion) afin de créer un profil unique pour ce client. Par conséquent, il est probable que le nombre total de fragments de profil soit toujours supérieur au nombre total de profils fusionnés, chaque profil étant composé de fragments multiples.
Pour en savoir plus sur les profils et leur rôle dans Experience Platform, commencez par lire la présentation du profil client en temps réel.
Déclenchement de l’exemple de traitement
Lorsque les données activées pour le profil client en temps réel sont ingérées dans Experience Platform, elles sont stockées dans la banque de données Profile. Lorsque l’ingestion d’enregistrements dans la banque de profils augmente ou réduit le nombre total de profils de plus de 3 %, une tâche d’échantillonnage est déclenchée pour mettre à jour le nombre. Le déclenchement de l’échantillon dépend du type d’ingestion utilisé :
- Pour les workflows de données en flux continu, une vérification est effectuée toutes les heures pour déterminer si le seuil d’augmentation ou de diminution de 3 % a été atteint. Si c’est le cas, un exemple de tâche est automatiquement déclenché pour mettre à jour le décompte.
- Pour l’ingestion par lots, dans les 15 minutes suivant l’ingestion réussie d’un lot dans la banque de profils, si le seuil d’augmentation ou de diminution de 3 % est atteint, une tâche est exécutée pour mettre à jour le nombre. À l’aide de l’API Profile, vous pouvez prévisualiser le dernier exemple de tâche réussie, ainsi que répertorier la distribution des profils par jeu de données et par espace de noms d’identité.
Les mesures nombre de profils et profils par espace de noms sont également disponibles dans la section Profiles de l’interface utilisateur d’Experience Platform. Pour plus d’informations sur l’accès aux données de profil à l’aide de l’interface utilisateur, consultez le Profile guide de l’interface utilisateur.
Afficher le dernier statut d’échantillon view-last-sample-status
Vous pouvez afficher les détails du dernier exemple de tâche réussie exécuté pour votre organisation en envoyant une requête GET au point d’entrée /previewsamplestatus. Ce rapport inclut le nombre total de profils dans l’exemple, ainsi que la mesure du nombre de profils ou le nombre total de profils de votre organisation dans Experience Platform.
Le nombre de profils est généré après la fusion de fragments de profil afin de former un seul profil pour chaque client individuel. En d’autres termes, lorsque des fragments de profil sont fusionnés, ils renvoient un nombre de « 1 » profil, car ils sont tous liés à la même personne.
Le nombre de profils inclut également les profils avec attributs (données d’enregistrement) ainsi que les profils contenant uniquement des données de série temporelle (événement), tels que les profils Adobe Analytics. L’exemple de tâche est actualisé régulièrement au fur et à mesure de l’ingestion des données de profil afin de fournir un nombre total de profils à jour dans Experience Platform.
Format d’API
GET /previewsamplestatus
Requête
| code language-shell |
|---|
|
Réponse
Une réponse réussie renvoie le statut HTTP 200 et inclut les détails du dernier exemple de traitement réussi exécuté pour l’organisation.
| note note |
|---|
| NOTE |
Dans cet exemple de réponse, numRowsToRead et totalRows sont égales l’une à l’autre. Cela peut être le cas selon le nombre de profils de votre entreprise dans Experience Platform. Cependant, ces deux nombres sont généralement différents, numRowsToRead étant le plus petit car il représente l’échantillon comme un sous-ensemble du nombre total de profils (totalRows). |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 | |
|---|---|
| Propriété | Description |
numRowsToRead |
Nombre total de profils fusionnés dans l’échantillon. |
sampleJobRunning |
Valeur booléenne qui renvoie un true lorsqu’un exemple de tâche est en cours. Fournit une transparence sur la latence qui se produit lorsqu’un fichier de commandes est chargé vers lorsqu’il est réellement ajouté à la banque de profils. |
docCount |
Nombre total de documents dans la base de données. |
totalFragmentCount |
Nombre total de fragments de profil dans la banque de profils. |
lastSuccessfulBatchTimestamp |
Date et heure de la dernière ingestion par lots réussie. |
streamingDriven |
Ce champ est obsolète et n’a aucune importance pour la réponse. |
totalRows |
Nombre total de profils fusionnés dans Experience Platform, également appelé nombre de profils. |
lastBatchId |
ID de la dernière ingestion par lots. |
status |
Statut du dernier échantillon. |
samplingRatio |
Rapport entre les profils fusionnés échantillonnés (numRowsToRead) et le total des profils fusionnés (totalRows), exprimé en pourcentage au format décimal. |
mergeStrategy |
Stratégie de fusion utilisée dans l’exemple. |
lastSampledTimestamp |
Dernier exemple d’horodatage réussi. |
Répertorier la distribution des profils par jeu de données
Vous pouvez voir la répartition des profils par jeu de données en adressant une requête GET au point d’entrée /previewsamplestatus/report/dataset.
Format d’API
GET /previewsamplestatus/report/dataset
GET /previewsamplestatus/report/dataset?{QUERY_PARAMETERS}
datedate=2024-12-31Requête
La requête suivante utilise le paramètre date pour renvoyer le rapport le plus récent pour la date spécifiée.
| code language-shell |
|---|
|
Réponse
Une réponse réussie renvoie un état HTTP 200 et inclut un tableau data, contenant une liste d’objets de jeu de données.
| note note |
|---|
| NOTE |
| La réponse suivante affichée a été tronquée pour afficher trois jeux de données. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 | |
|---|---|
| Propriété | Description |
sampleCount |
Nombre total de profils fusionnés échantillonnés avec cet identifiant de jeu de données. |
samplePercentage |
Le sampleCount en tant que pourcentage du nombre total de profils fusionnés échantillonnés (la valeur de numRowsToRead telle qu’elle est renvoyée dans le dernier statut d’échantillon), exprimé au format décimal. |
fullIDsCount |
Nombre total de profils fusionnés avec cet identifiant de jeu de données. |
fullIDsPercentage |
Le fullIDsCount en tant que pourcentage du nombre total de profils fusionnés (la valeur totalRows telle qu’elle est renvoyée dans le dernier statut d’échantillon), exprimé au format décimal. |
name |
Nom du jeu de données, tel qu’il est fourni lors de la création du jeu de données. |
description |
Description du jeu de données fournie lors de la création du jeu de données. |
value |
Identifiant du jeu de données. |
streamingIngestionEnabled |
Indique si le jeu de données est activé pour l’ingestion en flux continu. |
createdUser |
ID de l’utilisateur qui a créé le jeu de données. |
reportTimestamp |
Date et heure du rapport. Si un paramètre de date a été fourni pendant la requête, le rapport renvoyé porte sur la date fournie. Si aucun paramètre date n’est fourni, le rapport le plus récent est renvoyé. |
Répartition des profils de liste par espace de noms d’identité
Vous pouvez envoyer une requête GET au point d’entrée /previewsamplestatus/report/namespace pour afficher la répartition par espace de noms d’identité pour tous les profils fusionnés de votre banque de profils. Cela inclut les identités standard fournies par Adobe, ainsi que les identités personnalisées définies par votre organisation.
Les espaces de noms d’identité sont des composants importants du Adobe Experience Platform Identity Service qui servent d’indicateurs du contexte auquel les données client se rapportent. Pour en savoir plus, commencez par lire la présentation des espaces de noms d’identité.
Format d’API
GET /previewsamplestatus/report/namespace
GET /previewsamplestatus/report/namespace?{QUERY_PARAMETERS}
dateYYYY-MM-DD.date=2025-6-20Requête
La requête suivante ne spécifie aucun paramètre date et renvoie le rapport le plus récent.
| code language-shell |
|---|
|
Réponse
Une réponse réussie renvoie le statut HTTP 200 et inclut un tableau data, avec des objets individuels contenant les détails de chaque espace de noms. La réponse affichée a été tronquée afin d’afficher quatre espaces de noms.
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 | |
|---|---|
| Propriété | Description |
sampleCount |
Nombre total de profils fusionnés échantillonnés dans l’espace de noms. |
samplePercentage |
Le sampleCount sous la forme d’un pourcentage de profils fusionnés échantillonnés (la valeur de numRowsToRead telle qu’elle est renvoyée dans le dernier état d’échantillon), exprimé au format décimal. |
reportTimestamp |
Date et heure du rapport. Si un paramètre de date a été fourni pendant la requête, le rapport renvoyé porte sur la date fournie. Si aucun paramètre date n’est fourni, le rapport le plus récent est renvoyé. |
fullIDsFragmentCount |
Nombre total de fragments de profil dans l’espace de noms. |
fullIDsCount |
Nombre total de profils fusionnés dans l’espace de noms. |
fullIDsPercentage |
Le fullIDsCount en pourcentage du total des profils fusionnés (la valeur totalRows telle qu’elle est renvoyée dans le dernier état d’échantillon), exprimé au format décimal. |
code |
code de l’espace de noms. Vous pouvez le trouver lors de l’utilisation d’espaces de noms à l’aide de l’API Adobe Experience Platform Identity Service 🔗. Il est également appelé Identity symbol dans l’interface utilisateur d’Experience Platform. Pour en savoir plus, consultez la présentation des espaces de noms d’identité. |
value |
Valeur id pour l’espace de noms . Vous pouvez le trouver lorsque vous utilisez des espaces de noms à l’aide de l’API Identity Service. |
Liste des statistiques des jeux de données dataset-stats
Vous pouvez générer un rapport qui fournit des statistiques sur le jeu de données en envoyant une requête GET au point d’entrée /previewsamplestatus/report/dataset_stats.
Format d’API
GET /previewsamplestatus/report/dataset_stats
Requête
| code language-shell |
|---|
|
Réponse
Une réponse réussie renvoie un état HTTP 200 avec des informations sur les statistiques du jeu de données.
| note note |
|---|
| NOTE |
| La réponse suivante a été tronquée pour afficher trois jeux de données. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 11-row-2 12-row-2 13-row-2 14-row-2 | |
|---|---|
| Propriété | Description |
120days |
Le nombre d’enregistrements qui resteront dans le jeu de données après une expiration de données de 120 jours. |
14days |
Le nombre d’enregistrements qui resteront dans le jeu de données après une expiration de données de 14 jours. |
30days |
Le nombre d’enregistrements qui resteront dans le jeu de données après une expiration de données de 30 jours. |
365days |
Le nombre d’enregistrements qui resteront dans le jeu de données après une expiration de données de 365 jours. |
60days |
Le nombre d’enregistrements qui resteront dans le jeu de données après une expiration de données de 60 jours. |
7days |
Le nombre d’enregistrements qui resteront dans le jeu de données après une expiration de données de 7 jours. |
90days |
Le nombre d’enregistrements qui resteront dans le jeu de données après une expiration de données de 90 jours. |
datasetId |
Identifiant du jeu de données. |
datasetType |
Type de jeu de données. Cette valeur peut être Profiles ou ExperienceEvents. |
percentEvents |
Pourcentage d’enregistrements d’événements d’expérience qui se trouvent dans le jeu de données. |
percentProfiles |
Pourcentage d’enregistrements de profil qui se trouvent dans le jeu de données. |
profileFragments |
Nombre total de fragments de profil qui existent dans le jeu de données. |
records |
Nombre total d’enregistrements de profil ingérés dans le jeu de données. |
totalProfiles |
Nombre total de profils ingérés dans le jeu de données. |
Obtenir la taille du jeu de données character-count
Vous pouvez utiliser ce point d’entrée pour obtenir la taille du jeu de données en octets semaine par semaine.
Format d’API
GET /previewsamplestatus/report/character_count
Requête
| code language-shell |
|---|
|
Réponse
Une réponse réussie renvoie un état HTTP 200 avec des informations sur la taille du jeu de données tout au long des semaines.
| note note |
|---|
| NOTE |
| La réponse suivante a été tronquée pour afficher trois jeux de données. |
| code language-json |
|---|
|
| table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 | |
|---|---|
| Propriété | Description |
datasetId |
Identifiant du jeu de données. |
recordType |
Type de données dans le jeu de données. Le type d’enregistrement affecte la valeur de la variable weeks. Les valeurs prises en charge comprennent keyvalue et timeseries. |
weeks |
Un tableau contenant les informations de taille sur le jeu de données. Pour les jeux de données de type enregistrement keyvalue, il contient la semaine la plus récente ainsi que la taille totale du jeu de données en octets. Pour les jeux de données de type enregistrement timeseries, il contient chaque semaine depuis l’ingestion du jeu de données jusqu’à la semaine la plus récente et la taille totale du jeu de données en octets pour chacune de ces semaines. |
modelName |
Nom du modèle du jeu de données. Les valeurs possibles sont _xdm.context.profile et _xdm.context.experienceevent. |
reportTimestamp |
Date et heure auxquelles le rapport a été généré. |
Étapes suivantes
Maintenant que vous savez comment prévisualiser des données d’exemple dans la banque de profils et exécuter plusieurs rapports sur les données, vous pouvez également utiliser les points d’entrée d’estimation et de prévisualisation de l’API Segmentation Service pour afficher des informations de niveau résumé concernant vos définitions de segment. Ces informations vous permettent de vous assurer que vous isolez l’audience attendue. Pour en savoir plus sur l’utilisation des aperçus et des estimations à l’aide de l’API Segmentation, consultez le guide des points d’entrée aperçu et estimation.