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, il transfère les données vers Adobe Analytics. À l’avenir, ce même flux de données transfèrera des données à 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 Flux de données.
4. Sélectionnez Nouveau flux de données.
5. Saisissez le nom souhaité, puis sélectionnez Enregistrer.
6. Une fois le flux de données créé, sélectionnez Ajouter un service.
7. Dans le menu déroulant 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 du flux de données, car il est obligatoire lors de la configuration de Web SDK dans le code.

Configurez votre implémentation pour pointer vers le flux de données créé à l’étape précédente à l’aide de la commande Web SDK 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 configure de Web SDK :

• Définissez la datastreamId sur l’identifiant du flux 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 implémentation Analytics de sorte qu’elle ne repose pas sur AppMeasurement.js ou l’objet s. Au lieu de cela, définissez des variables dans un objet JavaScript correctement formaté, qui est converti en objet JSON lorsqu’il est envoyé à Adobe. Le fait d’avoir une ​ couche de données ​ sur votre site est extrêmement utile 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 payload de Web SDK doit utiliser data.__adobe.analytics avec toutes les variables d’analyse définies dans cet objet. Les variables au sein de cet objet partagent des noms et des formats identiques à leurs équivalents de variables 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 en tant que chaîne, exactement comme si vous définissiez la variable s.products :

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

Cette payload contient toutes les valeurs souhaitées et toutes les références à l’objet s dans votre implémentation sont supprimées. 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}}}};

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 sendEvent de Web SDK :

  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 propriété de configuration clickCollectionEnabled est activée par défaut. Il définit automatiquement les variables de suivi des liens appropriées 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 dispose pas de commandes distinctes entre les appels pageview et non-pageview. Fournissez cette distinction dans l’objet de payload.

  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 à l’objet s, publiez vos modifications dans votre environnement de développement afin de vérifier que la nouvelle implémentation fonctionne. Une fois que vous avez validé 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.