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

このページでは、 ヘルパー関数を使用して、パーソナライズされたコンテンツ内のデータを変換、書式設定、および適用できるので、顧客一人ひとりに合わせて動的にカスタマイズされたエクスペリエンスを構築できます。

ヘルパー関数を使用すると、パーソナライズされたコンテンツ内のデータを変換して操作できます。 これらを使用して、計算、データの書式設定、条件の適用、様々な操作を実行し、顧客に合わせて動的なエクスペリエンスを作成します。

これらの関数は、Journey Optimizer テンプレート言語を活用します。 パーソナライゼーション構文のガイドラインについて詳しくは、このページを参照してください。

➡️ ヘルパー関数の使用方法について詳しくは、このビデオを参照してください。

ヘルパー関数へのアクセス

ヘルパー関数は、パーソナライゼーションエディターの関数メニューから使用できます。

関数は、ナビゲーションを容易にするために次の 3 つのカテゴリに整理されています。

  • 関数 - データ操作と変換操作
  • ヘルパー - 条件付きロジックとユーティリティ関数
  • 演算子 - 比較演算子と論理演算子

ヘルパー関数を使用するには:

  1. カテゴリを選択して、サブカテゴリと使用可能な関数を表示します
  2. > アイコンをクリックして、サブカテゴリを展開します
  3. 関数の横にある + アイコンをクリックして、パーソナライゼーションコードに追加します
  4. ... アイコンをクリックして、関数の説明を表示し、お気に入りに追加さします。 詳細情報
NOTE
パーソナライゼーションエディターで使用できる関数や機能は、ジャーニーの高度な式エディターで使用できる関数や機能とは異なります。 例えば、now() 関数は、ジャーニー式でのみ使用できます。 詳細情報

関数 functions-helper

集計関数と配列関数

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

日時関数 date-functions

日数を追加
この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された日数で調整します。
時間数を追加
この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された時間数で調整します。
分数を追加
この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された分数で調整します。
月数を追加
この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された月数で調整します。
秒数を追加
この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された秒数で調整します。
年数を追加
この関数は、増分に正の値を使用し、減分に負の値を使用して、指定された日付を指定された年数で調整します。
経過時間
この関数は、指定された日付からの経過時間を取得します。
日数
この関数は、指定された日付を日数で、つまり指定された日付と現在の日付の間の経過日数を計算します。将来の日付の場合は負の数、過去の日付の場合は正の数になります。
月数
この関数は、指定された日付を月数で、つまり指定された日付と現在の日付の間の経過月数を計算します。将来の日付の場合は負の数、過去の日付の場合は正の数になります。
日付を比較
この関数は、最初の入力日と他の入力日を比較します。 date1 が date2 と等しい場合は 0 を返し、date1 が date2 より前の場合は -1 を返し、date1 が date2 より後の場合は 1 を返します。
ZonedDateTime を変換
この関数は、日時を指定されたタイムゾーンに変換します。
現在の時刻(ミリ秒)
この関数は、現在の時刻をエポックミリ秒で取得します。
日数の差異
この関数は、日数で 2 つの日付間の差異を取得します。
次の期間の日付
この関数は、指定された日付が開始日と終了日の間にあるかどうかを、両方の境界を含めてチェックします。
ある月の日付
この関数は、その月の日付を表す数値を返します。
曜日
この関数は、曜日を取得します。
年間通算日
この関数は、年間通算日を取得します。
秒数の差異
この関数は、秒数単位で 2 つの日付間の差異を返します。
時間数を抽出
この関数は、指定されたタイムスタンプから時間コンポーネントを抽出します。
分数を抽出
この関数は、指定されたタイムスタンプから分コンポーネントを抽出します。
月数を抽出
この関数は、指定されたタイムスタンプから月コンポーネントを抽出します。
秒数を抽出
この関数は、指定されたタイムスタンプから秒コンポーネントを抽出します。
日付を書式設定
この関数は、日時値を書式設定します。
日付をロケールサポートの形式にする
この関数は、日付と時刻の値を、目的のロケールなどの対応する言語に依存する表現にフォーマットします。
CurrentZonedDateTime を取得
この関数は、タイムゾーン情報を含む現在の日時を返します。
時間数の差異
この関数は、時間数単位で 2 つの日付間の差異を返します。
分数の差異
この関数は、分数単位で 2 つの日付間の差異を返します。
月数の差異
この関数は、月数単位で 2 つの日付間の差異を返します。
日数を設定
この関数は、指定された日時の日付を設定します。
時間を設定
この関数は、日時の時間を設定します。
日時に
この関数は、文字列を日付に変換します。 無効な入力に対する出力として、エポック日付を返します。
UTC に
この関数は、日時を UTC に変換します。
開始日に切り捨て
この関数は、指定された日時を、その日の始まり(00:00)に設定して変更します。
truncateToStartOfQuarter
この関数は、日時を四半期の最初の日(例:1月1日、4月1日、7月1日、10月1日)の 00:00 に切り捨てます。
truncateToStartOfWeek
この関数は、指定された日時を、週の始まり(月曜日の 00:00)に設定して変更します。
truncateToStartOfYear
この関数は、指定された日時を、年の最初の日(1月1日)の 00:00 に切り捨てて変更します。
年間通算週
この関数は、年の週番号(何週目か)を返します。
年数の差異
この関数は、年数単位で 2 つの日付間の差異を返します。

マップ関数 map-functions

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

数学関数 math-functions

絶対
この関数は、任意の数値を言語依存の表現に書式設定します。
数値を書式設定する
この関数は、任意の数値を言語依存の表現に書式設定します。
ランダム
この関数は、0 ~ 1 の間のランダムな値を返します。
切り捨て
この関数は、数値を切り捨てます。
切り上げ
この関数は、数値を切り上げます。
16 進文字列に
任意の数を 16 進数文字列に変換します。
ToInt
これらの型(number、double、int、long、float、short、byte、boolean、string)のいずれかを整数に変換します。
パーセンテージに
この関数は、数値をパーセンテージに変換します。
精度に
この関数は、数値を必要な精度に変換します。
toString
この関数は、任意の数値を文字列表現に変換します。

オブジェクト関数 object-functions

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

文字列関数 string-functions

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

ヘルパー helper-helper

ヘルパーについて詳しくは、このページを参照してください。

デフォルトのフォールバック値
この関数を使用すると、デフォルトで変数をレンダリングできます。
中止
このヘルパーは、レンダリング中に呼び出されたときにメッセージ配信を停止します(可用性が制限されています)
Each
配列を繰り返すために使用します。
データセットの参照
このヘルパーは、ルックアップキーを使用して、レンダリング時にAdobe Experience Platform レコードデータセットからフィールドを取得します
実行メタデータ
このヘルパーは、メッセージのレンダリング中にカスタムキーと値のメタデータをキャプチャし、ランタイム実行メタデータオブジェクトに保存できるようにします
If
条件付きブロックの定義に使用します。式の評価が true を返した場合、ブロックがレンダリングされます。
Let
この関数を使用すると、式を変数として保存し、後からクエリで使用できます。
JSONを解析
このヘルパーは、JSON文字列を解析し、解析されたオブジェクトをテンプレート変数に格納します
Unless
条件付きブロックの定義に使用します。式の評価が false を返した場合、ブロックがレンダリングします。
暗号化
サンドボックスレジストリのアクティブキーを使用して、レンダリング時にURL クエリパラメーターの式値を暗号化します
パスの値
このヘルパーは、オプションの配列インデックス付きで、データパスからテンプレート変数に値を割り当てます
URL
この関数は、SMS メッセージ コンテンツのURLを処理します。URLをoriginalUrlで短縮し、ディープリンクを挿入するにはtype='DEEPLINK'を使用します
With
テンプレート部分の評価トークンを変更するために使用します。

演算子 operators-helper

演算関数 arithmetic-helper

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

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

ブール関数 boolean-functions

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

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

比較関数 comparison-functions

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

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

テンプレート移行機能 template-migration-functions

テンプレート移行機能は、既存のテンプレートをJourney Optimizerに移行する際に役立ちます。

演算子を使用して比較
この関数は、指定された比較演算子を使用して2つの値を比較します
部分文字列範囲
この関数は、指定された開始インデックスと終了インデックスの間の文字列の一部を返します
比較先
この関数は、2つの文字列を辞書的に比較します

チュートリアルビデオ video

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

recommendation-more-help
journey-optimizer-help