関数 functions
関数は、Adobe Journey Optimizer の動的なジャーニー式の構成要素です。 リアルタイムでデータを変換、計算、検証、操作し、パーソナライズされたカスタマーエクスペリエンスを作成できます。 直感的なカテゴリに整理された 60 を超える関数を使用することで、高度な条件を作成し、複雑な計算を実行し、カスタマージャーニーのすべてのステップでデータ駆動型の意思決定を行うことができます。
関数について
ジャーニー式の関数は、次の一貫性のある構文パターンに従います。
<function name>(<expression as param 1>, <expression as param 2>, … ,<expression as param N>)
主な特性:
- 複数のシグネチャ:関数は、様々なユースケースに対応するために、異なるシグネチャ(順序付きパラメーターの異なるセット)を持つことができます
- タイプ固有の戻り値:各関数には、特定の戻り値タイプ(文字列、整数、ブール値、日付、リストなど)があります
- 0~N 個のパラメーター:関数は 0~N 個の式を順序付きパラメーターとして受け入れることができるので、使用方法を柔軟に指定できます
関数を使用する理由
関数を使用すると、次の操作を実行できます。
- 動的条件を作成 - リアルタイムデータ評価に基づいてジャーニーパスを分岐します
- 大規模にパーソナライズ - お客様データと行動インサイトを活用してコンテンツとエクスペリエンスをカスタマイズします。
- 決定を自動化 - 手動介入なしでインテリジェントロジックを作成します
- データを変換 - 互換性を確保するために、データタイプを変換、書式設定、操作します
- 計算を実行 - 数学演算と統計的な分析を実行します
- 入力を検証 - アクションを実行する前に、データの品質と完全性を確認します
カテゴリ別関数
主な目的別に整理された関数を参照して、ニーズに合った適切なツールをすばやく見つけます。
Adobe Experience Platform aep-functions
オーディエンスのセグメント化とターゲティング
オーディエンスメンバーシップを評価し、Adobe Experience Platform で定義された顧客セグメントに基づいてパーソナライズされたジャーニーパスを作成します。
集計関数 aggregation-functions
統計計算とデータ要約
値のセットに対して計算を実行し、平均値、カウント、合計値、最小値/最大値などのインサイトを導き出します。 データ駆動型の意思決定に不可欠です。
コンバージョン関数 conversion-functions
データタイプ変換
操作とデータソース間の互換性を確保するために、様々なタイプ(文字列、整数、小数、ブール値、日付、期間)間でデータを変換します。
日付関数 date-functions
日時の操作
日付、時刻、タイムゾーンを操作して、時間ベースの条件を作成し、アクションをスケジュールし、時間計算を実行します。
リスト関数 list-functions
コレクションの操作と分析
配列とリストをフィルタリング、並べ替え、変換、分析して、複雑なデータ構造を操作し、設定操作を実行します。
数学関数 math-functions
数学演算
データ処理とビジネスロジックに対して数値計算と変換を実行します。
文字列関数 string-functions
テキストの操作と検証
動的コンテンツの作成と条件付きロジック用にテキストデータを処理、変換、検索、検証します。
次の手順
使用可能な機能を理解したら、次を参照してください。
このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。
理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。
- TL;DR:このページは、ジャーニーの高度な式エディターで使用できる60以上の組み込み関数の分類されたリファレンスです。集計、コンバージョン、日付/時刻、リスト、計算、文字列、およびAdobe Experience Platform オーディエンス関数について説明します。
インテント:
- 分類された関数テーブルを参照して、タスクに適した関数を特定します
- 変換関数を使用して、文字列、整数、小数、ブール値、日付、期間の間でデータ型を変換します
inLastDays、inNextHours、nowWithDeltaなどの関数を使用して、日付ベースのフィルタリングを実行しますcontain、replace、split、trimなどの関数を使用して、文字列値を操作および検証しますcount、avg、sum、distinctCountなどの集計関数を使用して、コレクションの統計計算を実行しますinAudience関数を使用して、ジャーニー条件のオーディエンスメンバーシップを確認します
用語集:
- 集計関数:値のコレクション (製品固有)から1つの値(count、sum、average、min、max)を計算する関数
- 変換関数:あるデータタイプから別のデータタイプに値をキャストする関数(例:
toString、toDateTime、toDuration) (製品固有) - 日付関数: ジャーニー式 (製品固有) で日付、時刻、およびタイムゾーンの値を操作するための関数
- リスト関数:配列/収集データのフィルタリング、並べ替え、分析のための関数(製品固有)
- inAudience: プロファイルが指定されたAdobe Experience Platform オーディエンスセグメント (product-specific)に属しているかどうかを確認する関数
ガードレール:
- 関数は一貫した構文に従います:
functionName(param1, param2, ...) - 関数には、異なるユースケースを処理するための複数の署名(異なるパラメーターセット)が含まれている場合があります
- 各関数には固定の戻り値の型があります。戻り値の型が式のコンテキストで想定される型と一致することを確認します
- ジャーニー式エディターで使用できる関数は、パーソナライゼーションエディターの関数とは異なります
用語:
- 正規名:関数 – 頭字語:なし – バリアント:組み込み関数、式関数
- 同義語:「集計関数」 = 「統計関数」; 「変換関数」 = 「型鋳造関数」
- 混同しないでください:ジャーニー式の関数≠パーソナライゼーションエディターの関数(異なるセット)
FAQ:
- Q: ジャーニー式エディターで使用できる関数の数は? — aggregation、conversion、date、list、math、string、Adobe Experience Platformなど、60以上の関数をカテゴリ別に整理しました。
- Q: プロファイルがジャーニー条件のオーディエンスに属しているかどうかを確認するにはどうすればよいですか? — オーディエンス IDで
inAudience関数を使用します。 - Q:現在の日時を日数でオフセットするには、どの関数を使用すればよいですか? —
nowWithDelta(N, "days")を使用して、現在の時刻から日時オフセットを取得します。 - Q:関数は、呼び出し方法に応じて異なる型を返すことができますか? – 関数は署名ごとに特定の戻り値タイプを持ちますが、1つの関数名に異なるパラメーターセットと戻り値タイプを持つ複数の署名を持つことができます。
- Q:
countとcountWithNullの違いは何ですか? —countはnull以外の要素のみをカウントし、countWithNullはnullを含むすべての要素をカウントします。