Génération du rapport de chevauchement de jeux de données

Le rapport de chevauchement de jeux de données offre une visibilité sur la composition du Profile magasin de votre organisation en exposant les jeux de données qui contribuent le plus à votre audience adressable (profils).

En plus de fournir des informations sur vos données, ce rapport peut vous aider à prendre des mesures pour optimiser l’utilisation de votre licence, comme définir une limite de durée de vie de certaines données.

Ce tutoriel décrit les étapes nécessaires à la génération du rapport de chevauchement de jeux de données à l’aide de l’API Real-time Customer Profile et à l’interprétation des résultats pour votre organisation.

Prise en main

Pour utiliser les API Adobe Experience Platform, vous devez d’abord suivre le tutoriel authentification afin de rassembler les valeurs dont vous avez besoin pour les en-têtes requis. Pour en savoir plus sur les API Experience Platform, consultez la documentation Prise en main des API Platform.

Les en-têtes requis pour tous les appels API de ce tutoriel sont les suivants :

  • Authorization: Bearer {ACCESS_TOKEN}: L’ Authorization en-tête nécessite un jeton d’accès précédé du mot Bearer. Une nouvelle valeur de jeton d’accès doit être générée toutes les 24 heures.
  • x-api-key: {API_KEY}: API Key est également appelé Client ID et est une valeur qui ne doit être générée qu’une seule fois.
  • x-gw-ims-org-id: {IMS_ORG}: La variable IMS Org est également appelée Organization ID et ne doit être générée qu’une seule fois.

Après avoir suivi le tutoriel sur l’authentification et rassemblé les valeurs des en-têtes requis, vous êtes prêt à lancer des appels à l’API client en temps réel.

Générer un rapport de chevauchement de jeux de données à l’aide de la ligne de commande

Si vous maîtrisez l’utilisation de la ligne de commande, vous pouvez utiliser la requête cURL suivante pour générer le rapport de chevauchement de jeux de données en exécutant une requête de GET à /previewsamplestatus/report/dataset/overlap.

Requête

La requête suivante utilise le paramètre date pour renvoyer le rapport le plus récent pour la date spécifiée.

curl -X GET \
  https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=2021-04-19 \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
Paramètre Description
date Indiquez la date du rapport à renvoyer. Si plusieurs rapports ont été exécutés à la date, le rapport le plus récent pour cette date est renvoyé. Si un rapport n’existe pas pour la date spécifiée, une erreur d’état HTTP 404 (Not Found) est renvoyée. Si aucune date n’est spécifiée, le rapport le plus récent est renvoyé. Format : AAAA-MM-JJ. Exemple : date=2024-12-31

Réponse

Une requête réussie renvoie un état HTTP 200 (OK) et le rapport de chevauchement de jeux de données. Le rapport comprend un objet data, contenant des listes de jeux de données séparés par des virgules et leur nombre de profils respectif. Pour plus d’informations sur la lecture du rapport, reportez-vous à la section interprétation des données du rapport de chevauchement de jeux de données plus loin dans ce tutoriel.

{
    "data": {
        "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
        "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
        "5eeda0032af7bb19162172a7": 107
    },
    "reportTimestamp": "2021-04-19T19:55:31.147"
}

Générer un rapport de chevauchement de jeux de données à l’aide de Postman

Postman est une plateforme collaborative de développement d’API qui permet de visualiser des appels d’API. Il peut être téléchargé gratuitement à partir du site Web Postman et offre une interface utilisateur facile à utiliser pour effectuer des appels d’API. Les captures d’écran suivantes utilisent l’interface de Postman.

Requête

Pour demander le rapport de chevauchement de jeux de données à l’aide de Postman, procédez comme suit :

  • Dans la liste déroulante, sélectionnez GET comme type de requête.
  • Saisissez les en-têtes requis dans la colonne KEY :
    • Authorization
    • x-api-key
    • x-gw-ims-org-id
  • Saisissez les valeurs que vous avez générées lors de l'authentification dans la colonne VALUE, en remplaçant les accolades ({{ }}) et tout contenu entre accolades.
  • Saisissez le chemin de la requête avec ou sans le paramètre facultatif date :
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap
    or
    https://platform.adobe.io/data/core/ups/previewsamplestatus/report/dataset/overlap?date=YYYY-MM-DD
Paramètre Description
date Indiquez la date du rapport à renvoyer. Si plusieurs rapports ont été exécutés à la date, le rapport le plus récent pour cette date est renvoyé. Si un rapport n’existe pas pour la date spécifiée, une erreur d’état HTTP 404 (Not Found) est renvoyée. Si aucune date n’est spécifiée, le rapport le plus récent est renvoyé.
Format : AAAA-MM-JJ. Exemple : date=2024-12-31

Une fois le type de requête, les en-têtes, les valeurs et le chemin d’accès terminés, sélectionnez Envoyer pour envoyer la requête d’API et générer le rapport.

Réponse

Une requête réussie renvoie un état HTTP 200 (OK) et le rapport de chevauchement de jeux de données. Le rapport comprend un objet data, contenant des listes de jeux de données séparés par des virgules et leur nombre de profils respectif. Pour plus d’informations sur la lecture du rapport, reportez-vous à la section interprétation des données du rapport de chevauchement de jeux de données.

Interprétation des données de rapport de chevauchement de jeux de données

Le rapport de chevauchement de jeux de données généré fournit un horodatage indiquant la date et l’heure du rapport ainsi qu’un objet de données qui inclut des combinaisons uniques d’identifiants de jeu de données sous forme de listes séparées par des virgules. Les sections suivantes apportent des informations supplémentaires sur les composants du rapport.

Horodatage du rapport

La valeur reportTimestamp correspond à la date fournie dans la demande d’API ou, si aucune date n’a été fournie, à l’horodatage du rapport le plus récent.

Liste des identifiants des jeux de données

L’objet data comprend des combinaisons uniques d’identifiants de jeu de données sous forme de listes séparées par des virgules avec le nombre de profils correspondant à cette combinaison de jeux de données.

REMARQUE

La somme de tous les nombres de profils associés à chaque ligne du rapport de chevauchement de jeux de données doit être égale au nombre total de profils dans votre organisation.

Pour interpréter les résultats du rapport, prenez en compte l’exemple suivant :

  "5d92921872831c163452edc8,5da7292579975918a851db57,5eb2cdc6fa3f9a18a7592a98": 123,
  "5d92921872831c163452edc8,5eb2cdc6fa3f9a18a7592a98": 454412,
  "5eeda0032af7bb19162172a7": 107

Ce rapport fournit les informations suivantes :

  • Il existe 123 profils composés de données provenant des jeux de données suivants : 5d92921872831c163452edc8, 5da7292579975918a851db57, 5eb2cdc6fa3f9a18a7592a98.
  • Il existe 454 412 profils composés de données provenant de ces deux jeux de données : 5d92921872831c163452edc8 et 5eb2cdc6fa3f9a18a7592a98.
  • 107 profils se composent uniquement de données provenant du jeu de données 5eeda0032af7bb19162172a7.
  • Il y a un total de 454 642 profils dans l’organisation.

Étapes suivantes

Après avoir suivi ce tutoriel, vous pouvez désormais générer le rapport de chevauchement de jeux de données à l’aide de l’API Real-time Customer Profile. Pour en savoir plus sur l’utilisation des données de profil dans l’API et l’interface utilisateur Experience Platform, commencez par lire la documentation de présentation du profil.

Sur cette page