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 magasin Profile 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 la définition d’une limite de durée de vie de certaines données.

Ce tutoriel décrit les étapes nécessaires pour générer le rapport de chevauchement de jeux de données à l’aide de l’API Real-Time Customer Profile et interpréter les résultats pour votre organisation.

Commencer

Pour utiliser les API Adobe Experience Platform, vous devez d’abord suivre le tutoriel d’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 de prise en main des API Platform.

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

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: {ORG_ID}' \

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ées par des virgules et leur nombre de profils respectif. Pour plus d’informations sur la lecture du rapport, reportez-vous à la section sur l’ 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ération d’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 de Postman et offre une interface utilisateur facile à utiliser pour effectuer des appels 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 :

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 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ées par des virgules et leur nombre de profils respectif. Pour plus d’informations sur la lecture du rapport, reportez-vous à la section sur l’ 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 interpret-the-report

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

reportTimestamp correspond à la date fournie dans la requête 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.

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 :

É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.