Vásárlói adatok lekérése
A vásárlói adatokat használó munkafolyamatokban a Vásárlói adatok lekérése művelettel kérhetők le a vásárlókra vonatkozó információk az üzletből.
Ezen az oldalon
Konfiguráció
Mezők
A Vásárlói adatok lekérése művelet a következő mezőket tartalmazza, amelyek a lekérdezés létrehozásához használhatók:
| Mező | Leírás |
|---|---|
| Adatok rendezése | Kötelező. A paraméterek, amelyek alapján a keresési lekérdezés által visszaadott adatok rendezve lesznek. |
| Találatok maximális száma | Kötelező. A kiválasztott keresési lekérdezés által visszaadható eredmények maximális száma. Egyszerre legfeljebb 100 adható vissza. |
| Lekérdezés | Kötelező. Válasszon a gyakori lekérdezések közül, vagy válassza a Speciális lehetőséget saját lekérdezés létrehozásához. |
Lekérdezési karakterlánc
Az alábbiakban egy példa látható egy olyan lekérdezésre, amely az elmúlt nap során frissített vásárlókat kéri le:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Az updated_at változó a Vásárlók lekérdezésénél elérhető szűrő, amely többször is használható vagy más változókkal kombinálható. Az scheduledAt Liquid-változó azokban a munkafolyamatokban érhető el, amelyek a „Ütemezett idő” kiváltót használták. A date_minus Liquid-címke egy speciális Flow-címke, amely lehetővé teszi, hogy időt vonjon ki egy dátumból.
Adatok lekérdezésekor hasznos tudni a következőket:
- Az elérhető vásárlói szűrők listája
- A lekérdezéseknek egy bizonyos szintaxist kell követniük
- A lekérdezési mezők értékei nem mindig dokumentáltak. Bizonyos esetekben az értékek az API-dokumentációban találhatók. Alternatív megoldásként a mezőértékeket gyakran megtalálhatja az adminisztrációs felület URL-jeiben, amikor szűr. Ha például rendelési lekérdezési értékeket szeretne találni, szűrjön a Rendelések oldalon az adminisztrációs felületen, majd ellenőrizze az URL-t.
- A Shopify GraphiQL alkalmazás segítségével futtathat vagy tesztelhet egy lekérdezést az üzletében.
- Ügyeljen arra, hogy mi történik, ha a lekérdezés sikertelen. Az API gyakran az összes eredményt adja vissza (ahelyett, hogy egyet sem).
Visszaadott adatok
Minden Adatok lekérése művelet egy 0 és 100 közötti erőforrást tartalmazó listát ad vissza. A felhasználási esettől függően ezeket az adatokat különféle módokon használhatja fel:
- Ha minden listaelemét egyenként kell kezelnie, például címkét kell hozzáadnia mindegyikhez, akkor használhatja a Minden elemre műveletet.
- Ha összesítenie kell az adatokat, például meg kell számolnia, hogy hány eredményt adtak vissza, akkor használhatja a Számlálás vagy az Összegzés műveletet.
- Ha ki kell adnia a listát, például egy e-mailt kell küldenie az összes tétellel, akkor a visszaadott adatokat közvetlenül felhasználhatja a későbbi műveletekben.
Ahhoz, hogy a műveletet követő lépésekben hozzáférjen a visszaadott adatokhoz, használja a Vásárlói adatok lekérése nevű változót, amely a vásárlók listája. Ezt a változót feltételekben és műveletekben egyaránt használhatja. Például a következőképpen küldheti el a rendelések listáját egy Belső e-mail küldése műveletben:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Kiváltók
Ezt a műveletet bármely munkafolyamatban használhatja, beleértve az Ütemezett idő kiváltót is. Az Ütemezett idő kiváltót használó munkafolyamatban a munkafolyamat az Ön által megadott időpontban indul el, nem pedig egy esemény eredményeként. Mivel nincs olyan konkrét esemény az üzletében vagy egy alkalmazásban, amely elindítja a munkafolyamatot, ezért az automatikusan nem tartalmaz adatokat.
API-részletek
Sablonok
Vásárlói metamező átalakítása címkékké minden vásárló számára
Ez a munkafolyamat egy metamező értéke alapján pótolja a címkéket az összes vásárlónál. Óránként fut, és legfeljebb 100 olyan vásárlót kér le, akik nem rendelkeznek „feldolgozva” címkével. Minden vásárló esetében megvizsgálja egy `custom.test` metamező értékét, és címkeként hozzáadja. A munkafolyamat egy „feldolgozva” címkét is hozzáad, hogy az ne kerüljön vissza a munkafolyamat következő ütemezett futtatásakor. A munkafolyamat használatához meg kell változtatnia a metamező névterét és kulcsát, hogy az megfeleljen az üzletében lévő metamezőnek. Sablon megtekintése
Inaktív vásárlók törlése
Az 5 évnél idősebb, rendelést még nem leadott vásárlók törlése. Sablon megtekintése