Dohvaćanje analitičkih podataka

Radnja Dohvaćanje analitičkih podataka pokreće ShopifyQL upit i vraća rezultate za upotrebu u tijeku rada. ShopifyQL je jezik upita izrađen za analitiku trgovine. Možete ga upotrijebiti za prikupljanje mjernih podataka u različitim vremenskim razdobljima, primjenu filtara i grupiranje prema dimenzijama, kao što su proizvod, kolekcija ili korisnik. Podaci koje ova radnja vrati dostupni su za uvjete i radnje koji slijede nakon tog koraka.

Savjet

ShopifyQL također se upotrebljava u izvješćima na platformi Shopify i segmentaciji korisnika. Saznajte više o upitima i sintaksi jezika ShopifyQL.

Pokretači

Radnja Dohvaćanje analitičkih podataka kompatibilna je samo s pokretačem Zakazano vrijeme. Pokretači koji se temelje na događajima ne uključuju analitičke podatke.

Konfiguracija

Polja

Radnja Dohvaćanje analitičkih podataka sadrži sljedeće polje:

Polja koja se upotrebljavaju u radnji Dohvaćanje analitičkih podataka.

Polje	Opis
Upit jezika ShopifyQL	Obavezno. Upit jezika ShopifyQL koji se pokreće nad analitičkim podacima trgovine.

Upit jezika ShopifyQL

Možete napisati bilo koji važeći ShopifyQL upit pomoću podržanih shema, kao što su sales, sessions, inventory i payments. Na primjer, sljedeći upit vraća ukupnu prodaju i broj korisnika za onaj dan na koji se pokreće tijek rada:

FROM sales
  SHOW total_sales, customers
  SINCE today

Punu referencu za jezik, uključujući podržane sheme, funkcije i sintaksu, potražite u dokumentaciji 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 Dohvaćanje analitičkih podataka vraća retke koji odgovaraju upitu i dostupni su kao varijabla naziva getAnalyticsData. Redci su pohranjeni u varijabli getAnalyticsData.rows, gdje je svaki redak objekt čiji su ključevi nazivi stupaca iz vašeg upita.

Ovu varijablu možete upotrijebiti u uvjetima i radnjama koje slijede nakon tog koraka. Na primjer, za slanje interne e-poruke koja navodi svaki redak možete upotrijebiti jezik Liquid slično ovome:

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

Za pojedinačan rad sa svakim retkom, primjerice za primjenu radnje na svaki redak, možete upotrijebiti radnju Petlja za svaku stavku (ponavljanje) za varijablu getAnalyticsData.rows. Za prikupljanje vrijednosti, primjerice prebrojavanje redaka ili zbrajanje stupca, možete upotrijebiti radnje Brojenje i Zbroj.

Napomena

Ako se radnja Dohvaćanje podataka u jednom tijeku rada upotrijebi više puta, nazivu varijable dodaje se broj. Na primjer, u tijeku rada koji dvaput upotrebljava radnju Dohvaćanje podataka o narudžbi, prva varijabla za vraćene podatke glasi getOrderData, a druga getOrderData1. Taj se naziv ne može prilagođavati.

Referenca za API

Više informacija o API-ju koji se upotrebljava u ovoj radnji potražite pod upitom shopifyqlQuery u GraphQL Admin API-ju.

Složenost upita

Svaki upit jezika ShopifyQL ima trošak složenosti koji se izračunava iz shema, stupaca, filtara i vremenskog raspona koji taj upit upotrebljava. Ako upit prekorač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, ukloniti stupce ili ukloniti spojeve.

Pojedinosti o tome kako se izračunava trošak upita te koja su trenutačna ograničenja potražite u odjeljku Ograničavanje stope u ShopifyQL Admin API-ju.