Analüütikaandmete hankimine

Toiming Get analytics data käivitab ShopifyQL-i päringu ja tagastab tulemused sinu töövoos kasutamiseks. ShopifyQL on e-kaubanduse analüütika jaoks loodud päringukeel. Saad seda kasutada mõõdikute koondamiseks ajaperioodide lõikes, filtrite rakendamiseks ja rühmitamiseks selliste dimensioonide alusel nagu toode, kollektsioon või klient. Selle toiminguga tagastatud andmed on kättesaadavad tingimustele ja toimingutele, mis järgnevad sammule.

Nõuanne

ShopifyQL-i kasutatakse ka sinu Shopify aruannetes ja klientide segmenteerimises. Saad lugeda lisateavet ShopifyQL-i päringute ja süntaksi kohta.

Käivitajad

Toiming Get analytics data ühildub ainult käivitajaga Scheduled time. Sündmusepõhised käivitajad analüütikaandmeid ei sisalda.

Konfigureerimine

Väljad

Toiming Get analytics data sisaldab järgmist välja:

Toimingus Get analytics data kasutatavad väljad.

Väli	Kirjeldus
ShopifyQL-i päring	Nõutav. ShopifyQL-i päring sinu poe analüütikaandmetes käivitamiseks.

ShopifyQL-i päring

Saad kirjutada mis tahes kehtiva ShopifyQL-i päringu, kasutades toetatud skeeme (nt sales, sessions, inventory ja payments). Näiteks tagastab järgmine päring töövoo käivitamise päeva kogumüügi ja klientide arvu:

FROM sales
  SHOW total_sales, customers
  SINCE today

Keele täieliku viite, sh toetatud skeemide, funktsioonide ja süntaksi nägemiseks vaata ShopifyQL-i dokumentatsiooni.

Päring valideeritakse töövoo salvestamisel. Töövoogu ei saa aktiveerida enne, kui päring sinu poes edukalt käivitub.

Tagastatud andmed

Toiming Get analytics data tagastab sinu päringule vastavad read, mis on saadaval muutujana nimega getAnalyticsData. Read salvestatakse asukohta getAnalyticsData.rows, kus iga rida on objekt, mille võtmeteks on sinu päringu veerunimed.

Saad seda muutujat kasutada nii tingimustes kui ka sammule järgnevates toimingutes. Näiteks saad iga rida loetleva sisemise e-kirja saatmiseks kasutada Liquidi sarnaselt järgnevaga:

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

Iga reaga eraldi töötamiseks, näiteks igale reale toimingu rakendamiseks, saad koos asukohaga getAnalyticsData.rows kasutada toimingut For each loop (iterate). Väärtuste koondamiseks, näiteks ridade loendamiseks või veeru summeerimiseks, saad kasutada toiminguid Count ja Sum.

Märkus

Kui toimingut Hangi andmed kasutatakse ühes töövoos mitu korda, lisatakse muutuja nimele number. Näiteks töövoos, mis kasutab toimingut Hangi tellimuse andmed kaks korda, on esimene tagastatud andmete muutuja getOrderData ja teine getOrderData1. Seda nime ei saa muuta.

API viide

Lisateavet selles toimingus kasutatud API kohta leiad GraphQL Admin API päringust shopifyqlQuery.

Päringu keerukus

Igal ShopifyQL-i päringul on keerukuse kulu, mis arvutatakse päringus kasutatavate skeemide, veergude, filtrite ja ajavahemiku põhjal. Kui päring ületab keerukuse piirangut, siis toiming ebaõnnestub ja töövoogu ei saa käivitada. Päringu kulu vähendamiseks võid lühendada ajavahemikku, eemaldada veerge või eemaldada liitmisi.

Lisateavet päringu kulu arvutamise ja kehtivate piirangute kohta leiad jaotisest Päringusageduse piiramine ShopifyQL Admin API-s.