Pridobivanje podatkov o strankah
V potekih dela, ki uporabljajo podatke o strankah, lahko uporabite dejanje Get customer data, da iz trgovine pridobite informacije o strankah.
Konfiguracija
Polja
Dejanje Get customer data vsebuje naslednja polja, ki se uporabljajo za ustvarjanje poizvedbe:
| Polje | Opis |
|---|---|
| Razvrsti podatke po | Obvezno. Parametri, po katerih se razvrstijo podatki, ki jih vrne iskalna poizvedba. |
| Največje število rezultatov | Obvezno. Največje število rezultatov, ki jih lahko vrne izbrana iskalna poizvedba. Hkrati je lahko vrnjenih do 100 rezultatov. |
| Poizvedba | Obvezno. Izberite eno od pogostih poizvedb ali pa izberite možnost Advanced, da ustvarite svojo. |
Niz poizvedbe
To je primer poizvedbe za pridobivanje strank, ki so bile posodobljene v zadnjem dnevu:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Spremenljivka updated_at je filter, ki je na voljo v poizvedbi o strankah in ga lahko uporabite večkrat ali v kombinaciji z drugimi spremenljivkami. Spremenljivka Liquid scheduledAt je na voljo v potekih dela, ki uporabljajo sprožilec Scheduled time. Oznaka Liquid date_minus je posebna oznaka za Flow, ki omogoča odštevanje časa od datuma.
Pri izvajanju poizvedb za podatke je dobro vedeti naslednje:
- Seznam razpoložljivih filtrov za stranke
- Poizvedbe morajo upoštevati določeno sintakso
- Vrednosti polj za poizvedbe niso vedno dokumentirane. V nekaterih primerih lahko vrednosti poiščete v dokumentaciji za API. Pogosto jih lahko najdete tudi v URL-naslovih v skrbniški plošči med filtriranjem. Če želite na primer poiskati nekatere vrednosti poizvedbe o naročilih, filtrirajte stran »Naročila« v skrbniški plošči in nato preverite URL-naslov.
- Poizvedbo v svoji trgovini lahko zaženete ali preizkusite z aplikacijo Shopify GraphiQL.
- Bodite pozorni na to, kaj se zgodi, če vaša poizvedba ne uspe. API pogosto vrne vse rezultate (namesto nobenega).
Vrnjeni podatki
Vsa dejanja Get data vrnejo seznam od 0 do 100 virov. Glede na vaš primer uporabe lahko te podatke uporabite na različne načine:
- Če želite vsak element na seznamu obravnavati posamezno, na primer za dodajanje oznake, lahko uporabite dejanje For each.
- Če morate združevati podatke, na primer prešteti vrnjene rezultate, lahko uporabite dejanji Count ali Sum.
- Če želite izpisati seznam, na primer poslati e-pošto z vsemi elementi, lahko vrnjene podatke uporabite neposredno v nadaljnjih dejanjih.
Če želite v korakih po tem dejanju dostopati do vrnjenih podatkov, uporabite spremenljivko Get customer data, ki predstavlja seznam strank. To spremenljivko lahko uporabite tako v pogojih kot v dejanjih. Seznam naročil lahko na primer pošljete v dejanju Send internal email na naslednji način:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Sprožilci
To dejanje lahko uporabite v poljubnem poteku dela, vključno s sprožilcem Scheduled time. V poteku dela, ki uporablja sprožilec Scheduled time, se potek dela začne ob določenem času in ne kot posledica dogodka. Ker v trgovini ali aplikaciji ni določenega dogodka, ki bi zagnal potek dela, nobeni podatki niso samodejno vključeni.
Podrobnosti o API-ju
Predloge
Pretvori metapolje stranke v oznake za vse stranke
Ta potek dela bo dopolnil oznake za vse vaše stranke na podlagi vrednosti metapolja. Izvede se vsako uro in pridobi do 100 strank, ki nimajo oznake »processed«. Za vsako stranko pregleda vrednost metapolja custom.test in ga doda kot oznako. Potek dela doda tudi oznako »processed«, tako da stranka ni vrnjena pri naslednjem načrtovanem izvajanju poteka dela. Če želite uporabiti ta potek dela, boste morali spremeniti imenski prostor metapolja in ključ, da se bosta ujemala z metapoljem v vaši trgovini. Ogled predloge
Izbriši nedejavne stranke
Izbrišite stranke, ki so bile ustvarjene pred več kot 5 leti in še nikoli niso oddale naročila. Ogled predloge