Gauti analitikos duomenis

Veiksmas Gauti analitikos duomenis paleidžia ShopifyQL užklausą ir grąžina rezultatus, kad juos būtų galima naudoti Jūsų darbo eigoje. „ShopifyQL“ yra prekybos duomenų analizei sukurta užklausų kalba. Ją naudodami galite apibendrinti metrikas per tam tikrus laikotarpius, taikyti filtrus ir grupuoti pagal tokius aspektus kaip produktas, kolekcija ar klientas. Šio veiksmo grąžinti duomenys pasiekiami sąlygoms ir veiksmams, einantiems po šio žingsnio.

Patarimas

„ShopifyQL“ taip pat naudojama Jūsų „Shopify“ ataskaitose ir klientų segmentavime. Daugiau informacijos rasite skiltyje apie „ShopifyQL“ užklausas ir sintaksę.

Paleidikliai

Veiksmas Gauti analitikos duomenis suderinamas tik su Suplanuoto laiko paleidikliu. Įvykių pagrindu veikiantys paleidikliai neįtraukia analitikos duomenų.

Konfigūracija

Laukai

Veiksmas Gauti analitikos duomenis turi šį lauką:

Veiksme „Gauti analitikos duomenis“ naudojami laukai.

Laukas	Aprašymas
„ShopifyQL“ užklausa	Privalomas laukas. „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, tokias kaip sales, sessions, inventory ir payments. Pavyzdžiui, toliau pateikta užklausa grąžina bendras pardavimų pajamas ir klientų skaičių už 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.

Išsaugojus darbo eigą, užklausa patikrinama. Darbo eigos negalima aktyvuoti, kol užklausa nebus sėkmingai įvykdyta Jūsų parduotuvėje.

Grąžinti duomenys

Veiksmas Gauti analitikos duomenis grąžina Jūsų 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žklausoje nurodyti stulpelių pavadinimai.

Šį kintamąjį galite naudoti ir sąlygose, ir veiksmuose, kurie seka po šio žingsnio. Pavyzdžiui, norėdami išsiųsti vidinį el. laišką, kuriame išvardyta kiekviena eilutė, galite naudoti „Liquid“ kodą, panašų į šį:

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

Norėdami dirbti su kiekviena eilute atskirai, pavyzdžiui, pritaikyti veiksmą kiekvienai eilutei, galite naudoti veiksmą Kiekvienam ciklui (iteruoti) su getAnalyticsData.rows. Norėdami apibendrinti reikšmes, pavyzdžiui, suskaičiuoti eilutes ar susumuoti stulpelį, galite naudoti veiksmus Suskaičiuoti ir Susumuoti.

Pastaba

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

API žinynas

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

Užklausos sudėtingumas

Kiekviena „ShopifyQL“ užklausa turi sudėtingumo kainą, kuri apskaičiuojama pagal užklausoje naudojamas schemas, stulpelius, filtrus ir laikotarpį. Jei užklausa viršija sudėtingumo ribą, veiksmas nepavyksta ir darbo eiga negali būti aktyvuota. Norėdami sumažinti užklausos kainą, galite sutrumpinti laikotarpį, pašalinti stulpelius ar sujungimus.

Daugiau informacijos apie tai, kaip apskaičiuojama užklausos kaina ir kokios yra dabartinės ribos, rasite skiltyje Užklausų dažnio ribojimas „ShopifyQL Admin API“ aplinkoje.