Show Menu
TÓPICOS×

Envio de parâmetros para uma mbox global

A função targetPageParams do JavaScript é usada para passar parâmetros para o mbox global. Isso é necessário em qualquer situação na qual informações adicionais de direcionamento/contexto devam ser passadas para o Target.
For example, in a Recommendations activity, use the parameters to represent the current product or category that is being viewed.
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 do at.js ou ser incluída manualmente no código da página.
If you want to add parameters to all mboxes on the page, not just to the global mbox, use the targetPageParamsAll() function.
Você pode transmitir parâmetros para target-global-mbox usando 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() { 
           
<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>

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.age =26
  • profile.country.city =São Francisco