将参数传递到全局 mbox

The JavaScript targetPageParams function is used to pass parameters to the global mbox in Adobe Target. This is needed in any scenario where additional targeting/context information is to be passed into Target.

For example, in a Recommendations activity, use the parameters to represent the current product or category that is being viewed.

调用JavaScript函数的代码必须位于页面上的全局mbox之前,无论全局mbox是作为at.js的一部分触发还是手动包含在页面代码中。

NOTE

If you want to add parameters to all mboxes on the page, not just to the global mbox, use the targetPageParamsAll() function.

您可以按照以下任一方式使用 targetPageParams() 函数将参数传递到 target-global-mbox

  • 数组
  • JSON 对象
  • 以与号 (&) 分隔的列表

使用这三种方法可验证参数是否正确传递。您还可以使用 Adobe Experience Cloud 调试器来验证参数的传递。

您必须先定义 JavaScript 函数,然后再向页面中添加全局 mbox。函数名称必须为 targetPageParams

查询字符串

p1=v1&p2=v2&p3=hello%20world
  • 名称: targetPageParams

  • 返回值:以“&”分隔的参数,这些参数包含 URL 编码参数值。

    示例:

    在此示例中,p3 的值为 hello world,该值已进行 URL 编码。

下面显示了页面代码内容的一个示例:

<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>

此示例将以下数据发送到 mbox 边缘:

  • p1=v1
  • p2=v2
  • p3=hello world

数组

<!--window.-->targetPageParams = function() { 
  return ["a=1", "b=2", "c=hello world"]; 
}; 

不需要对值进行 URL 编码。例如,如果某个值中包含空格,则无需对空格进行编码。

此示例将以下数据发送到 mbox 边缘:

  • a=1
  • b=2
  • c=hello world

JSON

JSON 是传递参数的有效方式。Target 使用 JSON 对象键将复杂的结构精简为简单的参数。

<!--window.-->targetPageParams = function() { 
  return { 
    "a": 1, 
    "b": 2, 
    "profile": { 
                  "memberStatus": Gold, 
                  "country": { 
                                "city": "San Francisco" 
                            } 
              } 
  }; 
}; 

不需要对值进行 URL 编码。例如,“San Francisco”不需要对空格进行编码。只需使用空格即可。

此示例将以下数据发送到 mbox 边缘:

  • a=1
  • b=2
  • profile.memberStatus=黄金
  • profile.country.city=San Francisco

在此页面上