Envoyer des paramètres à Target à l’aide du SDK Web Platform
Les mises en oeuvre de Target diffèrent d’un site web à l’autre en raison de l’architecture du site, des exigences de l’entreprise et des fonctionnalités utilisées. La plupart des implémentations de Target incluent la transmission de divers paramètres pour les informations contextuelles, les audiences et les recommandations de contenu.
Utilisons une page de détails de produit simple et une page de confirmation de commande pour démontrer les différences entre les bibliothèques lors de la transmission de paramètres à Target.
Prenez les deux exemples de pages suivants à l’aide d’at.js :
code language-html |
---|
|
code language-html |
---|
|
Synthèse du mapping des paramètres
Les paramètres Target de ces pages sont envoyés différemment à l’aide du SDK Web Platform. Il existe plusieurs façons de transférer des paramètres à Target à l’aide d’at.js :
- Défini avec la fonction
targetPageParams()
pour l’événement de chargement de page (utilisé dans les exemples de cette page) - Défini avec la fonction
targetPageParamsAll()
pour toutes les requêtes Target sur la page. - Envoyez les paramètres directement avec la fonction
getOffer()
pour un emplacement unique - Envoyez des paramètres directement avec la fonction
getOffers()
pour un ou plusieurs emplacements
Le SDK Web Platform offre un moyen unique et cohérent d’envoyer des données sans avoir besoin de fonctions supplémentaires. Tous les paramètres doivent être transmis dans la payload avec la commande sendEvent
et se classer dans deux catégories :
- Mappé automatiquement à partir de l’objet
xdm
- Transmis manuellement à l’aide de l’objet
data.__adobe.target
Le tableau ci-dessous décrit comment les exemples de paramètres seraient mappés à l’aide du SDK Web Platform :
at_property
sendEvent
.pageName
xdm.web.webPageDetails.name
xdm
et conformes à un schéma à l’aide de la classe XDM ExperienceEvent. Les paramètres de mbox ne peuvent pas être transmis dans le cadre de l’objet data
.profile.gender
data.__adobe.target.profile.gender
data
et précédés du préfixe profile.
pour être mappés correctement.user.categoryId
data.__adobe.target.user.categoryId
data
.entity.id
data.__adobe.target.entity.id
OR
xdm.productListItems[0].SKU
data
ou mappés automatiquement à partir du premier élément du tableau xdm.productListItems
si votre implémentation utilise ce groupe de champs.entity.categoryId
data.__adobe.target.entity.categoryId
data
.entity.customEntity
data.__adobe.target.entity.customEntity
data
.cartIds
data.__adobe.target.cartIds
excludedIds
data.__adobe.target.excludedIds
mbox3rdPartyId
xdm.identityMap
orderId
xdm.commerce.order.purchaseID
orderTotal
xdm.commerce.order.priceTotal
productPurchasedId
data.__adobe.target.productPurchasedId
OR
xdm.productListItems[0-n].SKU
mboxPageValue
data.__adobe.target.mboxPageValue
Paramètres personnalisés
Les paramètres mbox personnalisés doivent être transmis en tant que données XDM avec la commande sendEvent
. Il est important de s’assurer que le schéma XDM inclut tous les champs requis pour votre mise en oeuvre Target.
Exemple d’at.js utilisant targetPageParams()
:
targetPageParams = function() {
return {
"pageName": "product detail"
};
};
Exemples JavaScript du SDK Web Platform à l’aide de la commande sendEvent
:
code language-javascript |
---|
|
Dans les balises, utilisez d’abord un élément de données objet XDM pour mapper le fichier au champ XDM :
{modal="regular"}
Ensuite, incluez votre objet XDM dans votre événement d’envoi action (plusieurs objets XDM peuvent être fusionnés) :
{modal="regular"}
xdm
, vous devez mettre à jour les audiences, les activités ou les scripts de profil qui référencent ces paramètres de mbox à l’aide de leurs nouveaux noms. Pour plus d’informations, consultez la page Mise à jour des audiences Target et des scripts de profil pour la compatibilité du SDK Web Platform de ce tutoriel.Paramètres de profil
Les paramètres de profil Target doivent être transmis sous l’objet data.__adobe.target
dans la payload de commande du SDK Web Platform sendEvent
.
Tout comme at.js, tous les paramètres de profil doivent également comporter le préfixe profile.
pour que la valeur soit correctement stockée en tant qu’attribut de profil Target persistant. Le paramètre réservé user.categoryId
pour la fonctionnalité d’affinité catégorielle de Target est précédé du préfixe user.
.
Exemple d’at.js utilisant targetPageParams()
:
targetPageParams = function() {
return {
"profile.gender": "male",
"user.categoryId": "clothing"
};
};
Exemples de SDK Web Platform à l’aide de la commande sendEvent
:
code language-javascript |
---|
|
Dans les balises , créez d’abord un élément de données pour définir l’objet data.__adobe.target
:
{modal="regular"}
Ensuite, incluez votre objet de données dans votre Envoyer l’événement action (plusieurs objets peuvent être fusionnés) :
{modal="regular"}
Paramètres d’entité
Les paramètres d’entité sont utilisés pour transmettre des données comportementales et des informations de catalogue supplémentaires pour Target Recommendations. Tous les paramètres d’entité pris en charge par at.js sont également pris en charge par le SDK Web Platform. Tout comme les paramètres de profil, tous les paramètres d’entité doivent être transmis sous l’objet data.__adobe.target
dans la payload de commande du SDK Web Platform sendEvent
.
Les paramètres d’entité d’un élément spécifique doivent comporter le préfixe entity.
pour une capture de données correcte. Les paramètres réservés cartIds
et excludedIds
pour les algorithmes de recommandations ne doivent pas être précédés d’un préfixe et la valeur de chacun d’eux doit contenir une liste séparée par des virgules d’identifiants d’entité.
Exemple d’at.js utilisant targetPageParams()
:
targetPageParams = function() {
return {
"entity.id": "SKU-00001-LARGE",
"entity.categoryId": "clothing,shirts",
"entity.customEntity": "some value",
"cartIds": "SKU-00002,SKU-00003",
"excludedIds": "SKU-00001-SMALL"
};
};
Exemples de SDK Web Platform à l’aide de la commande sendEvent
:
code language-javascript |
---|
|
Dans les balises , créez d’abord un élément de données pour définir l’objet data.__adobe.target
:
{modal="regular"}
Ensuite, incluez votre objet de données dans votre Envoyer l’événement action (plusieurs objets peuvent être fusionnés) :
{modal="regular"}
commerce
est utilisé et que le tableau productListItems
est inclus dans la charge utile XDM, la première valeur SKU
de ce tableau est mappée à entity.id
dans le but d’incrémenter une vue de produit.Paramètres d’achat
Les paramètres d’achat sont transmis sur une page de confirmation de commande après une commande réussie et sont utilisés pour les objectifs de conversion et d’optimisation de Target. Avec une implémentation du SDK Web Platform, ces paramètres et sont automatiquement mappés à partir des données XDM transmises dans le cadre du groupe de champs commerce
.
Exemple d’at.js utilisant targetPageParams()
:
targetPageParams = function() {
return {
"orderId": "ABC123",
"productPurchasedId": "SKU-00002,SKU-00003"
"orderTotal": 1337.89
};
};
Les informations d’achat sont transmises à Target lorsque purchases.value
est défini sur 1
pour le groupe de champs commerce
. L’identifiant de commande et le total de la commande sont automatiquement mappés à partir de l’objet order
. Si le tableau productListItems
est présent, les valeurs SKU
sont utilisées pour productPurchasedId
.
Exemples de SDK Web Platform à l’aide de la commande sendEvent
:
code language-javascript |
---|
|
Dans les balises, utilisez d’abord un élément de données objet XDM pour mapper les données aux champs XDM :
{modal="regular"}
Ensuite, incluez votre objet XDM dans votre événement d’envoi action (plusieurs objets XDM peuvent être fusionnés) :
{modal="regular"}
productPurchasedId
peut également être transmise sous la forme d’une liste d’identifiants d’entité séparés par des virgules sous l’objet data
.ID de client (mbox3rdPartyId)
Target permet la synchronisation des profils entre appareils et systèmes à l’aide d’un seul ID de client. Avec at.js, cette variable peut être définie comme mbox3rdPartyId
dans la requête Target ou comme premier ID de client envoyé à l’Experience Cloud Identity Service. Contrairement à at.js, une implémentation du SDK Web Platform vous permet de spécifier l’ID de client à utiliser comme mbox3rdPartyId
s’il en existe plusieurs. Par exemple, si votre entreprise possède un ID de client global et des ID de client distincts pour différents secteurs d’activité, vous pouvez configurer l’ID que Target doit utiliser.
Il existe quelques étapes pour configurer la synchronisation des identifiants pour les cas d’utilisation de Target sur plusieurs appareils et des attributs du client :
- Créez un espace de noms d’identité pour l’ID de client dans l’écran Identités de la collecte de données ou de la plateforme
- Assurez-vous que l’ alias dans les attributs du client correspond au symbole d’identité de votre espace de noms
- Spécifiez le symbole d’identy comme espace de noms d’identifiant tiers Target dans la configuration Target de la banque de données.
- Exécutez une commande
sendEvent
en utilisant le groupe de champsidentityMap
Exemple d’at.js utilisant targetPageParams()
:
targetPageParams = function() {
return {
"mbox3rdPartyId": "TT8675309"
};
};
Exemples de SDK Web Platform à l’aide de la commande sendEvent
:
code language-javascript |
---|
|
La valeur ID, État authentifié et Espace de noms sont capturés dans un élément de données carte des identités :
{modal="regular"}
L’élément de données Identity Map est ensuite utilisé pour définir le champ identityMap dans l’élément de données objet XDM :
{modal="regular"}
L’ objet XDM est alors inclus dans l’action Envoyer l’événement d’une règle :
{modal="regular"}
Dans le service Adobe Target de votre banque de données, veillez à définir l’espace de noms d’ID tiers Target sur le même espace de noms que celui utilisé dans l’élément de données Identity Map :
{modal="regular"}
Exemple de SDK Web Platform
Maintenant que vous comprenez comment les différents paramètres Target sont mappés à l’aide du SDK Web Platform, nos deux exemples de pages peuvent être migrés d’at.js vers le SDK Web Platform comme illustré ci-dessous. Les exemples de pages sont les suivants :
- Fragment de code de prémasquage de Target pour une implémentation de bibliothèque asynchrone
- Le code de base du SDK Web Platform
- Bibliothèque JavaScript du SDK Web Platform
- Une commande
configure
pour initialiser la bibliothèque - Une commande
sendEvent
pour envoyer des données et demander le rendu du contenu Target.
code language-html |
---|
|
code language-html |
---|
|
Ensuite, découvrez comment suivre les événements de conversion Target avec le SDK Web Platform.