Préparation des données pour la collecte de données

La préparation des données est un service Adobe Experience Platform qui vous permet de mapper, transformer et valider des données depuis et vers le modèle de données d’expérience (XDM). Lors de la configuration d’un flux de données compatible avec Platform, vous pouvez utiliser les fonctionnalités de préparation des données pour mapper vos données source à XDM lors de leur envoi à Platform Edge Network.

Toutes les données envoyées à partir d’une page web doivent atterrir en Experience Platform sous la forme XDM. Il existe 3 manières de traduire les données d’une couche de données sur la page vers le XDM accepté par l’Experience Platform :

Ce guide se concentre sur la 3e option.

Quand utiliser la préparation de données pour la collecte de données when-to-use-data-prep

Dans deux cas d’utilisation, la préparation des données pour la collecte de données est utile :

Envoyer une couche de données existante à l’Edge Network via WebSDK send-datalayer-via-websdk

La couche de données existante doit être envoyée à l’aide de l’objet data dans la commande sendEvent.

Si vous utilisez des balises, vous devez utiliser le champ Data du type d’action Send Event, comme décrit dans la documentation de l’extension de balise Web SDK.

Le reste de ce guide se concentrera sur la manière de mapper la couche de données aux normes XDM une fois qu’elle a été envoyée par le SDK WebSDK.

Ce guide explique comment mapper vos données dans l’interface utilisateur. Pour respecter les étapes, commencez le processus de création d’un flux de données jusqu’à (et y compris) l’étape de configuration de base.

Pour une démonstration rapide du processus de préparation des données pour la collecte de données, reportez-vous à la vidéo suivante :

Sélectionner les données select-data

Une fois la configuration de base d’un flux de données terminée, sélectionnez Enregistrer et Ajouter un mappage pour passer à l’étape Sélectionner les données. Ensuite, vous devez fournir un exemple d’objet JSON qui représente la structure des données que vous prévoyez d’envoyer à Platform.

Pour capturer les propriétés directement à partir de la couche de données, l’objet JSON doit comporter une seule propriété racine data. Les sous-propriétés de l’objet data doivent ensuite être construites de manière à correspondre aux propriétés de couche de données que vous souhaitez capturer. Sélectionnez la section ci-dessous pour afficher un exemple d’objet JSON correctement formaté avec une racine data.

{
  "data": {
    "eventMergeId": "cce1b53c-571f-4f36-b3c1-153d85be6602",
    "eventType": "view:load",
    "timestamp": "2021-09-30T14:50:09.604Z",
    "web": {
      "webPageDetails": {
        "siteSection": "Product section",
        "server": "example.com",
        "name": "product home",
        "URL": "https://www.example.com"
      },
      "webReferrer": {
        "URL": "https://www.adobe.com/index2.html",
        "type": "external"
      }
    },
    "commerce": {
      "purchase": 1,
      "order": {
        "orderID": "1234"
      }
    },
    "product": [
      {
        "productInfo": {
          "productID": "123"
        }
      },
      {
        "productInfo": {
          "productID": "1234"
        }
      }
    ],
    "reservation": {
      "id": "anc45123xlm",
      "name": "Embassy Suits",
      "SKU": "12345-L",
      "skuVariant": "12345-LG-R",
      "priceTotal": "112.99",
      "currencyCode": "USD",
      "adults": 2,
      "children": 3,
      "productAddMethod": "PDP",
      "_namespace": {
        "test": 1,
        "priceTotal": "112.99",
        "category": "Overnight Stay"
      },
      "freeCancellation": false,
      "cancellationFee": 20,
      "refundable": true
    }
  }
}

Les mêmes règles s’appliquent à l’objet JSON pour capturer les propriétés d’un élément de données d’objet XDM, mais la propriété racine doit plutôt être saisie en tant que xdm. Sélectionnez la section ci-dessous pour afficher un exemple d’objet JSON correctement formaté avec une racine xdm.

{
  "xdm": {
    "environment": {
      "type": "browser",
      "browserDetails": {
        "userAgent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_7_5) AppleWebkit/537.36 (KHTML, like Gecko) Chrome/49.0.2623.112 Safari/537.36",
        "javaScriptEnabled": true,
        "javaScriptVersion": "1.8.5",
        "cookiesEnabled": true,
        "viewportHeight": 900,
        "viewportWidth": 1680,
        "javaEnabled": true
      },
      "domain": "adobe.com",
      "colorDepth": 24,
      "viewportHeight": 1050,
      "viewportWidth": 1680
    },
    "device": {
      "screenHeight": 1050,
      "screenWidth": 1680
    }
  }
}

Vous pouvez sélectionner l’option pour charger l’objet sous forme de fichier ou coller l’objet brut dans la zone de texte fournie. Si le fichier JSON est valide, un schéma d’aperçu s’affiche dans le panneau de droite. Sélectionnez Suivant pour continuer.

Mappage

L’étape Mappage s’affiche et vous permet de mapper les champs de vos données source à ceux du schéma d’événement cible dans Platform. Ensuite, vous pouvez configurer le mappage de deux manières :

Création de règles de mappage create-mapping

Pour créer une règle de mappage, sélectionnez Ajouter un nouveau mappage.

Sélectionnez l’icône de source ( ) et, dans la boîte de dialogue qui s’affiche, sélectionnez le champ source que vous souhaitez mapper dans la zone de travail fournie. Une fois que vous avez choisi un champ, utilisez le bouton Sélectionner pour continuer.

Ensuite, sélectionnez l’icône de schéma ( ) pour ouvrir une boîte de dialogue similaire pour le schéma d’événement cible. Sélectionnez le champ vers lequel vous souhaitez mapper les données avant de confirmer à l’aide du bouton Sélectionner.

La page de mappage réapparaît et affiche le mappage des champs terminé. La section Progression du mappage est mise à jour pour refléter le nombre total de champs qui ont été mappés.

TIP

Si vous souhaitez mapper un tableau d’objets (dans le champ source) à un tableau d’objets différents (dans le champ cible), ajoutez [*] après le nom du tableau dans les chemins d’accès aux champs source et de destination, comme illustré ci-dessous.

Importer les règles de mappage existantes import-mapping

Si vous avez déjà créé un flux de données, vous pouvez réutiliser ses règles de mappage configurées pour un nouveau flux de données.

Pour commencer, sélectionnez Importer le mappage.

Dans la boîte de dialogue qui s’affiche, sélectionnez le flux de données dont vous souhaitez importer les règles de mappage. Une fois le flux de données choisi, sélectionnez Aperçu.

L’écran suivant affiche un aperçu des règles de mappage enregistrées pour le flux de données sélectionné. Assurez-vous que les mappages affichés vous conviennent, puis sélectionnez Importer pour confirmer et ajouter les mappages au nouveau flux de données.

Terminer le mappage

Continuez à suivre les étapes ci-dessus pour mapper le reste des champs au schéma cible. Bien que vous n’ayez pas à mapper tous les champs source disponibles, tous les champs du schéma cible définis selon les besoins doivent être mappés pour terminer cette étape. Le compteur Champs obligatoires indique le nombre de champs obligatoires qui ne sont pas encore mappés dans la configuration actuelle.

Une fois que le nombre de champs requis est nul et que vous êtes satisfait de votre mappage, sélectionnez Enregistrer pour finaliser vos modifications.

Étapes suivantes

Ce guide explique comment mapper les données à XDM lors de la configuration d’un flux de données dans l’interface utilisateur. Si vous avez suivi le tutoriel général sur les flux de données, vous pouvez maintenant revenir à l’étape sur l’affichage des détails des flux de données.