傳遞參數至全域 mbox

JavaScript targetPageParams函式可用來將參數傳遞至Adobe Target中的全域mbox。 在要將其他定位/上下文資訊傳入Target的任何情況下,都需要此項資訊。

例如,在Recommendations活動中,使用參數來表示目前正在檢視的產品或類別。

呼叫JavaScript函式的程式碼必須位於頁面上的全域mbox之前,不論全域mbox是作為at.js的一部分引發,還是手動包含在頁面程式碼中。

注意

如果您想要將參數新增至頁面上的所有mbox,而不只是全域mbox,請使用targetPageParamsAll()函式。

您可以透過下列任何方式,利用 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.memberStatus=金
  • profile.country.city=San Francisco

本頁內容