Obține date analitice

Acțiunea Obține date analitice execută o interogare ShopifyQL și returnează rezultatele pentru a fi utilizate în fluxul dvs. de lucru. ShopifyQL este un limbaj de interogare creat pentru date analitice din comerț. Îl puteți folosi pentru a agrega indicatori pe diverse perioade de timp, pentru a aplica filtre și pentru 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.

Sfat

ShopifyQL este utilizat, de asemenea, în rapoartele dvs. Shopify și în segmentarea clienților. Puteți afla mai multe despre interogările și sintaxa ShopifyQL.

Declanșatoare

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

Configurare

Câmpuri

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

Câmpuri utilizate în acțiunea Obține date analitice.

Câmp	Descriere
Interogare ShopifyQL	Obligatoriu. Interogarea ShopifyQL care se va executa asupra datelor analitice ale magazinului dvs.

Interogare ShopifyQL

Puteți scrie orice interogare ShopifyQL validă folosind schemele acceptate, cum ar fi 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ța completă a limbajului, 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 dvs., disponibile ca o variabilă numită getAnalyticsData. Rândurile sunt stocate în getAnalyticsData.rows, unde fiecare rând este un obiect indexat după numele coloanelor din interogarea dvs.

Puteți utiliza 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 listează fiecare rând, puteți utiliza cod Liquid 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 fiecărui rând, puteți utiliza acțiunea Buclă „pentru fiecare” (iterare) cu getAnalyticsData.rows. Pentru a agrega valori, cum ar fi numărarea rândurilor sau însumarea unei coloane, puteți utiliza acțiunile Numărare și Sumă.

Notă

Dacă o acțiune Obține date este utilizată de mai multe ori într-un singur flux de lucru, atunci la numele variabilei se adaugă un număr. De exemplu, într-un flux de lucru care utilizează acțiunea Obține datele comenzii de două ori, prima variabilă pentru datele returnate este getOrderData, iar a doua variabilă este getOrderData1. Acest nume nu poate fi personalizat.

Referință 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 pe care le utilizează interogarea. 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, să eliminați coloane sau să eliminați asocierile.

Pentru detalii despre modul în care este calculat costul interogării și despre limitele curente, consultați Limitarea ratei în ShopifyQL Admin API.