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

Действие Получить данные аналитики выполняет запрос 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 имеет стоимость сложности, которая рассчитывается на основе схем, столбцов, фильтров и диапазона времени, используемых в запросе. Если запрос превышает лимит сложности, действие завершается с ошибкой, и рабочий процесс не может быть активирован. Чтобы снизить стоимость запроса, вы можете сократить диапазон времени, удалить столбцы или объединения (joins).

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