Transfert de paramètres à une mbox globale
La fonction JavaScript targetPageParams est utilisée pour transmettre des paramètres à la mbox globale dans Adobe Target. Cela est nécessaire dans tout scénario où des informations de ciblage/contexte supplémentaires doivent être transmises à Target.
Par exemple, dans une activité de recommandations, utilisez les paramètres pour représenter le produit ou la catégorie actuelle qui est consultée.
Le code permettant d’appeler la fonction JavaScript doit être placé avant la mbox globale sur la page, que la mbox globale soit déclenchée dans le cadre d’at.js ou qu’elle soit incluse manuellement dans le code de page.
Vous pouvez transférer des paramètres à target-global-mbox à l’aide de la fonction targetPageParams() de l’une des façons suivantes :
- Un tableau
- Un objet JSON
- Une liste délimitée par des esperluettes
Utilisez ces trois méthodes pour vérifier que les paramètres sont transférés correctement. Vous pouvez également être en mesure de vérifier le transfert des paramètres en utilisant le Débogueur d’Adobe Experience Cloud.
Vous devez définir la fonction JavaScript avant d’ajouter la mbox globale à la page. Le nom doit être targetPageParams.
Chaîne de requête
p1=v1&p2=v2&p3=hello%20world
-
Nom :
targetPageParams -
Valeur de renvoi : des paramètres délimités « & » avec des valeurs de paramètre codées en URL
Exemple :
Dans cet exemple, p3 a la valeur
hello world, qui est codée en URL.
Examinez l’exemple de code de page suivant :
<html>
<head>
<title>Title here..</title>
<script type="text/javascript">
function targetPageParams() {
return "p1=v1&p2=v2&p3=hello%20world";
}
</script>
<script src="mbox.js" type="text/javascript"></script>
</head>
<body>Body here...
</body>
</html>
Cet exemple envoie les données suivantes dans le bord de mbox :
- p1=v1
- p2=v2
- p3=hello world
Tableau
<!--window.-->targetPageParams = function() {
return ["a=1", "b=2", "c=hello world"];
};
Il n’est pas nécessaire que les valeurs soient encodées en URL. Par exemple, si une valeur comporte un espace, il n’est pas nécessaire d’encoder l’espace.
Cet exemple envoie les données suivantes dans le bord de mbox :
- a=1
- b=2
- c=hello world
JSON
JSON est un moyen puissant de transférer des paramètres. Target utilise les clés d’objet JSON pour aplatir les structures complexes en paramètres simples.
<!--window.-->targetPageParams = function() {
return {
"a": 1,
"b": 2,
"profile": {
"memberStatus": Gold,
"country": {
"city": "San Francisco"
}
}
};
};
Il n’est pas nécessaire que les valeurs soient encodées en URL. Par exemple, « San Francisco » ne nécessite pas d’espace pour être encodé. Un espace suffit.
Cet exemple envoie les données suivantes dans le bord de mbox :
- a=1
- b=2
profile.memberStatus=Goldprofile.country.city=San Francisco