Migration d’AppMeasurement vers le SDK Web

Créez un flux de données dans la collecte de données Adobe Experience Platform. Lorsque vous envoyez des données à ce flux de données, elles sont transférées à Adobe Analytics. À l’avenir, ce même flux de données transfère les données vers Customer Journey Analytics.

1. Accédez à experience.adobe.com et connectez-vous à l’aide de vos informations d’identification.
2. Utilisez la page d’accueil ou le sélecteur de produits en haut à droite pour accéder à Collecte de données.
3. Dans le volet de navigation de gauche, sélectionnez Datastreams.
4. Sélectionnez Nouveau flux de données.
5. Saisissez le nom de votre choix, puis sélectionnez Enregistrer.
6. Une fois le flux de données créé, sélectionnez Ajouter un service.
7. Dans le menu déroulant du service, sélectionnez Adobe Analytics.
8. Saisissez le même identifiant de suite de rapports que le site auquel vous envoyez actuellement des données d’analyse. Cliquez sur Enregistrer.

Votre flux de données est maintenant prêt à recevoir et à transmettre des données à Adobe Analytics. Notez l’identifiant de la banque de données, car cet identifiant est requis lors de la configuration du SDK Web dans le code.

Configurez votre mise en oeuvre pour qu’elle pointe vers le flux de données créé à l’étape précédente à l’aide de la commande SDK Web configure . La commande configure doit être définie sur chaque page afin que vous puissiez l’inclure avec le code d’installation de la bibliothèque.

Utilisez les propriétés datastreamId et orgId dans la commande du SDK Web configure :

• Définissez le datastreamId sur l’identifiant de la banque de données récupéré à l’étape précédente.
• Définissez le orgId sur l’organisation IMS de votre organisation.

alloy("configure", {
    datastreamId: "ebebf826-a01f-4458-8cec-ef61de241c93",
    orgId: "ADB3LETTERSANDNUMBERS@AdobeOrg"
});

Vous pouvez éventuellement définir d’autres propriétés dans la commande configure en fonction des exigences d’implémentation de votre entreprise.

Modifiez votre mise en oeuvre Analytics de sorte qu’elle ne repose pas sur AppMeasurement.js ou l’objet s. Définissez plutôt des variables dans un objet JavaScript correctement formaté, qui est converti en objet JSON lorsqu’il est envoyé à l’Adobe. Disposer d’une couche de données sur votre site aide considérablement lors de la définition de valeurs, car vous pouvez continuer à référencer ces mêmes valeurs.

Pour envoyer des données à Adobe Analytics, la charge utile du SDK Web doit utiliser data.__adobe.analytics avec toutes les variables d’analyse définies dans cet objet. Les variables de cet objet partagent les mêmes noms et formats que leurs équivalents de variable d’AppMeasurement. Par exemple, si vous définissez la variable products, ne la divisez pas en objets individuels comme vous le feriez avec XDM. Au lieu de cela, incluez-le comme chaîne si vous définissez la variable s.products :

{
  "data": {
    "__adobe": {
      "analytics": {
        "products": "Shoes,Men's sneakers,1,49.99"
      }
    }
  }
}

En fin de compte, cette payload contient toutes les valeurs souhaitées et toutes les références à l’objet s dans votre mise en oeuvre sont supprimées. Vous pouvez utiliser n’importe quelle ressource fournie par JavaScript pour définir cet objet de charge utile, y compris la notation par points pour définir des valeurs individuelles.

// Define the payload and set objects within it
var dataObj = {data: {__adobe: {analytics: {}}}};
dataObj.data.__adobe.analytics.pageName = window.document.title;
dataObj.data.__adobe.analytics.eVar1 = "Example value";

// Alternatively, set values in an object and use a spread operator to achieve identical results
var a = new Object;
a.pageName = window.document.title;
a.eVar1 = "Example value";
var dataObj = {data:{__adobe:{analytics:{...a}}}};

Mettez à jour toutes les instances où vous appelez s.t() et s.tl(), en les remplaçant par la commande sendEvent . Trois scénarios sont à prendre en compte :

• Suivi des pages vues : remplacez l’appel de suivi des pages vues par la commande SDK Web sendEvent :

  // If your current implementation has this line of code:
  s.t();
  
  // Replace it with this line of code. The dataObj object contains the variables to send.
  alloy("sendEvent", dataObj);
  

• Suivi automatique des liens : la propriété de configuration clickCollectionEnabled est activée par défaut. Il définit automatiquement les variables de suivi des liens correctes pour envoyer des données à Adobe Analytics. Si vous souhaitez désactiver le suivi automatique des liens, définissez cette propriété sur false dans la commande configure.

• Suivi manuel des liens : le SDK Web ne comporte pas de commandes distinctes entre les appels pageview et non pageview. Précisez cette distinction dans l’objet de charge utile.

  // If your current implementation has this line of code:
  s.tl(true,"o","Example custom link");
  
  // Replace it with these lines of code. Add the required fields to the dataObj object.
  dataObj.data.__adobe.analytics.linkName = "Example custom link";
  dataObj.data.__adobe.analytics.linkType = "o";
  dataObj.data.__adobe.analytics.linkURL = "https://example.com";
  alloy("sendEvent", dataObj);
  

Une fois que vous avez supprimé toutes les références à AppMeasurement et à l’objet s, publiez vos modifications dans votre environnement de développement pour vérifier que la nouvelle mise en oeuvre fonctionne. Une fois que vous avez vérifié que tout fonctionne correctement, vous pouvez publier vos mises à jour en production.

Si la migration est effectuée correctement, AppMeasurement.js n’est plus nécessaire sur votre site et toutes les références à ce script peuvent être supprimées.