Elemzési adatok lekérése

Az Elemzési adatok lekérése művelet lefuttat egy ShopifyQL-lekérdezést, és visszaadja az eredményeket a munkafolyamatban való felhasználásra. A ShopifyQL egy kifejezetten kereskedelmi elemzésekhez készült lekérdezési nyelv. Segítségével mérőszámokat összesíthet különböző időszakokra vonatkozóan, szűrőket alkalmazhat, és dimenziók (például termék, kollekció vagy vásárló) szerint csoportosíthatja az adatokat. 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-t a Shopify-jelentésekben és a vásárlószegmentációban is használják. További információ a ShopifyQL-lekérdezésekről és -szintaxisról.

Kiváltók

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

Konfiguráció

Mezők

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

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

Mező	Leírás
ShopifyQL-lekérdezés	Kötelező. Az üzlet elemzési adatain lefuttatni kívánt ShopifyQL-lekérdezés.

ShopifyQL-lekérdezés

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

FROM sales
  SHOW total_sales, customers
  SINCE today

A teljes nyelvi referenciáért – beleértve a támogatott sémákat, függvényeket és szintaxist – tekintse meg a ShopifyQL-dokumentációt.

A lekérdezés érvényesítése a munkafolyamat mentésekor történik. A munkafolyamatot nem lehet aktiválni addig, amíg a lekérdezés nem fut le sikeresen az üzletben.

Visszaadott adatok

Az Elemzési adatok lekérése művelet visszaadja a lekérdezésnek megfelelő sorokat, amelyek a getAnalyticsData nevű változóként érhetők el. A sorok a getAnalyticsData.rows tömbben vannak tárolva, ahol minden sor egy objektum, amelynek kulcsai a lekérdezésben megadott 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 listázza az egyes sorokat, ehhez 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 egy műveletet alkalmazni minden sorra), használhatja a Ciklus minden elemre (iterálás) műveletet a getAnalyticsData.rows változóval. Az értékek összesítéséhez, 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, a rendszer egy számot fűz a változó nevéhez. Egy olyan munkafolyamatban például, amely kétszer használja a Rendelési adatok lekérése műveletet, a visszaadott adatok első változója a getOrderData, a második pedig a getOrderData1. Ez a név nem szabható testre.

API-referencia

Az ehhez a művelethez használt API-val kapcsolatos további információkért tekintse meg a GraphQL Admin API shopifyqlQuery lekérdezését.

Lekérdezés összetettsége

Minden ShopifyQL-lekérdezésnek van egy összetettségi költsége, amelyet a lekérdezés által használt sémák, oszlopok, szűrők és időtartamok alapján számítanak ki. Ha egy lekérdezés túllépi az összetettsé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éséhez lerövidítheti az időtartamot, és eltávolíthatja az oszlopokat vagy az illesztéseket.

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