할인 데이터 가져오기
할인 데이터가 필요한 워크플로에서는 할인 데이터 가져오기 작업을 사용하여 스토어에서 할인 정보를 검색할 수 있습니다.
구성
필드
할인 데이터 가져오기 작업에는 쿼리를 작성하는 데 사용되는 다음 필드가 포함되어 있습니다.
| 필드 | 설명 |
|---|---|
| 정렬 기준 | 필수 사항입니다. 단일 검색 쿼리에서 반환된 데이터를 정렬하는 기준이 되는 매개변수입니다. |
| 최대 결과 수 | 필수 사항입니다. 선택한 단일 검색 쿼리로 반환할 수 있는 최대 결과 수입니다. 한 번에 최대 100개까지 반환할 수 있습니다. |
| 쿼리 | 필수 사항입니다. 공통 쿼리 중에서 선택하거나 고급을 선택하여 직접 만드세요. |
쿼리 문자열
다음은 코드를 사용하는 활성 할인을 가져오는 예시 쿼리입니다.
method:code AND status:active`method` 및 `status` 변수는 할인 노드 쿼리에서 사용할 수 있는 필터이며, 여러 번 사용하거나 다른 변수와 조합할 수 있습니다.
데이터를 쿼리할 때 알아두면 유용한 정보는 다음과 같습니다.
- 사용 가능한 할인 필터 목록입니다.
- 쿼리는 특정 구문을 따라야 합니다.
- 쿼리 필드 값이 항상 문서화되어 있는 것은 아닙니다. 경우에 따라 API 문서에서 값을 찾을 수 있습니다. 또는 필터링 시 관리자 URL에서 필드 값을 찾을 수 있는 경우도 많습니다. 예를 들어 일부 주문 쿼리 값을 찾으려면 관리자에서 주문 페이지를 필터링한 다음 URL을 확인하세요.
- Shopify GraphiQL 앱을 사용하여 스토어에서 쿼리를 실행하거나 테스트할 수 있습니다.
- 쿼리가 실패하는 경우에 유의하세요. API는 결과가 없는 대신 모든 결과를 반환하는 경우가 많습니다.
반환된 데이터
모든 데이터 가져오기 작업은 0~100개의 리소스 목록을 반환합니다. 사용 사례에 따라 다음과 같이 다양한 방식으로 이 데이터를 사용할 수 있습니다.
- 각 항목에 태그를 추가하는 것처럼 각 목록 항목을 개별적으로 처리해야 하는 경우 각 항목에 대해 작업을 사용할 수 있습니다.
- 반환된 결과 수를 세는 등 데이터를 집계해야 하는 경우 개수 또는 합계 작업을 사용할 수 있습니다.
- 모든 항목이 포함된 이메일을 보내는 등 목록을 출력해야 하는 경우, 후속 작업에서 반환된 데이터를 직접 사용할 수 있습니다.
이 작업 다음 단계에서 반환된 데이터에 액세스하려면 할인 목록인 할인 데이터 가져오기 변수를 사용하세요. 이 변수는 조건과 작업 모두에서 사용할 수 있습니다. 예를 들어 다음과 같이 내부 이메일 보내기 작업에서 자동 앱 할인 목록을 보낼 수 있습니다.
{% for discount_item in getDiscountData %}
{% if discount_item.discount.__typename == "DiscountAutomaticApp" %}
* {{discount_item.discount.DiscountAutomaticApp.title}}
{% endif %}
{% endfor %}트리거
이 작업은 예약된 시간 트리거를 비롯한 모든 워크플로에서 사용할 수 있습니다. 예약된 시간 트리거를 사용하는 워크플로의 경우, 이벤트의 결과가 아닌 판매자가 지정한 시간에 워크플로가 시작됩니다. 스토어나 앱에서 워크플로를 시작하는 특정 이벤트가 없으므로 자동으로 포함되는 데이터는 없습니다.
API 세부 정보
템플릿
코드를 사용하는 활성 할인 주간 요약 이메일
코드를 사용하는 활성 할인 요약을 이메일로 보냅니다. 워크플로는 매주 월요일 오전 9시 일정에 따라 실행됩니다. 타이밍, 요약 수신 방법, 포함할 할인 유형, 모드를 변경하도록 워크플로를 사용자 지정할 수 있습니다. 템플릿 보기