高度な式エディターの操作 about-the-advanced-expression-editor
ジャーニーの高度な式エディターを使用すると、インターフェイスの様々な画面で高度な式を作成できます。 例えば、ジャーニーを設定して使用する場合や、データソース条件を定義する場合に、式を作成できます。
また、特定のデータ操作が必要なアクションパラメーターを定義する必要がある場合にも利用できます。 イベントから取得したデータやデータソースから取得した追加情報を活用できます。 ジャーニーでは、表示されるイベントフィールドリストは状況に応じて異なり、ジャーニーに追加されるイベントに応じて変化します。
高度な式エディターには、値を操作し、特にニーズに合った式を定義できる一連のビルトインの関数と演算子が用意されています。 また、高度な式エディターを使用すると、外部データソースパラメーターの値を定義したり、マップフィールドやコレクションを操作したりできます。
高度な式エディターへのアクセス accessing-the-advanced-expression-editor
高度な式エディターは、次の目的で使用できます。
可能な場合は、詳細設定モード／シンプルモードボタンを使用して 2 つのモードを切り替えることができます。 シンプルモードについてはここで説明されています。
-
条件は、単純な式エディターまたは高度な式エディターで定義できます。 常にブール型を返します。
-
アクションパラメーターは、フィールドを選択するか、高度な式エディターを使用して定義できます。 式に応じて特定のデータタイプを返します。
高度な式エディターには、様々な方法でアクセスできます。
-
データソース条件を作成した場合は、詳細設定モードをクリックして高度なエディターにアクセスできます。
-
カスタムタイマーを作成すると、高度なエディターが直接表示されます。
-
アクションパラメーターをマッピングする場合、詳細設定モードをクリックします。
インターフェイスの確認 discovering-the-interface
この画面では、式を手動で記述できます。
画面の左側には、使用可能なフィールドと関数が表示されます。
-
イベント：インバウンドイベントから受信したフィールドの 1 つを選択します。 表示されるイベントフィールドリストは状況に応じて異なり、ジャーニーに追加されるイベントに応じて変化します。 詳細情報
note caution CAUTION エクスペリエンスイベントを使用した式の作成はサポートされていません。 エクスペリエンスイベントを使用して式／ロジックを作成する際の代替アプローチとベストプラクティスについて詳しくは、こちらを参照してください。 -
オーディエンス：オーディエンスの選定イベントをドロップした場合は、式で使用するオーディエンスを選択します。 詳細情報
-
データソース：データソースのフィールドグループにあるフィールドリストから選択します。 詳細情報
-
ジャーニーのプロパティ：このセクションでは、特定のプロファイルのジャーニーに関連するテクニカルフィールドが再グループ化されます。 詳細情報
-
関数：複雑なフィルタリングを実行できるビルトインの関数のリストから選択します。 関数はカテゴリ別に整理されています。 詳細情報
オートコンプリートメカニズムにより、コンテキストに応じた候補が表示されます。
構文検証メカニズムは、コードの整合性をチェックします。 エラーはエディターの上部に表示されます。
高度な式エディターで条件を作成する場合のパラメーターの必要性
パラメーターの呼び出しが必要な外部データソースからフィールドを選択すると（このページを参照）、新しいタブが右側に表示されて、このパラメーターを指定できるようになります。 パラメーター値は、ジャーニー内に配置されたイベントまたは Experience Platform データソースから取得できます（他の外部データソースから取得することはできません）。 例えば、天候関連のデータソースでは、頻繁に使用されるパラメーターは「市区町村」です。 そのため、この市区町村パラメーターを取得する場所を選択する必要があります。 関数をパラメーターに適用して、形式の変更や連結を実行することもできます。
より複雑なユースケースの場合、データソースのパラメーターをメイン式に含めるには、「params」キーワードを使用して、そのパラメーター値を定義できます。 このページを参照してください。
このセクションには、このトピックに関連する解釈、検索、質問への回答をサポートすることを目的とした構造化された知識が含まれています。
理解を深めるには、この情報をこのページのドキュメントと組み合わせる必要があります。 どちらのソースも単独で使用することを意図していません。このページでは、機能について説明しますが、この節では、用語、意図、適用可能性、および制約の曖昧さを解消するのに役立つ追加のコンテキストを提供します。
- TL;DR:このページでは、ジャーニーの高度なエクスプレッションエディターについて説明します。イベント、データソース、関数、演算子を使用して、複雑な条件、カスタム待機タイマー、アクションパラメーターマッピングを構築するためのアクセスポイント、インターフェイスパネル、機能を紹介します。
インテント：
- データソース条件、カスタム待機アクティビティ、またはアクションパラメータマッピングから高度な式エディターにアクセスします
- イベントフィールド、データソースフィールド、オーディエンスメンバーシップ、ジャーニープロパティを使用して、高度なブール条件を構築します
- 条件の設定時にシンプルモードと詳細設定モードを切り替える
paramsキーワードを使用して、メイン式内で外部データソースパラメーターを直接参照します- AIを活用した式アシスタントを使用して、自然言語プロンプトから式を生成します
用語集：
- 高度な式エディター：複雑な式を書き込むためのJourney Optimizer コード エディター。シンプルなポイント アンド クリック条件エディター （製品固有） とは異なります
- シンプル モード：ポイント&クリック操作による条件エディター。高度なエディターよりも柔軟性は低いが、開発者以外のユーザーには容易である（製品固有）
- ジャーニープロパティ：式エディター （製品固有） でアクセス可能なジャーニーインスタンス（ID、バージョン、エラー、現在のノード）に関する技術フィールド
- 式アシスタント：高度なエディター内のAIを活用したツール（パブリックベータ版）で、平易な言語プロンプトから式を生成します（製品固有）
ガードレール：
- エクスペリエンスイベントを直接使用したエクスプレッションの作成はサポートされていません。計算属性などの代替アプローチを使用してください
- 条件は、エディターモードに関係なく、常にブール型を返します
- エクスプレッションには、非表示または印刷できない文字を含めることはできません。また、エラーの解析を避けるために、1行の形式を使用する必要があります
- 外部データソースパラメーターの値は、ジャーニーイベントまたはExperience Platform データソースからのみ取得できます。他の外部データソースから取得することはできません
- 高度な式エディター関数とパーソナライゼーションエディター関数は異なります
用語：
- 正規表現の名前：詳細式エディター – Acronym: none — バリアント：詳細エディター、式エディター
- 同義語：「詳細モード」 = 「高度な式エディター」
- 混同しない：高度な式エディター（ジャーニーの条件/アクション）≠パーソナライゼーションエディター（メッセージコンテンツのパーソナライゼーション）
FAQ:
- Q: シンプル モードではなく高度な式エディターを使用する必要がある場合はいつですか？ — コレクションのクエリ、関数の使用、ジャーニーのプロパティの参照、またはシンプルなエディターで表現できない複数の条件ロジックの構築が必要な場合は、高度なエディターを使用します。
- Q: パラメーターを式の外部データソースに渡すにはどうすればよいですか？ — エクスプレッション構文で
paramsキーワード （例：#{DataSource.fieldGroup.field, params: {paramName: value}}）を使用します。 - Q: オートコンプリート メカニズムの機能は何ですか？ – 入力時にコンテキストフィールドと関数の候補が表示され、有効な式をより迅速に作成できます。
- Q：式アシスタントはどこにアクセスしていますか？ – 高度な式エディター内のAI コントロールを使用します。現在パブリックベータ版です。
- Q：高度なエディターの条件は、単純なモードと異なるタイプを返しますか？ – いいえ。条件は両方のモードで常にブール値を返します。