Hent analysedata

Handlingen Hent analysedata kjører en ShopifyQL-spørring og returnerer resultatene for bruk i arbeidsflyten. ShopifyQL er et spørringsspråk bygget for handelsanalyse. Du kan bruke det til å samle målestokker på tvers av tidsperioder, bruke filtre og gruppere etter dimensjoner som produkt, samling eller kunde. Dataene som returneres av denne handlingen, er tilgjengelige for betingelser og handlinger som følger trinnet.

Tips

ShopifyQL brukes også i Shopify-rapportene dine og til kundesegmentering. Du kan finne ut mer om ShopifyQL-spørringer og syntaks.

Utløsere

Handlingen Hent analysedata er bare kompatibel med utløseren Planlagt tid. Analysedata er ikke inkludert av hendelsesbaserte utløsere.

Konfigurasjon

Felt

Handlingen Hent analysedata inneholder følgende felt:

Felt som brukes i handlingen Hent analysedata.

Felt	Beskrivelse
ShopifyQL-spørring	Obligatorisk. ShopifyQL-spørringen som skal kjøres mot butikkens analysedata.

ShopifyQL-spørring

Du kan skrive en hvilken som helst gyldig ShopifyQL-spørring med støttede skjemaer, som sales, sessions, inventory og payments. Følgende spørring returnerer for eksempel salg i alt og antall kunder for dagen arbeidsflyten kjører:

FROM sales
  SHOW total_sales, customers
  SINCE today

For den fullstendige språkreferansen, inkludert støttede skjemaer, funksjoner og syntaks, kan du se dokumentasjonen for ShopifyQL.

Spørringen valideres når du lagrer arbeidsflyten. Arbeidsflyten kan ikke aktiveres før spørringen kjører vellykket mot butikken.

Returnerte data

Handlingen Hent analysedata returnerer radene som samsvarer med spørringen, tilgjengelig som en variabel med navnet getAnalyticsData. Radene lagres i getAnalyticsData.rows, der hver rad er et objekt identifisert med kolonnenavnene i spørringen din.

Du kan bruke denne variabelen i både betingelser og handlinger som følger trinnet. For å for eksempel sende en intern e-post som lister opp hver rad, kan du bruke Liquid som ligner på dette:

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

For å arbeide med hver rad individuelt, som å bruke en handling på hver rad, kan du bruke handlingen For hver sløyfe (iterer) med getAnalyticsData.rows. For å samle verdier, som å telle rader eller summere en kolonne, kan du bruke handlingene Tell og Summer.

Merk

Hvis en Hent data-handling brukes flere ganger i én enkelt arbeidsflyt, legges det til et tall i variabelnavnet. I en arbeidsflyt som for eksempel bruker handlingen Hent bestillingsdata to ganger, vil den første variabelen for returnerte data være getOrderData og den andre variabelen være getOrderData1. Dette navnet kan ikke tilpasses.

API-referanse

For mer informasjon om API-et som brukes i denne handlingen, kan du se spørringen shopifyqlQuery i GraphQL Admin API.

Spørringskompleksitet

Hver ShopifyQL-spørring har en kompleksitetskostnad som beregnes ut fra skjemaer, kolonner, filtre og tidsperiode som spørringen bruker. Hvis en spørring overskrider grensen for kompleksitet, vil handlingen mislykkes, og arbeidsflyten kan ikke aktiveres. For å redusere kostnaden for en spørring kan du korte ned tidsperioden eller fjerne kolonner eller koblinger.

For mer informasjon om hvordan spørringskostnader beregnes og gjeldende grenser kan du se Hastighetsbegrensning i ShopifyQL Admin API.