Extension SDK Web Adobe Experience Platform

L’extension AEP Web SDK envoie des données au Adobe Experience Cloud à partir de propriétés web, via le Adobe Experience Platform Edge Network. L’extension Adobe Experience Platform Web SDK permet de diffuser des données sur la plateforme, de synchroniser les identités, de s’inscrire et de collecter automatiquement des données contextuelles.

Configuration de l’extension AEP Web SDK

Cette section fournit une référence pour les options disponibles lors de la configuration de l’extension Adobe Experience Platform Web SDK.

Si l’extension Adobe Experience Platform Web SDK n’est pas encore installée, ouvrez votre propriété, puis sélectionnez Extensions > Catalog, passez la souris sur l’extension Adobe Experience Platform Web SDK et sélectionnez Install.

Pour configurer l'extension, ouvrez l'onglet Extensions, passez la souris sur l'extension, puis sélectionnez Configure.

Nom d’instance

L’extension AEP Web SDK prend en charge plusieurs instances sur la page. Elle permet d’envoyer des données à plusieurs organisations à l’aide d’une configuration Adobe Experience Platform Launch unique. Par défaut, le Name est « alloy ». Vous pouvez toutefois remplacer le nom de l’instance par n’importe quel nom d’objet JavaScript valide. L’extension Adobe Experience Platform exige que chaque instance ait un Config ID et un Organization ID différents.

Config ID

L’Config ID indique à Adobe Experience Platform où les données doivent être acheminées et quelles configurations doivent être utilisées sur le serveur. Cela est nécessaire au fonctionnement de l’extension Adobe Experience Platform. Vous pouvez obtenir un ID de configuration en contactant le service à la clientèle.

Organization ID

L’Organization ID correspond à l’organisation à laquelle vous souhaitez envoyer les données chez Adobe. La plupart du temps, vous devez utiliser la valeur par défaut renseignée automatiquement. Si vous avez plusieurs instances sur la page, indiquez la valeur de la deuxième organisation à laquelle vous souhaitez envoyer des données.

Edge Domain

Le Edge Domain est le domaine vers lequel/à partir duquel l’extension Adobe Experience Platform envoie et reçoit des données. L’extension exige l’utilisation d’un CNAME propriétaire pour le trafic de production. Le domaine tiers par défaut fonctionne pour les environnements de développement, mais ne convient pas aux environnements de production. Les instructions de configuration d’un CNAME propriétaire sont répertoriées ici.

Enable Errors

En cas d’erreur avec l’extension, l’erreur est consignée par défaut dans la console. Si vous souhaitez masquer les erreurs dans un environnement de production, vous pouvez décocher la case Enable Errors. Les erreurs seront toujours imprimées lorsque le débogage est activé dans Platform Launch.

Enable Opt-in

Si Enable Opt-in est activé, l’extension AEP Web SDK peut contenir des accès jusqu’à ce que l’inclusion soit reçue. L’extension expose une action permettant de définir les préférences de l’inclusion.

Enable Migrate ECID

L’extension AEP Web SDK utilise un nouveau cookie pour stocker l’ECID. Ce paramètre assure la compatibilité entre le nouveau cookie et l’ancien cookie à des fins de migration. Adobe recommande vivement de l’activer, sauf si aucun visiteur existant ne dispose d’un ECID.

Use 3rd Party Cookies

Adobe Experience Platform stocke toujours les cookies dans le domaine propriétaire. Cette option vous permet d’utiliser un cookie tiers défini sur demdex.net en plus du cookie du domaine propriétaire. Cela peut s’avérer utile lorsque des utilisateurs se déplacent entre plusieurs domaines. Cela désactive les appels vers demdex.net.

Context

L’extension recueille automatiquement des informations sur le contexte de la requête (par exemple, des détails sur l’URL et sur le navigateur). Vous pouvez désactiver cette option en désélectionnant des contextes spécifiques.

  • web - Détails sur la page web, tels que l’URL, le référent, etc.
  • device - Détails sur l’appareil, tels que l’orientation de l’écran, la hauteur d’écran et la largeur d’écran.
  • environment - Informations sur l’environnement informatique (navigateur, connexion, etc.)
  • location - Informations limitées sur l’emplacement de l’utilisateur

Types d’actions

Envoyer un événement

Envoi d’un événement à Adobe Experience Platform afin qu’Adobe Experience Platform puisse collecter les données envoyées et agir sur ces informations. Vous devez sélectionner une instance (si vous en avez plusieurs). Si l’événement se produit au début du chargement d’une page ou lors d’un changement d’affichage dans une application d’une seule page, sélectionnez Occurs at the start of a view.

Toutes les données que vous souhaitez envoyer peuvent être envoyées dans le champ XDM Data. Il doit s’agir d’un objet JSON conforme à la structure de votre schéma XDM. Cet objet peut être créé sur votre page ou par l’intermédiaire d’un Custom Code Data Element.

Définir le consentement

Une fois que vous avez reçu le consentement de votre utilisateur, celui-ci doit être communiqué au SDK Web AEP. Pour ce faire, utilisez le type d’action "Définir le consentement". Actuellement, deux types de normes sont pris en charge : "Adobe" et "IAB TCF". Si vous utilisez la norme Adobe, vous pouvez actuellement définir le consentement sur "Entrée", "Sortie" ou vous pouvez le fournir à l’aide d’un élément de données. Si vous utilisez la norme IAB TCF, indiquez la version et la valeur que vous souhaitez utiliser, ainsi que des informations supplémentaires sur GDPR.

Dans cette action, un champ facultatif vous est également fourni pour inclure une carte d’identité afin que les identités puissent être synchronisées une fois le consentement reçu. Cela peut s’avérer utile lorsque le consentement est configuré comme "En attente", car l’appel de consentement sera probablement le premier appel à se déclencher.

Réinitialiser l’identifiant de fusion de Événements

Si vous souhaitez réinitialiser l’ID de fusion de événement sur votre page, vous pouvez le faire avec cette action. Pour réinitialiser votre ID, vous devez sélectionner l’ID de fusion que vous souhaitez réinitialiser et déclencher l’action si nécessaire.

Types d’éléments de données

ID de fusion de événement

Cet élément de données fournit un ID de fusion événement lorsqu’il est utilisé. Aucune configuration n’est nécessaire pour cet élément de données. L’élément de données fourni reste le même jusqu’à ce que le visiteur quitte la page ou jusqu’à ce que le type d’action "Réinitialiser l’ID de fusion de Événements" soit utilisé.

Mappage d’identités

L’élément de données de mappage d’identité vous permet de créer des identités à partir d’autres éléments de données ou d’autres valeurs que vous spécifiez. Toutes les identités que vous créez doivent être liées à un espace de nommage correspondant. Cet élément de données fournit une liste déroulante qui affiche tous les espaces de nommage par défaut, ainsi que tous ceux que vous avez créés.

Objet XDM

Toutes les données envoyées au Adobe Experience Platform Web SDK doivent être au format XDM. La mise en forme de vos données est plus facile avec l’élément de données d’objet XDM. Lorsque vous ouvrez pour la première fois cet élément de données, sélectionnez le sandbox et le schéma Adobe Experience Platform appropriés. Après avoir sélectionné votre schéma, vous verrez la structure de votre schéma, que vous pouvez facilement remplir.

Notez que lorsque vous ouvrez certains champs de votre schéma, tels que web.webPageDetails.URL, certains éléments sont automatiquement collectés. Bien que plusieurs éléments soient automatiquement collectés, vous avez la possibilité de les remplacer, si nécessaire. Toutes les valeurs peuvent être renseignées manuellement ou à l’aide d’autres éléments de données.

REMARQUE

Vous n'avez qu'à remplir les renseignements que vous souhaitez recueillir. Tout ce qui n'est pas renseigné sera omis lorsque les données seront envoyées aux solutions.

Sur cette page