Envio de parâmetros para uma mbox global

A função targetPageParams do JavaScript é usada para passar 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 uma atividade 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 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.

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