Show Menu
SUJETS×

Préparation des données en vue de leur utilisation dans les services intelligents

Pour que les services intelligents puissent découvrir des informations issues de vos données de événement marketing, les données doivent être enrichies et conservées de manière sémantique dans une structure standard. Les services intelligents tirent parti des schémas du modèle de données d’expérience (XDM) pour y parvenir. En particulier, tous les jeux de données utilisés dans Intelligent Services doivent être conformes au schéma XDM Consumer ExperienceEvent (CEE) .
Ce document fournit des conseils généraux sur le mappage des données de vos événements marketing de plusieurs canaux à ce schéma, en décrivant les informations sur les champs importants du schéma afin de vous aider à déterminer comment mapper efficacement vos données à leur structure.

Résumé du flux de travail

Le processus de préparation varie selon que vos données sont stockées dans l’Adobe Experience Platform ou en externe. Cette section résume les étapes nécessaires à suivre, selon l'un ou l'autre scénario.

Préparation de données externes

Si vos données sont stockées en dehors de Experience Platform, procédez comme suit :
  1. Contactez les services de conseil Adobe pour demander des informations d'identification d'accès pour un conteneur d'Enregistrement Azure Blob dédié.
  2. A l’aide de vos informations d’identification d’accès, téléchargez vos données vers le conteneur Blob.
  3. Travaillez avec Adobe Consulting Services pour faire correspondre vos données au schéma Comprendre le schéma CEE Consumer ExperienceEvent et les intégrer à Intelligent Services.

Experience Platform préparation des données

Si vos données sont déjà stockées dans Platform, procédez comme suit :
  1. Examinez la structure du schéma Comprendre le schéma CEE Consumer ExperienceEvent et déterminez si vos données peuvent être mises en correspondance avec ses champs.
  2. Contactez les services de conseil Adobe pour vous aider à mapper vos données au schéma et à les intégrer dans les services intelligents, ou suivez les étapes décrites dans ce guide si vous souhaitez mapper les données vous-même.

Comprendre le schéma CEE

Le schéma Consumer ExperienceEvent décrit le comportement d’une personne en ce qui concerne les événements de marketing numérique (Web ou mobile) ainsi que l’activité de commerce en ligne ou hors ligne. L'utilisation de ce schéma est requise pour les services intelligents en raison de ses champs (colonnes) sémantiquement bien définis, évitant ainsi les noms inconnus qui, autrement, rendraient les données moins claires.
Le schéma CEE, comme tous les schémas XDM ExperienceEvent, capture l’état du système basé sur les séries chronologiques lorsqu’un événement (ou un ensemble de événements) s’est produit, y compris le moment et l’identité du sujet concerné. Les Événements d'expérience sont des données factuelles de ce qui s'est passé, et ils sont donc immuables et représentent ce qui s'est passé sans agrégation ni interprétation.
Les services intelligents utilisent plusieurs champs clés de ce schéma pour générer des informations à partir des données de vos événements marketing, qui se trouvent tous au niveau racine et sont développés pour afficher leurs sous-champs requis.
Comme tous les schémas XDM, le mixin CEE est extensible. En d’autres termes, des champs supplémentaires peuvent être ajoutés au mixin CEE et différentes variantes peuvent être incluses dans plusieurs schémas si nécessaire.
Un exemple complet du mixin peut être trouvé dans le référentiel XDM public et doit servir de référence pour les champs clés décrits dans la section ci-dessous.

Champs clés

Il y a plusieurs champs clés dans le mixin CEE qui doivent être utilisés pour que les services intelligents puissent générer des informations utiles. Cette section décrit le cas d’utilisation et les données attendues pour ces champs et fournit des liens vers la documentation de référence pour d’autres exemples.

Champs obligatoires

Bien que l’utilisation de tous les champs clés soit fortement recommandée, deux champs sont requis pour que les services intelligents fonctionnent :

Identité du Principal

L'un des champs de votre schéma doit être défini en tant que champ d'identité principal, ce qui permet à Intelligent Services de lier chaque instance de données de séries chronologiques à une personne.
Vous devez déterminer le meilleur champ à utiliser comme identité principale en fonction de la source et de la nature de vos données. Un champ d'identité doit inclure un espace de nommage d' identité qui indique le type de données d'identité que le champ attend comme valeur. Certaines valeurs d’espace de nommage valides sont les suivantes :
  • "email"
  • "phone"
  • "mcid" (pour les ID d’Adobe Audience Manager)
  • "aid" (pour les identifiants Analytics Adobe)
Si vous ne savez pas quel champ vous devez utiliser comme identité principale, contactez les services de conseil d’Adobe pour déterminer la meilleure solution.

xdm:timestamp

Ce champ représente la date et l'heure auxquelles le événement s'est produit. Cette valeur doit être fournie sous forme de chaîne, conformément à la norme ISO 8601.

xdm:canal

Ce champ est obligatoire uniquement lors de l’utilisation de l’API d’attribution.
Ce champ représente le canal marketing associé à ExperienceEvent. Ce champ contient des informations sur le type de canal, le type de support et le type d’emplacement.
Exemple de schéma
{
  "@id": "https://ns.adobe.com/xdm/channels/facebook-feed",
  "@type": "https://ns.adobe.com/xdm/channel-types/social",
  "xdm:mediaType": "earned",
  "xdm:mediaAction": "clicks"
}

Pour obtenir des informations complètes sur chacun des sous-champs requis pour xdm:channel , veuillez consulter la section schéma du canal d’expérience. Pour obtenir des exemples de mappages, reportez-vous au tableau ci-dessous .
Exemples de mappages de canaux
Le tableau suivant fournit quelques exemples de canaux marketing mappés au xdm:channel schéma :
Channel
@type
mediaType
mediaAction
Recherche payante
https:/ /ns.adobe.com/xdm/canal-types/search
payé
clicks
Social - Marketing
https:/ /ns.adobe.com/xdm/canal-types/social
gagné
clicks
Afficher
https:/ /ns.adobe.com/xdm/canal-types/display
payé
clicks
Email
https:/ /ns.adobe.com/xdm/canal-types/email
payé
clicks
Parrain interne
https:/ /ns.adobe.com/xdm/canal-types/direct
détenu
clicks
Afficher la vue publicitaire
https:/ /ns.adobe.com/xdm/canal-types/display
payé
impressions
Redirection du code QR
https:/ /ns.adobe.com/xdm/canal-types/direct
détenu
clicks
Mobile
https:/ /ns.adobe.com/xdm/canal-types/mobile
détenu
clicks

Champs recommandés

Les autres champs clés sont décrits dans cette section. Bien que ces champs ne soient pas nécessairement requis pour que les services intelligents fonctionnent, il est fortement recommandé d’en utiliser autant que possible afin d’obtenir des informations plus précises.

xdm:productListItems

Ce champ est un tableau d'articles qui représentent les produits sélectionnés par un client, y compris le SKU, le nom, le prix et la quantité du produit.
Exemple de schéma
[
  {
    "xdm:SKU": "1002352692",
    "xdm:name": "24-Watt 8-Light Chrome Integrated LED Bath Light",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 159.45
  },
  {
    "xdm:SKU": "3398033623",
    "xdm:name": "16ft RGB LED Strips",
    "xdm:currencyCode": "USD",
    "xdm:quantity": 1,
    "xdm:priceTotal": 79.99
  }
]

Pour obtenir des informations complètes sur chacun des sous-champs obligatoires pour xdm:productListItems , veuillez consulter la section du schéma de détails commerciaux.

xdm:commerce

Ce champ contient des informations propres au commerce sur ExperienceEvent, notamment le numéro de bon de commande et les informations de paiement.
Exemple de schéma
{
    "xdm:order": {
      "xdm:purchaseID": "a8g784hjq1mnp3",
      "xdm:purchaseOrderNumber": "123456",
      "xdm:payments": [
        {
          "xdm:transactionID": "transactid-a111",
          "xdm:paymentAmount": 59,
          "xdm:paymentType": "credit_card",
          "xdm:currencyCode": "USD"
        },
        {
          "xdm:transactionId": "transactid-a222",
          "xdm:paymentAmount": 100,
          "xdm:paymentType": "gift_card",
          "xdm:currencyCode": "USD"
        }
      ],
      "xdm:currencyCode": "USD",
      "xdm:priceTotal": 159
    },
    "xdm:purchases": {
      "xdm:value": 1
    }
  }

Pour obtenir des informations complètes sur chacun des sous-champs obligatoires pour xdm:commerce , veuillez consulter la section du schéma de détails commerciaux.

xdm:web

Ce champ représente les détails Web relatifs à ExperienceEvent, tels que l’interaction, les détails de la page et le parrain.
Exemple de schéma
{
  "xdm:webPageDetails": {
    "xdm:siteSection": "Shopping Cart",
    "xdm:server": "example.com",
    "xdm:name": "Purchase Confirmation",
    "xdm:URL": "https://www.example.com/orderConf",
    "xdm:errorPage": false,
    "xdm:homePage": false,
    "xdm:pageViews": {
      "xdm:value": 1
    }
  },
  "xdm:webReferrer": {
    "xdm:URL": "https://www.example.com/checkout",
    "xdm:referrerType": "internal"
  }
}

Pour obtenir des informations complètes sur chacun des sous-champs requis pour xdm:productListItems , consultez la section du schéma de détails Web ExperienceEvent.

xdm:marketing

Ce champ contient des informations relatives aux activités marketing actives avec le point de contact.
Exemple de schéma
{
  "xdm:trackingCode": "marketingcampaign111",
  "xdm:campaignGroup": "50%_DISCOUNT",
  "xdm:campaignName": "50%_DISCOUNT_USA"
}

Pour obtenir des informations complètes sur chacun des sous-champs obligatoires pour xdm:productListItems , consultez la section marketing sechma .

Mappage et assimilation de données (#mapping)

Une fois que vous avez déterminé si les données de vos événements marketing peuvent être mises en correspondance avec le schéma CEE, l’étape suivante consiste à déterminer les données à importer dans les services intelligents. Toutes les données historiques utilisées dans les services intelligents doivent respecter une période minimale de quatre mois, plus le nombre de jours prévus comme période de consultation.
Après avoir décidé de la plage de données à envoyer, contactez les services de conseil Adobe pour les aider à mapper vos données au schéma et à les intégrer au service.
Si vous avez un Adobe Experience Platform abonnement et souhaitez mapper et assimiler les données vous-même, suivez les étapes décrites dans la section ci-dessous.

Utilisation de l’Adobe Experience Platform

Les étapes ci-dessous nécessitent un abonnement à l'Experience Platform. Si vous n’avez pas accès à Platform, passez directement à la section Étapes suivantes.
Cette section décrit le processus de mappage et d'assimilation de données dans un Experience Platform pour une utilisation dans les services intelligents, y compris les liens vers des didacticiels pour obtenir des étapes détaillées.

Créer un schéma et un jeu de données CEE

Lorsque vous êtes prêt à début pour préparer vos données pour l'assimilation, la première étape consiste à créer un nouveau schéma XDM qui utilise le mixin CEE. Les didacticiels suivants décrivent le processus de création d’un schéma dans l’interface utilisateur ou l’API :
Les didacticiels ci-dessus suivent un processus générique de création d’un schéma. Lorsque vous choisissez une classe pour le schéma, vous devez utiliser la classe ​XDM ExperienceEvent. Une fois cette classe choisie, vous pouvez ajouter le mixin CEE au schéma.
Après avoir ajouté le mixin CEE au schéma, vous pouvez ajouter d’autres mixins en fonction des champs supplémentaires de vos données.
Une fois le schéma créé et enregistré, vous pouvez créer un jeu de données basé sur ce schéma. Les didacticiels suivants décrivent le processus de création d’un nouveau jeu de données dans l’interface utilisateur ou l’API :
Une fois le jeu de données créé, vous pouvez le trouver dans l’interface utilisateur Platform de l’espace de travail Datasets .

Ajouter une balise d'espace de nommage d'identité principale au jeu de données

Les prochaines versions d'Intelligent Services intégreront le service d'identité des Adobes Experience Platform à leurs capacités d'identification des clients. Par conséquent, les étapes décrites ci-dessous peuvent être modifiées.
Si vous importez des données à partir de Adobe Audience Manager​Adobe Analytics, ou d’une autre source externe, vous devez alors ajouter une primaryIdentityNameSpace balise au jeu de données. Pour ce faire, vous pouvez adresser une demande PATCH à l’API du service de catalogue.
Si vous importez des données à partir d’un fichier CSV local, vous pouvez passer à la section suivante sur le mappage et l’assimilation des données .
Avant de suivre l’exemple d’appel d’API ci-dessous, consultez la section Catalog Service guide du développeur Prise en main du Guide du développeur du catalogue pour obtenir des informations importantes sur les en-têtes requis.
Format d’API
PATCH /dataSets/{DATASET_ID}

Paramètre
Description
{DATASET_ID}
ID du jeu de données que vous avez créé précédemment.
Requête
En fonction de la source à partir de laquelle vous importez des données, vous devez fournir les valeurs appropriées primaryIdentityNamespace sourceConnectorId et de balise dans la charge utile de la requête.
La demande suivante ajoute les valeurs de balise appropriées pour l’Audience Manager :
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["mcid"],
          "sourceConnectorId": ["audiencemanager"],
        }
      }'

La demande suivante ajoute les valeurs de balise appropriées pour Analytics :
curl -X PATCH \
  https://platform.adobe.io/data/foundation/catalog/dataSets/5ba9452f7de80400007fc52a \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {IMS_ORG}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
        "tags": {
          "primaryIdentityNameSpace": ["aaid"],
          "sourceConnectorId": ["analytics"],
        }
      }'

Pour plus d'informations sur l'utilisation des espaces de nommage d'identité dans Platform, consultez la présentation de l'espace de nommage d'identité.
Réponse
Une réponse réussie renvoie un tableau contenant l'identifiant du jeu de données mis à jour. Cet identifiant doit correspondre à celui envoyé dans la demande PATCH.
[
    "@/dataSets/5ba9452f7de80400007fc52a"
]

Mapper et assimiler des données

Après avoir créé un schéma CEE et un jeu de données, vous pouvez début de mappage de vos tables de données sur le schéma et d’assimiler ces données dans Platform. Consultez le didacticiel sur le mappage d’un fichier CSV à un schéma XDM pour savoir comment effectuer cette opération dans l’interface utilisateur. Une fois qu'un jeu de données a été renseigné, il est possible d'utiliser le même jeu de données pour importer des fichiers de données supplémentaires.
Si vos données sont stockées dans une application tierce prise en charge, vous pouvez également choisir de créer un connecteur Présentation des connecteurs source source pour intégrer les données de vos événements marketing dans Platform en temps réel.

Étapes suivantes

Ce document fournit des conseils généraux sur la préparation de vos données en vue de leur utilisation dans les services intelligents. Si vous avez besoin de conseils supplémentaires en fonction de votre cas d’utilisation, veuillez contacter le service d’assistance Adobe.
Une fois que vous avez renseigné un jeu de données avec vos données d’expérience client, vous pouvez utiliser les services intelligents pour générer des informations. Pour commencer, reportez-vous aux documents suivants :