Gauti analitikos duomenis

Veiksmas Gauti analitikos duomenis vykdo ShopifyQL užklausą ir grąžina rezultatus, kuriuos galite naudoti savo darbo eigoje. ShopifyQL yra užklausų kalba, sukurta prekybos analitikai. Ją galite naudoti norėdami apibendrinti metrikas per tam tikrus laikotarpius, taikyti filtrus ir grupuoti pagal tokius aspektus kaip produktas, kolekcija ar klientas. Šio veiksmo grąžinti duomenys pasiekiami po šio žingsnio einančioms sąlygoms ir veiksmams.

Patarimas

ShopifyQL taip pat naudojama jūsų „Shopify“ ataskaitose ir klientų segmentavime. Galite sužinoti daugiau apie ShopifyQL užklausas ir sintaksę.

Paleidikliai

Veiksmas Gauti analitikos duomenis suderinamas tik su paleidikliu Suplanuotas laikas. Į įvykiais pagrįstus paleidiklius analitikos duomenys nėra įtraukiami.

Konfigūracija

Laukai

Veiksme Gauti analitikos duomenis yra šis laukas:

Laukai, naudojami veiksme „Gauti analitikos duomenis“.

Laukas	Aprašymas
ShopifyQL užklausa	Būtina. ShopifyQL užklausa, vykdoma jūsų parduotuvės analitikos duomenims.

ShopifyQL užklausa

Galite parašyti bet kokią tinkamą ShopifyQL užklausą, naudodami palaikomas schemas, pvz., sales, sessions, inventory ir payments. Pavyzdžiui, toliau pateikta užklausa grąžina bendrą pardavimų sumą ir klientų skaičių tą dieną, kai paleidžiama darbo eiga:

FROM sales
  SHOW total_sales, customers
  SINCE today

Išsamų kalbos žinyną, įskaitant palaikomas schemas, funkcijas ir sintaksę, rasite ShopifyQL dokumentacijoje.

Užklausa patikrinama, kai išsaugote darbo eigą. Darbo eigos negalima aktyvinti, kol užklausa nebus sėkmingai įvykdyta jūsų parduotuvėje.

Grąžinti duomenys

Veiksmas Gauti analitikos duomenis grąžina užklausą atitinkančias eilutes, pasiekiamas kaip kintamasis pavadinimu getAnalyticsData. Eilutės saugomos getAnalyticsData.rows, kur kiekviena eilutė yra objektas, kurio raktai yra jūsų užklausos stulpelių pavadinimai.

Šį kintamąjį galite naudoti tiek sąlygose, tiek veiksmuose, einančiuose po šio žingsnio. Pavyzdžiui, norėdami išsiųsti vidinį el. laišką, kuriame pateikiama kiekviena eilutė, galite naudoti panašų Liquid kodą:

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

Norėdami dirbti su kiekviena eilute atskirai, pvz., taikyti veiksmą kiekvienai eilutei, su getAnalyticsData.rows galite naudoti veiksmą Ciklas kiekvienam (iteruoti). Norėdami apibendrinti reikšmes, pvz., suskaičiuoti eilutes ar gauti stulpelio sumą, galite naudoti veiksmus Skaičiuoti ir Sumuoti.

Pastaba

Jei veiksmas Gauti duomenis vienoje darbo eigoje naudojamas kelis kartus, prie kintamojo pavadinimo pridedamas skaičius. Pavyzdžiui, darbo eigoje, kurioje du kartus naudojamas veiksmas Gauti užsakymo duomenis, pirmasis grąžintų duomenų kintamasis yra getOrderData, o antrasis – getOrderData1. Šio pavadinimo tinkinti negalima.

API žinynas

Daugiau informacijos apie šiame veiksme naudojamą API rasite GraphQL Admin API esančioje shopifyqlQuery užklausoje.

Užklausos sudėtingumas

Kiekviena ShopifyQL užklausa turi sudėtingumo sąnaudas, kurios apskaičiuojamos pagal užklausoje naudojamas schemas, stulpelius, filtrus ir laikotarpį. Jei užklausa viršija sudėtingumo limitą, veiksmas nepavyksta ir darbo eiga negali būti aktyvinta. Norėdami sumažinti užklausos sąnaudas, galite sutrumpinti laikotarpį, pašalinti stulpelius arba pašalinti sujungimus.

Išsamią informaciją apie tai, kaip apskaičiuojamos užklausos sąnaudos, ir dabartinius limitus rasite Užklausų spartos ribojimas ShopifyQL Admin API.