Obține date analitice

Acțiunea Obține date analitice execută o interogare ShopifyQL și returnează rezultatele pentru a fi utilizate în fluxul de lucru. ShopifyQL este un limbaj de interogare creat pentru date analitice de comerț. Îl puteți folosi pentru a agrega indicatori în diverse perioade de timp, a aplica filtre și a grupa după dimensiuni precum produs, colecție sau client. Datele returnate de această acțiune sunt disponibile pentru condițiile și acțiunile care urmează după acest pas.

Pe această pagină

Declanșatoare

Acțiunea Obține date analitice este compatibilă doar cu declanșatorul Oră programată. Datele analitice nu sunt incluse de declanșatoarele bazate pe evenimente.

Configurare

Câmpuri

Acțiunea Obține date analitice conține următorul câmp:

Câmpurile utilizate în acțiunea Obține date analitice.
Câmp	Descriere
Interogare ShopifyQL	Obligatoriu. Interogarea ShopifyQL de executat asupra datelor analitice ale magazinului dvs.

Interogare ShopifyQL

Puteți scrie orice interogare ShopifyQL validă folosind schemele acceptate, precum sales, sessions, inventory și payments. De exemplu, următoarea interogare returnează vânzările totale și numărul de clienți pentru ziua în care se execută fluxul de lucru:

FROM sales
  SHOW total_sales, customers
  SINCE today

Pentru referințele complete privind limbajul, inclusiv schemele, funcțiile și sintaxa acceptate, consultați documentația ShopifyQL.

Interogarea este validată atunci când salvați fluxul de lucru. Fluxul de lucru nu poate fi activat până când interogarea nu se execută cu succes pentru magazinul dvs.

Date returnate

Acțiunea Obține date analitice returnează rândurile care corespund interogării, disponibile ca o variabilă cu numele getAnalyticsData. Rândurile sunt stocate în getAnalyticsData.rows, unde fiecare rând este un obiect indexat după numele coloanelor din interogare.

Puteți folosi această variabilă atât în condițiile, cât și în acțiunile care urmează după acest pas. De exemplu, pentru a trimite un e-mail intern care afișează fiecare rând, puteți folosi limbajul Liquid într-un mod similar cu acesta:

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

Pentru a lucra cu fiecare rând în mod individual, de exemplu pentru a aplica o acțiune pentru fiecare rând, puteți folosi acțiunea Pentru fiecare buclă (iterare) cu getAnalyticsData.rows. Pentru a agrega valori, cum ar fi numărarea rândurilor sau însumarea unei coloane, puteți folosi acțiunile Numără și Însumează.

Referințe API

Pentru mai multe informații despre API-ul utilizat în această acțiune, consultați interogarea shopifyqlQuery din GraphQL Admin API.

Complexitatea interogării

Fiecare interogare ShopifyQL are un cost de complexitate care se calculează pe baza schemelor, coloanelor, filtrelor și a intervalului de timp utilizate în interogare. Dacă o interogare depășește limita de complexitate, acțiunea eșuează, iar fluxul de lucru nu poate fi activat. Pentru a reduce costul unei interogări, puteți să scurtați intervalul de timp sau să eliminați coloane și asocieri.

Pentru detalii privind modul de calculare a costului interogării și a limitelor actuale, consultați Limitarea ratei în ShopifyQL Admin API.