Hent analysedata

Handlingen Hent analysedata kører en ShopifyQL-forespørgsel og returnerer resultaterne til brug 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 som f.eks. produkt, kollektion eller kunde. De data, der returneres af denne handling, er tilgængelige for betingelser og handlinger, der 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 tid. 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 en hvilken som helst gyldig ShopifyQL-forespørgsel ved hjælp af understøttede skemaer som 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

Du kan finde den fulde sprogreference, herunder understøttede skemaer, funktioner og syntaks, i dokumentationen til ShopifyQL.

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

Returnerede data

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

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, der angiver hver række, kan du bruge Liquid, som minder om dette:

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

Hvis du vil arbejde med hver række individuelt, f.eks. for at anvende en handling for hver række, kan du bruge handlingen For each-løkke (iterer) med getAnalyticsData.rows. Hvis du vil samle værdier, f.eks. tælle rækker eller summere en kolonne, kan du bruge handlingerne Tæl og Sum.

Bemærk

Hvis handlingen Hent data bruges flere gange i det samme workflow, føjes der et tal til variabelnavnet. I et workflow, der f.eks. bruger handlingen Hent ordredata to gange, er den første variabel for returnerede data 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, i forespørgslen shopifyqlQuery i GraphQL Admin API.

Forespørgselskompleksitet

Hver ShopifyQL-forespørgsel har en kompleksitetsomkostning, der beregnes ud fra de skemaer, kolonner, filtre og tidsintervaller, som forespørgslen bruger. Hvis en forespørgsel overskrider kompleksitetsgrænsen, mislykkes handlingen, og dit workflow kan ikke aktiveres. Du kan reducere omkostningen for en forespørgsel ved at forkorte tidsintervallet, fjerne kolonner eller fjerne joins.

Du kan finde flere oplysninger om, hvordan forespørgselsomkostninger beregnes, og de aktuelle grænser i Hastighedsbegrænsning i ShopifyQL Admin API.