文件Journey OptimizerJourney Optimizer 指南

條件式指令(if， then， else) conditional-instruction

最後更新： 2026年9月4日
  • 適用對象：
  • Journey Orchestration

建立對象：

  • Experienced
  • 開發人員

進階編輯器支援條件式指令(if， then， else)。 它可讓您定義更複雜的運算式。 它由下列元素組成：

  • if：先評估條件。
  • then：條件評估結果為true時要評估的運算式。
  • else：條件評估結果為false時要評估的運算式。
NOTE
所有運算式都必須加上括弧。
if  (<expression1>)
then
   (<expression2>)
else
   (<expression3>)

<expression1>必須傳回​布林值。

<expression2>和<expression3>必須具有相同的型別或相容的型別。 支援的簽章和傳回的型別包括：

boolean,boolean : boolean
dateTime,dateTime : dateTime
dateTimeOnly,dateTimeOnly : dateTimeOnly
decimal,integer : decimal
integer,decimal : integer
integer,decimal : decimal
duration,duration : duration
string,string : string
listBoolean,listBoolean : listBoolean
listDateTime,listDateTime : listDateTime
listDateTimeOnly,listDateTimeOnly : listDateTimeOnly
listDateOnly,listDateOnly : listDateOnly
listDecimal,listDecimal : listDecimal
listInteger,listInteger : listInteger
listString,listString : listString

使用狀況

條件式指示可讓您透過減少條件活動的數量，將歷程工作流程最佳化。 例如，在相同動作活動中，您僅能使用一個條件運算式，即可為欄位定義指定兩個替代方案。

動作活動的範例（適用於預期字串為條件指令結果的欄位）：

if (startWithIgnoreCase(@event{eventiOSPushPermissionAllowed.device.model}, 'iPad') or startWithIgnoreCase(@event{eventiOSPushPermissionAllowed.device.model}, 'iOS'))
then
   ('apns')
else
   ('fcm')
AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains the if / then / else conditional instruction available in the Journey advanced expression editor, including syntax rules, supported type combinations, and a practical usage example.

Intents:

  • Write a conditional expression using if, then, and else to return different values based on a boolean condition
  • Reduce the number of condition activities in a journey by embedding inline conditional logic within a single action activity
  • Determine which data type combinations are valid for the then and else branches
  • Apply the conditional instruction to route push notification tokens to either APNS or FCM based on device model

Glossary:

  • Conditional instruction: An if / then / else expression construct in the advanced editor that evaluates a boolean and returns one of two expressions (product-specific)
  • Advanced expression editor: The Journey Optimizer interface for writing complex expressions used in conditions, wait activities, and action parameter mapping (product-specific)

Guardrails:

  • Parentheses are required around all expressions in the if, then, and else clauses
  • The if clause (<expression1>) must return a boolean type
  • The then and else expressions (<expression2> and <expression3>) must have the same type or compatible types (e.g. decimal and integer are compatible, string and integer are not)
  • Not all type combinations are supported — only the pairs listed in the supported signatures table are valid

Terminology:

  • Canonical name: Conditional Instruction — Acronym: none — variants: if/then/else, ternary-style condition
  • Synonyms: “conditional instruction” = “inline condition” = “if-then-else expression”
  • Do not confuse: conditional instruction (inline expression) ≠ Condition activity (a journey canvas node)

FAQ:

  • Q: Does the if clause need to be wrapped in parentheses? — Yes, parentheses are required around all expressions including the condition in the if clause.
  • Q: Can I use if / then / else to return a number from one branch and a string from another? — No; <expression2> and <expression3> must have the same or compatible types.
  • Q: How does the conditional instruction reduce journey complexity? — It lets you specify two field value alternatives within a single action activity using one expression, avoiding a separate Condition activity node on the canvas.
  • Q: What type does the conditional instruction return if both branches are strings? — It returns a string.
  • Q: Can if / then / else be used to select a push notification channel? — Yes; for example, evaluating the device model to return 'apns' for Apple devices or 'fcm' for others.
recommendation-more-help
journey-optimizer-help