Hämta analysdata

Åtgärden Hämta analysdata kör en ShopifyQL-förfrågan och returnerar resultaten för användning i ditt arbetsflöde. ShopifyQL är ett frågespråk som har byggts 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 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-förfrågan	Krävs. ShopifyQL-förfrågan som ska köras mot butikens analysdata.

ShopifyQL-förfrågan

Du kan skriva valfri giltig ShopifyQL-förfrågan genom att använda scheman som stöds, till exempel sales, sessions, inventory och payments. Följande förfrågan returnerar till exempel omsättning och antal kunder för den dag som arbetsflödet körs:

FROM sales
  SHOW total_sales, customers
  SINCE today

Den fullständiga språkreferensen, inklusive scheman, funktioner och syntax som stöds, finns i dokumentationen om ShopifyQL.

Förfrågan valideras när du sparar arbetsflödet. Arbetsflödet kan inte aktiveras förrän förfrågan har körts utan fel mot din butik.

Returnerade data

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

Du kan använda denna variabel 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 sätt som liknar detta:

{% 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 sammanställa värden, till exempel för att räkna rader eller summera en kolumn, kan du använda åtgärderna Räkna och Summera.

API-referens

Mer information om det API som används i denna åtgärd finns under förfrågan shopifyqlQuery i GraphQL Admin API.

Förfrågans komplexitet

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

Mer information om hur förfrågans kostnad beräknas och gällande gränser finns i Hastighetsbegränsning i ShopifyQL Admin API.