文档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