Dohvaćanje analitičkih podataka

Radnja Dohvati analitičke podatke pokreće upit na jeziku ShopifyQL i vraća rezultate za upotrebu u vašem tijeku rada. ShopifyQL je jezik upita izrađen za analitiku trgovine. Možete ga upotrijebiti za prikupljanje mjernih podataka po vremenskim razdobljima, primjenu filtara i grupiranje po dimenzijama kao što su proizvod, kolekcija ili korisnik. Podaci koje ova radnja vrati dostupni su u uvjetima i radnjama koji slijede nakon tog koraka.

Savjet

ShopifyQL se također upotrebljava u izvješćima na platformi Shopify i segmentaciji korisnika. Možete saznati više o upitima i sintaksi za ShopifyQL.

Pokretači

Radnja Dohvati analitičke podatke kompatibilna je samo s pokretačem Zakazano vrijeme. Pokretači na temelju događaja ne uključuju analitičke podatke.

Konfiguracija

Polja

Radnja Dohvati analitičke podatke sadrži sljedeće polje:

Polja koja se upotrebljavaju u radnji Dohvati analitičke podatke.

Polje	Opis
ShopifyQL upit	Obavezno. ShopifyQL upit koji se treba pokrenuti nad analitičkim podacima vaše trgovine.

ShopifyQL upit

Možete napisati bilo koji važeći ShopifyQL upit upotrebom podržanih shema, poput sales, sessions, inventory i payments. Na primjer, sljedeći upit vraća ukupnu prodaju i broj korisnika za dan u kojem se tijek rada pokreće:

FROM sales
  SHOW total_sales, customers
  SINCE today

Za cijelu referencu jezika, uključujući podržane sheme, funkcije i sintaksu, pogledajte dokumentaciju za ShopifyQL.

Upit se provjerava kada spremite tijek rada. Tijek rada ne može se aktivirati dok se upit uspješno ne pokrene u vašoj trgovini.

Vraćeni podaci

Radnja Dohvati analitičke podatke vraća retke koji odgovaraju vašem upitu, dostupne kao varijabla naziva getAnalyticsData. Reci se pohranjuju u getAnalyticsData.rows, pri čemu je svaki redak objekt s ključem prema nazivima stupaca u vašem upitu.

Ovu varijablu možete upotrijebiti i u uvjetima i u radnjama koje slijede nakon tog koraka. Na primjer, da biste poslali internu e-poruku u kojoj se navodi svaki redak, možete upotrijebiti Liquid sličan ovome:

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

Za pojedinačni rad sa svakim retkom, primjerice za primjenu radnje na svaki redak, možete upotrijebiti radnju Petlja za svaki (iteriranje) s varijablom getAnalyticsData.rows. Za zbrajanje vrijednosti, primjerice prebrojavanje redaka ili zbrajanje stupca, možete upotrijebiti radnje Prebroji i Zbroji.

Napomena

Ako se radnja Dohvati podatke u jednom tijeku rada upotrijebi više puta, nazivu varijable dodaje se broj. Na primjer, u tijeku rada u kojem se dvaput upotrebljava radnja Dohvati podatke o narudžbi, prva varijabla za vraćene podatke je getOrderData, a druga getOrderData1. Taj se naziv ne može prilagoditi.

Referenca za API

Za više informacija o API-ju koji se upotrebljava u ovoj radnji pogledajte upit shopifyqlQuery na sučelju GraphQL Admin API.

Složenost upita

Svaki ShopifyQL upit ima trošak složenosti koji se izračunava iz shema, stupaca, filtara i vremenskog raspona koje upit upotrebljava. Ako upit premaši ograničenje složenosti, radnja neće uspjeti i tijek rada neće se moći aktivirati. Da biste smanjili trošak upita, možete skratiti vremenski raspon te ukloniti stupce ili spojeve.

Za pojedinosti o tome kako se izračunava trošak upita i trenutačnim ograničenjima pogledajte Ograničenje brzine na sučelju ShopifyQL Admin API.