Pobierz dane klienta
W sekwencjach zadań, które wykorzystują dane klientów, możesz użyć akcji Pobierz dane klienta, aby pobrać informacje o kliencie ze sklepu.
Na tej stronie
Konfiguracja
Pola
Akcja Pobierz dane klienta zawiera następujące pola, które służą do tworzenia zapytania:
| Pole | Opis |
|---|---|
| Sortuj dane według | Wymagane. Parametry, według których sortowane są dane zwrócone przez zapytanie wyszukiwania. |
| Maksymalna liczba wyników | Wymagane. Maksymalna liczba wyników, które mogą zostać zwrócone przez wybrane zapytanie. Jednorazowo można zwrócić maksymalnie 100 wyników. |
| Zapytanie | Wymagane. Wybierz spośród typowych zapytań lub wybierz opcję Zaawansowane, aby utworzyć własne. |
Ciąg zapytania
Oto przykładowe zapytanie dotyczące pobierania klientów, którzy zostali zaktualizowani w ciągu ostatniego dnia:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Zmienna updated_at to filtr dostępny w zapytaniu o klientów, którego można używać wielokrotnie lub łączyć z innymi zmiennymi. Zmienna Liquid scheduledAt jest dostępna w workflow, które używają wyzwalacza Czas zaplanowany. Tag Liquid date_minus to specjalny tag aplikacji Flow, który pozwala odjąć czas od daty.
Podczas wykonywania zapytań o dane warto wiedzieć, że:
- Lista dostępnych filtrów klientów
- Zapytania muszą być zgodne z określoną składnią
- Wartości pól zapytań nie zawsze są udokumentowane. W niektórych przypadkach można je znaleźć, przeglądając dokumentację API. Wartości pól można też często znaleźć w adresach URL w panelu administracyjnym po zastosowaniu filtrów. Aby na przykład znaleźć niektóre wartości zapytań dotyczących zamówień, należy przefiltrować stronę Zamówienia w panelu administracyjnym, a następnie sprawdzić adres URL.
- Możesz uruchomić lub przetestować zapytanie w sklepie za pomocą aplikacji Shopify GraphiQL.
- Pamiętaj o tym, co się stanie, jeśli zapytanie zakończy się niepowodzeniem. Często API zwróci wszystkie wyniki (zamiast żadnego).
Zwrócone dane
Wszystkie akcje typu Pobierz dane zwracają listę od 0 do 100 zasobów. W zależności od przypadku użycia możesz wykorzystać te dane na różne sposoby:
- Jeśli musisz obsłużyć każdą pozycję listy indywidualnie, na przykład w celu dodania tagu do każdej z nich, możesz użyć akcji Dla każdego.
- Jeśli chcesz agregować dane, na przykład policzyć, ile wyników zostało zwróconych, możesz użyć akcji Zlicz lub Sumuj.
- Jeśli chcesz użyć całej listy, np. wysłać e-mail ze wszystkimi pozycjami, możesz użyć zwróconych danych bezpośrednio w kolejnych akcjach.
Aby uzyskać dostęp do zwróconych danych w krokach następujących po tej akcji, użyj zmiennej o nazwie Pobierz dane klienta, która jest listą klientów. Możesz używać tej zmiennej zarówno w warunkach, jak i w akcjach. Możesz na przykład wysłać listę zamówień w akcji Wyślij wewnętrzną wiadomość e-mail w następujący sposób:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Wyzwalacze
Możesz użyć tej akcji w dowolnym workflow, w tym w przypadku wyzwalacza Czas zaplanowany. W workflow, który korzysta z wyzwalacza Czas zaplanowany, workflow uruchamia się o określonej przez Ciebie godzinie, a nie w wyniku zdarzenia. Ponieważ nie ma żadnego konkretnego zdarzenia w sklepie lub z aplikacji, które uruchamia workflow, żadne dane nie są dołączane automatycznie.
Szczegóły API
Szablony
Konwertuj metapole klienta na tagi dla wszystkich klientów
Ten workflow uzupełnia tagi u wszystkich klientów na podstawie wartości metapola. Uruchamia się co godzinę i pobiera do 100 klientów, którzy nie mają tagu „processed”. Dla każdego klienta sprawdza wartość metapola custom.test i dodaje ją jako tag. Workflow dodaje również tag „processed”, aby klient nie został zwrócony w następnym zaplanowanym przebiegu workflow. Aby użyć tego workflow, musisz zmienić przestrzeń nazw i klucz metapola, tak aby pasowały do metapola w sklepie. Wyświetl szablon
Usuń nieaktywnych klientów
Usuń klientów, którzy od ponad 5 lat nie złożyli żadnego zamówienia. Wyświetl szablon