Dohvati podatke o korisniku
U tijekovima rada koji upotrebljavaju podatke o korisnicima možete upotrijebiti radnju Dohvati podatke o korisniku za dohvaćanje informacija o korisnicima iz vaše trgovine.
Konfiguracija
Polja
Radnja Dohvati podatke o korisniku sadrži sljedeća polja koja se upotrebljavaju za izradu upita:
| Polje | Opis |
|---|---|
| Sortiraj podatke po | Obavezno. Parametri prema kojima se sortiraju podaci koje je vratio upit za pretraživanje. |
| Maksimalan broj rezultata | Obavezno. Maksimalan broj rezultata koje može vratiti odabrani upit za pretraživanje. Možete vratiti do 100 rezultata istodobno. |
| Upit | Obavezno. Odaberite među uobičajenim upitima ili odaberite Napredno da biste izradili vlastiti. |
Niz upita
Ovo je primjer upita za dohvaćanje korisnika koji su ažurirani u proteklom danu:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Varijabla updated_at filtar je koji je dostupan u upitu o korisnicima te se može upotrijebiti više puta ili u kombinaciji s drugim varijablama. Varijabla Liquid scheduledAt dostupna je u tijekovima rada koji upotrebljavaju pokretač Zakazano vrijeme. Oznaka Liquid date_minus posebna je oznaka za Flow koja omogućuje oduzimanje vremena od datuma.
Pri postavljanju upita o podacima korisno je znati sljedeće:
- Popis dostupnih filtara korisnika
- Upiti moraju slijediti određenu sintaksu
- Vrijednosti polja upita nisu uvijek dokumentirane. U nekim se slučajevima te vrijednosti mogu pronaći pregledom API dokumentacije. Alternativno, vrijednosti polja često možete pronaći u URL-ovima na administratorskoj ploči prilikom filtriranja. Na primjer, da biste pronašli neke vrijednosti upita za narudžbe, filtrirajte stranicu Narudžbe na administratorskoj ploči, a zatim provjerite URL.
- Upit možete pokrenuti ili testirati u svojoj trgovini upotrebom aplikacije Shopify GraphiQL.
- Imajte na umu što se događa ako vaš upit ne uspije. API će često vratiti sve rezultate (umjesto nijednog).
Vraćeni podaci
Sve radnje Dohvati podatke vraćaju popis od 0 do 100 resursa. Ovisno o vašem slučaju upotrebe, te ćete podatke možda htjeti upotrijebiti na različite načine:
- Ako pojedinačno trebate rukovati svakom stavkom s popisa, na primjer da biste za svaku dodali oznaku, tada možete upotrijebiti radnju Za svaki.
- Ako trebate prikupiti podatke, na primjer prebrojiti koliko je rezultata vraćeno, tada možete upotrijebiti radnju Prebroji ili Zbroji.
- Ako trebate izlazne podatke popisa, poput slanja e-poruke sa svim stavkama, vraćene podatke možete upotrijebiti izravno u sljedećim radnjama.
Da biste pristupili vraćenim podacima u koracima koji slijede nakon ove radnje, upotrijebite varijablu pod nazivom Dohvati podatke o korisniku, što predstavlja popis korisnika. Tu varijablu možete upotrijebiti i u uvjetima i u radnjama. Na primjer, popis narudžbi možete poslati u radnji Pošalji internu e-poruku na sljedeći način:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Pokretači
Ovu radnju možete upotrijebiti u bilo kojem tijeku rada, uključujući pokretač Zakazano vrijeme. U tijeku rada koji upotrebljava pokretač Zakazano vrijeme, tijek rada započinje u vrijeme koje ste odredili, a ne kao rezultat događaja. S obzirom na to da nema specifičnog događaja u vašoj trgovini ili iz aplikacije koji bi pokrenuo tijek rada, podaci se ne uključuju automatski.
Pojedinosti o API-ju
Predlošci
Pretvorite metapolje korisnika u oznake za sve korisnike
Ovaj će tijek rada naknadno ispuniti oznake za sve vaše korisnike na temelju vrijednosti metapolja. Pokreće se svaki sat i dohvaća do 100 korisnika koji nemaju oznaku „processed” (obrađeno). Za svakog korisnika pregledava vrijednost metapolja custom.test i dodaje je kao oznaku. Tijek rada također dodaje oznaku „processed” tako da se isti korisnici ne vraćaju u sljedećem zakazanom pokretanju tijeka rada. Za upotrebu tijeka rada morat ćete promijeniti prostor za ime i ključ metapolja tako da se podudaraju s metapoljem u vašoj trgovini. Prikaži predložak
Izbriši neaktivne korisnike
Izbrišite korisnike starije od 5 godina koji nikada nisu izvršili narudžbu. Prikaži predložak