Shopify 기반 고객 세그먼트 필터

이 참조 가이드를 사용하여 기본 Shopify 필터를 기반으로 하는 고객 세그먼트를 구축하는 데 사용되는 필터 이름, 연산자, 값을 알아보세요.

이 페이지의 내용

중단된 체크아웃 날짜

이름: abandoned_checkout_date

마지막으로 카트를 중단한 날짜를 기준으로 고객을 포함합니다.

연산자	정확한 날짜: `=` 해당 날짜 아님: `!=` 해당 날짜 또는 이전: `<=` 이전 날짜: `<` 해당 날짜 또는 이후: `>=` 이후 날짜: `>` 날짜 사이: `BETWEEN {date1} AND {date2}` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값
형식	절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: `-4w`, `-10y` 지정된 날짜: 오늘: `= today` 어제: `= yesterday` 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	지난주에 마지막으로 카트를 중단한 고객 포함: `abandoned_checkout_date >= -7d` 지난 8개월 이내에 마지막으로 카트를 중단한 고객 포함: `abandoned_checkout_date > -8m`
참고	날짜 값은 전체 일을 기준으로 하며 스토어의 표준 시간대에 따라 달라집니다.

기념일

이름: anniversary

날짜 매개변수와 연결된 이벤트 날짜별로 고객을 포함합니다.

함수 매개변수	필터링할 이벤트를 지정합니다. 예: `'metafields.facts.birth_date'`
연산자	`IS NULL`: 매개변수가 존재하지 않습니다. `IS NOT NULL`: 매개변수가 존재합니다. 날짜의 경우 사용 가능한 연산자는 다음과 같습니다. 같음: `=` 같지 않음: `!=` 사이: `BETWEEN`
값	`date`
형식	절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: `+4w`, `+3m` 지정된 날짜 또는 범위: 오늘: `= today` 다음 7일 이내: `BETWEEN today AND +7d` 다음 30일 이내: `BETWEEN today AND +30d`
예	다음 30일 이내에 생일인 고객 포함: `anniversary ('metafields.facts.birth_date') BETWEEN today AND +30d`
참고	`anniversary` 필터는 연도를 고려하지 않습니다. 날짜 값은 전체 일을 기준으로 하며 스토어의 표준 시간대에 따라 달라집니다. 생년월일로 필터링하려면 `facts.birth_date` 표준 메타 필드를 활성화하거나 사용자 지정 메타 필드를 생성해야 합니다. 표준 메타 필드 추가 또는 사용자 지정 메타 필드 정의 생성에 대해 자세히 알아보세요.

지출액

이름: amount_spent

스토어에서 지출한 금액을 기준으로 고객을 포함합니다.

연산자	같음: `=` 같지 않음: `!=` 보다 큼: `>` 보다 작음: `<` 작거나 같음: `<=` 크거나 같음: `>=` 사이: `BETWEEN`
값
형식	숫자 범위: `# AND #` 숫자: `#` 십진수: 소수 구분 기호로 소수점(.)을 사용합니다. 쉼표나 공백과 같은 천 단위 구분 기호는 허용되지 않습니다. 언어별 형식의 숫자는 허용되지 않습니다.
예	스토어에서 1~999.99를 지출한 고객 포함: `amount_spent BETWEEN 1 AND 999.99`
참고	사용되는 통화는 스토어에 대해 선택한 통화를 기준으로 합니다. 통화 기호를 입력하여 사용되는 통화를 지정하지 마세요. `BETWEEN` 은(는) 시작 값과 종료 값을 모두 포함합니다. 예를 들어 `amount_spent BETWEEN 1 AND 100` 은(는) 최소 1에서 최대 100까지 지출한 고객을 포함합니다.

도시

이름: customer_cities

지정된 도시에 주소가 있는 고객을 포함합니다. 여러 주소를 가진 고객은 이 필터를 사용하는 둘 이상의 고객 세그먼트에 포함될 수 있습니다.

연산자	이 도시를 정확히 포함: `CONTAINS` 이 도시를 정확히 포함하지 않음: `NOT CONTAINS` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값
형식	`countryCode-regionCode-cityCode`
예	뉴욕시에 주소가 있는 고객 포함: `customer_cities CONTAINS 'US-NY-NewYorkCity'`
참고	도시를 찾으려면 도시 이름 입력을 시작한 다음 표시되는 목록에서 적절한 값을 선택하세요.

회사

이름: companies

B2B 고객으로 구성된 회사의 고객을 포함합니다.

연산자	이 회사 ID를 정확히 포함: `CONTAINS` 이 회사 ID를 정확히 포함하지 않음: `NOT CONTAINS` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	회사 ID
형식
예	B2B 고객: `companies IS NOT NULL` B2B 고객 아님: `companies IS NULL` 특정 회사에 소속된 고객 포함: `companies CONTAINS 3778915041302`
참고	고객 세그먼트를 생성할 때 표시되는 목록에서 이름으로 회사를 선택할 수 있습니다. 또는 회사 제목 입력을 시작한 다음 목록에서 선택할 수도 있습니다. 코드에는 회사 이름이 아닌 회사 ID가 입력됩니다. 커서를 회사 ID 위로 가져가면 회사 이름이 표시됩니다.

국가 또는 지역

이름: customer_countries

지정된 국가 또는 지역에 주소가 있는 고객을 포함합니다. 여러 주소를 가진 고객은 이 필터를 사용하는 둘 이상의 고객 세그먼트에 포함될 수 있습니다.

연산자	이 위치를 정확히 포함: `CONTAINS` 이 위치를 정확히 포함하지 않음: `NOT CONTAINS` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	ISO 두 자리 국가 코드를 사용합니다.
형식
예	미국에 주소가 있는 고객 포함: `customer_countries CONTAINS 'US'`
참고	국가를 찾으려면 국가 이름 입력을 시작한 다음 표시되는 목록에서 적절한 값을 선택하면 됩니다.

생성한 앱 ID

이름: created_by_app_id

지정된 앱에서 생성한 고객을 포함합니다.

연산자	같음: `=` 같지 않음: `!=`
값	세그먼트 기준으로 삼을 앱의 ID입니다.
형식	앱 ID
예	Shopify 관리자에서 생성된 고객 포함: `created_by_app_id = 1830279`
참고	고객 세그먼트를 생성할 때 표시되는 목록에서 이름으로 앱을 선택할 수 있습니다. 또는 앱 이름 입력을 시작한 다음 목록에서 선택할 수도 있습니다. 코드에는 앱 이름이 아닌 앱 ID가 입력됩니다. 커서를 앱 ID 위로 가져가면 앱 이름이 표시됩니다.

고객 계정 상태

이름: customer_account_status

지정된 고객 계정 상태의 고객을 포함합니다.

연산자	같음: `=` 같지 않음: `!=`
값	거부됨: `'DECLINED'` 고객이 계정 생성을 초대받았지만 거부했습니다. 비활성화됨: `'DISABLED'` 고객이 계정을 생성하지 않았거나 스토어에서 신규 고객 계정을 사용 중입니다. 활성화됨: `'ENABLED'` 고객이 계정을 생성했습니다. 초대됨: `'INVITED'` 고객이 계정 생성을 초대받았지만 아직 수락하거나 거부하지 않았습니다.
형식
예	계정을 생성하도록 초대받았으나 거부한 고객 포함: `customer_account_status = 'DECLINED'`
참고

고객 추가 날짜

이름: customer_added_date

스토어에 추가된 날짜를 기준으로 고객을 포함합니다.

연산자	정확한 날짜: `=` 해당 날짜 아님: `!=` 해당 날짜 또는 이전: `<=` 이전 날짜: `<` 해당 날짜 또는 이후: `>=` 이후 날짜: `>` 날짜 사이: `BETWEEN {date1} AND {date2}`
값
형식	절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: `-4w`, `-10y` 지정된 날짜: 오늘: `= today` 어제: `= yesterday` 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	지난주 내에 추가된 고객 포함: `customer_added_date >= -7d` 지난 8개월 내에 추가된 고객 포함: `customer_added_date > -8m` 특정 날짜 범위 내에 추가된 고객 포함: `customer_added_date BETWEEN 2022-12-01 AND 2022-12-31`
참고	날짜 값은 전체 일을 기준으로 하며 스토어의 시간대에 따라 달라집니다.

고객 이메일 도메인

이름: customer_email_domain

이메일 주소가 지정된 도메인에 속한 고객을 포함합니다. 도메인 이름은 @ 기호 뒤에 오는 이메일 주소의 일부입니다(예: gmail.com).

연산자	같음: `=` 같지 않음: `!=` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	다음 도메인 이름은 제안으로 제공됩니다. 이러한 도메인 이름으로 제한되지 않으며 다른 유효한 도메인 이름을 수동으로 입력할 수 있습니다. Gmail: `'gmail.com'` Yahoo: `'yahoo.com'` 또는 `'yahoo.ca'` Hotmail: `'hotmail.com'` AOL: `'aol.com'` MSN: `'msn.com'` Live: `'live.com'` Outlook: `'outlook.com'`
형식
예	이메일 도메인이 shopify.com인 고객 포함: `customer_email_domain = 'shopify.com'`
참고

고객 언어

이름: customer_language

고객이 스토어와 통신하는 데 사용하는 언어를 기준으로 고객을 포함합니다.

연산자	같음: `=` 같지 않음: `!=` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	ISO 639-1 두 자리 언어 코드를 사용합니다.
형식	다음 값은 몇 가지 일반적인 ISO 언어 코드의 예입니다. 데이터가 이러한 언어 코드로 제한되지 않으며 다른 유효한 언어 코드를 수동으로 입력할 수 있습니다. 단, 편집기에서 제안 값으로 제공되는 값만 고객 데이터에서 사용 가능합니다. 영어: `'en'` 프랑스어: `'fr'` 스페인어: `'es'` 독일어: `'de'` 이탈리아어: `'it'` 일본어: `'ja'` 러시아어: `'ru'`
예	스토어와 영어로 소통하는 고객 포함: `customer_language = 'en'` 스토어와 캐나다 영어로 소통하는 고객 제외: `customer_language != 'en-CA'`
참고	로케일 ISO 코드를 값에 추가하여 해당 언어의 방언을 지정할 수 있습니다. 예를 들어 `'en-US'` 을(를) 미국에, `'en-GB'` 을(를) 영국에 사용하거나 `'pt-PT'` 을(를) 포르투갈에, `'pt-BR'` 을(를) 브라질에 사용할 수 있습니다. 언어 접두사만 지정된 경우 필터 값은 와일드카드 역할을 합니다. 예를 들어 필터 값이 `'en'`이면 결과에 언어가 `'en'` 로 설정된 고객과 언어가 `'en-GB'`, `'en-CA'`로 설정된 고객 등이 포함됩니다.

고객 태그

이름: customer_tags

태그를 기준으로 고객을 포함합니다.

연산자	이 태그를 정확히 포함: `CONTAINS` 이 태그를 정확히 포함하지 않음: `NOT CONTAINS` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	고객 태그의 이름입니다.
형식
예	GoldStatus 태그가 있는 고객 포함: `customer_tags CONTAINS 'GoldStatus'`
참고	태그는 대/소문자를 구분하지 않습니다. 태그 및 관련 고려 사항에 대해 자세히 알아보기.

거리 내 고객

이름: customer_within_distance

저장된 위치에서 지정된 거리 내에 있는 고객을 포함합니다.

함수 매개변수	각 필터에는 거리 매개변수를 하나만 사용할 수 있습니다. `coordinates`(필수): 이 매개변수를 사용하여 세그먼트를 생성하는 데 사용할 핀 위치를 지정합니다. `distance_km`(필수): 이 매개변수를 사용하여 고객을 검색할 거리 반경을 지정합니다. `distance_mi`(필수): 이 매개변수를 사용하여 고객을 검색할 거리 반경을 지정합니다.
연산자	`MATCHES`매개변수가 true입니다. `NOT_MATCHES`매개변수가 false입니다. `IS NULL`: 매개변수가 존재하지 않습니다. `IS NOT NULL`매개변수가 존재합니다.
값
형식	지원되는 형식: `coordinates`: 숫자(위도), 숫자(경도) 좌표(위도, 경도)에 지원되는 형식: 숫자: `#` 지원되는 형식: `distance_mi`, `distance_km`: 숫자: `#`
예	이 필터가 유효하려면 좌표와 거리 매개변수 하나가 필요합니다. 좌표(45.419190, -75.696727)에서 10마일 이내에 주소를 둔 고객 필터링: `customer_within_distance MATCHES (coordinates = (45.419190, -75.696727), distance_mi = 10 )` 이 필터는 다른 필터와 함께 사용하여 고객 목록의 범위를 더 좁힐 수 있습니다. 예를 들면 다음과 같습니다. 좌표(43.634,-79.412)에서 20km 이내에 주소를 두고 1회 이상 주문한 고객 필터링: `customer_within_distance MATCHES (coordinates = (43.634,-79.412), distance_km = 20 ) AND number_of_orders > 0`
참고	Shopify Segmentation은 저장된 위치를 좌표 쌍으로 자동 전환합니다. 이 필터를 사용하면 해당 좌표가 선택 가능한 값으로 표시됩니다. 스토어에 저장된 위치가 있는 경우 Shopify Magic이 매직 번역에서 좌표 쌍을 해당 위치 이름으로 자동 번역합니다. 예: “'Salt Lake City Store' 위치에서 10마일 이내에 주소가 있는 고객”

이메일 이벤트

이름: shopify_email.EVENT

선택한 이메일 이벤트를 기반으로 고객을 포함합니다. 지원되는 이벤트(EVENT)는 다음과 같습니다.

반송됨: bounced
클릭함: clicked
전달됨: delivered
스팸으로 표시됨: marked_as_spam
열어봄: opened
구독 취소됨: unsubscribed

함수 매개변수	`activity_id`(선택 사항): 필터링하려는 마케팅 활동 ID를 선택하려면 이 매개변수를 사용합니다. `count`(선택 사항): 이메일 이벤트가 발생한 횟수를 지정하려면 이 매개변수를 사용합니다. `date`(선택 사항): 이벤트 날짜를 지정하려면 이 매개변수를 사용합니다.
연산자	`MATCHES`: 이벤트가 발생한 경우에 사용합니다. `NOT_MATCHES`: 이벤트가 발생하지 않은 경우에 사용합니다. `IS NULL`: 매개변수가 존재하지 않습니다. `IS NOT NULL`: 매개변수가 존재합니다. 날짜의 경우 사용 가능한 연산자는 다음과 같습니다. 같음: `=` 같지 않음: `!=` 보다 큼: `>` 보다 작음: `<` 작거나 같음: `<=` 크거나 같음: `>=` 사이: `BETWEEN`
값
형식	지원되는 형식: `activity_id`: `=` (단일 값) `IN` : 쉼표로 구분된 값 집합으로, 괄호로 묶고 암시적 “OR”을 사용합니다. 예: `(activity_id IN (1, 2, 3))`. 한 세트의 활동 ID는 500개로 제한됩니다. `date`에 지원되는 날짜 형식: 절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: 7일 전: `-7d` 4주 전: `-4w` 3개월 전: `-3m` 1년 전: `-1y` 명명된 날짜: `today`, `yesterday` 명명된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요. 지난 26개월간의 이메일 이벤트를 사용할 수 있으며, 데이터는 2022년 3월부터 제공됩니다. 지원되는 형식: `count`: 숫자: `#`
예	`MATCHES` 또는 `NOT MATCHES` 연산자를 사용하여 이메일 이벤트 발생 여부를 지정합니다. `shopify_email.opened MATCHES (activity_id = 135195754518)` `shopify_email.opened NOT MATCHES (activity_id = 135195754518)` `activity_id` 매개변수를 사용하여 필터링할 마케팅 활동 ID를 지정합니다. `shopify_email.delivered MATCHES (activity_id = 135195754518)` `date` 매개변수와 `>=` 연산자를 사용하여 이메일 이벤트의 시작 날짜를 지정합니다. `shopify_email.delivered NOT MATCHES (activity_id = 135195754518, date >= 2022-01-01)` `date` 매개변수와 `<=` 연산자를 사용하여 이메일 이벤트의 종료 날짜를 지정합니다. `shopify_email.delivered MATCHES (activity_id = 135195754518, date <= 2022-01-01)` `date` 매개변수와 `BETWEEN` 연산자를 사용하여 이메일 이벤트의 시작 및 종료 날짜를 모두 지정합니다. `shopify_email.bounced NOT MATCHES (activity_id = 135195754518, date BETWEEN -12m AND today)`
참고	`activity_id` 매개변수를 사용하여 고객 세그먼트를 생성하면 표시되는 목록에서 이름으로 마케팅 활동을 선택할 수 있습니다. 데이터 보존으로 인해 `date` 매개변수가 없는 경우 결과는 설정된 시작 또는 종료 날짜 없이 지난 26개월 동안 필터링됩니다. `activity_id`가 없으면 필터에 모든 Shopify 이메일 활동이 포함됩니다.

이메일 구독 상태

이름: email_subscription_status

마케팅 이메일 구독 여부에 따라 고객을 포함합니다.

연산자	같음: `=` 같지 않음: `!=` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	구독 안 함: `'NOT_SUBSCRIBED'` 고객이 마케팅 이메일을 구독하지 않았습니다. 구독함: `'SUBSCRIBED'` 고객이 마케팅 이메일을 구독하고 있습니다. 보류 중: `'PENDING'` 고객이 마케팅 이메일을 구독하는 과정에 있습니다. 유효하지 않음: `'INVALID'` 고객의 이메일 주소 마케팅 상태가 유효하지 않습니다. 구독 취소: `'UNSUBSCRIBED'` 고객이 마케팅 이메일 구독을 취소했습니다. 삭제됨: `'REDACTED'` 고객의 이메일 주소가 삭제되었습니다.
형식
예	이메일 마케팅을 구독한 고객을 포함합니다. `email_subscription_status = 'SUBSCRIBED'`
참고

첫 주문 날짜

이름: first_order_date

지정된 날짜에 첫 주문을 한 고객을 포함합니다.

연산자	정확한 날짜: `=` 해당 날짜 아님: `!=` 해당 날짜 또는 이전: `<=` 이전 날짜: `<` 해당 날짜 또는 이후: `>=` 이후 날짜: `>` 날짜 사이: `BETWEEN {date1} AND {date2}` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값
형식	절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: `-4w`, `-10y` 지정된 날짜: 오늘: `= today` 어제: `= yesterday` 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	지난주 이후 첫 주문을 한 고객 포함: `first_order_date >= -7d` 8개월 전 이후 첫 주문을 한 고객을 포함합니다. `first_order_date > -8m`
참고	날짜 값은 전체 일을 기준으로 하며 스토어의 시간대에 따라 달라집니다.

마지막 주문 날짜

이름: last_order_date

지정된 날짜에 마지막 주문을 한 고객을 포함합니다.

연산자	정확한 날짜: `=` 해당 날짜 아님: `!=` 해당 날짜 또는 이전: `<=` 이전 날짜: `<` 해당 날짜 또는 이후: `>=` 이후 날짜: `>` 날짜 사이: `BETWEEN {date1} AND {date2}` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값
형식	절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: `-4w`, `-10y` 지정된 날짜: 오늘: `= today` 어제: `= yesterday` 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	지난주 이후 마지막 주문을 한 고객을 포함합니다. `last_order_date >= -7d` 8개월 전 이후 마지막 주문을 한 고객을 포함합니다. `last_order_date > -8m`
참고	날짜 값은 전체 일을 기준으로 하며 스토어의 시간대에 따라 달라집니다.

주문 수

이름: number_of_orders

스토어에서 주문한 횟수를 기준으로 고객을 포함합니다.

연산자	같음: `=` 같지 않음: `!=` 보다 큼: `>` 보다 작음: `<` 작거나 같음: `<=` 크거나 같음: `>=` 사이: `BETWEEN`
값	입력하는 값은 정수여야 합니다.
형식	숫자 범위: `# AND #` 숫자: `#`
예	주문을 10회 초과하여 완료한 고객을 포함합니다. `number_of_orders > 10`
참고	`BETWEEN` 은(는) 시작 값과 종료 값을 모두 포함합니다. 예를 들어 `number_of_orders BETWEEN 1 AND 100` 최소 1회, 최대 100회 주문한 고객을 포함합니다.

접수된 주문

이름: orders_placed

지정된 날짜 범위 동안 주문을 하거나 특정 금액을 지출한 고객을 포함합니다.

함수 매개변수	`app_id` (선택 사항): 이 매개변수를 사용하여 주문을 생성한 앱을 지정합니다. 여기에는 앱 ID가 129785인 Shopify POS와 같은 앱이 포함됩니다. `location_id` (선택 사항): 이 매개변수를 사용하여 주문이 접수된 위치를 지정합니다. 위치에서 위치의 세부 정보로 이동하면 Shopify Admin의 URL에서 위치 ID를 찾을 수 있습니다. `count` (선택 사항): 이 매개변수를 사용하여 주문이 접수된 정확한 횟수를 지정합니다. `amount` (선택 사항): 이 매개변수를 사용하여 주문에 지출된 정확한 금액을 지정합니다. `sum_amount` (선택 사항): 이 매개변수를 사용하여 모든 주문에 지출된 금액을 지정합니다. `date` (선택 사항): 이 매개변수를 사용하여 이벤트 날짜를 지정합니다.
연산자	`MATCHES`매개변수가 true입니다. `NOT_MATCHES`매개변수가 false입니다. `IS NULL`: 매개변수가 존재하지 않습니다. `IS NOT NULL`: 매개변수가 존재합니다. 날짜의 경우 사용 가능한 연산자는 다음과 같습니다. 같음: `=` 같지 않음: `!=` 보다 큼: `>` 보다 작음: `<` 작거나 같음: `<=` 크거나 같음: `>=` 사이: `BETWEEN`
값
형식	에 지원되는 형식 `count`, `amount`, ` 및 ` `sum_amount`: 숫자: `#` 에 지원되는 형식 `date`: 절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: 7일 전: `-7d` 4주 전: `-4w` 3개월 전: `-3m` 1년 전: `-1y` 명명된 날짜: 오늘: `today` 어제: `yesterday` 명명된 날짜는 기본값이며 변경할 수 없습니다.
예	주문 접수 여부를 `MATCHES` 또는 `NOT_MATCHES` 연산자를 사용하여 지정합니다. `orders_placed MATCHES ()` `orders_placed NOT MATCHES ()` 지난 6개월 동안 3회 이상 주문한 고객을 필터링합니다. `orders_placed MATCHES (count >= 3, date >= -6m)` 지난 90일 동안 $1000 이상 지출한 고객을 필터링합니다. `orders_placed MATCHES (sum_amount >= 1000, date >= -90d)` 지난 7일 동안 $100 이하를 지출한 고객을 필터링합니다. `orders_placed MATCHES (sum_amount <= 100, date >= -7d)` 2023년 1월 1일 이후로 $1000 이상 지출하고 3회 이상 주문한 고객을 필터링합니다. `orders_placed MATCHES (sum_amount >= 1000, count >= 3, date >= 2023-01-01)` 매개변수 `date` 및 연산자 `BETWEEN` 를 사용하여 특정 날짜 범위를 지정합니다. 2023년 1월 1일부터 2023년 6월 1일까지(포함)는 다음과 같이 표현할 수 있습니다. `orders_placed MATCHES (count >= 3, date BETWEEN 2023-01-01 AND 2023-06-01)` HQ 기프트샵 위치(1122334455) 또는 메인 스트리트 위치(6677889900)에서 주문한 고객을 필터링합니다. `orders_placed MATCHES (location_id IN (1122334455,6677889900))` Shopify POS에서 총 $500를 초과하여 지출한 고객을 필터링합니다. `orders_placed MATCHES (app_id = 129785, sum_amount >= 500)`
참고	금액 위로 커서를 가져가면 고객을 필터링하는 데 사용된 통화가 표시됩니다. 다음 구문 위로 커서를 가져가면 다음과 같이 표시됩니다. `amount`, `sum_amount` 구문에 대한 설명이 표시됩니다. 없는 경우 `parameters` 필터에 전체 기간 동안 접수된 모든 주문이 포함됨을 의미합니다.

예상 지출 등급

이름: predicted_spend_tier

지정된 예상 지출 등급 내의 고객을 포함합니다. 예상 지출 등급에 대해 자세히 알아보세요.

연산자	같음: `=` 같지 않음: `!=` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	`'HIGH'` `'MEDIUM'` `'LOW'`
형식
예	`HIGH` 등급의 고객 포함: `predicted_spend_tier = 'HIGH'`
참고

제품 구독 상태

이름: product_subscription_status

지정된 제품 구독 상태의 고객을 포함합니다.

연산자	같음: `=` 같지 않음: `!=` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	활성: `'SUBSCRIBED'` 고객에게 활성 제품 구독이 있습니다. 취소됨: `'CANCELLED'` 고객이 제품 구독을 취소했습니다. 만료됨: `'EXPIRED'` 고객의 제품 구독이 만료되었습니다. 실패: `'FAILED'` 고객에게 결제 실패가 있습니다. 구독 안 함: `'NEVER_SUBSCRIBED'` 고객이 구독한 적이 없습니다. 일시 중지됨: `'PAUSED'` 고객이 제품 구독을 일시 중지했습니다.
형식
예	활성 제품 구독이 있는 고객 포함: `product_subscription_status = 'SUBSCRIBED'`
참고

구매한 제품

이름: products_purchased

지정된 제품을 구매한 고객을 포함합니다. 또한 지정된 날짜 범위 동안 제품을 구매한 고객을 포함할 수 있습니다.

함수 매개변수	`id` (선택 사항): 이 매개 변수를 사용하여 필터링하려는 고객이 구매한 제품을 지정합니다. `quantity` (선택 사항): 이 매개 변수를 사용하여 주문당 구매한 제품 수량을 지정합니다. `sum_quantity` (선택 사항): 이 매개 변수를 사용하여 모든 주문에서 구매한 제품 수량을 지정합니다. `date` (선택 사항): 이 매개 변수를 사용하여 이벤트 날짜를 지정합니다. `tag` (선택 사항): 이 매개 변수를 사용하여 필터링하려는 구매 제품의 제품 태그를 지정합니다.
연산자	`MATCHES`: 매개 변수가 true입니다. `NOT_MATCHES`: 매개 변수가 false입니다. `IS NULL`: 매개 변수가 존재하지 않습니다. `IS NOT NULL`: 매개 변수가 존재합니다. 날짜에 사용 가능한 연산자는 다음과 같습니다. 같음: `=` 같지 않음: `!=` 보다 큼: `>` 보다 작음: `<` 작거나 같음: `<=` 크거나 같음: `>=` 사이: `BETWEEN`
값
형식	에 지원되는 형식 `tag`: `문자열` (단일 값) 지원되는 형식: `id`: `=` (단일 값) `IN` : 괄호로 묶고 쉼표로 구분된 값 세트(암시적 “OR” 사용). 예: `(id IN (1012132033639, 2012162031638, 32421429314657))`. 한 세트에는 제품 ID가 500개로 제한됩니다. 지원되는 `date` 형식: 절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: 7일 전: `-7d` 4주 전: `-4w` 3개월 전: `-3m` 1년 전: `-1y` 명명된 날짜: `today`, `yesterday` 명명된 날짜는 기본값이며 변경할 수 없습니다. 지원되는 형식: `quantity` 및 `sum_quantity`: 숫자: `#`
예	`MATCHES` 또는 `NOT_MATCHES` 연산자를 사용하여 제품 구매 여부를 지정합니다. `products_purchased MATCHES (id = 2012162031638)` `products_purchased NOT MATCHES (id IN (2012162031638, 1012132033639))` `products_purchased MATCHES (tag = 'red')` 2022년 1월 1일부터 오늘까지 특정 제품을 구매한 고객 필터링: `products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND today)` 2022년 1월 1일부터 오늘까지 태그가 `'red'`인 제품을 구매한 고객 필터링: `products_purchased MATCHES (tag = 'red', date BETWEEN 2022-01-01 AND today)` 최근 30일 이내: `products_purchased MATCHES (date >= -30d)` 2022년 1월 1일까지: `products_purchased MATCHES (date <= 2022-01-01)` 매개 변수 `date` 및 연산자 `BETWEEN` 을(를) 사용하여 특정 날짜 범위를 지정합니다. 2022년 1월 1일부터 2022년 6월 1일까지(포함)를 다음과 같이 표현할 수 있습니다. `products_purchased MATCHES (id = 1012132033639, date BETWEEN 2022-01-01 AND 2022-06-01)` 최근에 특정 태그가 있는 제품을 많이 구매한 고객 필터링: `products_purchased MATCHES (tag = 'product_tag', sum_quantity >= 3, date >= -90d)`
참고	`id` 매개 변수를 사용하여 고객 세그먼트를 생성할 때 표시되는 목록에서 이름이나 이미지로 제품을 선택할 수 있습니다. 또는 제품 이름을 입력하기 시작한 다음 목록에서 선택할 수도 있습니다. 코드에는 제품 이름이 아닌 제품 ID가 입력됩니다. 제품 ID 위로 커서를 가져가면 제품 이름과 이미지가 표시됩니다. 모두 없는 경우 `date` 매개 변수가 없으면 시작일이나 종료일이 설정되지 않은 상태로 전체 기간에 대해 결과가 필터링됨을 의미합니다. 매개 변수가 없으면 필터에 전체 기간 동안 구매한 모든 제품이 포함됨을 의미합니다.

RFM 그룹

이름: rfm_group

고객이 분류된 RFM 그룹을 기반으로 고객을 포함합니다. RFM 고객 분석에 대해 자세히 알아보세요.

예를 포함한 사용 가능한 RFM 그룹 연산자 및 값 목록입니다.
연산자	같음: `=` 같지 않음: `!=` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	휴면: `'DORMANT'` 이탈 위험: `'AT_RISK'` 과거 충성 고객: `'PREVIOUSLY_LOYAL'` 관심 필요: `'NEEDS_ATTENTION'` 이탈 직전: `'ALMOST_LOST'` 충성 고객: `'LOYAL'` 유망 고객: `'PROMISING'` 활성: `'ACTIVE'` 신규: `'NEW'` 챔피언: `'CHAMPIONS'` 잠재 고객: `'PROSPECTS'`
형식
예	RFM 관심 필요 그룹에 고객 포함: `rfm_group = 'NEEDS_ATTENTION'`
참고

SMS 구독 상태

이름: sms_subscription_status

마케팅 SMS 문자 메시지 구독 여부를 기준으로 고객을 포함합니다. 고객 연락처 정보 수집에 대해 자세히 알아보십시오.

연산자	같음: `=` 같지 않음: `!=` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	구독함: `'SUBSCRIBED'` 고객이 마케팅 SMS 문자 메시지를 구독했습니다. 보류 중: `'PENDING'` 고객이 마케팅 SMS 문자 메시지 구독을 진행 중입니다. 삭제됨: `'REDACTED'` 고객이 GDPR 삭제 요청으로 인해 삭제 보류 중입니다. 구독 취소됨: `'UNSUBSCRIBED'` 고객이 마케팅 SMS 문자 메시지 구독을 취소했습니다. 구독 안 함: `'NOT_SUBSCRIBED'` 고객이 마케팅 SMS 문자 메시지를 구독한 적이 없습니다.
형식
예	마케팅 SMS 문자 메시지를 구독한 고객 포함: `sms_subscription_status = 'SUBSCRIBED'`
참고

주 또는 시/도

이름: customer_regions

특정 국가 내의 지정된 지역에 주소가 있는 고객을 포함합니다. 주소가 여러 개인 고객은 이 필터를 사용하는 둘 이상의 고객 세그먼트에 포함될 수 있습니다.

연산자	이 위치를 정확히 포함: `CONTAINS` 이 위치를 정확히 포함하지 않음: `NOT CONTAINS` 존재하지 않음: `IS NULL` 존재: `IS NOT NULL`
값	ISO 국가 코드를 ISO 3166-2 하위 구분 코드와 함께 사용하십시오.
형식
예	뉴욕주에 주소가 있는 고객 포함: `customer_regions CONTAINS 'US-NY'`
참고	지역을 찾으려면 지역 이름을 입력한 다음 표시되는 목록에서 적절한 값을 선택할 수 있습니다.

스토어 크레딧 계정

이름: store_credit_accounts

스토어에 스토어 크레딧 잔액이 있는 고객을 포함합니다.

함수 매개변수	`balance` (선택 사항): 이 매개변수를 사용하여 고객의 현재 스토어 크레딧 계정 잔액을 지정합니다. `currency` (선택 사항): 이 매개변수를 사용하여 고객의 스토어 크레딧 잔액 통화를 지정합니다. `next_expiry_date` (선택 사항): 이 매개변수를 사용하여 미사용 스토어 크레딧 중 가장 빨리 만료되는 날짜를 지정합니다. `last_credit_date` (선택 사항): 이 매개변수를 사용하여 고객이 마지막으로 스토어 크레딧을 받은 날짜를 지정합니다.
연산자	`MATCHES`매개변수가 true입니다. `NOT_MATCHES`매개변수가 false입니다. `IS NULL`: 매개변수가 존재하지 않습니다. `IS NOT NULL`: 매개변수가 존재합니다. 날짜의 경우 사용 가능한 연산자는 다음과 같습니다. 같음: `=` 같지 않음: `!=` 보다 큼: `>` 보다 작음: `<` 작거나 같음: `<=` 크거나 같음: `>=` 사이: `BETWEEN`
값
형식	지원되는 형식: `currency`: 통화 코드: 예: `USD` 지원되는 형식: `balance`: 숫자: `#` 지원되는 형식: `next_expiry_date` 및 `last_credit_date`: 절대 날짜: `YYY-MM-DD` 날짜 오프셋 예: 7일 전: `-7d` 4주 전: `-4w` 3개월 전: `-3m` 1년 전: `-1y` 지정 날짜: 오늘: `today` 어제: `yesterday` 지정 날짜는 기본값이며 변경할 수 없습니다.
예	모든 통화에서 스토어 크레딧 계정 잔액이 1 이상인 고객 필터링: `store_credit_accounts MATCHES (balance >= 1)` 스토어 크레딧 계정 잔액이 USD 1달러 이상인 고객 필터링: `store_credit_accounts MATCHES (balance >= 1, currency: 'USD')` 향후 7일 이내에 만료되는 스토어 크레딧이 있는 고객 필터링: `store_credit_accounts MATCHES (next_expiry_date <= +7d)` 1개월 이전에 마지막으로 스토어 크레딧을 받았지만 아직 사용 가능한 잔액이 있는 고객 필터링: `store_credit_accounts MATCHES (last_credit_date <= -1m, balance >= 1)`
참고	고객에게 스토어 크레딧을 발급한 적이 있으면 해당 고객은 스토어 크레딧 계정을 갖게 됩니다. 고객의 스토어 크레딧 잔액은 0 이상일 수 있습니다. 스토어 크레딧 계정은 통화별로 지정됩니다. 세그먼트에 `currency` 매개변수를 포함하지 않으면 필터는 통화 유형에 관계없이 모든 스토어 크레딧 계정을 반환합니다. 지원하는 통화 수에 따라 고객은 0개부터 여러 개의 스토어 크레딧 계정을 가질 수 있습니다. 예를 들어, 고객에게 CAD와 USD로 스토어 크레딧을 발급하면 해당 고객은 2개의 스토어 크레딧 계정을 갖게 됩니다.

스토어프론트 이벤트

이름: storefront.EVENT

스토어프론트 이벤트를 기준으로 고객을 포함합니다. 지원되는 이벤트(EVENT)는 다음과 같습니다.

조회한 제품: product_viewed
조회한 컬렉션: collection_viewed

함수 매개변수	`id`(선택 사항): 이 매개변수를 사용하여 필터링할 제품 또는 컬렉션을 지정합니다. `date`(선택 사항): 이 매개변수를 사용하여 이벤트 날짜를 지정합니다. `count`(선택 사항): 이 매개변수를 사용하여 제품 또는 컬렉션을 조회한 정확한 횟수를 지정합니다. 제품 이벤트 관련 매개변수: `tag`(선택 사항): 이 매개변수를 사용하여 필터링할 제품 태그를 지정합니다. 이 작업은 해당 태그가 있는 모든 제품 ID를 필터링하는 것과 동일하게 작동합니다.
연산자	`MATCHES`: 매개 변수가 true입니다. `NOT_MATCHES`: 매개 변수가 false입니다. `IS NULL`: 매개 변수가 존재하지 않습니다. `IS NOT NULL`: 매개 변수가 존재합니다. 날짜에 사용 가능한 연산자는 다음과 같습니다. 같음: `=` 같지 않음: `!=` 보다 큼: `>` 보다 작음: `<` 작거나 같음: `<=` 크거나 같음: `>=` 사이: `BETWEEN`
값
형식	지원되는 형식: `id`: `=` (단일 값) `IN` : 괄호로 묶고 쉼표로 구분된 값 세트(암시적 “OR” 사용). 예: `(id IN (1012132033639, 2012162031638, 32421429314657))`한 세트의 제품 또는 컬렉션 ID는 500개로 제한됩니다. 지원되는 형식: `tag`: `문자열` (단일 값) 지원되는 `date` 형식: 절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: 7일 전: `-7d` 4주 전: `-4w` 3개월 전: `-3m` 1년 전: `-1y` 지정 날짜: 오늘: `today` 어제: `yesterday` 스토어프론트 이벤트는 지난 26개월 동안 사용할 수 있으며 데이터는 2023년 5월부터 시작됩니다. 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	`MATCHES` 또는 `NOT_MATCHES` 연산자를 사용하여 스토어프론트 이벤트 발생 여부를 지정하십시오: `storefront.product_viewed MATCHES()` `storefront.collection_viewed NOT MATCHES ()` `id` 매개변수를 사용하여 필터링할 제품을 지정하십시오: `storefront.product_viewed MATCHES (id = 2012162031638)` `storefront.collection_viewed MATCHES (id IN (2012162031638, 456, 789))` `tag` 매개변수를 사용하여 필터링할 제품 태그를 지정하십시오: `storefront.product_viewed MATCHES (tag CONTAINS 'jeans')` `date` 매개변수와 `>=` 연산자를 사용하여 스토어프론트 이벤트의 시작 날짜를 지정하십시오: `storefront.product_viewed MATCHES (id = 2012162031638, date >= 2023-04-03)` `storefront.collection_viewed MATCHES (id = 2012162031638, date >= -30d)` `date` 매개변수와 `<=` 연산자를 사용하여 스토어프론트 이벤트의 종료 날짜를 지정하십시오: `storefront.product_viewed MATCHES (id = 2012162031638, date <= 2023-04-30)` `storefront.collection_viewed MATCHES (id = 2012162031638, date <= -7d)` `date` 매개변수와 `BETWEEN` 연산자를 사용하여 스토어프론트 이벤트의 시작 및 종료 날짜를 모두 지정하십시오: `storefront.product_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-04-03 AND 2023-04-30)` `storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN -90d AND -30d)` 지난 30일 동안 특정 제품을 조회한 고객 필터링: `storefront.product_viewed MATCHES (id = 2012162031638, date >= -30d)` 2023년 1월 1일부터 오늘까지 특정 컬렉션을 조회한 고객 필터링: `storefront.collection_viewed MATCHES (id = 2012162031638, date BETWEEN 2023-01-01 AND today)`
참고	`id` 매개변수를 사용하여 고객 세그먼트를 생성할 때 표시되는 목록에서 이름이나 이미지로 제품 또는 컬렉션을 선택할 수 있습니다. 또는 제품이나 컬렉션의 제목을 입력하기 시작한 다음 목록에서 선택할 수도 있습니다. 코드에는 제목이 아닌 제품 또는 컬렉션 ID가 입력됩니다. ID 위에 커서를 올리면 제품 또는 컬렉션 제목과 이미지가 표시됩니다. 컬렉션은 해당하는 경우 컬렉션 썸네일로 저장된 이미지를 사용합니다. 그렇지 않은 경우에는 일반 이미지 플레이스 홀더가 표시됩니다. 데이터 보존으로 인해 `date` 매개변수가 없는 경우 결과는 설정된 시작 또는 종료 날짜 없이 지난 26개월 동안 필터링됩니다. `id`가 없으면 필터에 모든 제품이 포함됨을 의미합니다.