Mise à jour des audiences Target et des scripts de profil pour la compatibilité de Platform Web SDK

Une fois les mises à jour techniques terminées pour migrer Target vers Platform Web SDK, vous devrez peut-être mettre à jour certaines de vos audiences, scripts de profil et activités pour assurer une transition fluide.

Tous les paramètres de la mbox cible doivent être transmis au format XDM avec une implémentation de Platform Web SDK. Avant de publier vos modifications en production, vous devez :

Ajuster les audiences

Toutes les audiences qui utilisent des paramètres de mbox personnalisés doivent être mises à jour pour utiliser les nouveaux noms de paramètres XDM. Par exemple, un paramètre personnalisé pour page_name serait probablement mappé à web.webpagedetails.pageName.

Pour garantir la compatibilité avec at.js et Platform Web SDK, une méthode consiste à mettre à jour les audiences pertinentes afin que OR conditions soient utilisées, comme illustré ci-dessous :

{modal="regular"}

Modifier les scripts de profil

Les scripts de profil doivent être mis à jour pour référencer de nouveaux noms de paramètres XDM, similaires aux audiences. Outre la modification des noms de paramètre mbox, il n’existe aucune différence dans le fonctionnement des scripts de profil entre une implémentation d’at.js et de Platform Web SDK.

Pour garantir la compatibilité, une méthode consiste à utiliser des conditions OR dans le code de script de votre profil.

Exemple de script de profil :

if(mbox.param('pageName') == 'Product Details'){
  return true
}

Mise à jour du script de profil pour la compatibilité de Platform Web SDK :

if((mbox.param('pageName') == 'Product Details') || (mbox.param('web.webPageDetails.pageName') =='Product Details')){
  return true
}

Pour plus d’informations et de bonnes pratiques, reportez-vous à la documentation dédiée sur les scripts de profil.

Mise à jour des jetons de paramètre pour le contenu dynamique

Si des offres, des conceptions de recommandations ou des activités utilisent le remplacement de contenu dynamique, elles doivent être mises à jour en conséquence pour prendre en compte les nouveaux noms de paramètres XDM.

Selon la manière dont vous utilisez le remplacement de jeton pour les paramètres de mbox, vous pouvez améliorer votre configuration existante pour tenir compte des anciens et des nouveaux noms de paramètre. Cependant, dans les cas où le code JavaScript personnalisé n’est pas possible, comme dans les offres JSON, vous devez créer des copies et effectuer des mises à jour une fois la migration terminée et active sur votre site de production.

Exemple d’offre JSON :

{
  "pageName" : "${mbox.page_name}",
  "layoutVariation" : "grid"
}

Exemple d’offre JSON utilisant les noms de paramètres de SDK web de Platform :

{
  "pageName" : "${mbox.web.webPagedDetails.pageName}",
  "layoutVariation" : "grid"
}

Si vous choisissez d’effectuer des ajustements après la migration pour tenir compte des nouveaux noms de paramètres de mbox XDM, veillez à suspendre les activités affectées pendant l’événement de migration afin d’éviter que les visiteurs ne rencontrent des erreurs d’affichage des activités.

Découvrez ensuite comment valider l’implémentation de Target.