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 handelsanalyser. Du kan bruke det til å samle målestokker over 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 tidspunkt. Analysedata inkluderes ikke 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 enhver gyldig ShopifyQL-spørring ved hjelp av støttede skjemaer, for eksempel sales, sessions, inventory og payments. Følgende spørring returnerer for eksempel salg i alt og antall kunder for den dagen arbeidsflyten kjører:

FROM sales
  SHOW total_sales, customers
  SINCE today

For hele språkreferansen, inkludert støttede skjemaer, funksjoner og syntaks, kan du se ShopifyQL-dokumentasjonen.

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

Returnerte data

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

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

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

For å jobbe med hver rad individuelt, for eksempel for å bruke en handling for hver rad, kan du bruke handlingen For hver-løkke (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 en enkelt arbeidsflyt, legges det til et tall i variabelnavnet. I en arbeidsflyt som for eksempel bruker handlingen Hent bestillingsdata to ganger, er den første variabelen for returnerte data getOrderData, og den andre variabelen er 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 skjemaene, kolonnene, filtrene og tidsintervallet som spørringen bruker. Hvis en spørring overskrider kompleksitetsgrensen, vil handlingen mislykkes og arbeidsflyten kan ikke aktiveres. For å redusere kostnaden for en spørring, kan du forkorte tidsintervallet, fjerne kolonner eller fjerne sammenføyninger (joins).

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