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 de manière à ce qu’elle pointe vers le flux de données créé à l’étape précédente à l’aide du SDK Web. configure . La variable configure doit être définie sur chaque page afin que vous puissiez l’inclure avec le code d’installation de la bibliothèque.

Utilisez la variable edgeConfigId et orgId propriétés dans le SDK Web configure command :

• Définissez la variable edgeConfigId à l’identifiant du flux de données récupéré à l’étape précédente.
• Définissez la variable orgId à l’organisation IMS de votre entreprise.

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

Vous pouvez éventuellement définir d’autres propriétés dans la variable configure en fonction des exigences de mise en oeuvre de votre entreprise.

Modifiez votre mise en oeuvre Analytics de sorte qu’elle ne repose pas sur AppMeasurement.js ou le s . Définissez plutôt des variables dans un objet JavaScript correctement formaté, qui est converti en objet JSON lorsqu’il est envoyé à Adobe. Pour Couche de données sur votre site vous 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 analytics 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 le divisez pas en objets individuels comme vous le feriez avec XDM. Au lieu de cela, incluez-le comme chaîne si vous avez défini la variable s.products variable :

{
  "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 au s dans votre mise en oeuvre sont supprimés. Vous pouvez utiliser n’importe quelle ressource fournie par JavaScript pour définir cet objet de payload, 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}}}};

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

• Suivi des pages vues: remplacez l’appel de suivi des pages vues par le SDK Web. sendEvent command :

  code language-js
  // 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 variable clickCollectionEnabled La propriété de configuration est activée par défaut. Il définit automatiquement les variables de suivi des liens correctes pour envoyer des données à Adobe Analytics. Pour désactiver le suivi automatique des liens, définissez cette propriété sur false dans la fonction 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.

  code language-js
  // 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 au 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 correcte, AppMeasurement.js n’est plus nécessaire sur votre site et toutes les références à ce script peuvent être supprimées.