설명서 Journey Optimizer Journey Optimizer 안내서

도우미 함수 시작 functions

Last update: Thu Dec 11 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

주제:
개인화

작성 대상:

경험
개발자

도우미 기능을 사용하면 개인화된 콘텐츠 내에서 데이터를 변환하고 조작할 수 있습니다. 이를 사용하여 계산을 수행하고, 데이터의 형식을 지정하며, 조건을 적용하고, 다양한 작업을 실행하여 고객을 위한 동적이고 맞춤화된 경험을 만들 수 있습니다.

이러한 함수는 Journey Optimizer 템플릿 언어를 활용합니다. 이 페이지에서 개인화 구문 지침에 대해 알아보세요.

➡️ 이 비디오에서 도우미 함수를 사용하는 방법에 대해 알아보세요

도우미 기능 액세스

도우미 함수는 개인화 편집기의 함수 메뉴에서 사용할 수 있습니다.

함수는 쉽게 탐색할 수 있도록 세 가지 범주로 구성됩니다.

함수 - 데이터 조작 및 변환 작업
도우미 - 조건부 논리 및 유틸리티 함수
연산자 - 비교 및 논리 연산자

도우미 함수를 사용하려면:

하위 범주 및 사용 가능한 기능을 보려면 범주를 선택하십시오.
하위 범주를 확장하려면 > 아이콘을 클릭하십시오.
함수 옆에 있는 + 아이콘을 클릭하여 개인화 코드에 추가합니다
함수 설명을 보거나 즐겨찾기에 추가하려면 ... 아이콘을 클릭하십시오. 자세히 알아보기

NOTE

개인화 편집기에서 사용할 수 있는 기능 및 기능은 여정 고급 표현식 편집기에서 사용할 수 있는 기능 및 기능과 다릅니다. 예를 들어 now() 함수는 여정 식에서만 사용할 수 있습니다. 자세히 알아보기

함수 functions-helper

집계 및 스토리지 기능

평균

이 함수는 배열에서 선택한 모든 값의 산술 평균을 반환합니다.

Count

이 함수는 특정 배열에서 요소의 수를 반환합니다.

null만 계산

이 함수는 목록의 null 값 수를 계산합니다.

null이 포함된 개수

이 함수는 null 값을 포함하여 목록의 모든 요소를 계산합니다.

고유

이 함수는 중복 값이 제거된 배열 또는 목록에서 값을 가져옵니다.

Null이 포함된 고유 개수

이 함수는 null 값을 포함한 다른 값의 수를 계산합니다.

첫 번째 항목

이 함수는 배열 또는 목록의 첫 번째 항목을 반환합니다.

배열의 첫 번째 n

이 함수는 특정 수식에 따라 내림차순으로 정렬되면 배열에서 첫 번째 'N' 항목을 반환합니다

위치

이 함수는 항목이 배열의 멤버인지 또는 목록의 멤버인지 확인하는 데 사용합니다.

포함

이 함수는 배열 또는 목록에 지정된 항목이 포함되어 있는지 확인합니다.

교차

이 함수는 두 배열 또는 목록에 최소 하나 이상의 공통 멤버가 있는지 확인합니다.

배열의 마지막 n

이 함수는 특정 수식에 따라 내림차순으로 정렬되면 배열에서 마지막 'N' 항목을 반환합니다.

최대

이 함수는 배열에서 선택한 모든 값 중 가장 큰 값을 반환합니다.

최소

이 함수는 배열에서 선택한 모든 값 중 가장 작은 값을 반환합니다.

다음에 없음

이 함수는 항목이 배열의 멤버인지 또는 목록의 멤버가 아닌지 확인합니다.

하위 집합

이 함수는 특정 배열(배열 A)이 다른 배열(배열 B)의 하위 집합인지 여부, 즉 배열 A의 모든 요소가 배열 B의 요소인지 여부를 결정합니다

Sum

이 함수는 배열에서 선택한 모든 값의 합계를 반환합니다.

상위 집합

이 함수는 특정 배열(배열 A)이 다른 배열(배열 B)의 상위 집합인지, 즉 배열 A에 배열 B의 모든 요소가 포함되어 있는지 확인합니다

날짜 시간 함수 date-functions

일 추가

이 함수는 양수 값을 사용하여 증가 값을 하고 음수 값을 사용하여 지정된 일 수만큼 지정된 날짜를 조정합니다.

시간 추가

이 함수는 양수 값을 사용하여 증분 및 음수 값을 사용하여 지정된 시간 수만큼 지정된 날짜를 조정합니다.

분 추가

이 함수는 양수 값을 사용하여 증분 및 음수 값을 사용하여 지정된 분 단위로 지정된 날짜를 조정합니다.

월 추가

이 함수는 양수 값을 사용하여 증가 값을 하고 음수 값을 사용하여 지정된 개월 수만큼 지정된 날짜를 조정합니다.

초 추가

이 함수는 양수 값을 사용하여 증분 및 음수 값을 사용하여 지정된 시간(초)만큼 지정된 날짜를 조정합니다.

연도 추가

이 함수는 양수 값을 사용하여 증가 값을 하고 음수 값을 사용하여 지정된 연도 수만큼 지정된 날짜를 조정합니다.

나이

이 함수는 특정 날짜의 연령을 검색합니다.

나이(일)

이 함수는 특정 일자의 기간(예: 특정 일자와 현재 일자 사이에 경과된 일 수)을 계산합니다. 이 수치는 미래 일자의 경우 음수이고, 과거 일자의 경우 양수입니다.

나이(월)

이 함수는 특정 날짜의 기간(예: 특정 날짜와 현재 날짜 사이에 경과된 개월 수)을 월 단위로 계산합니다. 이 수는 미래 날짜의 경우 음수이고, 과거 날짜의 경우 양수입니다.

날짜 비교

이 함수는 첫 번째 입력 날짜를 다른 입력 날짜와 비교합니다. date1이 date2와 같으면 0을 반환하고, date1이 date2 전에 오면 -1을 반환하고, date1이 date2 후에 오면 1을 반환합니다.

ZonedDateTime 변환

이 함수는 날짜-시간을 지정된 시간대로 변환합니다.

현재 시간(밀리초)

이 함수는 에포크 밀리초로 현재 시간을 검색합니다.

날짜 차이

이 함수는 일 수로 두 날짜 간의 차이를 검색합니다.

월일

이 함수는 해당 월의 일을 나타내는 숫자를 반환합니다.

요일

이 함수는 요일을 검색합니다.

일(한 해 기준)

이 함수는 연간 일자를 검색합니다.

초 단위 차이

이 함수는 초 단위로 두 날짜 간의 차이를 반환합니다.

시간 추출

이 함수는 특정 타임스탬프에서 시간 구성 요소를 추출합니다.

시간(분) 추출

이 함수는 특정 타임스탬프에서 분 구성 요소를 추출합니다.

월 추출

이 함수는 특정 타임스탬프에서 월 구성 요소를 추출합니다.

초 추출

이 함수는 특정 타임스탬프에서 두 번째 구성 요소를 추출합니다.

날짜 형식 지정

이 함수는 날짜 시간 값의 형식을 지정합니다.

로케일 지원을 사용하여 날짜 형식 지정

이 함수는 날짜 시간 값의 형식을 해당 언어 구분 표시, 즉 원하는 로케일로 지정합니다.

CurrentZonedDateTime 가져오기

이 함수는 시간대 정보와 함께 현재 날짜 및 시간을 반환합니다.

시간 차이

이 함수는 시간 측면에서 두 날짜 간의 차이를 반환합니다.

분 차이

이 함수는 분 단위로 두 날짜 간의 차이를 반환합니다.

월 차이

이 함수는 월 단위로 두 날짜 간의 차이를 반환합니다.

일 설정

이 함수는 특정 날짜-시간에 대한 월 중 특정 일을 설정합니다.

시간 설정

이 함수는 날짜-시간의 시간을 설정합니다.

종료 날짜/시간

이 함수는 문자열을 날짜로 변환합니다. 잘못된 입력에 대한 출력으로 에포크 날짜를 반환합니다.

UTC로

이 함수는 날짜/시간을 UTC로 변환합니다.

당일의 시작으로 자르기

이 함수는 특정 날짜-시간을 시간이 00:00으로 설정된 하루의 시작으로 설정하여 수정합니다.

truncateToStartOfQuarter

이 함수는 00:00에 분기 첫째 날(예: 1월 1일, 4월 1일, 7월 1일, 10월 1일)까지 날짜-시간을 자릅니다.

truncateToStartOfWeek

이 함수는 특정 날짜-시간을 주의 시작(월요일 00:00)으로 설정하여 수정합니다.

truncateToStartOfYear

이 함수는 00:00에 연도의 첫 날(1월 1일)까지 잘라내어 지정된 날짜-시간을 수정합니다.

주(한 해 기준)

이 함수는 연간 주를 반환합니다.

연도 차이

이 함수는 연도 단위로 두 날짜 간의 차이를 반환합니다.

맵 함수 map-functions

Get

이 함수는 특정 키에 대한 맵의 값을 검색하는 데 사용합니다.

키

이 함수는 특정 맵에 대한 모든 키를 검색하는 데 사용합니다.

값

이 함수는 특정 맵의 모든 값을 검색합니다.

수학 함수 math-functions

절대

이 함수는 모든 숫자를 해당 언어 구분 표현으로 서식을 지정합니다.

포맷 번호

이 함수는 모든 숫자를 해당 언어 구분 표현으로 서식을 지정합니다.

무작위

이 함수는 0과 1 사이의 임의 값을 반환합니다.

내림

이 함수는 숫자를 내림합니다

올림

이 함수는 숫자를 올림합니다.

16진수 문자열로 변환

모든 숫자를 16진수 문자열로 변환합니다.

대상 정수

이러한 유형(숫자, 더블, int, long, float, short, 바이트, 부울, 문자열) 중 하나를 정수로 변환합니다.

백분율로 변환

이 함수는 숫자를 백분율로 변환합니다.

전체 자릿수로 변환

이 함수는 숫자를 필요한 전체 자릿수로 변환합니다.

대상 문자열

이 함수는 모든 숫자를 문자열 표현으로 변환합니다.

개체 함수 object-functions

null이 아님

이 함수는 오브젝트 참조가 존재하는지 확인하는 데 사용합니다.

null임

이 함수는 오브젝트 참조가 존재하지 않은지 확인하는 데 사용합니다.

문자열 함수 string-functions

카멜 대/소문자

이 함수는 문자열의 각 단어의 첫 번째 문자를 대문자로 사용하는 데 사용합니다

의 문자 코드

이 함수는 JavaScript의 charCodeAt 함수와 같은 문자의 ASCII 값을 반환합니다.

Concat

이 함수는 2개의 문자열을 하나로 결합하는 데 사용합니다.

다음을 포함

이 함수는 문자열에 지정된 하위 문자열이 포함되어 있는지 확인하는 데 사용합니다.

다음을 포함하지 않음

이 함수는 문자열에 지정된 하위 문자열이 포함되어 있지 않은지 확인하는 데 사용합니다.

다음으로 끝나지 않음

이 함수는 문자열이 지정된 하위 문자열로 끝나지 않은지 확인하는 데 사용합니다.

다음으로 시작하지 않음

이 함수는 문자열이 지정된 하위 문자열로 시작되지 않는지 확인하는 데 사용합니다.

인코딩 64

이 함수는 문자열을 인코딩하는 데 사용합니다.

다음으로 끝남

이 함수는 문자열이 지정된 하위 문자열로 끝나는지 확인하는 데 사용합니다.

다음과 같음

이 함수는 대/소문자 구분을 통해 문자열이 지정된 하위 문자열로 시작되지 않는지 확인하는 데 사용합니다.

같음 대/소문자 무시

이 함수는 대/소문자를 구분하지 않고 문자열이 지정된 하위 문자열로 시작되지 않는지 확인하는 데 사용합니다.

이메일 도메인 추출

이 함수는 이메일 주소의 도메인을 추출하는 데 사용합니다.

통화 포맷

이 함수는 두 번째 인수에서 문자열로 전달된 로케일에 따라 모든 숫자를 해당 언어 구분 통화 표시로 변환합니다

URL 호스트 가져오기

이 함수는 URL 호스트를 가져오는 데 사용합니다.

URL 경로 가져오기

이 함수는 URL 경로를 가져오는 데 사용합니다.

URL 프로토콜 가져오기

이 함수는 URL 프로토콜을 가져오는 데 사용합니다.

색인

이 함수는 (첫 번째 인수에서) 두 번째 매개 변수의 첫 번째 발생 횟수 위치를 반환합니다. 일치하는 항목이 없으면 -1을 반환합니다.

IsEmpty

이 함수는 문자열이나 표현식이 비어 있는지 확인하는 데 사용합니다.

비어 있지 않음

이 함수는 매개 변수의 문자열이 비어 있지 않으면 true를 반환합니다.

마지막 색인

이 함수는 (첫 번째 인수에서) 두 번째 매개 변수의 마지막 발생 횟수 위치를 반환합니다. 일치하는 항목이 없으면 -1을 반환합니다.

Left trim

이 함수는 문자열의 시작에서 공백을 제거합니다.

Length

이 함수는 문자열 또는 표현식의 문자 수를 가져오는 데 사용합니다.

다음과 유사

이 함수는 문자열이 지정된 패턴과 일치하는지 확인하는 데 사용합니다.

소문자

이 함수는 문자열을 소문자로 변환합니다.

마스크

이 함수는 문자열의 일부를 "X" 문자로 바꾸는 데 사용합니다.

일치

이 함수는 문자열이 특정 정규 표현식과 일치하는지 확인하는 데 사용합니다.

MD5

이 함수는 입력 문자열의 md5 해시를 반환합니다.

다음과 같지 않음

이 함수는 문자열이 지정된 문자열과 같지 않은지 확인하는 데 사용합니다.

대/소문자 무시와 같지 않음

이 함수는 대/소문자를 무시하는 2개의 문자열을 비교합니다.

정규 표현식 그룹

이 함수는 제공된 정규 표현식에 따라 특정 정보를 추출하는 데 사용합니다.

바꾸기

이 함수는 문자열에서 지정된 하위 문자열을 다른 하위 문자열로 대체합니다

모두 바꾸기

이 함수는 "target"과 일치하는 텍스트의 모든 하위 문자열을 지정된 리터럴 "replacement" 문자열로 바꿉니다

오른쪽 트림

이 함수는 문자열의 끝에서 공백을 제거합니다.

SHA256

이 함수는 문자열의 sha256 해시를 계산하고 반환합니다.

분할

이 함수는 특정 문자로 문자열을 분할하는 데 사용합니다.

다음으로 시작

이 함수는 문자열이 지정된 하위 문자열로 시작하는지 확인하는 데 사용합니다.

문자열을 현재까지

이 함수는 문자열 값을 날짜-시간 값으로 변환합니다.

문자열을 정수로 변환

이 함수는 문자열 값을 정수 값으로 변환합니다.

문자열을 숫자로 변환

이 함수는 문자열을 숫자로 변환하는 데 사용합니다. 잘못된 입력에 대한 출력과 동일한 문자열을 반환합니다.

하위 문자열

이 함수는 시작 색인과 종료 색인 사이에 있는 문자열 식의 하위 문자열을 반환합니다.

제목 대/소문자

이 함수는 문자열의 각 단어의 첫 문자를 대문자로 사용하는 데 사용합니다

부울로

이 함수는 인수 유형에 따라 인수 값을 부울 값으로 변환합니다.

종료 날짜/시간

이 함수는 문자열을 날짜로 변환하는 데 사용합니다. 잘못된 입력에 대한 출력으로 에포크 날짜를 반환합니다.

종료 날짜/시간만

이 함수는 인수 값을 날짜/시간 전용 값으로 변환합니다. 잘못된 입력에 대한 출력으로 에포크 날짜를 반환합니다.

트리밍

이 함수는 문자열의 시작과 끝에서 공백을 제거합니다.

대문자

이 함수는 문자열을 대문자로 변환합니다.

URL 디코드

이 함수는 URL로 인코딩된 문자열을 디코딩하는 데 사용합니다.

Url 인코딩

이 함수는 문자열을 URL 인코딩하는 데 사용합니다.

도우미 helper-helper

도우미는 이 페이지에 자세히 설명되어 있습니다.

기본 대체 값

이 함수는 기본값으로 변수를 렌더링하는 데 사용합니다.

각

이 함수는 배열을 반복하는 데 사용합니다.

실행 메타데이터

이 도우미는 런타임 실행 메타데이터 개체에 저장할 수 있도록 메시지 렌더링 동안 사용자 지정 키-값 메타데이터를 캡처합니다

조건

이 함수는 조건부 블록을 정의하는 데 사용합니다. 식 계산이 true를 반환하면 블록이 렌더링됩니다.

Let

이 함수를 사용하면 표현식을 나중에 쿼리에서 사용할 변수로 저장할 수 있습니다

Unless

이 함수는 조건부 블록을 정의하는 데 사용합니다. 표현식 평가에서 false를 반환하면 블록이 렌더링됩니다.

포함

이 함수는 템플릿 일부의 평가 토큰을 변경하는 데 사용합니다.

연산자 operators-helper

산술 함수 arithmetic-helper

산술 함수는 값에 대한 기본 계산을 수행하는 데 사용됩니다.

더하기

이 연산자는 두 인수 표현식의 합을 찾는 데 사용됩니다.

나누기

이 연산자는 두 인수 표현식의 몫을 찾는 데 사용됩니다

곱하기

이 연산자는 두 인수 표현식의 곱을 찾는 데 사용됩니다

나머지

이 연산자는 두 인수 표현식을 나눈 후 나머지를 찾는 데 사용됩니다

빼기

이 연산자는 두 표현식 간의 차이점을 찾습니다

부울 함수 boolean-functions

부울 함수는 다른 요소에 부울 로직을 수행하는 데 사용됩니다.

And

이 연산자는 논리 결합을 생성합니다.

또는

이 연산자는 논리합을 생성합니다.

비교 함수 comparison-functions

비교 함수는 다른 표현식과 값을 비교하는 데 사용되며, 그에 따라 true 또는 false를 반환합니다.

다음과 같음

이 작업은 값이 같은지 확인합니다.

다음보다 큼

이 연산자는 첫 번째 값이 두 번째 값보다 큰지 확인합니다

크거나 같음

이 연산자는 첫 번째 값이 두 번째 값보다 크거나 같은지 확인합니다

작거나 같음

이 연산자는 첫 번째 값이 두 번째 값보다 작거나 같은지 확인합니다

다음과 같지 않음

이 연산자는 특정 표현식이 특정 값과 같지 않은지 확인합니다.

사용 방법 비디오 video

개인화 도우미 기능을 사용하여 개인화 값을 변형하는 방법을 알아보고 도우미 기능의 다양한 사용 사례를 이해합니다.

https://video.tv.adobe.com/v/3416646?captions=kor&quality=12

recommendation-more-help

b22c9c5d-9208-48f4-b874-1cefb8df4d76