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.

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

Les sections ci-dessous mettent en évidence les champs clés du mixin CEE qui doivent être utilisés pour que les services intelligents génèrent des informations utiles, y compris des descriptions et des liens vers la documentation de référence pour d'autres exemples.
Le xdm:channel champ (expliqué dans la première section ci-dessous) est requis pour que l’API d’attribution fonctionne avec vos données, tandis que l’IA du client ne comporte aucun champ obligatoire. Tous les autres champs clés sont fortement recommandés, mais pas obligatoires.

xdm:canal

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. Ce champ _doit_être fourni pour que l’API d’attribution fonctionne avec vos données .
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 :
Canal
@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
Courriel
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

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

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 d’Adobe pour aider à faire correspondre vos données au schéma et à les intégrer au service.
Si vous disposez d’un abonnement Adobe Experience Platform et souhaitez mapper et assimiler les données vous-même, suivez les étapes décrites dans la section ci-dessous.

Utilisation d’Adobe Experience Platform

Les étapes ci-dessous nécessitent un abonnement à la plate-forme d’expérience. Si vous n’avez pas accès à la plate-forme, passez directement à la section Étapes suivantes.
Cette section décrit le processus de mappage et d’assimilation des données dans la plate-forme Experience 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 :

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

Si vous importez des données d’Adobe Audience Manager, d’Adobe Analytics ou d’une autre source externe, vous devez 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 Guide du développeur de Catalog Service 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 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 la plate-forme. 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 la plate-forme 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, contactez le service de conseil d’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 :