Shopify 기반 고객 세그먼트 필터

이 참조 가이드를 통해 고객 세그먼트를 구축할 때 사용되는 Shopify 기본 필터 기반의 필터 이름, 연산자 및 값에 대해 알아보십시오.

이 페이지의 정보

중단된 결제 날짜

이름: abandoned_checkout_date

마지막으로 카트에서 결제를 중단한 날짜까지의 고객이 포함됩니다.

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

기념일

이름: anniversary

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

함수 매개 변수	필터를 적용하려는 이벤트를 지정합니다. 예: `'metafields.facts.birth_date'`
연산자	`MATCHES`: 매개 변수가 true입니다. `NOT_MATCHES`: 매개 변수가 false입니다. `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 MATCHES ('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` 지난 7일: `>= 7_days_ago` 지난 30일: `>= 30_days_ago` 지난 90일: `>= 90_days_ago` 지난 12개월: `>= 12_months_ago` 이름이 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	지난주에 추가된 고객 포함: `customer_added_date >= 7_days_ago` 지난 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`에 지원되는 형식: 숫자(위도), 숫자(경도) 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 이내이고 한 번 이상 주문한 고객을 필터링합니다. `customer_within_distance MATCHES (coordinates = (43.634,-79.412), distance_km = 20 ) AND number_of_orders > 0`
참고 사항	Shopify 세분화 기능이 저장된 위치를 자동으로 좌표 쌍으로 전환하며 이 필터를 사용할 때 선택 가능한 값으로 표시됩니다. 스토어에 위치가 저장된 경우, 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` 이름이 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요. 2022년 3월부터 지난 26개월 동안의 데이터에 대해 이메일 이벤트를 사용할 수 있습니다. `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, 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` 지난 7일: `>= 7_days_ago` 지난 30일: `>= 30_days_ago` 지난 90일: `>= 90_days_ago` 지난 12개월: `>= 12_months_ago` 이름이 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	지난주 이후 처음으로 주문한 고객 포함: `first_order_date >= 7_days_ago` 8개월 전에 처음으로 주문한 고객 포함: `first_order_date > -8m`
참고 사항	날짜 값은 전체 기간을 기반으로 하며 스토어 위치에 따른 표준 시간대별로 다를 수 있습니다.

마지막 주문 날짜

이름: last_order_date

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

연산자	정확한 날짜: `=` 해당 날짜 제외: `!=` 해당 날짜 이전: `<=` 해당 날짜 전날까지: `<` 해당 날짜 이후: `>=` 해당 날짜 다음날부터: `>` 해당 날짜 사이: `BETWEEN {date1} AND {date2}` 존재하지 않음: `IS NULL` 존재함: `IS NOT NULL`
값
형식	절대적 날짜: `YYYY-MM-DD` 날짜 오프셋 예: `-4w`, `-10y` 지정된 날짜: 오늘: `= today` 어제: `= yesterday` 지난 7일: `>= 7_days_ago` 지난 30일: `>= 30_days_ago` 지난 90일: `>= 90_days_ago` 지난 12개월: `>= 12_months_ago` 이름이 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	지난주 이후 마지막으로 주문한 고객 포함: `last_order_date >= 7_days_ago` 지난 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` (선택 사항): 이 매개 변수를 사용하여 주문을 생성한 앱을 지정합니다. `location_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)`
참고 사항	금액 위에 커서를 올리면 고객을 필터링하는 데 사용된 통화가 표시됩니다. 다음 구문 위에 커서를 올리면: `amount`,`sum_amount` 구문에 대한 설명이 표시됩니다. `parameters`가 없으면 필터에 전체 기간 동안 접수된 모든 주문이 포함됩니다.

예측된 지출 등급

이름: predicted_spend_tier

지정된 예측 지출 등급에 해당하는 고객을 포함합니다. 예측된 지출 등급에 대해 자세히 알아보십시오.

연산자	같음: `=` 같지 않음: `!=` 존재하지 않음: `IS NULL` 존재함: `IS NOT NULL`
값	`'HIGH'` `'MEDIUM'` `'LOW'`
형식
예	`높음` 등급에 있는 고객 포함: `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`에 지원되는 형식: `string`(단일 값) `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 3166-2 하위 코드로 ISO 국가 코드를 사용합니다.
형식
예	주소가 뉴욕주에 있는 고객 포함: `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)` 스토어 크레딧 계좌 잔액이 $1 USD 이상인 고객을 필터링합니다. `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`에 지원되는 형식: `string`(단일 값) 지원되는 `date` 형식: 절대 날짜: `YYYY-MM-DD` 날짜 오프셋 예: 7일 전: `-7d` 4주 전: `-4w` 3개월 전: `-3m` 1년 전: `-1y` 이름이 지정된 날짜: 오늘: `today` 어제: `yesterday` 2023년 5월부터 지난 26개월 동안의 데이터에 대해 상점 이벤트를 사용할 수 있습니다. 이름이 지정된 날짜는 기본값이며 변경할 수 없습니다. 사용자 지정 날짜의 경우 날짜 오프셋을 사용하세요.
예	`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`가 없으면 필터에 모든 제품이 포함됩니다.