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

Utilisez Data Prep, un service Adobe Experience Platform, pour mapper, transformer et valider des données vers et depuis Modèle de données d’expérience (XDM). Lors de la configuration d’un flux de données compatible avec Experience Platform, vous pouvez utiliser Data Prep fonctionnalités pour mapper vos données source à XDM lors de leur envoi à Adobe Experience Platform Edge Network.

Toutes les données envoyées à partir d’une page web doivent atterrir dans Experience Platform en tant que XDM. Vous disposez de trois méthodes pour traduire les données d’une couche de données sur la page dans le fichier XDM accepté par Experience Platform :

Ce guide couvre la troisième option.

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

La préparation des données pour la collecte de données est utile dans deux cas :

Envoyer une couche de données existante à Edge Network via Web SDK 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 Tags, vous devez utiliser le champ Data du type d’action Send Event.

Le reste de ce guide explique comment mapper la couche de données aux normes XDM après son envoi par le SDK Web.

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

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

Fournir des exemples de données select-data

Sélectionnez Save and Add Mapping après avoir terminé la configuration de base d’un flux de données et l’étape Select data s’affiche. Ensuite, vous devez fournir un exemple d’objet JSON qui représente la structure des données que vous prévoyez d’envoyer à Experience 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 structurées de manière à correspondre aux propriétés de la 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 Next pour continuer.

Mappage des données mapping

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

Créer des règles de mappage create-mapping

Pour créer une règle de mappage, sélectionnez Add new mapping.

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

Sélectionnez ensuite 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 avec Select.

La page de mappage réapparaît et affiche le mappage des champs terminé. La section Mapping progress 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 précédemment 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 Import Mapping.

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

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 Import pour confirmer et ajouter les mappages au nouveau flux de données.

Terminer le mappage complete-mapping

Poursuivez le mappage des champs restants au schéma cible. Bien que vous ne deviez pas mapper tous les champs source disponibles, tous les champs du schéma cible qui sont définis comme obligatoires doivent être mappés pour terminer cette étape. Le compteur Required fields indique le nombre de champs obligatoires qui ne sont pas encore mappés dans la configuration actuelle.

Lorsque le nombre de champs requis atteint zéro et que le mappage vous convient, sélectionnez Save pour finaliser les modifications.

Étapes suivantes next-steps

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 affichage des détails des flux de données.