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 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 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 XDMpublic. En outre, vous pouvez vue et copier le fichier 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

REMARQUE

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

REMARQUE

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 :

IMPORTANT

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 les champs d'identité au jeu de données

Si vous importez des données à partir de Adobe Audience ManagerAdobe Analytics, ou d’une autre source externe, vous avez la possibilité de définir un champ de schéma comme champ d’identité. Pour définir un champ de schéma en tant que champ d’identité, vue la section relative à la définition des champs d’identité dans le didacticiel IU ou le didacticiel API pour la création d’un schéma.

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.

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

Sur cette page