Pasar parámetros a un mbox global

El JavaScript targetPageParams se usa para pasar parámetros al mbox global en Adobe Target. Esto es necesario en cualquier escenario en el que se vaya a pasar información de segmentación o contexto adicional a Target.

Por ejemplo, en una actividad de Recommendations, use los parámetros para representar el producto o la categoría actual que se está viendo.

El código para llamar a la función de JavaScript debe ir antes que el mbox global de la página, independientemente de si el mbox global se activa como parte de at.js o se incluye manualmente en el código de página.

NOTE
Si desea agregar parámetros a todos los mboxes de la página, no solo al mbox global, utilice el targetPageParamsAll() función.

Puede pasar parámetros a target-global-mbox mediante la función targetPageParams() de cualquiera de estas formas:

  • Una matriz
  • Un objeto JSON
  • Una lista delimitada por Y comerciales

Use estos tres métodos para verificar que los parámetros se estén pasando correctamente. También podría verificar el paso de parámetros con Adobe Experience Cloud Debugger.

Debe definir la función de JavaScript antes de añadir el mbox global a la página. El nombre debe ser targetPageParams.

Cadena de consulta

p1=v1&p2=v2&p3=hello%20world
  • Nombre: targetPageParams

  • Valor devuelto: parámetros delimitados por “&”, con valores de parámetro codificados con la dirección URL.

    Ejemplo:

    En este ejemplo, p3 tiene el valor hello world, que está codificado con la dirección URL.

Veamos el siguiente código de página de ejemplo:

<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>

Este ejemplo envía los siguientes datos al edge de mbox:

  • p1=v1
  • p2=v2
  • p3=hello world

Matriz

<!--window.-->targetPageParams = function() {
  return ["a=1", "b=2", "c=hello world"];
};

Los valores no necesitan tener codificación de dirección URL. Por ejemplo, si un valor contiene un espacio, no es necesario codificar el espacio.

Este ejemplo envía los siguientes datos al edge de mbox:

  • a=1
  • b=2
  • c=hello world

JSON

JSON es una manera eficaz de pasar parámetros. Target usa las claves de objeto JSON para convertir estructuras complicadas en parámetros simples.

<!--window.-->targetPageParams = function() {
  return {
    "a": 1,
    "b": 2,
    "profile": {
                  "memberStatus": Gold,
                  "country": {
                                "city": "San Francisco"
                            }
              }
  };
};

Los valores no necesitan tener codificación de dirección URL. Por ejemplo, “San Francisco” no requiere que se codifique el espacio. Un espacio es suficiente.

Este ejemplo envía los siguientes datos al edge de mbox:

  • a=1
  • b=2
  • profile.memberStatus=Oro
  • profile.country.city=San Francisco
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3