리텐션 리포트에서 사용하는 코호트를 정의합니다. 항상 andClauses
, orClauses
, segment
순서로 하위 변수를 정의합니다. 아래에서 각 변수의 관계를 확인하세요.
groupBy.cohorts[0].definition.andClauses (object[]) 필수
코호트 정의의 최상위 조건입니다. 설정한 조건을 모두 and로 연결합니다. 하위 변수로 negated
와 orClauses
를 반드시 설정해야 합니다.
negated
(boolean): orClauses
에 설정한 조건의 부정 여부를 설정합니다.
true
: orClauses
에 설정한 조건을 부정합니다. 따라서 orClauses
에 설정한 조건이 거짓입니다.
false
: orClauses
에 설정한 조건을 부정하지 않습니다. 따라서 orClauses
에 설정한 조건이 참입니다.
groupBy.cohorts[0].definition.andClauses[*].orClauses (object[]) 필수
andClauses
하위에 설정하는 조건입니다. 설정한 조건을 모두 or로 연결합니다. 하위 변수로 negated
와 segment
를 반드시 설정해야 합니다.
negated
(boolean): segment
에 설정한 조건의 부정 여부를 설정합니다.
true
: segment
에 설정한 조건을 부정합니다. 따라서 segment
에 설정한 조건이 거짓입니다.
false
: segment
에 설정한 조건을 부정하지 않습니다. 따라서 segment
에 설정한 조건이 참입니다.
groupBy.cohorts[0].definition.andClauses[*].orClauses[*].segment (object) 필수
코호트 정의의 최소 조건입니다. 하위 변수로 event
, filters
, time
을 설정할 수 있습니다.
event
(object): 유저가 발생시킨 이벤트와 이벤트 발생 횟수를 정의할 수 있습니다. 하위 변수로 type
, operator
, value
를 설정할 수 있습니다.
type
(string): 유저가 발생시킨 이벤트를 설정합니다. any-event
를 사용하면 모든 이벤트로 설정할 수 있습니다. 설정할 수 있는 다른 이벤트는 [에어브릿지 데이터 스펙]>[Retention Report - Audience Events]의 Event Key 열에서 확인할 수 있습니다. -
, _
사용에 주의해 주세요.
operator
(enum): 이벤트 발생 횟수에 사용하는 비교 연산자를 설정할 수 있습니다. equals
, more than or equals
, more than
, less than or equals
, less than
등 총 5가지 중에서 1가지만 사용할 수 있습니다 .
value
(number): 이벤트 발생 횟수를 설정할 수 있습니다. 자연수를 입력해 주세요.
filters
(object[]): 정의한 이벤트 중 특정 이벤트만 확인할 수 있습니다. 코호트 정의의 had property와 같습니다. 하위 변수로 field
, filterType
를 설정할 수 있습니다.
field
(string): 필터로 설정할 수 있는 프로퍼티입니다. 설정할 수 있는 프로퍼티는 [에어브릿지 데이터 스펙]>[Retention Report - Audience Properties]의 Property Key 열을 참고해 주세요.
filterType
(enum): 프로퍼티에 사용할 수 있는 연산자를 설정합니다. 설정한 프로퍼티에 따라 사용할 수 있는 연산자와 필터로 설정하는 값(없음, value, values)이 변경됩니다
filterType | 프로퍼티 데이터 타입 | 하위 변수 |
---|
is / is not | string, boolean | values |
contains / does not contain | string | value |
exists / does not exist | string, boolean, int, float | 없음 |
equals / does not equal | int, float | value |
does not equal | int, float | value |
greater than or equals | int, float | value |
greater than | int, float | value |
less than or equals | int, float | value |
less than | int, float | value |
between | int, float | values |
does not between | int, float | values |
time
(object): 이벤트가 발생한 시각에 대한 조건을 설정할 수 있습니다. 설정한 조건에 따라 하위 변수가 변경됩니다.
operator
(enum): during
, between
, since
중에서 조건을 설정합니다. 3가지 중에서 1가지만 설정할 수 있습니다.
operator | 하위 변수 | 설명 |
---|
during | values, isNowEnabled | isNowEnabled은 오늘 포함 여부를 설정합니다 |
between | values | values에 시작일과 종료일을 모두 설정해야 합니다 |
since | values | 시작일만 설정합니다 |