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

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now