建立自訂變數

本指南將逐步引導您建立自訂變數範本。使用這個變數時，會擷取一個值陣列，並以逗號分隔字串傳回。

  1. 如要開始第一個變數範本，請按一下左側導覽列中的「Templates」(範本)，然後按一下「Variable Templates」(變數範本) 區段下方的「New」(新增) 按鈕。

  2. 在「Info」(資訊) 分頁中，定義變數的「Name」(名稱) 和「Description」(說明) 。

    「名稱」是指使用者在整個代碼管理工具使用者介面中導入這個變數時，會看到的名稱。

    Description 只是它們聽起來的，只是這個變數的簡單說明 (最多 200 個字元)。

  3. 按一下 [重新整理] 即可預覽範本。

    欄位輸入右側會顯示「Template Preview」(範本預覽) 視窗，每次在編輯器中進行變更時，都會出現 [Refresh] (重新整理) 按鈕。按一下 [Refresh] (重新整理) 即可查看變更對變數外觀所造成的影響。

  4. 按一下 [欄位] 即可在變數範本中新增欄位。

    範本編輯器的「Fields」(欄位) 分頁可讓您在變數範本中建立及編輯欄位。使用欄位來輸入自訂資料，例如帳戶 ID。您可以新增標準表單元素，例如文字欄位、下拉式選單、圓形按鈕和核取方塊。

  5. 按一下 [新增欄位] 並選取 [簡易表格]。將預設名稱 (例如 "simpleTable1") 替換為 "list"。在「範本預覽」中，按一下 [重新整理]。

    針對「Text Input」(文字輸入) 重複這個步驟，並呼叫 "array"、兩個 核取方塊，分別稱為「use_array」和「sort」，以及一個稱為 "分隔符號" 的文字輸入。針對 "分隔符號"，將齒輪圖示設為「,」，做法是設定齒輪圖示，然後將 "Default value" 切換為開啟，然後填寫新的預設值輸入欄位。

  6. 按一下 [程式碼] 分頁，然後在編輯器中輸入沙箱模式的 JavaScript：

    var input = data.array;

if (!data.use_array) {
  input = [];
  for (var i = 0; i < data.list.length; i++) {
    input.push(data.list[i].values);
  }
}

if (data.sort) {
  input.sort();
}

return input.join(data.delimiter || ',');

    這個變數的程式碼雖然簡單明瞭，但還是有需要注意的地方。

    • 「data」欄位。

      有數個欄位可從 data 全域存取。data 會包含您在上一個步驟中設定的值。因此，我們可以存取 data.use_array、data.sort、data.list 和 data.delimiter。

    • 如未提供 data.delimiter，則 delimiter 會設定為預設值 ","。如果有必要，可以為欄位設定預設值。如此一來，使用者就不用填寫每個欄位就能使用變數，因此更容易使用變數範本。

  7. 按一下「儲存」以儲存您的進度。這麼做會將所有偵測到的權限載入到範本編輯器中。

    部分範本 API 擁有與權限相關聯的權限，可決定他們能夠或不可執行哪些操作。當您在程式碼中使用 sendPixel 等範本 API 時，代碼管理工具會在「權限」分頁中顯示相關權限。

  8. 在「Template Preview」(範本預覽) 分頁中，為「values」值輸入一些值，按一下「Run Code」，然後查看「Console」，以查看變數輸出結果。

    如有任何錯誤，這些錯誤會顯示在「Console」(主控台) 視窗中。

  9. 按一下 [儲存]，然後關閉範本編輯器。

    這個變數範本現在已可使用。