포인트 참조

모든 포인트는 포인트의 point_type과 일치하는 중첩된 키를 하나만 포함하는 point_data 객체를 가집니다(포인트 타입 → 키 매핑 참조). 이 페이지에서는 각 키 아래의 구조를 설명합니다.

참고

진입, 타이밍, 분기, 액션, 전환 포인트는 아래에 자세히 설명되어 있습니다.

메시징 포인트(send_*, inapp)의 경우, 이 페이지에서는 구조적 필드만 다룹니다: 어떤 프리셋이나 콘텐츠를 참조하고 어떤 채널 설정을 전달할지 등입니다. 메시지 콘텐츠 자체는 프리셋에 정의되어 있으며 프리셋 API 및 채널별 문서에 설명되어 있습니다. 일부 필드는 Customer Journey 빌더의 컨트롤을 미러링하는 중첩된 객체를 참조합니다.

진입 포인트

Journey에는 최소 하나의 진입 포인트가 필요합니다. 모든 진입 포인트는 단일 default 출력을 가집니다.

start_by_segment

세그먼트와 일치하는 사용자를 진입시킵니다. POINT_TYPE_START_BY_SEGMENT.

필드	타입	설명
application_code	string	애플리케이션 코드.
filter_code	string	오디언스를 정의하는 세그먼트/필터 코드.
repeat	SegmentRepeat	선택적 반복 진입 스케줄(SegmentRepeat 참조).
start_at	timestamp	이 시간(ISO 8601) 이전에는 처리하지 마십시오.
is_deactivated	bool	이 진입 포인트가 꺼져 있는지 여부.

message_bus (이벤트 진입)

사용자가 이벤트를 트리거할 때 진입시킵니다. POINT_TYPE_EVENT.

필드	타입	설명
event_name	string	수신할 이벤트 이름.
application_code	string	애플리케이션 코드.
event_conditions	PointEventCondition[]	이벤트의 속성과 일치하는 조건.
active_period	Period	트리거가 활성화되는 시간 창.
multi_entry	MultiEntry	사용자가 한 번 이상 진입할 수 있는 방법(MultiEntry 참조).
attribute_entry	AttributeEntry	이벤트를 트리거한 사용자 대신 이벤트 속성에 포함된 사용자 ID를 등록합니다(AttributeEntry 참조).
allow_reenter	bool	사용자가 Journey에 다시 진입할 수 있는지 여부.

AttributeEntry

이벤트를 트리거한 사용자 대신 이벤트 속성에 포함된 사용자 ID를 등록합니다. Customer Journey 빌더의 이벤트 속성의 사용자를 미러링합니다.

필드	타입	설명
enabled	bool	이벤트를 트리거한 사용자 대신 이벤트 속성에 명시된 사용자를 등록할지 여부.
attribute_name	string	등록할 사용자 ID(또는 사용자 ID 목록)를 포함하는 이벤트 속성의 이름.

start_by_api

Start by API 호출에 의해 공급되는 진입 포인트입니다. POINT_TYPE_START_BY_API.

필드	타입	설명
application_code	string	애플리케이션 코드.
attributes	string[]	Start by API 요청의 attribute_values에 전달될 수 있는 사용자 지정 속성의 이름.
is_deactivated	bool	이 진입 포인트가 꺼져 있는지 여부.

타이밍 포인트

delay (대기)

각 사용자를 고정되거나 계산된 간격 동안 일시 중지합니다. POINT_TYPE_WAIT. point_data.delay 객체는 다음 간격 키 중 하나를 정확히 설정합니다:

간격 키	타입	설명
sec	uint64	고정된 초 수만큼 대기합니다.
exact_time	ExactTime	특정 시간(hour, minute)까지 대기합니다.
exact_date_time	ExactDateTime	절대적인 날짜 및 시간까지 대기합니다.
exact_week_days_time	ExactWeekDaysTime	특정 요일의 특정 시간까지 대기합니다(요일 맵 0=월요일 … 6=일요일 → ExactTime).
dynamic_time	DynamicTime	태그 또는 이벤트의 값을 기준으로 상대적으로 대기합니다.

split_branches: true인 dynamic_time은 output1 브랜치를 추가합니다(출력 키 참조).

DynamicTime

필드	타입	설명
from	enum DynamicTimeFrom	기준 시간이 태그에서 오는지 이벤트에서 오는지 여부.
direction	enum DynamicTimeDirection	기준 시간 전후의 오프셋.
duration	uint64	오프셋의 크기.
unit	enum DynamicTimeUnit	duration의 단위(분, 시간, 일, …).
split_branches	bool	계산된 시간이 다를 때 사용자를 별도의 브랜치로 분할합니다.
tag_name	string	기준 시간을 포함하는 태그(from이 태그일 때).
event_name / event_attribute / point_id	string	기준 시간의 이벤트 소스(from이 이벤트일 때).

wait_event

사용자가 이벤트를 트리거할 때까지 (또는 타임아웃까지) 대기합니다. POINT_TYPE_WAIT_EVENT. default 출력은 트리거되지 않음 경로입니다. 트리거된 경로는 output1이거나, 스크립트를 사용하면 조건당 하나의 브랜치입니다.

필드	타입	설명
events	PointWaitEventInfo[]	대기할 이벤트.
conditions_script	string	복잡한 다중 이벤트 로직을 위한 선택적 스크립트. 파싱된 조건 이름이 출력 키가 됩니다.
multi_entry	MultiEntry	재진입 동작.

분기 및 필터링 포인트

boolean_splitter

조건에 따라 사용자를 브랜치로 라우팅합니다. POINT_TYPE_BOOLEAN_SPLITTER.

필드	타입	설명
split_strategy	enum	SPLIT_FILTER(세그먼트별), SPLIT_TAGS(태그 조건별), 또는 SPLIT_EVENTS(이벤트 조건별).
load_policy	enum	ALL(사용자의 모든 기기가 일치할 수 있음) 또는 FILTER(현재 기기만).
filter_code	string	split_strategy가 SPLIT_FILTER일 때의 세그먼트 코드.
filter_expressions	FilterExpression[]	split_strategy가 SPLIT_TAGS일 때의 태그 조건: 표현식당 하나의 추가 output 브랜치.
event	BooleanSplitterEventInfo	split_strategy가 SPLIT_EVENTS일 때의 이벤트 조건: 조건당 하나의 추가 output 브랜치.

ab_splitter

사용자를 가중치가 적용된 변형으로 무작위로 분할합니다. POINT_TYPE_AB_SPLITTER. 출력 키는 output0, output1, … (split의 항목당 하나, 0부터 인덱싱됨. default는 없음).

필드	타입	설명
split	uint32[]	각 브랜치의 백분율. 합계는 100이어야 합니다. 인덱스 i는 출력 키 output{i}에 매핑됩니다.
auto_select_winner	bool	우승 브랜치를 자동으로 선택할지 여부.
winner_strategy	enum	ANY_GOAL 또는 SPECIFIC_GOAL.
goal_uuid	string	우승자를 결정하는 데 사용되는 목표(SPECIFIC_GOAL과 함께).
winner_split	uint32	우승 브랜치 번호(1부터 시작, 0 = 아직 우승자 없음).

filter

일치하는 사용자만 계속 진행하도록 하고(default), 나머지는 output1로 라우팅합니다. POINT_TYPE_FILTER.

필드	타입	설명
filter	enum Filter	사전 정의된 확인: EMAIL_EXISTS, PUSH_TOKEN_EXISTS, SMS_TOKEN_EXISTS, WHATSAPP_TOKEN_EXISTS, LINE_TOKEN_EXISTS, 또는 CUSTOM.
filter_raw	string	filter가 CUSTOM일 때의 사용자 지정 필터 표현식.

액션 포인트

set_tags

사용자의 태그를 업데이트합니다. POINT_TYPE_SET_TAGS.

필드	타입	설명
application_code	string	애플리케이션 코드.
tags	Tag[]	쓸 태그.

Tag

필드	타입	설명
name	string	태그 이름.
value_type	enum TagValueType	태그의 데이터 유형: TAG_VALUE_TYPE_INTEGER, TAG_VALUE_TYPE_STRING, TAG_VALUE_TYPE_LIST, TAG_VALUE_TYPE_DATE, TAG_VALUE_TYPE_BOOLEAN, TAG_VALUE_TYPE_PRICE, TAG_VALUE_TYPE_VERSION, TAG_VALUE_TYPE_TIMEZONE, TAG_VALUE_TYPE_OBJECT 또는 TAG_VALUE_TYPE_OBJECT_LIST.
operation	enum SetTagOperation	값에 수행할 작업: SET_TAG_OPERATION_SET (덮어쓰기), SET_TAG_OPERATION_APPEND (목록에 추가), SET_TAG_OPERATION_REMOVE (목록에서 제거), SET_TAG_OPERATION_INCREMENT 또는 SET_TAG_OPERATION_DECREMENT (숫자 변경).
dynamic_value	bool	고정 값 대신 실행 시점에 이벤트나 다른 태그에서 값을 가져옵니다. 소스는 dynamic 값 키에 넣습니다.
value	oneof	value_type과 일치하는 값 키 정확히 하나: str, int, bool, date, price, version, timezone 또는 list. dynamic_value: true인 경우 dynamic을 사용합니다. timezone 값은 UTC+01:00 같은 UTC 오프셋이거나 "3600"처럼 문자열로 된 초 단위 숫자입니다. Europe/Berlin 같은 시간대 이름은 허용되지 않습니다.

operation은 필수입니다. operation이 없는 태그가 있는 Journey는 Choose what Set tags does with the tag <name> 오류와 함께 유효성 검사에 실패합니다. 제거된 type 필드를 여전히 보내는 요청은 HTTP 400 및 unknown field "type"과 함께 거부됩니다.

예를 들어 다음 태그는 visits를 1만큼 증가시킵니다.

{ "name": "visits", "value_type": "TAG_VALUE_TYPE_INTEGER", "operation": "SET_TAG_OPERATION_INCREMENT", "int": 1 }

객체 태그의 필드(예: order.amount)는 해당 필드 유형의 일반 태그처럼 기록됩니다. Set tags 포인트는 전체 객체(TAG_VALUE_TYPE_OBJECT, TAG_VALUE_TYPE_OBJECT_LIST)나 객체 목록의 필드를 기록할 수 없습니다. 이런 태그가 있는 Journey는 유효성 검사를 통과하지 못합니다.

web_hook

아웃바운드 HTTP 요청을 보냅니다. POINT_TYPE_WEBHOOK. 단일 default 출력.

필드	타입	설명
method	string	HTTP 메서드(GET, POST, PUT, …).
url	string	대상 URL.
request_template	string	요청 본문 템플릿. Liquid 템플릿을 지원합니다.
headers	map<string, string>	HTTP 헤더.
disabled	bool	읽기 전용. 반복적인 오류 후 Pushwoosh가 웹훅을 자동으로 비활성화했을 때 true.
reactivate	bool	쓰기 전용. 비활성화된 웹훅을 다시 활성화하려면 true로 설정합니다.

audience_sync

Meta 맞춤 타겟에 사용자를 추가하거나 제거합니다. POINT_TYPE_AUDIENCE_SYNC.

필드	타입	설명
ad_account_id	string	Meta 광고 계정 ID.
ad_account_name	string	UI 전용 ad_account_id의 표시 이름.
audience_id	string	Meta 맞춤 타겟 ID.
audience_name	string	UI 전용 audience_id의 표시 이름.
action	enum AudienceSyncAction	AUDIENCE_SYNC_ACTION_ADD 또는 AUDIENCE_SYNC_ACTION_REMOVE.

주의

이 내용은 포인트를 생성하거나 업데이트할 때는 확인되지 않으며, Journey가 검증되거나 시작될 때만 확인됩니다. 잘못된 ad_account_id(더 이상 연결되지 않음) 또는 audience_id(Meta에서 반환되지 않음)는 오류 없이 저장되며, 각 사용자의 동기화 시 조용히 처리되는 것이 아니라 해당 시점에서만 문제가 드러납니다.

전환 포인트

goal_event

전환 목표를 추적합니다. POINT_TYPE_GOAL_EVENT. 출력이 없습니다.

필드	타입	설명
event_name	string	목표 이벤트 이름.
application_code	string	애플리케이션 코드.
event_conditions	PointEventCondition[]	목표 이벤트의 속성과 일치하는 조건.
is_throw_out	bool	목표에 도달하면 Journey에서 사용자를 제거할지 여부.
is_cancel_event	bool	이것이 부정적인(취소) 목표인지 여부.

종료 포인트

terminator

사용자의 Journey를 종료합니다. POINT_TYPE_EXIT. 빈 객체({})이며 출력이 없습니다.

{ "point_type": "POINT_TYPE_EXIT", "point_data": { "terminator": {} }, "outputs": [] }

종료 포인트는 선택 사항입니다. 출력의 info.next_point_uuid를 설정하지 않은 채로 두면 명시적인 종료 포인트와 동일한 방식으로 사용자의 Journey가 종료됩니다. 두 경우 모두 오류가 아닌 종료로 동일하게 계산됩니다.

메시징 포인트

모든 메시징 포인트는 채널을 통해 전송되며 공통 봉투를 공유합니다. 분할기가 활성화되지 않은 경우 각각 단일 default 출력을 가집니다(출력 키 참조).

공통 필드:

필드	타입	설명
application_code	string	애플리케이션 코드.
preset_code	string	전송할 프리셋(템플릿). inapp은 대신 richmedia_code를 사용합니다.
content / title	string	프리셋을 사용하지 않을 때의 인라인 메시지 콘텐츠(채널에 따라 다름).
campaign_code	string	Journey가 시작될 때 할당되는 캠페인 코드. 생성 및 새 포인트: 이 포인트용으로 생성된 시스템 캠페인을 제외하고 비워 둡니다. 기존 포인트: 비워 두거나 읽어온 값 그대로 둡니다. 그렇지 않으면 요청이 거부됩니다.
split_params	BehaviorSplitter	선택 사항: 상호 작용을 기다리고 그에 따라 분기합니다.
message_type	enum	마케팅 대 거래 메시지 타입(컨트롤 그룹 처리 제어). 아래의 자체 email_type/email_category 쌍이 있는 send_email에서는 사용되지 않습니다.

포인트 타입 및 주목할 만한 추가 필드:

포인트 타입	point_data 키	참고
POINT_TYPE_SEND_PUSH	send_push	split_params(동작)와 전달 분할기는 최대 세 개의 출력을 생성할 수 있습니다. send_by_user_id, wait_optimal_time.
POINT_TYPE_SEND_EMAIL	send_email	liquid_template_params, personalise, email_type, email_category(아래 참조), email_sunset_policy. 이메일 API를 참조하십시오.
POINT_TYPE_SEND_SMS	send_sms	SMS를 참조하십시오.
POINT_TYPE_SEND_WHATSAPP	send_whatsapp	personalise(아래 참조). 빠른 답장 프리셋은 답장당 하나의 출력을 추가합니다(키 = 답장 값). WhatsApp을 참조하십시오.
POINT_TYPE_SEND_TELEGRAM	send_telegram	텔레그램 채널.
POINT_TYPE_SEND_KAKAO	send_kakao	카카오를 참조하십시오.
POINT_TYPE_SEND_LINE	send_line	LINE API를 참조하십시오.
POINT_TYPE_SEND_DATA	send_data	자동 데이터 메시지(UI 없음).
POINT_TYPE_INAPP	inapp	richmedia_code, expire_in_days, capping을 사용합니다.

주의

send_email에서 email_type은 생략하거나 정확히 marketing 또는 transactional(소문자)로 설정해야 하며, 다른 값은 거부됩니다. email_type이 marketing일 때 email_category는 필수이며, 기존 카테고리의 표시 이름이 아닌 코드여야 합니다.

send_whatsapp에서 type: "MPM"(다중 제품 메시지)을 가진 personalise.placeholders[] 항목은 actions.actions[].type을 정확히 action으로 설정해야 합니다. 이는 Meta가 MPM 템플릿 버튼에서 허용하는 유일한 액션 타입이며, 다른 값은 거부됩니다.

이 중 어느 것도 포인트를 생성하거나 업데이트할 때 확인되지 않으며, Journey가 검증되거나 시작될 때만 확인됩니다. 잘못된 값은 오류 없이 저장되며 해당 시점에서만 문제가 드러납니다.

공유 타입

SegmentRepeat

필드	타입	설명
enabled	bool	반복 진입이 켜져 있는지 여부.
frequency	string	daily, weekly, monthly, 또는 dates.
every	uint32	N 주기마다 반복합니다.
dates	string[]	frequency가 dates일 때의 특정 날짜.
time	SegmentRepeatTime	시간 구성.

시간 객체

• ExactTime: { "hour": 0–23, "minute": 0–59 }.
• ExactDateTime: { "year", "month": 1–12, "day": 1–31, "hour": 0–23, "minute": 0–59 }.

BehaviorSplitter

필드	타입	설명
enabled	bool	상호 작용을 기다리고 그에 따라 분기할지 여부.
interval	uint64	상호 작용을 기다릴 시간(초).

EmailSunsetPolicy

send_email에서 email_sunset_policy로 사용됩니다. Email 요소의 선셋 정책 설정을 미러링하며, 프로젝트의 선셋 정책이 이 포인트에 적용되는 방식을 제어합니다.

mode는 프로젝트에서 선셋 정책이 켜져 있을 때만 적용됩니다. 이 정책은 기본적으로 꺼져 있으며, 켜기 전까지는 두 모드 모두 모든 연락처에 이메일을 보냅니다.

"email_sunset_policy": { "mode": "EMAIL_SUNSET_MODE_OFF" }

mode	이메일을 받는 대상
EMAIL_SUNSET_MODE_DEFAULT	활성 연락처만: 비활성 연락처는 건너뜁니다. email_sunset_policy를 생략한 것과 같습니다.
EMAIL_SUNSET_MODE_OFF	비활성 연락처를 포함한 모든 연락처.

이 정책은 마케팅 이메일에만 적용되므로 email_type이 transactional이면 이 필드는 효과가 없습니다.

윈백 모드 EMAIL_SUNSET_MODE_WINBACK은 Journey가 아닌 Messaging API v2에서만 사용할 수 있습니다.

MultiEntry

사용자가 Journey에서 동시에 가질 수 있는 활성 세션 수를 제어합니다. Customer Journey 빌더의 사용자가 동시에 가질 수 있는 세션 수 제어를 미러링합니다. 이벤트 진입 포인트 및 wait_event에서 사용됩니다.

필드	타입	설명
enabled	bool	사용자가 동시에 여러 활성 세션을 가질 수 있는지 여부. false: 사용자당 하나의 활성 세션. true: 사용자당 여러 활성 세션.
attribute_name	string	선택 사항. 각 세션의 범위를 지정하는 이벤트 속성. 설정하면 사용자는 이 속성의 고유한 값당 하나의 활성 세션을 가질 수 있습니다(예: order_id당 하나). 동일한 값을 가진 이벤트는 하나의 세션을 공유합니다. 사용자의 모든 진입을 함께 범위로 지정하려면 비워 둡니다.

관련

Journey 객체

생성 및 업데이트

프리셋 API