Analitikai adatok lekérése

Az Analitikai adatok lekérése művelet egy ShopifyQL-lekérdezést futtat, és visszaadja az eredményeket a munkafolyamatban való használatra. A ShopifyQL egy kifejezetten kereskedelmi analitikához készült lekérdezési nyelv. Használatával aggregálhatja a különböző időszakokhoz tartozó mérőszámokat, szűrőket alkalmazhat, valamint csoportosíthat olyan dimenziók alapján, mint a termék, a kollekció vagy a vásárló. A művelet által visszaadott adatok a lépést követő feltételek és műveletek számára is elérhetők.

Tipp

A ShopifyQL a Shopify-jelentésekben és a vásárlószegmentációban is használatos. Tudjon meg többet a ShopifyQL-lekérdezésekről és azok szintaxisáról.

Kiváltók

Az Analitikai adatok lekérése művelet csak az Ütemezett időpont kiváltóval kompatibilis. Az eseményalapú kiváltók nem tartalmazzák az analitikai adatokat.

Konfiguráció

Mezők

Az Analitikai adatok lekérése művelet a következő mezőt tartalmazza:

Az Analitikai adatok lekérése műveletben használt mezők.

Mező	Leírás
ShopifyQL-lekérdezés	Kötelező. Az üzlet analitikai adatain futtatandó ShopifyQL-lekérdezés.

ShopifyQL-lekérdezés

Bármilyen érvényes ShopifyQL-lekérdezést írhat a támogatott sémák használatával, mint például a sales, sessions, inventory és payments. A következő lekérdezés például a teljes árbevételt és a vásárlók számát adja vissza arra a napra vonatkozóan, amikor a munkafolyamat lefut:

FROM sales
  SHOW total_sales, customers
  SINCE today

A teljes nyelvi referenciát, beleértve a támogatott sémákat, függvényeket és szintaxist, a ShopifyQL dokumentációjában találja.

A lekérdezés érvényesítése a munkafolyamat mentésekor történik. A munkafolyamatot csak akkor lehet aktiválni, ha a lekérdezés sikeresen lefut az üzletében.

Visszaadott adatok

Az Analitikai adatok lekérése művelet visszaadja a lekérdezésnek megfelelő sorokat, amelyek egy getAnalyticsData nevű változóként érhetők el. A sorok a getAnalyticsData.rows helyen vannak tárolva, ahol minden sor egy objektum, amelynek kulcsai a lekérdezésben szereplő oszlopnevek.

Ezt a változót a lépést követő feltételekben és műveletekben is használhatja. Ha például egy belső e-mailt szeretne küldeni, amely felsorolja az egyes sorokat, a következőhöz hasonló Liquid-kódot használhat:

{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}

Ha az egyes sorokkal külön-külön szeretne dolgozni, például minden sorra szeretne alkalmazni egy műveletet, használhatja a Ciklus minden elemhez (iterálás) műveletet a getAnalyticsData.rows listán. Az értékek aggregálásához, például a sorok megszámlálásához vagy egy oszlop összegzéséhez a Számlálás és az Összegzés műveleteket használhatja.

Megjegyzés

Ha egy Adatok lekérése műveletet többször is használ egyetlen munkafolyamatban, akkor a változó neve egy számmal egészül ki. Például egy olyan munkafolyamatban, amely kétszer használja a Rendelési adatok lekérése műveletet, a visszaadott adatok első változója getOrderData, a második pedig getOrderData1 lesz. Ez a név nem szabható testre.

API-referencia

A műveletben használt API-ról további információt a GraphQL Admin API shopifyqlQuery lekérdezésénél talál.

Lekérdezés bonyolultsága

Minden ShopifyQL-lekérdezésnek van egy bonyolultsági költsége, amelyet a lekérdezés által használt sémák, oszlopok, szűrők és az időtartam alapján számítanak ki. Ha egy lekérdezés túllépi a bonyolultsági korlátot, a művelet meghiúsul, és a munkafolyamatot nem lehet aktiválni. A lekérdezés költségének csökkentése érdekében lerövidítheti az időtartamot, eltávolíthatja az oszlopokat vagy az illesztéseket.

A lekérdezési költségek kiszámításának módjáról és az aktuális korlátokról a Sebességkorlátozás a ShopifyQL Admin API-ban című részben olvashat bővebben.