Preuzimanje analitičkih podataka

Radnja Preuzimanje analitičkih podataka izvršava ShopifyQL upit i vraća rezultate za korišćenje u vašem toku posla. ShopifyQL je upitni jezik kreiran za analitiku trgovine. Možete ga koristiti za agregiranje metrika za različite vremenske periode, primenu filtera i grupisanje po dimenzijama, kao što su proizvod, kolekcija ili kupac. Podaci koje ova radnja vraća su dostupni za uslove i radnje koji prate ovaj korak.

Okidači

Radnja Preuzimanje analitičkih podataka je kompatibilna samo sa okidačem Zakazano vreme. Analitički podaci nisu uključeni u okidače koji se zasnivaju na događajima.

Konfiguracija

Polja

Radnja Preuzimanje analitičkih podataka sadrži sledeće polje:

Polja koja se koriste u radnji „Preuzimanje analitičkih podataka“.
PoljeOpis
ShopifyQL upitObavezno. ShopifyQL upit koji se izvršava na analitičkim podacima vaše prodavnice.

ShopifyQL upit

Možete napisati bilo koji važeći ShopifyQL upit pomoću podržanih šema, kao što su sales, sessions, inventory i payments. Na primer, sledeći upit vraća ukupnu prodaju i broj kupaca za dan kada se tok posla izvršava:

FROM sales
  SHOW total_sales, customers
  SINCE today

Za kompletnu jezičku referencu, uključujući podržane šeme, funkcije i sintaksu, pogledajte ShopifyQL dokumentaciju.

Upit se validira kada sačuvate tok posla. Tok posla se ne može aktivirati dok se upit uspešno ne izvrši u vašoj prodavnici.

Vraćeni podaci

Radnja Preuzimanje analitičkih podataka vraća redove koji se podudaraju sa vašim upitom, koji su dostupni kao promenljiva pod imenom getAnalyticsData. Redovi se čuvaju u okviru promenljive getAnalyticsData.rows, gde je svaki red objekat sa ključevima prema imenima kolona u vašem upitu.

Ovu promenljivu možete da koristite i u uslovima i u radnjama koji prate ovaj korak. Na primer, da biste poslali interni imejl koji navodi svaki red, možete da upotrebite Liquid slično ovome:

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

Za individualni rad sa svakim redom, na primer kako biste primenili neku radnju za svaki od njih, možete da iskoristite radnju For each petlja (iteracija) uz getAnalyticsData.rows. Za agregiranje vrednosti, recimo da prebrojite redove ili izračunate zbir kolone, možete da iskoristite radnje Prebrojavanje i Zbir.

Referenca za API

Za više informacija o API-ju koji se koristi u ovoj radnji, pogledajte upit shopifyqlQuery u interfejsu GraphQL Admin API.

Složenost upita

Svaki ShopifyQL upit ima cenu složenosti koja se izračunava iz šema, kolona, filtera i vremenskog raspona koje taj upit koristi. Ako upit premaši ograničenje složenosti, radnja neće uspeti i tok posla neće moći da se aktivira. Da biste smanjili cenu upita, možete da skratite vremenski raspon, uklonite kolone ili uklonite spajanja (joins).

Za detalje o tome kako se izračunava cena upita i o trenutnim ograničenjima, pogledajte odeljak Ograničavanje broja zahteva (rate limiting) u interfejsu ShopifyQL Admin API.