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

Действието Получаване на данни за анализ изпълнява 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.