> For the complete documentation index, see [llms.txt](https://docs.dfinery.ai/user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dfinery.ai/user-guide/customer/audience/audience-filter-rules.md). # 오디언스 필터 규칙 ## **오디언스 그룹 생성** 오디언스 그룹은 각 필터 조건의 결합으로 구성되며, 필터 조건은 크게 이벤트와 유저 프로필 조건으로 구분됩니다.
필터 조건리밋룰
이벤트개수 제한 없음(단, 동일한 이벤트로 필터 조건 추가 불가)
유저 프로필개수 제한 없음(단, 동일한 속성으로 필터 조건 추가 불가)
캠페인개수 제한 없음
이 때, 한 그룹 내에서는 동일한 필터 조건으로만 추가 할 수 있습니다. ([관련 가이드](/user-guide/customer/audience.md#undefined-3)) ## **이벤트 필터** ### **이벤트 집계 방식 개요** 이벤트는 크게 **횟수**와 해당 이벤트의 **하위 속성**을 집계하는 방식으로 나뉩니다.\ 속성 집계의 경우 **해당 이벤트의 하위 속성이 등록되어 있어야 활용 가능**합니다. {% file src="/files/5Ch11rLK9xMBaDQuVKyw" %}
집계 방식설명비고
1.전체 수
(Total Count)		기간 내 발생한 총 이벤트 횟수에 대한 조건을 필터할 수 있습니다.
2.속성 집계선택한 이벤트의 하위 속성을 집계하여 필터링 할 수 있습니다.*전체 이벤트, 전체 활성 이벤트, 시스템 이벤트의 경우 속성 집계로 필터링 불가
### **1.전체 수** 기간 내 발생한 총 이벤트 횟수에 대한 조건을 필터할 수 있습니다. #### **예시** **최근 30일간 구매 이벤트를 5회 이상 발생시킨 고객**을 조건으로 설정하려면 아래와 같이 설정할 수 있습니다.
### **2.속성 집계** 이벤트의 하위 속성으로 더 세분화된 조건을 설정할 수 있습니다.
#### **예시** **최근 30일간 배송료 합이 5,000원 이상 구매 고객**로 설정하려면 아래와 같이 설정할 수 있습니다.
배송료는 정수로 데이터가 수집되며, 합계, 평균, 최소값, 최대값 등의 집계 방식을 선택할 수 있습니다.\ **그러나 데이터 타입이 다른 경우에는 아래 표에 따라 제공되는 집계 함수가 달라집니다.**
속성 데이터 타입집계 함수
문자
(String)		• 속성 수(Unique)

정수
(Number)


실수
(Double)

• 합 (Sum)
• 평균 (Average)
• 최소 (Min)
• 최대 (Max)
문자 목록
(List of strings)		미지원
참/거짓
(Boolean)		미지원
날짜 및 시간
(Datetime)		미지원
문자
(String enum)		미지원
숫자 목록
(List of “Number | Double”)		미지원
### **이벤트 필터 추가** 이벤트를 선택한 후, 해당 이벤트에 대해 세부 조건을 추가로 필터링할 수 있습니다.\ 필터의 경우 개수 제한은 없지만 이미 추가한 속성은 중복해서 추가할 수 없습니다. 기본적으로 모든 이벤트는 디파이너리 자동 수집 속성으로 필터링이 가능하며, 선택한 이벤트의 하위 속성으로도 추가 필터링이 가능합니다. #### **예시** 앞선 예시(**최근 30일간 구매 이벤트를 5회 이상 발생시킨 고객)**에 **강남구에서 구매한 고객**이라는 필터를 추가하고 싶은 경우 아래와 같이 설정할 수 있습니다.
{% hint style="warning" %} **이벤트 속성 시 주의사항** * Not 연산자(불포함, 값 제외, \~로 시작 제외, 사잇값 제외)를 지원하지 않습니다. * List 유형은 최대 1개만 사용 가능합니다. {% endhint %} ## **유저 프로필** 유저 프로필은 이벤트 조건과 달리 이벤트를 선택하지 않고도 항상 최신화된 유저 프로필 DB 속성값을 통해 직접 필터링할 수 있습니다. #### **예시** **성별이 여성이고 회원 등급이 ‘GOLD’인 고객**을 조건으로 설정하고 싶은 경우, 아래와 같이 설정할 수 있습니다.
유저 프로필은 크게 유저 속성, 최근 디바이스 속성, 행동 속성의 카테고리로 구분됩니다. ([관련 가이드](/user-guide/customer/audience.md#undefined-3)) 유저 프로필은 조건 추가에 대한 개수 제한은 없지만, 이미 추가한 속성은 중복해서 추가할 수 없습니다. ## **캠페인** 캠페인은 조회 시점 기준 최근 1년 내 운영 종료 혹은 현재 운영중인 캠페인을 선택하여, 주요 지표 기준 필터하는 기능입니다. 제공되는 기준 지표는 '**클릭 수** / **구매 전환 수** / **구매 금액**' 3가지 이며 원하는 연산자 기호와 기준 숫자를 입력하여 해당 수치에 해당하는 유저 id를 필터합니다. 또한, 기간 필터를 걸어 해당 기간에 쌓인 유저만 특정하여 추출할 수 있습니다. #### **예시** **지난 달 진행한 푸시 캠페인A 기준 ‘구매 금액’이 1만원 이상인 고객을** 조건으로 설정하고 싶은 경우, 아래와 같이 설정할 수 있습니다.
## **기간 필터** ### **조회 가능 기간** * 그룹 당 최대 365일까지 설정할 수 있습니다. * 기간을 '상대'로 설정 시 선택할 수 있는 기준일은 최대 100일 전으로 설정할 수 있습니다. * 2개 그룹을 합집합하였을 때 최대 730일까지 조회가 가능합니다. ([관련 가이드](/user-guide/customer/audience/samples.md#id-200)) ### **리밋룰** * 이벤트와 항상 최신 값으로 유지되는 유저 프로필 속성을 설정할 때에만 Not 조건(제외 연산자)을 지원합니다. * 이벤트 속성 설정시에는 Not 조건을 지원하지 않습니다. * 단, 이벤트 트리거링 설정시에는 이벤트 속성에 대해서도 Not 조건을 지원합니다. * 오디언스 생성 시 데이터는 최대 200일까지 조회할 수 있습니다. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.dfinery.ai/user-guide/customer/audience/audience-filter-rules.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.