Получаване на данни от анализа

Действието Получаване на данни от анализа изпълнява ShopifyQL заявка и връща резултатите за използване във Вашия работен процес. ShopifyQL е език на заявката, създаден за анализ на търговията. Можете да го използвате за обобщаване на показатели за различни периоди от време, прилагане на филтри и групиране по величини като продукт, колекция или клиент. Данните, върнати от това действие, са достъпни за условия и действия, които следват стъпката.

Съвет

ShopifyQL се използва също във Вашите Shopify отчети и сегментиране на клиентите. Можете да научите повече за заявките и синтаксиса на ShopifyQL.

Тригери

Действието Получаване на данни от анализа е съвместимо само с тригера Планирано време. Данните от анализа не се включват от тригери, базирани на събития.

Конфигурация

Полета

Действието Получаване на данни от анализа съдържа следното поле:

Полета, използвани в действието „Получаване на данни от анализа“.

Поле	Описание
Заявка на ShopifyQL	Задължително. Заявката на ShopifyQL, която да се изпълни към данните от анализа на Вашия магазин.

Заявка на ShopifyQL

Можете да напишете всяка валидна ShopifyQL заявка, като използвате поддържани схеми като sales, sessions, inventory и payments. Например следната заявка връща общо продажби и броя на клиентите за деня, в който се изпълнява работният процес:

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. За да обобщите стойности, например да преброите редове или да сумирате колона, можете да използвате действията Преброяване и Сума.

Забележка

Ако действие Получаване на данни се използва няколко пъти в един работен процес, тогава към името на променливата се добавя число. Например в работен процес, който използва действието Получаване на данни за поръчка два пъти, първата променлива за върнати данни е getOrderData, а втората променлива е getOrderData1. Това име не може да бъде персонализирано.

Справка за API

За повече информация относно API, използвано в това действие, вижте заявката shopifyqlQuery в GraphQL Admin API.

Сложност на заявката

Всяка ShopifyQL заявка има цена за сложност, която се изчислява въз основа на схемите, колоните, филтрите и времевия диапазон, които заявката използва. Ако дадена заявка надвишава ограничението за сложност, действието е неуспешно и работният процес не може да бъде активиран. За да намалите цената на дадена заявка, можете да съкратите времевия диапазон, да премахнете колони или да премахнете обединения.

За подробности относно това как се изчислява цената на заявката и текущите ограничения вижте Ограничаване на скоростта в ShopifyQL Admin API.