Hangi kliendi andmed
Töövoogudes, mis kasutavad kliendi andmeid, saad oma poest klienditeabe hankimiseks kasutada toimingut Hangi kliendi andmed.
Konfigureerimine
Väljad
Toiming Hangi kliendi andmed sisaldab järgmisi välju, mida kasutatakse päringu koostamiseks:
| Väli | Kirjeldus |
|---|---|
| Andmete sortimisalus | Kohustuslik. Parameetrid, mille järgi otsingupäringuga tagastatud andmed sorditakse. |
| Maksimaalne tulemuste arv | Kohustuslik. Maksimaalne tulemuste arv, mida valitud otsingupäring võib tagastada. Korraga saad tagastada kuni 100 tulemust. |
| Päring | Kohustuslik. Vali levinud päringute hulgast või tee valik Täpsem, et luua oma päring. |
Päringusõne
See on näidispäring klientide saamiseks, keda värskendati viimase päeva jooksul:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Muutuja updated_at on filter, mis on saadaval klientide päringus (Customers query) ja mida saab kasutada mitu korda või kombineerida teiste muutujatega. Liquidi muutuja scheduledAt on saadaval töövoogudes, mis kasutasid määratud aja käivitajat (Scheduled time). Liquidi silt date_minus on spetsiaalne Flow silt, mis võimaldab kuupäevast aega lahutada.
Andmete pärimisel on kasulik teada järgmist.
- Saadaolevate kliendifiltrite loend
- Päringud peavad järgima teatud süntaksit
- Päringu välja väärtused ei ole alati dokumenteeritud. Mõnel juhul leiab väärtused, kui vaadata API dokumentatsiooni. Sageli leiad välja väärtused admini URL-idest, kui kasutad filtreid. Näiteks tellimuse päringu väärtuste leidmiseks filtreeri adminis lehte Tellimused ja seejärel vaata URL-i.
- Päringu käivitamiseks või testimiseks oma poes saad kasutada rakendust Shopify GraphiQL.
- Pea meeles, mis juhtub, kui sinu päring nurjub. Sageli tagastab API kõik tulemused (mitte null tulemust).
Tagastatud andmed
Kõik toimingud Hangi andmed tagastavad 0–100 ressursist koosneva loendi. Olenevalt kasutusjuhust võid neid andmeid kasutada mitmel viisil:
- Kui sul on vaja iga loendiüksust eraldi käsitleda, näiteks neile kõigile silt lisada, saad kasutada toimingut For each.
- Kui sul on vaja andmeid koondada, näiteks lugeda kokku tagastatud tulemused, saad kasutada toiminguid Count või Sum.
- Kui sul on vaja loend väljastada, näiteks saata e-kiri kõigi üksustega, saad tagastatud andmeid kasutada otse järgnevates toimingutes.
Et pääseda tagastatud andmetele juurde sellele toimingule järgnevates sammudes, kasuta muutujat Get customer data, mis on klientide loend. Seda muutujat saad kasutada nii tingimustes kui ka toimingutes. Näiteks saad tellimuste loendi saata toiminguga Send internal email järgmiselt:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Käivitajad
Seda toimingut saad kasutada mis tahes töövoos, sealhulgas koos käivitajaga Scheduled time. Töövoos, mis kasutab käivitajat Scheduled time, käivitub töövoog sinu määratud ajal, mitte sündmuse tulemusena. Kuna poes või rakenduses pole konkreetset sündmust, mis töövoo käivitaks, ei kaasata andmeid automaatselt.
API üksikasjad
Mallid
Kliendi metavälja konverteerimine siltideks kõigi klientide jaoks
See töövoog täidab tagantjärele kõigi klientide sildid metavälja väärtuse põhjal. See käivitub iga tund ja hangib kuni 100 klienti, kellel pole silti „processed“. Töövoog vaatab iga kliendi puhul metavälja custom.test väärtust ja lisab selle sildina. Ühtlasi lisab töövoog sildi „processed“, et klienti järgmisel kavandatud töövoo käivitusel ei tagastataks. Töövoo kasutamiseks pead muutma metavälja nimeruumi ja võtit nii, et need vastaksid sinu poe metaväljale. Vaata malli
Mitteaktiivsete klientide kustutamine
Kustuta üle viie aasta vanused kliendid, kes pole kunagi tellimust esitanud. Vaata malli