ヘルパー関数の基本を学ぶ functions

Journey Optimizer テンプレート言語を使用して、計算、データの書式設定や変換、条件、パーソナライゼーションのコンテキストでの操作など、データの操作を実行します。パーソナライゼーション構文のガイドラインについては、このページを参照してください。

➡️ ヘルパー関数の使用方法については、このビデオをご覧ください

テンプレート言語は、次に示すように、パーソナライゼーションエディターのパーソナライゼーションドロップダウンリストで選択できるヘルパー関数で利用されます。

NOTE
パーソナライゼーションエディターで使用できる関数や機能は、ジャーニーの高度な式エディターで使用できる関数や機能とは異なります。

Journey Optimizer パーソナライゼーションエディターでは、ヘルパー関数は関数ヘルパーおよび演算子の 3 つのカテゴリにグループ化されます。

サブカテゴリと関数にアクセスするには、カテゴリを選択します。

サブカテゴリにアクセスするには、「>」アイコンをクリックします。+ アイコンをクリックして関数を選択すると、その関数がパーソナライゼーション画面に自動的に追加されます。

...」アイコンをクリックして関数の説明を表示し、お気に入りに追加します。詳細情報

関数 functions-helper

集計関数と配列関数

平均
配列内の選択された値すべての算術平均を返します。
カウント
指定された配列内の要素数を返します。
Null のみをカウント
この関数はリスト内の null 値の数をカウントします。
null でカウント
この関数は null 値を含むリストのすべての要素をカウントします。
個別
重複する値が削除された配列またはリストから値を取得します。
null で個別カウント
この関数は null 値を含む、異なる値の数をカウントします。
最初の項目
配列またはリスト内の最初の項目を返します。
配列の最初の n
指定した数値式に基づいて昇順で並べ替えられた場合、配列の最初の「N」項目を返します。
次に含まれる
項目が配列またはリストのメンバーであるかどうかを判断するために使用します。
次を含む
配列またはリストに指定した項目が含まれているかどうかを判定します。
交わり
2 つの配列またはリストに、共通メンバーが 1 つ以上あるかどうかを判断します。
配列の最後の n
指定した数値式に基づいて昇順で並べ替えられた場合、配列の最後の「N」項目を返します。
最大
配列内の選択された値すべての最大値を返します。
最小
配列内の選択された値すべての最小値を返します。
次に含まれない
項目が配列またはリストのメンバーではないかどうかを判定します。
サブセット
特定の配列(配列 A)が別の配列(配列 B)のサブセットであるか、つまり、配列 A のすべての要素が配列 B の要素であるかを判定します。
合計
配列内の選択された値すべての合計を返します。
スーパーセット
この関数は、特定の配列(配列 A)が別の配列(配列 B)のスーパーセットであるかどうか、つまり配列 A に配列 B のすべての要素が含まれているかどうかを判定します

日時関数 date-functions

年齢
この関数は、指定された日付からの経過時間を取得します。
現在の時刻 (ミリ秒)
この関数は、現在の時刻をエポックミリ秒で取得します。
日付の差異
この関数は、2 つの日付間の差異を日数単位で取得します。
曜日
この関数は、曜日を取得します。
通日
この関数は、通日(1月1日からの通算日数)を取得します。
日付をフォーマット
この関数は、日時値を書式設定します。
日付をロケールサポートの形式にする
この関数は、日付と時刻の値を、目的のロケールなどの対応する言語に依存する表現にフォーマットします。
日数を設定
この関数は、指定された日時の日付を設定します。
時間を設定
この関数は、日時の時を設定します。
UTC に
この関数は、日時を UTC に変換します。
年間通算週
この関数は、年の週番号(何週目か)を返します。

マップ関数 map-functions

取得
指定されたキーのマップの値を取得するために使用します。
キー
指定されたマップのすべてのキーを取得するために使用します。
指定されたマップのすべての値を取得します。

数学関数 math-functions

絶対パス
この関数は、任意の数値を言語依存の表現に書式設定します。
数値を書式設定する
この関数は、任意の数値を言語依存の表現に書式設定します。
ランダム
この関数は、0 ~ 1 の間のランダムな値を返します。
切り捨て
この関数は、数値を切り捨てます。
切り上げ
この関数は、数値を切り上げます。
16 進文字列に
任意の数を 16 進数文字列に変換します。
パーセンテージに
この関数は、数値をパーセンテージに変換します。
精度に
この関数は、数値を必要な精度に変換します。
toString
この関数は、任意の数値を文字列表現に変換します。

オブジェクト関数 object-functions

null でない
オブジェクト参照が存在するかどうかを判断するために使用します。
null である
オブジェクト参照が存在しないかどうかを判断するために使用します。

文字列関数 string-functions

キャメルケース
文字列の各単語の最初の文字を大文字にするために使用します。
次の場所の文字コード
この関数は、JavaScript の charCodeAt 関数と同様に、文字の ASCII 値を返します。
連結
2 つの文字列を 1 つに結合するために使用します。
次を含む
文字列が指定の部分文字列を含んでいるかどうかを判定するために使用します。
次を含まない
文字列が指定の部分文字列を含んでいないかどうかを判定するために使用します。
次で終わらない
文字列の末尾が指定の部分文字列になっていないかどうかを判定するために使用します。
次で始まらない
文字列の先頭が指定の部分文字列になっていないかどうかを判定するために使用します。
エンコード 64
文字列のエンコードまたはデコードに使用します。
次で終わる
文字列の末尾が指定の部分文字列になっていないかどうかを判定するために使用します。
次に等しい
文字列の大文字と小文字を区別し、文字列の先頭が指定の部分文字列になっていないかどうかを判定するために使用します。
等しい (大文字と小文字を区別しない)
文字列の大文字と小文字を区別せず、文字列の先頭が指定の部分文字列になっていないかどうかを判定するために使用します。
電子メールドメインを抽出
メールアドレスのドメインを抽出するために使用します。
通貨の書式設定
この関数は、2 番目の引数で文字列として渡されたロケールに応じて、任意の数値を対応する言語に依存する通貨表現に変換します。
URL ホストを取得
この関数は、URL ホストを取得するために使用されます。
URL パスを取得
この関数は、URL パスの取得に使用されます。
URL プロトコルを取得
この関数は、URL プロトコルの取得に使用されます。
インデックス
この関数は 2 番目のパラメーターが最初に現れる(最初の引数内の)位置を返します。一致するものがない場合は「-1」を返します。
IsEmpty
文字列や式が空かどうかを確認するために使用します。
空でない
この関数はパラメーター内の文字列が空でない場合、true を返します。
最後のインデックス
この関数は 2 番目のパラメーターが最後に現れる(最初の引数内の)位置を返します。一致するものがない場合は「-1」を返します。
左トリミング
文字列の先頭から空白を削除します。
長さ
文字列や式の文字数を取得するために使用します。
類似
文字列が指定のパターンと一致するかどうかを判定するために使用します。
小文字
文字列を小文字に変換します。
マスク
この関数は、文字列の一部を「X」の文字に置き換えるために使用されます。
一致
文字列が特定の正規表現と一致するかどうかを判定するために使用します。
MD5
この関数は、入力文字列の md5 ハッシュを返します。
次と等しくない
文字列が指定の文字列に等しくないかどうかを判定するために使用します。
等しくない (大文字と小文字を区別しない)
この関数は、大文字と小文字を区別せずに、2 つの文字列を比較します。
正規表現グループ
指定された正規表現に基づいて特定の情報を抽出するために使用します。
置換
文字列内の指定された部分文字列を別の部分文字列で置き換えます。
すべて置換
「target」に一致するテキストのすべての部分文字列を、指定されたリテラルの「replacement」文字列に置き換えます。
右トリミング
文字列の末尾から空白を削除します。
分割
文字列を指定された文字で分割するために使用します。
次で始まる
この関数は、文字列が指定の部分文字列で始まるかどうかを判定するために使用されます
文字列を日付に
この関数は、文字列値を日時値に変換します。
文字列を整数に
この関数は、文字列値を整数値に変換します。
文字列から数値へ
この関数は、文字列を数値に変換するために使用されます。無効な入力の出力と同じ文字列を返します。
部分文字列
この関数は文字列式の開始インデックスと終了インデックスの間にある部分文字列を返します。
タイトルケース
この関数は、文字列の各単語の最初の文字を大文字にするために使用します。
ブール値に
この関数雨は引数の値をタイプに応じてブール値に変換します。
日時に
この関数は、文字列を日付に変換するために使用されます。無効な入力に対する出力として、エポック日付を返します。
日時のみに
この関数は、引数値を日時のみの値に変換します。無効な入力に対する出力として、エポック日付を返します。
トリミング
文字列の先頭と末尾の空白を削除します
大文字
文字列を大文字に変換します。
URL デコード
この関数は、URL エンコードされた文字列をデコードするために使用されます。
URL エンコード
この関数は、文字列を URL エンコードするために使用されます。

ヘルパー helper-helper

ヘルパーの詳細は、このページで説明しています。

デフォルトのフォールバック値
この関数を使用すると、デフォルトで変数をレンダリングできます。
Each
配列を繰り返すために使用します。
If
条件付きブロックの定義に使用します。式の評価が true を返した場合、ブロックがレンダリングされます。
Let
この関数を使用すると、式を変数として保存し、後からクエリで使用できます。
Unless
条件付きブロックの定義に使用します。式の評価が false を返した場合、ブロックがレンダリングします。
With
テンプレート部分の評価トークンを変更するために使用します。

演算子 operators-helper

演算関数 arithmetic-helper

演算関数は、値に対する基本的な計算を実行するために使用します。

加算
2 つの引数式の合計を求めるために使用します。
除算
2 つの引数式の商を求めるために使用します。
乗算
2 つの引数式の積を求めるために使用します。
残り
2 つの引数式を除算した後の剰余を求めるために使用します。
減算
2 つの式の差分を求めます。

ブール関数 boolean-functions

ブール関数を使用すると、様々な要素に対してブール論理を実行できます。

および
この演算子は論理積を作成します。
または
この演算子は論理和を作成します。

比較関数 comparison-functions

比較関数は、様々な式と値を比較するために使用され、結果に応じて true または false を返します。

次に等しい
値が等しいかどうかを確認します。
次より大きい
最初の値が 2 番目の値より大きいかどうかを確認します。
同じかそれ以上
最初の値が 2 番目の値より大きいか、もしくは等しいかどうかを確認します。
同じかそれ以下
最初の値が 2 番目の値より小さいか、もしくは等しいかどうかを確認します。
次と等しくない
指定された式が指定された値に等しくないかどうかを確認します。

チュートリアルビデオ video

パーソナライズ機能のヘルパー関数を使用してパーソナライゼーション値を変換する方法と、ヘルパー関数の様々なユースケースを説明します。

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