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

В рабочих процессах, использующих данные о клиентах, можно использовать действие «Получить данные о клиентах», чтобы извлечь информацию о клиентах из вашего магазина.

Примечание

Это действие относится к типу «Получить данные». Чтобы узнать, как использовать такие действия с триггером «Запланированное время» и циклами «Для каждого» (For each), см. статью «Расписания, получение данных и циклические рабочие процессы в Shopify Flow».

Настройка

Поля

Действие «Получить данные о клиентах» содержит следующие поля, которые используются для создания запроса:

Поля, используемые в действиях «Получить данные».

Поле	Описание
Сортировать данные по	Обязательное поле. Параметры, по которым сортируются данные, возвращаемые поисковым запросом.
Максимальное количество результатов	Обязательное поле. Максимальное количество результатов, которое может вернуть выбранный поисковый запрос. За один раз можно получить до 100 результатов.
Запрос	Обязательное поле. Выберите один из стандартных запросов или нажмите «Дополнительно», чтобы создать собственный.

Строка запроса

Ниже приведен пример запроса для получения данных о клиентах, которые были обновлены за последний день:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

Переменная updated_at — это фильтр, доступный в запросе клиентов. Его можно использовать несколько раз или в сочетании с другими переменными. Переменная Liquid scheduledAt доступна в рабочих процессах, использующих триггер «Запланированное время». Тег Liquid date_minus — это специальный тег Flow, который позволяет вычитать время из даты.

При работе с запросами полезно знать:

• Список доступных фильтров для клиентов
• Запросы должны соответствовать определенному синтаксису
• Значения полей запроса документируются не всегда. Иногда их можно найти в документации по API. Кроме того, значения полей часто можно найти в URL-адресах панели администратора при использовании фильтров. Например, чтобы найти некоторые значения для запроса заказов, отфильтруйте страницу «Заказы» в панели администратора, а затем проверьте URL-адрес.
• Вы можете запустить или протестировать запрос в своем магазине с помощью приложения Shopify GraphiQL.
• Учитывайте, что произойдет в случае сбоя запроса. Часто API возвращает все результаты (а не ни одного).

Возвращаемые данные

Все действия «Получить данные» возвращают список, содержащий от 0 до 100 ресурсов. В зависимости от вашего сценария использования вы можете применять эти данные различными способами:

• Если вам нужно обработать каждый элемент списка по отдельности, например добавить тег к каждому из них, используйте действие «Для каждого».
• Если вам нужно агрегировать данные, например подсчитать, сколько результатов было возвращено, используйте действия «Подсчитать» или «Суммировать».
• Если вам нужно вывести список (например, отправить электронное письмо со всеми элементами), вы можете использовать возвращенные данные непосредственно в последующих действиях.

Чтобы получить доступ к возвращаемым данным на следующих за этим действием шагах, используйте переменную с названием «Полученные данные о клиентах», которая представляет собой список клиентов. Эту переменную можно использовать как в условиях, так и в действиях. Например, можно отправить список заказов с помощью действия «Отправить внутреннее электронное письмо» следующим образом:

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

Примечание

Если действие «Получить данные» используется в одном рабочем процессе несколько раз, к имени переменной добавляется номер. Например, в рабочем процессе, где действие «Получить данные о заказе» используется дважды, первая переменная для возвращаемых данных будет называться getOrderData, а вторая — getOrderData1. Это имя изменить нельзя.

Триггеры

Это действие можно использовать в любом рабочем процессе, в том числе с триггером «Запланированное время». В рабочем процессе с таким триггером запуск происходит в указанное вами время, а не в результате какого-либо события. Поскольку запуск рабочего процесса не вызван конкретным событием в вашем магазине или приложении, никакие данные не включаются в него автоматически.

Сведения об API

• Ресурс клиента
• Фильтры запросов для клиентов

Шаблоны

Преобразование метаполя клиента в теги для всех клиентов

Этот рабочий процесс заполняет теги для всех ваших клиентов на основе значения метаполя. Он запускается каждый час и извлекает до 100 клиентов без тега «processed». Для каждого клиента он проверяет значение метаполя custom.test и добавляет его в качестве тега. Рабочий процесс также добавляет тег «processed», чтобы этот клиент не был возвращен при следующем плановом запуске. Чтобы использовать этот рабочий процесс, вам потребуется изменить пространство имен и ключ метаполя в соответствии с метаполем в вашем магазине. Просмотреть шаблон

Удаление неактивных клиентов

Удаление клиентов старше 5 лет, которые никогда не размещали заказы. Просмотреть шаблон