Hämta analysdata

Åtgärden Hämta analysdata kör en ShopifyQL-fråga och returnerar resultaten för användning i ditt arbetsflöde. ShopifyQL är ett frågespråk som har skapats för handelsanalys. Du kan använda det för att aggregera mätvärden över tidsperioder, tillämpa filter och gruppera efter dimensioner såsom produkt, produktserie eller kund. Data som returneras av denna åtgärd är tillgängliga för villkor och åtgärder som följer efter steget.

På den här sidan

Utlösare

Åtgärden Hämta analysdata är endast kompatibel med utlösaren Schemalagd tid. Analysdata inkluderas inte av händelsebaserade utlösare.

Konfiguration

Fält

Åtgärden Hämta analysdata innehåller följande fält:

Fält som används i åtgärden Hämta analysdata.
Fält	Beskrivning
ShopifyQL-fråga	Krävs. ShopifyQL-frågan som ska köras mot din butiks analysdata.

ShopifyQL-fråga

Du kan skriva vilken giltig ShopifyQL-fråga som helst med hjälp av scheman som stöds, till exempel sales, sessions, inventory och payments. Följande fråga returnerar exempelvis omsättningen och antalet kunder för den dag då arbetsflödet körs:

FROM sales
  SHOW total_sales, customers
  SINCE today

För en fullständig språkreferens, inklusive scheman som stöds, funktioner och syntax, se ShopifyQL-dokumentationen.

Frågan valideras när du sparar arbetsflödet. Arbetsflödet kan inte aktiveras förrän frågan har körts framgångsrikt mot din butik.

Returnerade data

Åtgärden Hämta analysdata returnerar de rader som matchar din fråga, tillgängliga som en variabel med namnet getAnalyticsData. Raderna lagras i getAnalyticsData.rows, där varje rad är ett objekt med kolumnnamnen i din fråga som nycklar.

Du kan använda den här variabeln i både villkor och åtgärder som följer steget. För att till exempel skicka ett internt e-postmeddelande som listar varje rad kan du använda Liquid på ett liknande sätt som följande:

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

För att arbeta med varje rad individuellt, till exempel för att tillämpa en åtgärd på varje rad, kan du använda åtgärden För varje-loop (iterera) med getAnalyticsData.rows. För att aggregera värden, till exempel räkna rader eller summera en kolumn, kan du använda åtgärderna Räkna och Summa.

API-referens

För mer information om det API som används i denna åtgärd, se shopifyqlQuery-frågan i GraphQL Admin API.

Frågans komplexitet

Varje ShopifyQL-fråga har en komplexitetskostnad som beräknas utifrån de scheman, kolumner, filter och tidsintervall som frågan använder. Om en fråga överskrider komplexitetsgränsen misslyckas åtgärden och arbetsflödet kan inte aktiveras. För att minska kostnaden för en fråga kan du förkorta tidsintervallet, ta bort kolumner eller ta bort kopplingar.

För information om hur frågekostnaden beräknas och vilka de aktuella gränserna är, se Hastighetsbegränsning i ShopifyQL Admin API.