Envio de parâmetros para uma mbox global

O JavaScript targetPageParams é usada para enviar parâmetros para a mbox global em Adobe Target. Isso é necessário em qualquer situação na qual informações adicionais de direcionamento/contexto devam ser passadas para o Target.

Por exemplo, em um Recommendations , use os parâmetros para representar o produto ou a categoria atual que está sendo visualizada.

O código para chamar a função do JavaScript deve vir antes da mbox global na página, independentemente de a mbox global ser acionada como parte da at.js ou incluída manualmente no código da página.

OBSERVAÇÃO

Se você quiser adicionar parâmetros a todas as mboxes na página, não apenas à mbox global, use a targetPageParamsAll() .

Você pode transmitir parâmetros para target-global-mboxusando a função targetPageParams()de qualquer uma das seguintes maneiras:

  • Uma matriz
  • Um objeto JSON
  • Uma lista delimitada por ampersand

Use esses três métodos para verificar se os parâmetros estão sendo enviados corretament. Você também pode ser capaz de verificar o envio de parâmetros usando o depurador da Adobe Experience Cloud.

Você deve definir a função JavaScript antes de adicionar a mbox global à página. O nome deve ser targetPageParams.

String de consulta

p1=v1&p2=v2&p3=hello%20world

  • Nome: targetPageParams

  • Valor de retorno: a "&" parâmetros delimitados, com valores de parâmetro codificados por URL.

    Exemplo:

    Neste exemplo, p3 tem o valor hello world, que é codificado por URL.

Um exemplo de como deverá ser o código da página é mostrado a seguir:

<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 exemplo envia os seguintes dados para a borda do mbox:

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

Matriz

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

Os valores não precisam ser codificados por URL. Por exemplo, se um valor tiver um espaço, não há necessidade de codificar o espaço.

Este exemplo envia os seguintes dados para a borda do mbox:

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

JSON

JSON é um modo poderoso de enviar os parâmetros. O Target usa as chaves de objeto JSON para achatar as estruturas complicadas em parâmetros simples.

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

Os valores não precisam ser codificados por URL. Por exemplo, "San Francisco" não precisa de espaço para ser codificado. Um espaço é suficiente.

Este exemplo envia os seguintes dados para a borda do mbox:

  • a=1
  • b=2
  • profile.memberStatus=Gold
  • profile.country.city=São Francisco

Nesta página