Получить данные аналитики

Действие Получить данные аналитики запускает запрос ShopifyQL и возвращает результаты для использования в вашем рабочем процессе. 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 %}

Для работы с каждой строкой по отдельности (например, для применения действия к каждой строке) можно использовать действие Цикл for each (итерация) с getAnalyticsData.rows. Для агрегирования значений, например подсчета строк или суммирования по столбцу, вы можете использовать действия Подсчет и Сумма.

Справка по API

Для получения дополнительной информации об API, используемом в этом действии, см. запрос shopifyqlQuery в GraphQL Admin API.

Сложность запроса

Каждый запрос ShopifyQL имеет стоимость сложности, которая рассчитывается на основе схем, столбцов, фильтров и диапазона времени, используемых в запросе. Если запрос превышает лимит сложности, действие завершается с ошибкой, и рабочий процесс не может быть активирован. Чтобы снизить стоимость запроса, вы можете сократить диапазон времени, удалить столбцы или объединения.

Подробные сведения о том, как рассчитывается стоимость запроса, и о текущих лимитах см. в статье Ограничение частоты запросов в ShopifyQL Admin API.