Отримати аналітичні дані

Дія Отримати аналітичні дані виконує запит 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.