Отримати дані клієнта
У робочих процесах, які використовують дані клієнтів, ви можете застосувати дію Отримати дані клієнта, щоб отримати інформацію про клієнтів з вашого магазину.
На цій сторінці
Налаштування
Поля
Дія Отримати дані клієнта містить наведені далі поля, які використовуються для створення запиту:
| Поле | Опис |
|---|---|
| Сортувати дані за | Обов'язково. Параметри, за якими сортуються дані, повернуті за пошуковим запитом. |
| Максимальна кількість результатів | Обов'язково. Максимальна кількість результатів, які може повернути вибраний пошуковий запит. Одночасно можна повернути до 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 %}Тригери
Цю дію можна використовувати в будь-якому робочому процесі, зокрема з тригером Запланований час. У робочому процесі з тригером Запланований час робочий процес починається в зазначений вами час, а не в результаті події. Оскільки немає конкретної події в магазині або від застосунку, яка запускає робочий процес, жодні дані не включаються автоматично.
Відомості про API
Шаблони
Конвертувати метаполе клієнта в теги для всіх клієнтів
Цей робочий процес дозаповнить теги для всіх ваших клієнтів на основі значення метаполя. Він запускається щогодини й отримує до 100 клієнтів без тегу «processed». Для кожного клієнта він перевіряє значення метаполя custom.test і додає його як тег. Робочий процес також додає тег «processed», щоб цей клієнт не повертався під час наступного запланованого запуску робочого процесу. Щоб використовувати робочий процес, потрібно змінити простір імен і ключ метаполя, щоб вони відповідали метаполю у вашому магазині. Переглянути шаблон
Видалити неактивних клієнтів
Видалити клієнтів, які були зареєстровані понад 5 років тому і жодного разу не оформили замовлення. Переглянути шаблон