DocumentationExperience PlatformGuide du SDK web

Questions fréquentes

Last update: Mon Mar 11 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Créé pour :

  • Developer

Ce guide répond aux questions fréquentes sur le SDK Web de Adobe Experience Platform.

Qu’est-ce que le SDK Web Adobe Experience Platform ?

Le SDK Web de Adobe Experience Platform est une bibliothèque JavaScript côté client qui vous permet d’interagir avec les différents services de Adobe Experience Cloud.

Le SDK Web envoie les données de manière indépendante de la solution (XDM) au réseau Edge Experience Platform, qui les mappe ensuite aux formats et destinations spécifiques à une solution et les envoie en temps réel.

Pour plus d’informations sur le SDK Web, visionnez la vidéo suivante : Rencontrez Alloy.js et ne plus jamais baliser pour un eVar ou une mbox.

En quoi le SDK Web de Adobe Experience Platform diffère-t-il des solutions précédentes ?

Avant le SDK Web Experience Platform

Actuellement, vous devez déployer différentes bibliothèques JavaScript en fonction de chaque solution.

  • Chaque solution possède sa propre bibliothèque JavaScript, son propre schéma et son propre domaine.
  • Aucune de ces bibliothèques n'a été construite pour fonctionner les unes avec les autres.
  • Les cas d’utilisation inter-solutions et Adobe Experience Platform nécessitent que ces bibliothèques disparates soient interdépendantes, ce qui entraîne des frictions de déploiement.

Bien que les balises dans Platform facilitent le déploiement et la gestion de ces bibliothèques, des problèmes subsistent avec :

  • Taille de la bibliothèque (trop de code Adobe sur une page)
  • Performances (le chargement des sites prend trop de temps)
  • Plusieurs appels pour un cas d’utilisation unique
  • Attente du retour d’ECID avant les appels de personnalisation (cause un retard)
  • Collecte de données fracturées (qu’est-ce qu’une evar ?)
  • Confusions de schémas entre les solutions (A4T)
  • Beaucoup d'autres choses moins optimales

En outre, il n’existe actuellement aucune bibliothèque JavaScript qui envoie directement des données à Adobe Experience Platform.

Avec SDK Web Experience Platform

Le nouveau SDK Web envoie des données pour les solutions suivantes vers une seule destination (réseau Edge Experience Platform) et résout les cas d’utilisation de solution les plus courants mentionnés ci-dessus.

  • Adobe Analytics
  • Adobe Audience Manager
  • Adobe Target
  • Visitor ID (Identifiant visiteur)
  • Adobe Experience Platform

D'autres solutions suivront.

Le SDK Web de Adobe Experience Platform peut également envoyer des données directement à Adobe Experience Platform. Ces données sont au format XDM et sont mappées au schéma de solution côté serveur.

Quelle est la valeur de ce nouveau SDK Web ?

Performances : Le SDK web est plus petit que l’utilisation de toutes les bibliothèques d’Adobe actuelles et permet de charger les pages beaucoup plus rapidement.

Simplicité : La combinaison de XDM, de SDK Web, de balises, de réseau Edge, de solutions Adobe Experience Cloud et de Adobe Experience Platform crée un récit de collecte de données facile à comprendre et simple à suivre.

  • XDM : Schéma indépendant de la solution que vous utilisez pour envoyer des données à Adobe. Plus de balisage pour les eVars ou les mbox.
  • SDK Web : Facilite l’envoi et la réception de données vers Adobe Experience Platform Edge Network.
  • Balises : Simplifie le déploiement et la configuration du SDK Web (et de toute autre balise JavaScript) sur un site.
  • Edge Network : acheminez facilement les données vers Adobe Experience Platform et les solutions au format dont elles ont besoin.
  • Solutions Adobe Experience Platform et Adobe : Activez leur proposition de valeur.

Contrôle : Comme toutes les données utilisent un seul flux de données connecté, vous pouvez logiquement suivre et contrôler à quoi ressemblent les données à chaque milliseconde de son parcours, depuis et vers les applications.

Moderne et prêt pour l'avenir : Le SDK web et sa connexion au réseau Edge ont permis à Adobe de moderniser de manière significative la manière dont l’Adobe traite la collecte de données, la personnalisation, le consentement et l’avenir des cookies tiers. (Il active un domaine propriétaire, géré par Adobe.)

Durée à valeur : Adobe a travaillé dur (et continuera) pour faciliter au maximum le déploiement du SDK Web par le biais de balises et de la mise en correspondance des données côté client avec XDM. Une fois ce travail effectué, toutes les autres solutions d’Adobe et tous les services Adobe Experience Platform peuvent être activés ou désactivés côté serveur. Par exemple, si vous l’utilisez pour Adobe Analytics et que vous souhaitez activer Target ou l’Experience Platform, vous pouvez simplement basculer sur la configuration de la chaîne de données et éclairer ces cas d’utilisation.

Qu’est-ce que alloy.js ?

alloy.js est le nom de la bibliothèque JavaScript du SDK Web. Il est référencé dans le code source et le nom de fichier du SDK.

Les clients doivent-ils acheter Adobe Experience Platform pour utiliser la variable Web SDK?

Non. Tout client Adobe Digital Experience peut utiliser le SDK Web de Adobe Experience Platform gratuitement. Les clients qui souhaitent utiliser la variable Web SDK Vous devrez configurer les autorisations appropriées pour créer des schémas, des jeux de données, des espaces de noms d’identité et des flux de données dans l’interface utilisateur de la collecte de données ou l’interface utilisateur Experience Platform.

Pour plus d’informations sur la configuration de ces autorisations, consultez notre documentation sur gestion des autorisations de collecte de données.

Qui doit utiliser le SDK Web ?

Le SDK Web de Adobe Experience Platform a été développé pour les clients suivants :

  • Utilisateurs de Adobe Experience Platform

    • Si vous devez envoyer des données directement d’un appareil à Adobe Experience Platform, il s’agit de la méthode officiellement recommandée.
    • Adobe sait que l’utilisation du connecteur Adobe Analytics est plus rapide si vous disposez déjà d’Adobe Analytics, mais ce n’est pas la stratégie à long terme pour la collecte de données.

  • Clients de la solution Adobe Experience Cloud

    • Les nouveaux clients Adobe Analytics, Adobe Audience Manager et Adobe Target doivent commencer par le nouveau SDK Web et ne pas utiliser de bibliothèques héritées.
    • Les clients existants qui souhaitent obtenir la mise en oeuvre la plus optimisée possible doivent utiliser le nouveau SDK Web.

Comment accéder au SDK Web ?

Le SDK Web est actuellement disponible pour le grand public et peut être utilisé pour envoyer des données aux produits Adobe Experience Cloud. La possibilité d’envoyer des données à des solutions tierces sera bientôt disponible.

Le SDK est gratuit et est hébergé gratuitement par Adobe. Si nécessaire, vous pouvez le télécharger et l’héberger sur vos propres serveurs sans frais.

Le SDK Web requiert l’accès à configurations de flux de données et l’Experience Platform Générateur de schéma XDM, afin que les serveurs d’Adobe puissent gérer correctement les données entrantes provenant du SDK. Si vous souhaitez y accéder, contactez votre équipe de compte d’Adobe pour lancer le processus de demande.

Quels cas pratiques sont actuellement pris en charge par le SDK Web ?

Le SDK Web évolue rapidement. D’autres cas pratiques sont en cours de traitement. Vous pouvez trouver la variable liste des cas d’utilisation actuellement pris en charge ici.

Les clients actuels doivent-ils rebaliser leurs sites ?

Tout dépend. Le SDK Web de Adobe Experience Platform peut être déployé dans deux styles différents. Un futur document de migration fournira des détails supplémentaires.

  • Juste une autre balise : Si le site est déjà balisé pour les solutions et que vous ne pouvez pas le remarquer, mais que vous souhaitez envoyer des données à Adobe Experience Platform Edge Network pour les cas d’utilisation Experience Platform ou les fonctions de transfert d’événement à venir (voir ci-dessous), vous pouvez ajouter la variable alloy.js sur le site, où fonctionne comme "juste une autre balise".

  • La seule balise : Si vous souhaitez utiliser le SDK Web pour une solution Experience Cloud, vous devez l’utiliser pour all des solutions de cette page. Par exemple, si votre site est déjà balisé pour Adobe Analytics et que vous souhaitez l’utiliser pour Target, vous devez l’utiliser pour , ainsi que pour tout autre site à l’avenir.

En d’autres termes, si vous décidez d’utiliser le SDK Web de Adobe Experience Platform pour des cas d’utilisation non liés à une solution, vous pouvez baliser le site avec alloy.js et passer à une nouvelle solution. Si vous souhaitez l’utiliser pour Adobe Analytics, Target ou Audience Manager, ou pour des cas d’utilisation d’application, vous devrez peut-être supprimer l’un des codes hérités de votre page.

Puis-je migrer les ECID lorsque je commence à utiliser le SDK Web de sorte que les visiteurs de mon site web ne commencent pas à s’afficher comme de nouveaux visiteurs ?

Oui, le SDK Web de Adobe Experience Platform fournit une fonctionnalité de migration des identités. Suivez les instructions de migration des identifiants dans la section Documentation sur l’identité du SDK Web Platform pour plus d’informations.

En quoi le SDK Web est-il différent des balises ?

  • Balises dans Experience Platform gérez le code de l’appareil. Utilisez-les pour déployer plus facilement le code. Ils sont libres et puissants.

  • SDK Web Adobe Experience Platform est le nom officiel du nouveau code qui serait déployé par des balises pour les cas d’utilisation d’Adobe. C'est aussi gratuit et puissant.

  • alloy.js est le nom de fichier du code du SDK Web de Adobe Experience Platform.

Dois-je utiliser des balises pour déployer le SDK Web ?

Non. Vous pouvez télécharger le fichier alloy.js mettez-vous en file.

Toutefois :

  • Le SDK Web de Adobe Experience Platform nécessite un identifiant de flux de données (Datastream ID) afin que le réseau Edge puisse identifier le flux et déterminer ce qu’il faut faire avec les données. Cet identifiant est créé dans Experience Platform. Cela ne signifie pas que vous devez utiliser l’interface utilisateur pour créer des propriétés ou déployer le code JavaScript, mais vous devez utiliser des balises pour créer un ID de configuration.

  • Les balises ne sont pas seulement le meilleur gestionnaire de balises et de SDK disponible. Il facilite le déploiement. alloy.js et mapper les données aux schémas XDM. Si vous décidez de ne pas utiliser de balises, vous devrez gérer le déploiement alloy.js, l’événement et le mappage de vos données dans XDM avant de les envoyer. Ceci est une many processus plus difficile que l’utilisation de balises.

  • Il est recommandé d’utiliser des balises pour déployer alloy.js, même s’il s’agit de la seule balise pour laquelle vous l’utilisez.

Qu’est-ce que le transfert d’événement ?

Si vous utilisez nos SDK et envoyez XDM au réseau Edge, ces nouvelles fonctionnalités de transfert d’événement vous permettent d’installer de nouvelles extensions côté serveur et de mapper ces données à n’importe quel élément (et de les envoyer n’importe où) de notre réseau Edge. Considérez-le comme une "collecte de données en tant que service". Cette option est disponible pour un coût et pour être regroupée dans le cadre de Adobe Experience Platform.

Qu’est-ce qu’un CNAME ou un domaine propriétaire et pourquoi est-ce important ?

Pour plus d’informations sur un CNAME, voir Documentation Adobe

Le SDK Web de Adobe Experience Platform utilise-t-il des cookies ? Si tel est le cas, quels cookies utilise-t-il ?

Oui, le SDK Web utilise actuellement entre un et sept cookies en fonction de votre mise en oeuvre. Vous trouverez ci-dessous une liste des cookies que vous pouvez voir avec le SDK Web et de la manière dont ils sont utilisés :

Nom
maxAge
Page conviviale
Description
kndct_orgid_identity
34128000
395 jours
Le cookie d’identité stocke l’ECID, ainsi que d’autres informations relatives à l’ECID.
kndctr_orgid_consent_check
7200
2 heures
Ce cookie stocke les préférences de consentement de l’utilisateur pour le site web.
kndctr_orgid_consent
15552000
180 jours
Ce cookie basé sur une session indique au serveur de rechercher les préférences de consentement côté serveur.
kndctr_orgid_cluster
1800
30 minutes
Ce cookie stocke la région réseau Edge qui traite les requêtes de l’utilisateur actuel. La région est utilisée dans le chemin d’URL afin que le réseau Edge puisse acheminer la requête vers la région appropriée. Ce cookie a une durée de vie de 30 minutes, de sorte que si un utilisateur se connecte à une autre adresse IP, la demande peut être acheminée vers la région la plus proche.
mbox
63072000
2 ans
Ce cookie s’affiche lorsque le paramètre de migration Target est défini sur true. Cela permet à Target de cookie mbox à définir par le SDK Web.
mboxEdgeCluster
1800
30 minutes
Ce cookie s’affiche lorsque le paramètre de migration Target est défini sur true. Ce cookie permet au SDK Web de communiquer la grappe Edge appropriée à at.js afin que les profils Target puissent rester synchronisés lorsque les utilisateurs naviguent sur un site.
AMCV_##@AdobeOrg
34128000
395 jours
Ce cookie s’affiche uniquement lorsque la migration des identifiants sur le SDK Web de Adobe Experience Platform est activée. Ce cookie est utile lors de la transition vers le SDK Web alors que certaines parties du site utilisent toujours visitor.js. Voir idMigrationEnabled pour plus d’informations.

Lors de l’utilisation du SDK Web, le réseau Edge définit un ou plusieurs des cookies ci-dessus. Le réseau Edge définit tous les cookies avec la variable secure et sameSite="none" attributs.

Si votre site web comporte actuellement des sections sécurisées et non sécurisées, cela peut interférer avec l’identification de l’utilisateur. Lorsqu’un utilisateur passe d’une section sécurisée du site à une section non sécurisée, le réseau Edge génère une nouvelle ECID avec la requête .

Quels sont les navigateurs pris en charge par le SDK Web de Adobe Experience Platform ?

Le SDK Web de Adobe Experience Platform est conçu pour fonctionner de manière optimale dans les dernières versions de Google Chrome, Safari, Firefox, Internet Explorer 11 et Microsoft Edge Chromium. Vous pouvez rencontrer des problèmes lors de l’utilisation de certaines fonctionnalités sur des versions plus anciennes de navigateurs.

Où puis-je obtenir plus d’informations sur le SDK Web de Adobe Experience Platform ?

Prise en charge d’Internet Explorer support-internet-explore

Ce SDK utilise des promesses, qui sont une méthode de communication de l’achèvement des tâches asynchrones. La variable Promesse La mise en oeuvre utilisée par le SDK est prise en charge en mode natif par tous les navigateurs cibles, à l’exception de Internet Explorer. Pour utiliser le SDK sur Internet Explorer, vous devez window.Promise polyfillé.

Pour déterminer si window.Promise est déjà polyfillé :

  1. Ouvrez votre site web dans Internet Explorer.
  2. Ouvrez la console de débogage du navigateur.
  3. Saisissez window.Promise dans la console, puis appuyez sur Entrée.

Si autre chose que undefined s’affiche, window.Promise est déjà polyfillé. Une autre façon de déterminer si window.Promise est polyfillé consiste à charger votre site web après avoir suivi les instructions d’installation ci-dessus. Si le SDK renvoie une erreur à propos d’une promesse, il est probable que window.Promise n’ait pas été polyfillé.

Si vous avez déterminé que vous devez polyfiller window.Promise, incluez la balise de script suivante au-dessus du code de base fourni précédemment :

<script src="https://cdn.jsdelivr.net/npm/promise-polyfill@8/dist/polyfill.min.js"></script>

Cette balise charge un script qui s’assure que window.Promise est une implémentation de promesse valide.

NOTE
Si vous choisissez de charger une implémentation de promesse différente, assurez-vous qu’elle prend en charge Promise.prototype.finally.

Prise en charge d’Internet Explorer

Le SDK Adobe Experience Platform utilise des promesses, qui sont une méthode de communication de l’achèvement des tâches asynchrones. La variable Promesse La mise en oeuvre utilisée par le SDK est prise en charge en mode natif par tous les navigateurs cibles, à l’exception de Internet Explorer. Pour utiliser le SDK sur Internet Explorer, vous devez window.Promise polyfillé.

Une bibliothèque que vous pouvez utiliser pour polyfiller la promesse est promesse-polyfill. Voir documentation promo-polyfill pour plus d’informations sur la procédure d’installation avec NPM.

NOTE
Si vous choisissez de charger une implémentation de promesse différente, assurez-vous qu’elle prend en charge Promise.prototype.finally.
recommendation-more-help
ad108910-6329-42f1-aa1d-5920a2b13636