Transfert de paramètres à une mbox globale

La fonction JavaScript targetPageParams permet de transmettre des paramètres à la mbox globale dans Adobe Target. Cette fonction est requise dans les scénarios où des informations supplémentaires de ciblage/contexte doivent être transférées dans Target.

Par exemple, dans une activité Recommendations, utilisez les paramètres pour représenter le produit ou la catégorie en cours de consultation.

Le code permettant d’appeler la fonction JavaScript doit précéder la mbox globale sur la page, que la mbox globale soit déclenchée dans le cadre d’at.js ou soit incluse manuellement dans le code de page.

REMARQUE

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.

Vous trouvez ci-dessous un exemple présentant à quoi pourrait ressembler le code pour la page :

<html> 
  <head> 
    <title>Title here..</title> 
    <script type="text/javascript"> 
        function targetPageParams() { 
           
<b>return "p1=v1&p2=v2&p3=hello%20world"</b>; 
        } 
    </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 aplanir des structures compliquées en simples paramètres.

<!--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=Or
  • profile.country.city=San Francisco

Sur cette page

Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free
Adobe Summit Banner

A virtual event April 27-28.

Expand your skills and get inspired.

Register for free