傳遞參數至全域 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() { 
          return "p1=v1&p2=v2&p3=hello%20world";
        } 
    </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

本頁內容

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