DocumentaçãoGuia do desenvolvedor do Target

Envio de parâmetros para uma mbox global

Last update: Sat Jul 20 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Tópicos:

Criado para:

  • undefined

A função targetPageParams do JavaScript é usada para passar parâmetros para a mbox global em Adobe Target. Isso é necessário em qualquer cenário em que informações adicionais de direcionamento/contexto sejam passadas para 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 de a 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 a função 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.

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. Target usa as chaves de objeto JSON para nivelar 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