Légendes dignes de mention
Target at.js 2.x | SDK Web de Platform | |
---|---|---|
Réduction du scintillement | Le 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 page | Contrô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 contenu | Les 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és | Pris 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 Target | Pris 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ébogage | Les 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 Analytics | Prise en charge native sans besoin de groupement |
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.js | Non 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 |
---|---|
bodyHiddenStyle | Définissez la prehidingStyle avec la commande configure |
bodyHidingEnabled | Si 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. |
clientCode | Automatiquement configuré |
cookieDomain | Non applicable |
crossDomain | Dé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 cspStyleNonce | Reportez-vous à la documentation pour configurer une CSP |
dataProviders | Non pris en charge |
decisioningMethod | Toutes 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 defaultContentVisibleStyle | Applicable 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é. |
deviceIdLifetime | Non 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. |
enabled | La fonctionnalité Target est activée ou désactivée avec la configuration du flux de données. |
globalMboxAutoCreate | Dé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. |
imsOrgId | Définissez le orgId avec la commande configure |
optinEnabled et optoutEnabled | Reportez-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 overrideMboxEdgeServerTimeout | Non applicable. Toutes les demandes du SDK Web Platform utilisent le réseau Adobe Experience Platform Edge. |
pageLoadEnabled | Définissez l’option renderDecisions sur true avec la commande sendEvent |
secureOnly | Non pris en charge. Le SDK Web Platform définit tous les cookies avec les attributs secure et sameSite="none" . |
selectorsPollingTimeout | Non 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. |
serverDomain | Utilisation du paramètre edgeDomain avec la commande configure |
telemetryEnabled | Non applicable |
timeout | Non pris en charge. Il est conseillé de vous assurer que tout code d’atténuation du scintillement comprend un délai d’expiration approprié. |
viewsEnabled | Non 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. |
visitorApiTimeout | Non 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
Appeler | Détails |
---|---|
1 | L’appel renvoie un ID d’Experience Cloud (ECID). Si l’utilisateur est authentifié, un autre appel synchronise l’ID de client. |
2 | La 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). |
3 | La requête de chargement de page est effectuée, y compris tous les paramètres configurés, ECID, SDID et ID de client. |
4 | Les 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. |
5 | En 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. |
6 | Contenu 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. |
7 | Données Analytics envoyées de la page aux serveurs de collecte de données. |
8 | Les 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.