開始使用協助程式函式 functions

使用Journey Optimizer範本化語言對資料執行作業,例如計算、資料格式設定或轉換、條件,並在個人化的內容中加以處理。 在此頁面中瞭解個人化語法准則。

➡️在此影片中瞭解如何使用協助程式函式

在個人化編輯器的個人化下拉式清單提供的協助程式功能中,會運用範本語言,如下所示:

NOTE
個人化編輯器中可用的功能和功能,與歷程進階運算式編輯器中可用的功能和功能不同。

在Journey Optimizer個人化編輯器中,協助程式功能分為三個類別: 功能協助程式運運算元

選取類別,以存取子類別和函式。

按一下>圖示即可存取子類別。 按一下+圖示來選取函式:函式會自動新增至個人化畫面。

按一下...圖示可檢視函式的說明,並將其新增至您的最愛。 了解更多

函數 functions-helper

彙總與陣列函式

平均
此函式傳回陣列中所有選取值的算術平均值
計數
此函式傳回給定陣列中的元素數
只計算 Null
此函數計算清單中 null 值的數量。
計算 Null
此函式計算清單的所有元素,包括null值
相異
此函式從已移除重複值的陣列或清單中取得值
Null 的相異計數
此函式計算不同值的數量,包括空值
第一個項目
此函式傳回陣列或清單中的第一個專案
陣列中的前 n 個
當根據給定的數值運算式依遞增順序排序時,此函式傳回陣列中的前「N」個專案
位於
此函式用於決定專案是陣列或清單的成員
包括
此函式決定陣列或清單是否包含給定專案
相交
此函式決定兩個陣列或清單是否至少有一個通用成員
陣列中的最後 n 個
當根據給定的數值運算式依遞增順序排序時,此函式傳回陣列中的最後「N」個專案
最大值
此函式傳回陣列中所有選取值的最大值
最小值
此函式傳回陣列中所有選取值的最小值
不在
此函式決定專案是否不是陣列或清單的成員
子集:
此函式決定特定陣列(陣列A)是否是另一個陣列(陣列B)的子集,亦即,如果陣列A中的所有元素都是陣列B的元素
總和
此函式傳回陣列中所有選定值的總和
超集:
此函式決定特定陣列(陣列A)是否是另一個陣列(陣列B)的超集,亦即,該陣列A是否包含陣列B中的所有元素

日期時間函式 date-functions

年齡
此函式從指定日期擷取年齡
目前時間 (以毫秒為單位)
此函式擷取目前時間(以紀元毫秒為單位)
日期差異
此函式擷取兩個日期之間的天數差異
星期幾
此函式擷取星期幾
年中的日
此函式擷取一年當中的第幾天
格式化日期
此函式格式化日期時間值
支援地區設定的日期格式
此函式將日期時間值格式化為其對應的語言敏感表示法,亦即所需的地區設定。
設定天數
此函式為給定的日期時間設定月份日期
設定時數
此函式設定日期時間的小時
到 UTC
此函式將日期時間轉換為UTC
年中的週
此函式傳回年中的周數

對應函數 map-functions

取得
此函式用於擷取給定索引鍵的對應值
索引鍵
此函式用於擷取給定對應的所有索引鍵
此函式擷取給定對應的所有值

數學函數 math-functions

絕對
此函式將任何數字格式化為區分語言的表示法。
格式化數字
此函式將任何數字格式化為區分語言的表示法。
隨機
此函數傳回 0 到 1 之間的隨機值
向下四捨五入
此函數對數字進行向下四捨五入
向上四捨五入
此函式對數字進行向上四捨五入
至十六進位字串
將任何數字轉換為十六進位字串。
ToInt
將這些型別(數字、雙精度浮點數、整數、長整數、浮點數、短整數、位元組、布林值、字串)轉換成整數。
至百分比
此函數將數字轉換為百分比
至精確度
此函數將數字轉換為所需的精確度
至字串
此函式將任何數字轉換為其字串表示。

物件函數 object-functions

不是 Null
此函式用於決定物件參考是否存在
是 Null
此函式用於決定物件參考是否不存在

字串函數 string-functions

駝峰式大小寫
此函式用於將字串中每個字詞的第一個字母大寫
字元代碼位於
此函式傳回字元的ASCII值,例如JavaScript中的charCodeAt函式
Concat
此函式用於將兩個字串合併為一個
包含
此函式用於決定字串是否包含指定的子字串
不包含
此函式用於決定字串是否不包含指定的子字串
結尾不是
此函式用於決定字串的結尾是否不是指定的子字串
開頭不是
此函式用於決定字串的開頭是否不是指定的子字串
編碼64
此函式用於編碼或解碼字串
結尾為
此函式用於決定字串的結尾是否為指定的子字串
等於
此函式用於決定字串的開頭是否不是指定的子字串,須區分大小寫
等於忽略大小寫
此函式用於決定字串是否不以指定的子字串開頭,不區分大小寫
擷取電子郵件網域
此函式用於擷取電子郵件地址的網域
格式化貨幣
此函式根據在第二個引數中作為字串傳遞的區域設定,將任何數字轉換為其對應的語言敏感型貨幣表示
取得 url 主機
此函數用於取得 URL 主機。
取得 url 路徑
此函式用於取得url路徑
取得 url 通訊協定
此函式用於取得url通訊協定
索引:
此函式傳回第二個引數在第一個引數中第一次出現的位置。如果沒有相符專案,則傳回–1
IsEmpty
此函式用於檢查字串或運算式是否為空。
不是空的
如果參數中的字串不為空,則此函數傳回 true。
最後索引:
此函數傳回第二個引數最後一次出現的位置 (在第一個引數中)。如果沒有相符項目,則傳回 -1。
左側修剪
此函式移除字串開頭的空格
長度
此函式用於取得字串或運算式中的字元數
此函式用於決定字串是否符合指定的模式
小寫
此函式將字串轉換為小寫字母
遮罩
此函式用來以「X」字元取代字串的一部分。
符合
此函數用於決定字串是否符合特定的規則運算式
MD5
此函數傳回輸入字串的 md5 雜湊。
不等於
此函式用於決定字串是否不等於指定的字串
不等於,忽略大小寫
此函數比較兩個字串,忽略大小寫。
規則運算式群組
此函式用於根據提供的規則運算式擷取特定資訊
取代
此函式將字串中的指定子字串替換為另一個子字串
全部取代
此函式以指定的常值「取代」字串取代符合「target」的文字之所有子字串
右側修剪
此函式移除字串結尾的空格
分割
此函式用於依指定字元分割字串
開頭為
此函式用於決定字串的開頭是否為指定的子字串
字串至日期
此函式將字串值轉換為日期時間值
字串至整數
此函數會將字串值轉換為整數值。
字串至數字
此函數用於將字串轉換為數字。針對無效輸入會傳回相同字串作為輸出。
子字串
此函數傳回開始索引和結束索引之間的字串運算式的子字串。
字首大寫
此函式用於將字串中每個字詞的首字母大寫
至 Bool
此函數根據其類型將引數值轉換為布林值。
至日期時間
此函數用於將字串轉換為日期。針對無效輸入會傳回 epoch 日期作為輸出。
僅至日期時間
此函式將引數值轉換為僅日期時間值。 針對無效輸入會傳回epoch日期作為輸出。
修剪
此函式移除字串開頭和結尾的空格
大寫
此函式將字串轉換為大寫字母
Url 解碼
此函數用於解碼 URL 編碼的字串。
Url 編碼
此函數用於對字串進行 URL 編碼。

輔助程式 helper-helper

協助程式在此頁面中有詳細說明。

預設遞補值
此函式用於呈現具有預設值的變數
Each
此函式用於反複處理陣列
If
此函式用於定義條件區塊 — 如果運算式評估傳回true,則會轉譯區塊
Let
此函式允許將運算式儲存為變數,以便稍後在查詢中使用
Unless
此函式用於定義條件區塊 — 如果運算式評估傳回false,則會轉譯區塊
With
此函式用於變更範本部分的評估權杖

操作者 operators-helper

算術函式 arithmetic-helper

算術函式用於對值執行基本計算。

加法
此運運算元用於尋找兩個引數運算式的總和
此運運算元用於尋找兩個引數運算式的商
乘法
此運運算元用於尋找兩個引數運算式的乘積
餘數
此運運算元用來找出兩個引數運算式相除後的餘數
減法
此運運算元求兩個運算式之間的差異

布林函式 boolean-functions

布林值函式用於對不同元素執行布林值邏輯。

此運運算元建立邏輯結合
此運運算元建立邏輯分離

比較函式 comparison-functions

比較函式是用來比較不同運算式和值之間的差異,並據此傳回true或false。

等於
此操作會檢查值是否相等
大於
此運運算元檢查第一個值是否大於第二個值
大於或等於
此運運算元檢查第一個值是否大於或等於第二個值
小於或等於
此運運算元檢查第一個值是否小於或等於第二個值
不等於
此運運算元檢查給定的運算式是否不等於給定值

操作說明影片 video

瞭解如何使用個人化協助程式函式來轉換個人化值,並瞭解協助程式函式的不同使用案例。

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76