Show Menu
主題×

傳遞參數至全域 mbox

JavaScript targetPageParams 函數用來將參數傳遞至全域 mbox。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的一部分引發,還是手動包含在頁面程式碼中。
If you want to add parameters to all mboxes on the page, not just to the global mbox, use the targetPageParamsAll() function.
您可以透過下列任何方式,利用 target-global-mbox 函數將參數傳入 targetPageParams() :
  • 陣列
  • JSON 物件
  • 以 & 符號區隔的清單
使用這三個方法來驗證是否正確傳遞參數。您可以使用 Adobe Experience Cloud Debugger 來驗證參數傳遞。
在將全域 mbox 新增至頁面之前,您必須定義 JavaScript 函式。名稱必須是 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.age =26
  • profile.country.city =San Francisco