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.

NOTE
Si vous souhaitez ajouter des paramètres à toutes les mbox de la page et pas seulement à la mbox globale, utilisez la fonction targetPageParamsAll() .

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=Gold
  • profile.country.city=San Francisco
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3