Pridobi podatke analitike

Dejanje Pridobi podatke analitike izvede poizvedbo ShopifyQL in vrne rezultate za uporabo v vašem poteku dela. ShopifyQL je poizvedovalni jezik, ustvarjen za analitiko trgovanja. Z njim lahko združite metrike v različnih časovnih obdobjih, uporabite filtre in jih razvrstite po dimenzijah, kot so izdelek, zbirka ali stranka. Podatki, ki jih vrne to dejanje, so na voljo za pogoje in dejanja, ki sledijo temu koraku.

Nasvet

ShopifyQL se uporablja tudi v vaših poročilih Shopify in segmentaciji strank. Več informacij o poizvedbah in sintaksi ShopifyQL.

Sprožilci

Dejanje Pridobi podatke analitike je združljivo samo s sprožilcem Načrtovan čas. Podatki analitike niso vključeni v sprožilce na podlagi dogodkov.

Konfiguracija

Polja

Dejanje Pridobi podatke analitike vsebuje naslednje polje:

Polja, uporabljena v dejanju »Pridobi podatke analitike«.

Polje	Opis
Poizvedba ShopifyQL	Obvezno. Poizvedba ShopifyQL za izvajanje na podatkih analitike vaše trgovine.

Poizvedba ShopifyQL

Napišete lahko poljubno 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 na dan, ko se izvede potek dela:

FROM sales
  SHOW total_sales, customers
  SINCE today

Za celotno referenco o jeziku, vključno s podprtimi shemami, funkcijami in sintakso, si oglejte dokumentacijo ShopifyQL.

Poizvedba se preveri, ko shranite potek 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, pri čemer je vsaka vrstica objekt, določen z imeni stolpcev v vaši poizvedbi.

To spremenljivko lahko uporabite v pogojih in dejanjih, ki sledijo koraku. Za pošiljanje interne e-pošte s seznamom posameznih vrstic lahko na primer uporabite jezik Liquid na podoben način:

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

Če želite obdelati vsako vrstico posebej, na primer uveljaviti dejanje za vsako vrstico, lahko uporabite dejanje Zanka »za vsako« (ponavljanje) skupaj s spremenljivko getAnalyticsData.rows. Za združevanje vrednosti, kot je štetje vrstic ali seštevek stolpca, lahko uporabite dejanji Štetje in Vsota.

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 API-ju, uporabljenem v tem dejanju, si oglejte 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 razpona, ki jih uporablja poizvedba. Č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 časovni razpon, odstranite stolpce ali odstranite združevanja.

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