분석 데이터 가져오기
분석 데이터 가져오기 작업은 ShopifyQL 쿼리를 실행하고 워크플로에서 사용할 수 있도록 결과를 반환합니다. ShopifyQL은 상거래 분석을 위해 구축된 쿼리 언어입니다. 이 언어를 사용하여 기간별로 지표를 집계하고, 필터를 적용하며, 제품, 컬렉션 또는 고객과 같은 차원별로 그룹화할 수 있습니다. 이 작업에서 반환된 데이터는 해당 단계 이후의 조건 및 작업에서 사용할 수 있습니다.
트리거
분석 데이터 가져오기 작업은 예약된 시간 트리거와만 호환됩니다. 분석 데이터는 이벤트 기반 트리거에 포함되지 않습니다.
구성
필드
분석 데이터 가져오기 작업에는 다음 필드가 포함되어 있습니다.
| 필드 | 설명 |
|---|---|
| ShopifyQL 쿼리 | 필수입니다. 스토어의 분석 데이터에 대해 실행할 ShopifyQL 쿼리입니다. |
ShopifyQL 쿼리
sales, sessions, inventory 및 payments와 같이 지원되는 스키마를 사용하여 유효한 ShopifyQL 쿼리를 작성할 수 있습니다. 예를 들어 다음 쿼리는 워크플로가 실행되는 날짜의 총 판매액 및 고객 수를 반환합니다.
FROM sales
SHOW total_sales, customers
SINCE today지원되는 스키마, 기능, 구문 등 전체 언어 참조는 ShopifyQL 문서를 참조하십시오.
쿼리는 워크플로를 저장할 때 유효성이 검사됩니다. 쿼리가 스토어에서 성공적으로 실행될 때까지 워크플로를 활성화할 수 없습니다.
반환된 데이터
분석 데이터 가져오기 작업은 쿼리와 일치하는 행을 반환하며 getAnalyticsData라는 변수로 사용할 수 있습니다. 행은 getAnalyticsData.rows에 저장되며, 여기서 각 행은 쿼리의 열 이름을 키로 사용하는 개체입니다.
해당 단계 이후의 조건 및 작업 모두에서 이 변수를 사용할 수 있습니다. 예를 들어, 각 행을 나열하는 내부 이메일을 보내려면 다음과 유사한 Liquid를 사용할 수 있습니다.
{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}각 행에 작업을 적용하는 등 각 행을 개별적으로 처리하려면 getAnalyticsData.rows와 함께 각 루프(반복) 작업을 사용할 수 있습니다. 행 수를 계산하거나 열 합계를 구하는 등 값을 집계하려면 개수 및 합계 작업을 사용할 수 있습니다.
API 참조
이 작업에서 사용되는 API에 대한 자세한 내용은 GraphQL Admin API의 shopifyqlQuery 쿼리를 참조하십시오.
쿼리 복잡성
각 ShopifyQL 쿼리에는 쿼리에서 사용하는 스키마, 열, 필터 및 시간 범위에서 계산되는 복잡성 비용이 있습니다. 쿼리가 복잡성 한도를 초과하면 작업이 실패하고 워크플로를 활성화할 수 없습니다. 쿼리 비용을 줄이려면 시간 범위를 단축하거나, 열을 제거하거나, 조인을 제거할 수 있습니다.
쿼리 비용이 계산되는 방식과 현재 한도에 대한 자세한 내용은 ShopifyQL Admin API의 속도 제한을 참조하십시오.