함수 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에 정의된 고객 세그먼트를 기반으로 개인화된 여정 경로를 만듭니다.

함수
설명
inAudience
개인이 특정 대상자에 속하는지 확인

Adobe Experience Platform 기능 세부 사항 보기 →

집계 함수 aggregation-functions

통계 계산 및 데이터 요약

값 집합에 대해 계산을 수행하여 평균, 개수, 합계 및 최소/최대 값과 같은 통찰력을 얻습니다. 데이터 중심의 의사 결정에 필수적입니다.

함수
설명
avg
평균 값 계산
count
null이 아닌 요소 계산
countOnlyNull
null 값만 계산
countWithNull
null을 포함한 모든 요소 계산
distinctCount
null이 아닌 고유한 값 계산
distinctCountWithNull
null을 포함한 고유 값 계산
max
최대 값 찾기
min
최소값 찾기
sum
총 합계 계산

모든 집계 함수 보기 →

전환 함수 conversion-functions

데이터 형식 변환

작업과 데이터 소스 간의 호환성을 보장하기 위해 다양한 유형(문자열, 정수, 십진수, 부울, 날짜, 기간) 간에 데이터를 변환합니다.

함수
설명
toBool
부울로 변환
toDateOnly
날짜로만 변환(시간 없음)
toDateTime
시간이 있는 날짜로 변환
toDateTimeOnly
시간대 없이 날짜-시간으로 전환
toDecimal
십진수로 변환
toDuration
기간으로 변환
toInteger
정수로 변환
toString
문자열로 변환

모든 전환 함수 보기 →

날짜 함수 date-functions

날짜 및 시간 조작

날짜, 시간 및 시간대를 사용하여 시간 기반 조건을 만들고, 작업을 예약하며, 임시 계산을 수행합니다.

함수
설명
currentTimeInMillis
현재 시간(밀리초) 가져오기
dateDiff
두 날짜 또는 날짜-시간의 차이 계산
inLastDays
날짜가 지난 N일 이내인지 확인
inLastHours
날짜가 지난 N시간 이내인지 확인
inLastMonths
날짜가 지난 N개월 이내인지 확인
inLastYears
날짜가 최근 N년 이내인지 확인
inNextDays
날짜가 다음 N일 이내인지 확인
inNextHours
날짜가 다음 N시간 이내인지 확인
inNextMonths
날짜가 다음 N개월 이내인지 확인
inNextYears
날짜가 다음 N년 이내인지 확인
now
현재 날짜-시간 가져오기
nowWithDelta
오프셋으로 현재 시간 가져오기
setHours
날짜-시간의 특정 시간 설정
setDays
날짜-시간의 특정 일 설정
updateTimeZone
날짜-시간의 시간대 업데이트

모든 날짜 함수 보기 →

목록 함수 list-functions

컬렉션 조작 및 분석

배열과 목록을 필터링, 정렬, 변환 및 분석하여 복잡한 데이터 구조로 작업하고 교차, 결합 및 차이점 같은 집합 작업을 수행합니다.

함수
설명
differenceLists
한 목록에 다른 목록에 없는 항목 가져오기
distinct
고유 값 가져오기(null 제외)
distinctWithNull
고유 값 가져오기(null 포함)
필터
기준을 기반으로 목록 필터링
getListItem
특정 인덱스에서 항목 가져오기
in
목록에 값이 있는지 확인
교차
목록 간 공통 요소 찾기
제한
반환되는 항목 수 제한
listSize
목록 크기 가져오기
mergeLists
중복 제거를 사용하거나 사용하지 않고 두 목록 결합
serializeList
목록을 문자열로 변환
sort
목록 요소 정렬

모든 목록 함수 보기 →

수학 함수 math-functions

수학 연산

데이터 처리 및 비즈니스 논리를 위한 수치 계산 및 변환을 수행합니다.

함수
설명
random
난수 생성(0-1)
round
가장 가까운 정수로 반올림

모든 수학 함수 보기 →

문자열 함수 string-functions

텍스트 조작 및 유효성 검사

다이내믹 콘텐츠 생성 및 조건부 논리를 위해 텍스트 데이터를 처리, 변환, 검색 및 검증합니다.

함수
설명
concat
문자열 연결
contain
문자열에 하위 문자열이 포함되어 있는지 확인
containIgnoreCase
포함 확인(대/소문자 구분 안 함)
endWith
문자열이 접미사로 끝나는지 확인
endWithIgnoreCase
확인 다음으로 끝남(대/소문자 구분 안 함)
equalIgnoreCase
문자열 비교(대/소문자 구분 안 함)
indexOf
첫 번째 발생 위치 찾기
isEmpty
문자열이 비어 있는지 확인
isNotEmpty
문자열이 비어 있지 않은지 확인
lastIndexOf
마지막 발생 위치 찾기
length
문자열 길이 가져오기
lower
소문자로 변환
matchRegExp
정규 표현식 일치
notEqualIgnoreCase
같지 않음 확인(대/소문자 구분 안 함)
replace
첫 번째 발생 횟수 바꾸기
replaceAll
모든 발생 항목 바꾸기
split
문자열을 배열로 분할
startWith
문자열이 접두사로 시작하는지 확인
startWithIgnoreCase
다음으로 시작 확인(대/소문자 구분 안 함)
substr
하위 문자열 추출
trim
선행/후행 공백 제거
upper
대문자로 변환
uuid
UUID 생성

모든 문자열 함수 보기 →

다음 단계

사용 가능한 기능을 이해했으므로 다음을 살펴보십시오.

  • 고급 표현식 편집기 - 고급 편집기를 사용하여 복잡한 표현식을 만드는 방법에 대해 알아봅니다.
  • 식 구문 - 여정 식을 작성하기 위한 구문 규칙을 기본으로 제공합니다.
  • 연산자 - 함수를 사용하여 논리를 빌드할 수 있는 연산자를 검색합니다.
  • 필드 참조 - 식에서 데이터 필드를 참조하는 방법 이해
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 is a categorized reference of all 60+ built-in functions available in the Journey advanced expression editor, covering aggregation, conversion, date/time, list, math, string, and Adobe Experience Platform audience functions.

Intents:

  • Identify the right function for a task by browsing the categorized function tables
  • Transform data types between string, integer, decimal, boolean, date, and duration using conversion functions
  • Perform date-based filtering with functions like inLastDays, inNextHours, nowWithDelta, and dateDiff
  • Manipulate and validate string values using functions like contain, replace, split, and trim
  • Perform statistical calculations on collections using aggregation functions like count, avg, sum, and distinctCount
  • Check audience membership in journey conditions using the inAudience function

Glossary:

  • Aggregation functions: Functions that compute a single value (count, sum, average, min, max) from a collection of values (product-specific)
  • Conversion functions: Functions that cast a value from one data type to another (e.g. toString, toDateTime, toDuration) (product-specific)
  • Date functions: Functions for working with date, time, and timezone values in journey expressions (product-specific)
  • List functions: Functions for filtering, sorting, and analyzing array/collection data (product-specific)
  • inAudience: A function that checks whether a profile belongs to a specified Adobe Experience Platform audience segment (product-specific)

Guardrails:

  • Functions follow a consistent syntax: functionName(param1, param2, ...)
  • A function may have multiple signatures (different parameter sets) to handle different use cases
  • Each function has a fixed return type — ensure the return type matches what the expression context expects
  • The functions available in the Journey expression editor differ from those in the personalization editor

Terminology:

  • Canonical name: Functions — Acronym: none — variants: built-in functions, expression functions
  • Synonyms: “aggregation functions” = “statistical functions”; “conversion functions” = “type casting functions”
  • Do not confuse: journey expression functions ≠ personalization editor functions (different sets)

FAQ:

  • Q: How many functions are available in the Journey expression editor? — Over 60 functions organized across categories including aggregation, conversion, date, list, math, string, and Adobe Experience Platform.
  • Q: How do I check if a profile belongs to an audience in a journey condition? — Use the inAudience function with the audience identifier.
  • Q: What function should I use to get the current date and time offset by a number of days? — Use nowWithDelta(N, "days") to get a dateTime offset from the current time.
  • Q: How can I calculate the difference between two dates? — Use the dateDiff function. Both parameters must be the same type: dateOnly parameters return the difference in days, while dateTimeOnly and dateTime parameters return the difference in milliseconds.
  • Q: Can a function return different types depending on how it is called? — A function has a specific return type per signature, but a single function name can have multiple signatures with different parameter sets and return types.
  • Q: What is the difference between count and countWithNull?count counts only non-null elements; countWithNull counts all elements including nulls.
recommendation-more-help
journey-optimizer-help