필터 조건 설정하기
필터 조건 소개
오디언스로 발송 대상을 선택하거나 메시지 발송에 추가 필터로 추가할 수 있는 조건은 다음 카테고리로 구성됩니다.
- 이벤트 속성 (유저 행동)
- 유저 속성 (기본 / 커스텀 / 디바이스)
- 캠페인·시나리오 수신·오픈 여부
- 결제 금액
이벤트 속성
이벤트 속성은 유저의 서비스 내 행동(예: 회원가입, 장바구니, 구매 등)에 대한 필터입니다.
아래 표는 블럭스가 기본으로 제공하는 예약 이벤트(reserved events) 목록입니다. 이외에도 애플리케이션마다 직접 정의한 커스텀 이벤트를 동일한 방식으로 필터에 사용할 수 있습니다.
1. 유저 행동 이벤트
| 이벤트 속성 | 설명 |
|---|---|
| visit | 서비스 접속 |
| page_visit | 페이지 조회 |
| section_view | 섹션 조회 |
| product_detail_view | 상품 상세 페이지 조회 |
| click | 상품 클릭 |
| like | 상품 좋아요 누르기 |
| rate | 상품 평점 남기기 |
| cartadd | 장바구니 추가 |
| order | 구매 (주문건 단위) |
| purchase | 구매 (주문 내 개별 상품 단위) |
| instant_impression | 노출 |
| persistent_impression | 1초 이상 노출 |
2. 메시지 관련 이벤트
블럭스가 메시지를 발송·수신·오픈하는 과정에서 자동으로 생성되는 이벤트입니다.
| 이벤트 속성 | 설명 |
|---|---|
| message_received | 메시지 수신 |
| push_opened | 메시지 오픈 (앱푸시) |
| inapp_opened | 메시지 오픈 (인앱) |
| friendtalk_button_clicked | 메시지 버튼 클릭 (친구톡) |
| alimtalk_button_clicked | 메시지 버튼 클릭 (알림톡) |
| brandmessage_button_clicked | 메시지 버튼 클릭 (브랜드 메시지) |
| email_link_clicked | 메시지 링크 클릭 (이메일) |
| sms_link_clicked | 메시지 링크 클릭 (문자) |
| rcs_link_clicked | 메시지 링크 클릭 (RCS) |
| landing_clicked | 블럭스 랜딩페이지 클릭 |
3. 이커머스 통합 이벤트
연동된 이커머스 플랫폼에서 자동으로 들어오는 이벤트입니다.
| 이벤트 속성 | 설명 |
|---|---|
| cafe24_purchase_canceled | 카페24 개별 상품 구매 취소 |
| cafe24_return_received | 카페24 개별 상품 반품 접수 |
| cafe24_exchange_received | 카페24 개별 상품 교환 접수 |
| cafe24_return_withdrawn | 카페24 개별 상품 반품 철회 |
| cafe24_exchange_withdrawn | 카페24 개별 상품 교환 철회 |
| cafe24_cancel_withdrawn | 카페24 개별 상품 취소 철회 |
| cafe24_coupon_issued | 카페24 쿠폰 발급 |
| cafe24_coupon_used | 카페24 쿠폰 사용 |
| cafe24_point_added | 카페24 적립금 추가 |
| cafe24_delivery_ready | 카페24 배송 준비 중 |
| cafe24_delivery_started | 카페24 배송 시작 |
| cafe24_delivery_completed | 카페24 배송 완료 |
| shopby_coupon_issued | 샵바이 쿠폰 발급 |
| godomall_coupon_issued | 고도몰 쿠폰 발급 |
| godomall_coupon_used | 고도몰 쿠폰 사용 |
| godomall_delivery_started | 고도몰 배송 시작 |
| godomall_delivery_completed | 고도몰 배송 완료 |
이벤트별 추가 속성
각 이벤트에는 트리거 시 함께 들어오는 속성 값이 있어, 필터에서 추가 조건으로 활용할 수 있습니다.
| 속성 | 설명 |
|---|---|
| price | 가격 |
| order_id | 주문 ID |
| order_amount | 주문 금액 |
| paid_amount | 실제 결제 금액 |
| rating | 평점 |
| page | 페이지 ID |
| item_id | 상품 ID |
| search_query | 검색어 |
| campaign_id | 캠페인 ID |
| scenario_id | 시나리오 ID |
| scenario_node_id | 시나리오 노드 ID |
이 외 애플리케이션마다 SDK로 보낸 커스텀 이벤트 속성도 추가 조건으로 사용할 수 있습니다.
이벤트 조건 기준
이벤트를 고른 뒤에는 그 이벤트를 어떤 기준으로 볼지를 정합니다. 기준마다 기간과 이벤트 속성 조건을 함께 붙일 수 있습니다.
| 기준 | 설명 | 예시 |
|---|---|---|
| 수행 여부 | 기간 안에 이벤트를 한 번이라도 했는지(하지 않았는지) | 최근 30일 안에 purchase를 한 적이 있음 |
| 수행 횟수 | 기간 안에 이벤트를 몇 번 했는지 | 최근 7일 안에 product_detail_view 5회 이상 |
| 마지막으로 수행한 날짜 | 이벤트를 마지막으로 한 날짜 | 마지막 cartadd가 3일 전보다 이전 |
| 같은 상품 수행 횟수 | 같은 상품에 대해 이벤트를 몇 번 했는지. 상품을 미리 지정하지 않아도 특정 상품에 반복된 행동을 한 유저를 찾습니다. | 최근 3일 안에 같은 상품을 2회 이상 조회 |
| 이벤트 속성 합계 | 기간 안에 발생한 이벤트의 숫자 속성을 유저별로 합산한 값 | 최근 30일 안에 포인트 사용 이벤트의 amount 합계가 50,000 이상 |
같은 상품 수행 횟수는 상품 ID(item_id)가 들어오는 이벤트에서만 고를 수 있고, 유저가 남긴 상품별 횟수 중 가장 큰 값으로 판정합니다. 예를 들어 상품 A를 2번, B를 1번 봤다면 수행 횟수는 3이지만 같은 상품 수행 횟수는 2입니다. 기간은 오늘 또는 최근 30일(4주) 이내의 상대 기간만 지원하며, 이벤트 속성 조건은 함께 붙일 수 없습니다.
이벤트 속성 합계는 합산할 숫자 속성에서 그 이벤트에 등록된 숫자 타입 속성을 고릅니다. 결제 금액처럼 미리 정해진 값이 아니라 포인트·기프트카드 사용액 같은 임의의 숫자 속성을 기간별로 더해 비교할 수 있습니다. 숫자가 아닌 값과 비어 있는 값은 제외하고 음수는 그대로 더하며, 합산할 값이 없는 유저는 0으로 계산합니다. 합산 속성과 별개로 이벤트 속성 조건을 붙여 합산할 이벤트를 좁힐 수 있습니다.
유저 속성
유저의 고유 속성(예: 이름, 닉네임, 생일 등)에 대한 필터예요.
유저 속성은 다음으로 구분됩니다.
- 기본 유저 속성: 데이터 연동 시 전달한 기본 유저 속성
- 커스텀 유저 속성: 애플리케이션마다 추가로 전송하는 유저 속성
- 디바이스 속성: 유저의 디바이스(앱 버전, SDK 버전 등) 정보
- 마지막 행동 상품 속성: 마지막으로 본 상품 / 장바구니에 담은 상품 / 구매한 상품 / 좋아요한 상품의 속성
1. 기본 유저 속성
| 유저 속성 | 설명 | 타입 |
|---|---|---|
| blux_user_id | 블럭스 유저 ID | string |
| user_id | 유저 ID | string |
| phone_number | 전화번호 | string |
| email_address | 이메일 | string |
| gender | 성별 | string |
| age | 나이 | number |
| blux_user_tier | 블럭스 유저 등급 | string |
| last_active_at | 마지막 활동 시간 | date |
2. 마케팅 수신 동의 속성
| 유저 속성 | 설명 |
|---|---|
| marketing_notification_consent | 광고 수신 동의 (전체) |
| marketing_notification_sms_consent | 광고 문자 수신 동의 |
| marketing_notification_email_consent | 광고 이메일 수신 동의 |
| marketing_notification_kakao_consent | 광고 카카오톡 수신 동의 |
| marketing_notification_push_consent | 광고 앱푸시 수신 동의 |
| nighttime_notification_consent | 야간 수신 동의 |
| is_all_notification_blocked | 모든 메시지 수신 차단 여부 |
| is_persistent_error_friendtalk | 브랜드 메시지(I형) 발송 실패 예상 여부 |
| is_persistent_error_brand_message_m | 브랜드 메시지(M형) 발송 실패 예상 여부 |
| is_persistent_error_brand_message_n | 브랜드 메시지(N형) 발송 실패 예상 여부 |
| notification_blocked_by_reject_number | 080 수신 거부 여부 |
3. 마지막 행동 상품 속성
마지막으로 액션한 상품의 속성을 메시지 개인화 변수로 활용할 수 있습니다. ID 단일 값은 underscore 형태(_id)로, 그 외 상품 정보(이름·링크·이미지 등)는 dot 표기법(.name, .item_url_mobile 등)으로 사용합니다.
| 마지막 행동 | ID 변수 | 상세 정보 (dot 표기법) |
|---|---|---|
| 마지막으로 조회한 상품 | latest_product_detail_view_item_id | latest_product_detail_view_item.name / .item_url_mobile / .brand_message_image_url ... |
| 마지막으로 장바구니에 담은 상품 | latest_cartadd_item_id | latest_cartadd_item.name / .item_url_mobile / .brand_message_image_url ... |
| 마지막으로 구매한 상품 | latest_purchase_item_id | latest_purchase_item.name / .item_url_mobile / .brand_message_image_url ... |
| 마지막으로 좋아요한 상품 | latest_like_item_id | latest_like_item.name / .item_url_mobile / .brand_message_image_url ... |
마지막 행동 상품 속성은 그 행동을 한 적이 있는 유저만 값이 존재합니다.
만약 유저가 상품을 조회한 적이 없다면, latest_product_detail_view_item.item_url_mobile은 null 값을 가집니다.
4. 디바이스 속성
| 유저 속성 | 설명 |
|---|---|
| android_sdk_version | 안드로이드 SDK 버전 |
| ios_sdk_version | iOS SDK 버전 |
| android_app_version | 안드로이드 앱 버전 |
| ios_app_version | iOS 앱 버전 |
| browser_sdk_version | 브라우저 SDK 버전 |
구매·방문 확률
블럭스 AI가 유저별로 예측한 구매 확률과 방문 확률로 조건을 만들 수 있어요. 값은 확률 자체가 아니라 전체 유저 중 백분위입니다. 확률이 가장 높은 유저가 상위 1%, 가장 낮은 유저가 하위 1%가 됩니다.
| 유저 속성 | 설명 |
|---|---|
| 구매 확률 | 유저가 구매할 확률의 전체 유저 대비 백분위 |
| 방문 확률 | 유저가 서비스에 방문할 확률의 전체 유저 대비 백분위 |
조건을 추가하면 하위 20% · 중위 60% · 상위 20% 프리셋으로 구간을 바로 고를 수 있어요. 다른 구간이 필요하면 직접 설정을 누르거나 슬라이더를 끌어 조정하고, 백분위 입력란에 숫자를 직접 넣을 수도 있어요. 확률 데이터가 준비된 애플리케이션에서는 구간에 대응하는 예상 확률(예: 예상 구매 확률 0.42~14.43%)이 함께 표시됩니다.
구간별 특성과 활용 방법은 다음을 참고하세요.
구매 확률
| 구간 | 설명 |
|---|---|
| 하위 | 구매까지 이어질 가능성이 낮은 그룹이에요. 관심 유도나 반복 노출로 장기적 전환을 기대할 수 있지만, 단기간의 메시지로는 효과가 크지 않을 수 있어요. |
| 중위 | 구매 유도에 가장 효과적인 그룹이에요. 적절한 메시지를 통해 전환율을 끌어올릴 수 있어 타겟 설정 시 우선적으로 고려해보세요. |
| 상위 | 구매 가능성이 높은 그룹이에요. 구매를 앞당길 수 있는 메시지를 보내보세요. 단, 메시지 발송에 관계없이 자발적으로 전환할 가능성이 높아요. |
방문 확률
| 구간 | 설명 |
|---|---|
| 하위 | 장기간 방문하지 않았던 유저예요. 복귀를 유도할 수 있지만, 단기간 메시지로는 효과가 크지 않을 수 있어요. |
| 중위 | 이탈 가능성이 있는 유저예요. 적절한 메시지로 재방문을 유도할 수 있어 타겟 설정 시 우선적으로 고려해보세요. |
| 상위 | 재방문 가능성이 높은 유저예요. 메시지를 통해 행동을 앞당길 수 있지만, 메시지 없이도 스스로 재방문할 가능성이 높아요. |
구매·방문 확률 조건은 블럭스 팀이 해당 기능을 활성화한 애플리케이션에서만 사용할 수 있어요. 조건 목록에 보이지 않는다면 블럭스 팀에 문의해 주세요.
캠페인·시나리오 수신·오픈 여부
특정 캠페인 또는 시나리오의 수신·오픈 여부에 대한 필터입니다. 조건 추가 팝오버의 기타 카테고리에서 선택할 수 있습니다.
| 속성 | 설명 |
|---|---|
| 캠페인 수신/오픈 여부 | 특정 캠페인을 선택한 기간 내에 수신·오픈했는지 여부 |
| 시나리오 수신/오픈 여부 | 특정 시나리오를 선택한 기간 내에 수신·오픈했는지 여부 |
각 항목별로 수신함 / 수신하지 않음 / 오픈함 / 오픈하지 않음을 조합해 조건을 만들 수 있습니다.
결제 금액
설정한 기간 내 유저의 총 결제 금액에 대한 필터를 추가할 수 있어요.
| 속성 | 설명 |
|---|---|
| 총 결제금액 | 설정한 기간 내 결제된 금액의 합 |
고급 조건 — 데이터 준비가 필요한 조건
오디언스·시나리오·인앱 메시지에서 쓰는 이벤트 조건 중 일부는 고급 조건으로 분류됩니다. 실시간으로 바로 평가할 수 없어, 사용 전에 데이터 준비가 필요한 조건입니다.
- 최근 30일을 넘는 기간의 이벤트 조건 (예: "최근 90일 동안
purchase3회 이상") - 최초·최근 발생 시점처럼 전체 이력이 필요한 조건
고급 조건이 들어간 오디언스를 저장하거나 시나리오·인앱 메시지를 활성화하면, 준비가 필요한 고급 조건이 있어요 모달이 뜹니다. 준비 시작을 클릭하면 준비가 시작되고, 최대 30분 정도 걸립니다.
준비가 끝난 뒤의 동작은 사용처에 따라 다릅니다.
| 사용처 | 준비 완료 후 |
|---|---|
| 오디언스 저장 | 자동 반영되지 않습니다. 준비가 끝난 뒤 다시 저장하면 반영됩니다. |
| 시나리오·인앱 메시지 활성화 | 준비가 끝나면 자동으로 활성화가 진행됩니다. |
모달의 준비 목록 보기 버튼으로 고급 필터 화면을 열면, 준비된 고급 조건의 상태(활성화·활성화중·비활성·실패)와 사용 중인 오디언스·시나리오·인앱 메시지를 확인할 수 있습니다. 고급 조건은 애플리케이션마다 서로 다른 조건 기준으로 최대 50개까지 준비할 수 있으며, 같은 조건을 쓰는 항목은 하나로 묶여 계산됩니다.
캠페인의 발송 대상 필터는 발송 시점에 한 번만 평가하므로, 같은 조건이라도 데이터 준비 없이 바로 사용할 수 있습니다.
타입 별 연산자 기준
속성마다 데이터 타입이 다릅니다(숫자, 문자열, 불리언, 날짜, 배열). 오디언스 필터를 만들 때는 타입별로 다른 연산자를 적용해야 합니다.
아래 표는 각 타입별로 사용할 수 있는 연산자입니다.
| 타입 | 가능한 연산자 |
|---|---|
number | - 같음(=) - 같지 않음(≠) - 보다 큼(>) - 보다 크거나 같음(≥) - 보다 작음(<) - 보다 작거나 같음(≤) - 값 있음 - 값 없음 |
string | - 같음(=) - 같지 않음(≠) - 여러 값 중 하나(any of) - 여러 값 중 어느 것도 아님(none of) - 하나라도 포함 함(includes any of) - 모두 포함하지 않음(includes none of) - 정규식 일치 - 정규식 불일치 - 값 있음 - 값 없음 |
boolean | - 참(true) - 거짓(false) - 값 있음 - 값 없음 |
date | - 정확히 ~ 전 - ~ 이전 / ~ 이전 또는 같음 - ~ 이후 / ~ 이후 또는 같음 - 특정 날짜 - 특정 날짜 이전 / 이후 - 오늘(today) - 전체 기간 - 값 있음 - 값 없음 |
array | - 포함(contains) - 미포함(not contains) - 임의 포함(any of) - 임의 미포함(none of) - 모두 포함(all of) - 비어 있음 - 값 있음 - 미설정 |
하나라도 포함함·모두 포함하지 않음은 입력한 값 목록 중 하나라도 부분 문자열로 포함하는지(포함하지 않는지)를 평가합니다. 정규식을 쓰지 않고 URL 목록으로 페이지 조건을 만들 때 유용하며, 유저 속성 조건과 이벤트 속성 조건 모두에서 쓸 수 있습니다.
이벤트 속성 조건의 정규식 일치·불일치는 저장할 때 실행 엔진 호환성을 검사해요. lookaround·backreference·\Z 앵커가 들어간 정규식은 지원하지 않는 정규식입니다 안내와 함께 저장되지 않습니다. "X를 포함하지 않음"을 뜻하는 ^(?!.*X).* 형태는 예외적으로 사용할 수 있어요. 정규식은 16,000바이트(UTF-8 기준)를 넘으면 저장되지 않으므로, 상품 ID 수천 개를 |로 잇는 대신 여러 값 중 하나 연산자를 쓰는 편이 안전합니다.