Show Menu
SUJETS×

Préparer les données à utiliser dans Intelligent Services

Pour Intelligent Services découvrir des informations issues des données de vos événements marketing, les données doivent être enrichies et conservées sémantiquement dans une structure standard. Intelligent Services tirer parti Experience Data Model des schémas (XDM) pour y parvenir. En particulier, tous les jeux de données utilisés dans Intelligent Services doivent être conformes au schéma XDM de 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 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 en 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 les services de conseil en Adobe pour que vos données soient mises en correspondance avec le schéma Comprendre le schéma CEE Consumer ExperienceEvent et assimilées 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 en Adobe pour vous aider à mapper vos données au schéma et à les intégrer Intelligent Servicesou 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 nécessaire pour Intelligent Services cause de ses champs (colonnes) sémantiquement bien définis, en évitant 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.
Intelligent Services utilisez 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.
Vous trouverez un exemple complet du mixin dans le référentiel XDM public. En outre, vous pouvez vue et copier le fichier CEE_XDM_sample_rows.json JSON suivant pour obtenir un exemple de la manière dont les données peuvent être structurées pour se conformer au schéma CEE. Reportez-vous à ces deux exemples au fur et à mesure que vous découvrirez les champs clés décrits dans la section ci-dessous, afin de déterminer comment mapper vos propres données au schéma.

Champs clés

Il y a plusieurs champs clés dans le mixin CEE qui doivent être utilisés pour Intelligent Services 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 Intelligent Services fonctionner :

Identité Principal

L'un des champs de votre schéma doit être défini comme un Principal champ d'identité, 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 :
  • "e-mail"
  • "phone"
  • "mcid" (pour les Adobe Audience Manager ID)
  • "aid" (pour les identifiants Adobe Analytics)
Si vous ne savez pas quel champ vous devez utiliser comme Principale identité, contactez les Services de conseil en 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:channel

Ce champ n’est obligatoire que lorsque vous utilisez Attribution AI.
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
E-mail
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 nécessaires Intelligent Services au travail, 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 qui sont principales 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 que vous devez importer dans Intelligent Services. Toutes les données historiques utilisées dans Intelligent Services doivent se situer dans la période minimale de quatre mois des données, plus le nombre de jours prévus comme période de recherche.
Après avoir décidé de la plage de données à envoyer, contactez les services de conseil en Adobe pour aider à faire correspondre 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 Adobe Experience Platform

Les étapes ci-dessous nécessitent un abonnement à l'Experience Platform. 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 l'Experience Platform en vue de leur utilisation dans Intelligent Services, 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 de la plate-forme de l’espace de travail Datasets .

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

Les prochaines versions de Intelligent Services intégreront le service d'identité de Adobe 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 de 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"],
        }
      }'

For more information on working with identity namespaces in Platform, see the identity namespace overview .
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 requête 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. Vous pouvez utiliser l’ exemple de fichier JSON suivant pour tester le processus d’assimilation avant d’utiliser vos propres données.
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 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 Intelligent Services. Si vous avez besoin de services de conseil 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 les utiliser Intelligent Services pour générer des informations. Pour commencer, reportez-vous aux documents suivants :