Légendes dignes de mention

Target at.js 2.xSDK Web de Platform
Réduction du scintillementLe fragment de code de masquage préalable pour les implémentations asynchrones utilise un ID de style at-body-style. at.js recherche cet ID d’élément pour supprimer le style une fois qu’une réponse est reçue.Le fragment de code de masquage préalable par défaut utilise un ID de style alloy-prehiding. Le SDK Web n’est pas compatible avec le fragment de code de masquage préalable d’at.js. Il doit donc être modifié dans le cadre du processus de migration.
Rendu automatique du contenu au chargement de la pageContrôlé avec un paramètre global de Target. Activé lorsque pageLoadEnabled est défini sur true.Spécifié dans la commande SDK Web Platform sendEvent. Activé en définissant l’option renderDecisions sur true.
Rendu manuel du contenuLes fonctions applyOffer() et applyOffers() prennent uniquement en charge l’HTML des paramètres.La commande applyPropositions prend en charge le paramétrage, le remplacement ou l’ajout d’un HTML pour une plus grande flexibilité.
Suivi des événements personnalisésPris en charge avec les fonctions trackEvent() et sendNotifications(). Ces fonctions sont spécifiques à Target et n’ont aucune incidence sur les mesures Adobe Analytics.Toutes les données des appels sendEvent du SDK Web Platform sont transférées à Target. Les données supplémentaires nécessaires spécifiquement à Target doivent être incluses avec la commande sendEvent avec un eventType decisioning.propositionDisplay ou decisioning.propositionInteract pour s’assurer que les mesures Adobe Analytics ne sont pas affectées.
CNAME TargetPris en charge. Il est distinct du CNAME utilisé pour Analytics et du service d’ID Experience Cloud.Plus pertinent. Un seul CNAME peut être utilisé pour tous les appels du SDK Web Platform.
DébogageLes paramètres d’URL mboxDisable, mboxDebug et mboxTrace peuvent être utilisés pour le débogage avec les outils de développement de votre navigateur.

L’Adobe Experience Platform Debugger est également un outil de débogage pris en charge.
Les paramètres d’URL mboxDisable, mboxDebug et mboxTrace ne sont pas pris en charge.

Vous pouvez activer le débogage du SDK Web en ajoutant le alloy_debug=true à votre chaîne de requête ou en exécutant alloy("setDebug", { "enabled": true }); dans votre console de développement.

L’extension de navigateur Adobe Experience Platform Debugger peut être utilisée pour lancer une trace de périphérie pour le débogage.

Pour plus d’informations, consultez la documentation Débogage du SDK Web Platform .
Analytics for Target (A4T)Utilise des valeurs SDID pour regrouper les appels Target et AnalyticsPrise en charge native sans besoin de groupement
NOTE
La migration de Target vers le SDK Web Platform tout en conservant une mise en oeuvre Adobe Analytics d’AppMeasurement existante pour une page donnée n’est pas prise en charge.
Il est possible de migrer votre implémentation d’at.js (et d’AppMeasurement.js) vers le SDK Web Platform une page à la fois. Si vous optez pour cette approche, il est préférable de définir les options idMigrationEnabled et targetMigrationEnabled sur true avec la commande configure.

Fonctions d’at.js et équivalents du SDK Web Platform

De nombreuses fonctions at.js ont une approche équivalente à l’aide du SDK Web Platform décrit dans le tableau ci-dessous. Pour plus d’informations sur les fonctions at.js, consultez le Guide du développeur d’Adobe Target.

fonction at.js 2.xÉquivalent SDK Web Platform
getOffer() et getOffers()Pour demander et générer automatiquement des expériences Target basées sur le VEC, utilisez la commande sendEvent et définissez l’option renderDecisions sur true.

Pour demander des expériences basées sur des formulaires ou du contenu rendu manuel, spécifiez un tableau de decisionScopes (mbox) avec la commande sendEvent.
applyOffer() et applyOffers()Utilisez la commande applyPropositions pour appliquer du contenu. Vous pouvez choisir de définir, remplacer ou ajouter un HTML à un sélecteur spécifique.
triggerView()Le SDK Web Platform déclenche automatiquement un changement d’affichage aux fins du SPA VEC si la propriété web.webPageDetails.viewName est définie sous l’option xdm de la commande sendEvent.
trackEvent() et sendNotifications()Utilisez la commande sendEvent avec un ensemble eventType spécifique :

decisioning.propositionDisplay signale le rendu d’une activité

decisioning.propositionInteract signale une interaction de l’utilisateur avec une activité, comme un clic de souris.
targetGlobalSettings()Pas d'équivalent direct. Pour plus d’informations, consultez la comparaison des paramètres de Target .
targetPageParams() et targetPageParamsAll()Toutes les données transmises dans l’option xdm de la commande sendEvent sont mappées aux paramètres de mbox Target. Puisque les paramètres de mbox sont nommés à l’aide de la notation par points sérialisés, la migration vers le SDK Web Platform peut nécessiter la mise à jour des audiences et des activités existantes pour utiliser les nouveaux noms de paramètres de mbox.

Les données transmises dans le cadre de data.__adobe.target de la commande sendEvent sont mappées à Profil Target et paramètres spécifiques à Recommendations.
événements personnalisés at.jsNon pris en charge. Voir la feuille de route publique pour connaître l’état actuel. Les jetons de réponse sont exposés en tant que partie de propositions dans la réponse de l’appel sendEvent.

Paramètres d’at.js et équivalents du SDK Web Platform

La bibliothèque at.js peut être configurée et téléchargée avec divers paramètres dans l’interface utilisateur de Target. Ces paramètres peuvent également être mis à jour avec la fonction targetGlobalSettings() . Le tableau ci-dessous compare ces paramètres à ceux disponibles avec le SDK Web Platform.

Paramètre at.jsÉquivalent SDK Web Platform
bodyHiddenStyleDéfinissez la prehidingStyle avec la commande configure
bodyHidingEnabledSi un prehidingStyle est défini avec la commande configure, cette fonction est activée. Si aucun style n’est défini, le SDK Web Platform ne tente pas de masquer le contenu.
clientCodeAutomatiquement configuré
cookieDomainNon applicable
crossDomainDéfinissez l’option thirdPartyCookiesEnabled sur true avec la commande configure pour activer les cookies propriétaires et tiers pour les cas d’utilisation inter-domaines.
cspScriptNonce et cspStyleNonceReportez-vous à la documentation pour configurer une CSP
dataProvidersNon pris en charge
decisioningMethodToutes les commandes du SDK Web Platform sendEvent utilisent la prise de décision côté serveur. La prise de décision hybride et sur appareil n’est pas prise en charge.
defaultContentHiddenStyle et defaultContentVisibleStyleApplicable uniquement avec at.js 1.x. Tout comme at.js 2.x, toute atténuation du scintillement pour les expériences basées sur les formulaires peut être réalisée à l’aide de code personnalisé.
deviceIdLifetimeNon pris en charge. Si targetMigrationEnabled est défini sur true avec la commande configure, le cookie mbox est défini avec la durée de vie de l’appareil définie sur 2 ans. Cette valeur n’est pas configurable.
enabledLa fonctionnalité Target est activée ou désactivée avec la configuration du flux de données.
globalMboxAutoCreateDéfinissez l’option renderDecisions sur true avec la commande sendEvent pour récupérer et effectuer automatiquement le rendu des expériences basées sur le VEC.

Demandez un decisionScope pour __view__ si vous préférez effectuer le rendu manuel des expériences basées sur le VEC.
imsOrgIdDéfinissez le orgId avec la commande configure
optinEnabled et optoutEnabledReportez-vous aux options de confidentialité du SDK Web Platform. L’option defaultConsent s’applique à toutes les solutions d’Adobe prises en charge par le SDK Web Platform.
overrideMboxEdgeServer et overrideMboxEdgeServerTimeoutNon applicable. Toutes les demandes du SDK Web Platform utilisent le réseau Adobe Experience Platform Edge.
pageLoadEnabledDéfinissez l’option renderDecisions sur true avec la commande sendEvent
secureOnlyNon pris en charge. Le SDK Web Platform définit tous les cookies avec les attributs secure et sameSite="none".
selectorsPollingTimeoutNon pris en charge. Le SDK Web Platform utilise une valeur de 5 secondes. Si nécessaire, vous pouvez utiliser du code personnalisé pour effectuer le rendu manuel du contenu.
serverDomainUtilisation du paramètre edgeDomain avec la commande configure
telemetryEnabledNon applicable
timeoutNon pris en charge. Il est conseillé de vous assurer que tout code d’atténuation du scintillement comprend un délai d’expiration approprié.
viewsEnabledNon pris en charge. Le contenu des vues Target est toujours récupéré lors du premier appel sendEvent() si renderDecisions est défini sur true ou si la variable __view__ DecisionScope est incluse dans la requête.
visitorApiTimeoutNon applicable

Comparaison des diagrammes système

Les diagrammes suivants doivent vous aider à comprendre les différences de flux de données entre une implémentation Target à l’aide d’at.js et une implémentation à l’aide du SDK Web Platform.

Diagramme du système at.js 2.x

Comportement at.js 2.0 au chargement de la page

AppelerDétails
1L’appel renvoie un ID d’Experience Cloud (ECID). Si l’utilisateur est authentifié, un autre appel synchronise l’ID de client.
2La bibliothèque at.js se charge de manière synchrone et masque le corps du document (at.js peut également être chargé de manière asynchrone avec un extrait de code prémasqué facultatif implémenté sur la page).
3La requête de chargement de page est effectuée, y compris tous les paramètres configurés, ECID, SDID et ID de client.
4Les scripts de profil s’exécutent et sont introduits dans le magasin de profils. Le magasin demande des audiences qualifiées auprès de la bibliothèque d’audiences (par exemple, audiences partagées à partir d’Analytics, d’Audience Manager, etc.). Les attributs du client sont envoyés par lot dans le magasin de profils.
5En fonction de l’URL, des paramètres de requête et des données de profil, Target décide quelles activités et expériences renvoyer au visiteur pour la page active et les futures vues.
6Contenu ciblé renvoyé à la page, comprenant éventuellement des valeurs de profil pour une personnalisation supplémentaire.

Le contenu ciblé sur la page active est affiché aussi rapidement que possible sans scintillement du contenu par défaut.

Le contenu ciblé pour les futures vues d’une application d’une seule page est mis en cache dans le navigateur. Il peut donc être appliqué instantanément sans appel au serveur supplémentaire lorsque les vues sont déclenchées.
7Données Analytics envoyées de la page aux serveurs de collecte de données.
8Les données Target sont associées aux données Analytics par l’intermédiaire du SDID et sont traitées dans le stockage de rapports Analytics. Les données Analytics peuvent ensuite être visualisées à la fois dans Analytics et dans Target au moyen de rapports A4T.

Reportez-vous au guide de développement pour plus d’informations sur la mise en oeuvre de Target à l’aide d’at.js pour les applications d’une seule page.