고객 데이터 가져오기
고객 데이터를 사용하는 워크플로에서는 고객 데이터 가져오기 작업을 사용하여 스토어에서 고객 정보를 검색할 수 있습니다.
구성
필드
고객 데이터 가져오기 작업에는 쿼리를 빌드하는 데 사용되는 다음 필드가 포함되어 있습니다.
| 필드 | 설명 |
|---|---|
| 데이터 정렬 기준 | 필수 사항입니다. 단일 검색 쿼리에서 반환된 데이터를 정렬하는 기준 매개 변수입니다. |
| 최대 결과 수 | 필수 사항입니다. 선택한 단일 검색 쿼리로 반환할 수 있는 최대 결과 수입니다. 한 번에 최대 100개까지 반환할 수 있습니다. |
| 쿼리 | 필수 사항입니다. 공통 쿼리 중에서 선택하거나 고급을 선택하여 직접 만드세요. |
쿼리 문자열
다음은 지난 하루 동안 업데이트된 고객을 가져오는 예시 쿼리입니다.
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'`updated_at` 변수는 고객 쿼리에서 사용할 수 있는 필터이며, 여러 번 사용하거나 다른 변수와 조합할 수 있습니다. `scheduledAt` Liquid 변수는 예약 시간 트리거를 사용한 워크플로에서 사용할 수 있습니다. `date_minus` Liquid 태그는 날짜에서 시간을 뺄 수 있는 특수 Flow 태그입니다.
데이터를 쿼리할 때 알아두면 유용한 정보는 다음과 같습니다.
- 사용 가능한 고객 필터 목록
- 쿼리는 특정 구문을 따라야 합니다.
- 쿼리 필드 값은 항상 문서화되어 있는 것은 아닙니다. 경우에 따라 API 문서를 통해 값을 찾을 수 있습니다. 또는 관리자에서 필터링할 때 URL에서 필드 값을 찾는 방법도 자주 사용됩니다. 예를 들어 일부 주문 쿼리 값을 찾으려면 관리자에서 주문 페이지를 필터링한 다음 URL을 확인하십시오.
- Shopify GraphiQL 앱을 사용하여 스토어에서 쿼리를 실행하거나 테스트할 수 있습니다.
- 쿼리가 실패할 경우 발생하는 상황에 유의하십시오. API는 종종 결과가 없는 대신 모든 결과를 반환합니다.
반환된 데이터
모든 데이터 가져오기 작업은 0개에서 100개 사이의 리소스 목록을 반환합니다. 사용 사례에 따라 다음과 같은 다양한 방법으로 이 데이터를 사용할 수 있습니다.
- 각 항목에 태그를 추가하는 등 목록의 각 항목을 개별적으로 처리해야 하는 경우 For each 작업을 사용할 수 있습니다.
- 반환된 결과 수를 계산하는 등 데이터를 집계해야 하는 경우 개수 또는 합계 작업을 사용할 수 있습니다.
- 모든 항목이 포함된 이메일을 보내는 등 목록을 출력해야 하는 경우 후속 작업에서 반환된 데이터를 직접 사용할 수 있습니다.
이 작업 다음 단계에서 반환된 데이터에 액세스하려면 고객 목록인 고객 데이터 가져오기라는 변수를 사용합니다. 이 변수는 상태와 작업 모두에서 사용할 수 있습니다. 예를 들어 다음과 같이 내부 이메일 보내기 작업에서 주문 목록을 보낼 수 있습니다.
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}트리거
이 작업은 예약 시간 트리거를 포함한 모든 워크플로에서 사용할 수 있습니다. 예약 시간 트리거를 사용하는 워크플로에서는 이벤트 결과가 아닌 지정된 시간에 워크플로가 시작됩니다. 스토어나 앱에서 워크플로를 시작하는 특정 이벤트가 없으므로 자동으로 포함되는 데이터가 없습니다.
API 세부 정보
템플릿
모든 고객의 고객 메타 필드를 태그로 전환
이 워크플로는 메타 필드 값을 기준으로 모든 고객에게 태그를 백필합니다. 매시간 실행되며 “처리됨” 태그가 없는 고객을 최대 100명까지 가져옵니다. 각 고객에 대해 custom.test 메타 필드의 값을 확인하고 태그로 추가합니다. 또한 워크플로는 다음 예약 실행 시 반환되지 않도록 “처리됨” 태그를 추가합니다. 워크플로를 사용하려면 스토어의 메타 필드와 일치하도록 메타 필드 네임스페이스와 키를 변경해야 합니다. 템플릿 보기
비활성 고객 삭제
주문한 적이 없는 5년 이상 된 고객을 삭제합니다. 템플릿 보기