DocumentaçãoGuia do desenvolvedor do Target

Envio de parâmetros para uma mbox global

Last update: Thu Jul 27 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

Criado para:

  • Developer

O JavaScript targetPageParams é usada para transmitir parâmetros para a mbox global no 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 uma atividade do Recommendations, use os parâmetros para representar o produto ou categoria atual que está sendo visualizada.

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

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

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.

Considere o exemplo de código de página 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. TargetO 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=Ouro
  • profile.country.city=São Francisco
recommendation-more-help
6906415f-169c-422b-89d3-7118e147c4e3