Hent analysedata

Handlingen Hent analysedata kører en ShopifyQL-forespørgsel og returnerer resultaterne, så de kan bruges i dit workflow. ShopifyQL er et forespørgselssprog, der er udviklet til handelsanalyse. Du kan bruge det til at samle metrikværdier på tværs af tidsperioder, anvende filtre og gruppere efter dimensioner såsom produkt, kollektion eller kunde. De data, der returneres af denne handling, er tilgængelige for betingelser og handlinger, som følger efter trinnet.

Tip

ShopifyQL bruges også i dine Shopify-rapporter og kundesegmentering. Du kan få mere at vide om ShopifyQL-forespørgsler og syntaks.

Udløsere

Handlingen Hent analysedata er kun kompatibel med udløseren Planlagt tidspunkt. Analysedata inkluderes ikke af hændelsesbaserede udløsere.

Konfiguration

Felter

Handlingen Hent analysedata indeholder følgende felt:

Felter, der bruges i handlingen Hent analysedata.

Felt	Beskrivelse
ShopifyQL-forespørgsel	Påkrævet. ShopifyQL-forespørgslen, der skal køres mod din butiks analysedata.

ShopifyQL-forespørgsel

Du kan skrive enhver gyldig ShopifyQL-forespørgsel ved hjælp af understøttede skemaer, som f.eks. sales, sessions, inventory og payments. Følgende forespørgsel returnerer f.eks. salg i alt og antallet af kunder for den dag, hvor dit workflow kører:

FROM sales
  SHOW total_sales, customers
  SINCE today

Se ShopifyQL-dokumentationen for at få den fulde sprogreference, herunder understøttede skemaer, funktioner og syntaks.

Forespørgslen valideres, når du gemmer dit workflow. Workflowet kan ikke aktiveres, før forespørgslen er blevet kørt korrekt mod din butik.

Returnerede data

Handlingen Hent analysedata returnerer de rækker, der matcher din forespørgsel, og de er tilgængelige som en variabel med navnet getAnalyticsData. Rækkerne gemmes i getAnalyticsData.rows, hvor hver række er et objekt med kolonnenavnene i din forespørgsel som nøgler.

Du kan bruge denne variabel i både betingelser og handlinger, der følger efter trinnet. Hvis du f.eks. vil sende en intern mail med en liste over hver række, kan du bruge Liquid på en måde, der minder om dette:

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

For at arbejde med hver enkelt række, som f.eks. at anvende en handling for hver række, kan du bruge handlingen For hver-løkke (iterer) med getAnalyticsData.rows. For at aggregere værdier, som f.eks. at tælle rækker eller lægge en kolonne sammen, kan du bruge handlingerne Tæl og Sum.

Bemærk

Hvis en Hent data-handling bruges flere gange i et enkelt workflow, tilføjes der et tal til variabelnavnet. I et workflow, der bruger handlingen Hent ordredata to gange, er den første variabel for returnerede data f.eks. getOrderData, og den anden variabel er getOrderData1. Dette navn kan ikke tilpasses.

API-reference

Du kan finde flere oplysninger om den API, der bruges i denne handling, under forespørgslen shopifyqlQuery i GraphQL Admin API.

Forespørgselskompleksitet

Hver ShopifyQL-forespørgsel har en kompleksitetsomkostning, som beregnes ud fra de skemaer, kolonner, filtre og det tidsinterval, som forespørgslen bruger. Hvis en forespørgsel overskrider kompleksitetsgrænsen, mislykkes handlingen, og workflowet kan ikke aktiveres. Hvis du vil reducere omkostningen for en forespørgsel, kan du forkorte tidsintervallet, fjerne kolonner eller fjerne sammenkædninger.

Se Hastighedsbegrænsning i ShopifyQL Admin API for at få flere oplysninger om, hvordan forespørgselsomkostningen beregnes, og hvad de nuværende grænser er.