Pridobi podatke analitike

Dejanje Pridobi podatke analitike zažene poizvedbo ShopifyQL in vrne rezultate za uporabo v vašem poteku dela. ShopifyQL je poizvedovalni jezik, zasnovan za analitiko trgovanja. Uporabite ga lahko za združevanje metrik v različnih časovnih obdobjih, uporabo filtrov in združevanje po dimenzijah, kot so izdelek, zbirka ali stranka. Podatki, ki jih vrne to dejanje, so na voljo za pogoje in dejanja, ki sledijo koraku.

Nasvet

ShopifyQL se uporablja tudi v vaših poročilih Shopify in pri segmentaciji strank. Preberite več o poizvedbah in sintaksi jezika ShopifyQL.

Sprožilci

Dejanje Pridobi podatke analitike je združljivo samo s sprožilcem Načrtovani čas. Podatkov analitike sprožilci, ki temeljijo na dogodkih, ne vključujejo.

Konfiguracija

Polja

Dejanje Pridobi podatke analitike vsebuje naslednje polje:

Polja, uporabljena v dejanju Pridobi podatke analitike.

Polje	Opis
Poizvedba ShopifyQL	Obvezno. Poizvedba ShopifyQL, ki se zažene v podatkih analitike vaše trgovine.

Poizvedba ShopifyQL

Napišete lahko katero koli veljavno poizvedbo ShopifyQL z uporabo podprtih shem, kot so sales, sessions, inventory in payments. Naslednja poizvedba na primer vrne skupni znesek prodaje in število strank za dan, ko se izvede potek dela:

FROM sales
  SHOW total_sales, customers
  SINCE today

Za celotno referenco jezika, vključno s podprtimi shemami, funkcijami in sintakso, glejte dokumentacijo za ShopifyQL.

Poizvedba se preveri ob shranjevanju poteka dela. Poteka dela ni mogoče aktivirati, dokler se poizvedba uspešno ne izvede v vaši trgovini.

Vrnjeni podatki

Dejanje Pridobi podatke analitike vrne vrstice, ki se ujemajo z vašo poizvedbo, in so na voljo kot spremenljivka z imenom getAnalyticsData. Vrstice so shranjene v getAnalyticsData.rows, kjer je vsaka vrstica predmet, katerega ključi so imena stolpcev v vaši poizvedbi.

To spremenljivko lahko uporabite v pogojih in dejanjih, ki sledijo koraku. Za pošiljanje interne e-pošte, ki navaja vsako vrstico, lahko na primer uporabite kodo Liquid na naslednji način:

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

Za delo z vsako vrstico posebej, na primer za uporabo dejanja za vsako vrstico, lahko uporabite dejanje Zanka »za vsakega« (iteracija) s spremenljivko getAnalyticsData.rows. Za združevanje vrednosti, na primer preštevanje vrstic ali seštevanje stolpca, lahko uporabite dejanji Preštej in Seštej.

Opomba

Če je dejanje Pridobi podatke v enem poteku dela uporabljeno večkrat, se imenu spremenljivke doda številka. Na primer, v poteku dela, ki dejanje Pridobi podatke o naročilu uporabi dvakrat, je prva spremenljivka za vrnjene podatke getOrderData, druga pa getOrderData1. Tega imena ni mogoče prilagoditi.

Referenca za API

Za več informacij o vmesniku API, uporabljenem v tem dejanju, glejte poizvedbo shopifyqlQuery v vmesniku GraphQL Admin API.

Kompleksnost poizvedbe

Vsaka poizvedba ShopifyQL ima strošek kompleksnosti, ki se izračuna na podlagi shem, stolpcev, filtrov in časovnega obdobja, ki jih poizvedba uporablja. Če poizvedba preseže omejitev kompleksnosti, dejanje ne uspe in poteka dela ni mogoče aktivirati. Strošek poizvedbe lahko zmanjšate tako, da skrajšate časovno obdobje ter odstranite stolpce ali pridruževanja.

Za podrobnosti o tem, kako se izračuna strošek poizvedbe, in o trenutnih omejitvah, preberite Omejevanje števila zahtev v vmesniku ShopifyQL Admin API.