Hent kundedata
Hvis du har workflows, der bruger kundedata, kan du bruge handlingen Hent kundedata til at hente kundeoplysninger fra din butik.
Konfiguration
Felter
Handlingen Hent kundedata indeholder følgende felter, der bruges til at oprette forespørgslen:
| Felt | Beskrivelse |
|---|---|
| Sortér data efter | Påkrævet. De parametre, som de data der returneres af søgeforespørgslen, sorteres efter. |
| Det maksimale antal resultater | Påkrævet. Det maksimale antal resultater, der kan returneres af den valgte søgeforespørgsel. Du kan returnere op til 100 ad gangen. |
| Forespørgsel | Påkrævet. Vælg mellem almindelige forespørgsler, eller vælg Avanceret for at oprette din egen. |
Forespørgselsstreng
Dette er et eksempel på en forespørgsel, der henter kunder, som er blevet opdateret inden for den seneste dag:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variablen updated_at er et filter, der er tilgængeligt i Kundeforespørgsel, og som kan bruges flere gange eller kombineres med andre variabler. Liquid-variablen scheduledAt er tilgængelig i workflows, der bruger udløseren Planlagt tidspunkt. Liquid-tagget date_minus er et særligt Flow-tag, som giver dig mulighed for at trække tid fra en dato.
Når du forespørger om data, er det brugbart at vide:
- Liste over tilgængelige kundefiltre - Forespørgsler skal følge en bestemt syntaks
- Værdierne for forespørgselsfeltet er ikke altid dokumenteret. I nogle tilfælde kan du finde værdierne ved at kigge i API-dokumenterne. Du kan ofte også finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. gerne vil finde værdier for ordreforespørgsler, skal du filtrere siden Ordrer i administratoren og derefter tjekke webadressen.
- Du kan køre eller teste en forespørgsel i din butik ved hjælp af Shopify GraphiQL-appen.
- Vær opmærksom på, hvad der sker, hvis forespørgslen mislykkes. API’en returnerer ofte alle resultater (i stedet for ingen).
Returnerede data
Alle handlinger af typen Hent data returnerer en liste over 0-100 ressourcer. Du kan bruge disse data på forskellige måder afhængigt af dit brugsscenarie:
- Hvis du f.eks. skal håndtere hvert listeelement enkeltvis, f.eks. ved at tilføje et tag for hvert element, kan du bruge handlingen For each.
- Hvis du skal bruge aggregerede data, f.eks. optællinger af returnerede resultater, kan du bruge handlingerne Antal eller Sum.
- Hvis du skal sende listen ud, f.eks. ved at sende en mail med alle elementerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.
Hvis du vil tilgå de returnerede data i trin, der følger denne handling, skal du bruge variablen med navnet Hent kundedata, som er en liste over kunder. Du kan både bruge denne variabel i betingelser og handlinger. Du kan f.eks. sende listen over kunder i handlingen Send intern mail på følgende måde:
{% for single_customer in GetCustomerData %}
- {{ single_customer.name }}
{% endfor %}Triggere
Du kan bruge denne handling alle workflow, herunder udløseren Planlagt tid. I et workflow, der bruger udløseren Planlagt tid, starter workflowet på et tidspunkt, som du har angivet, i stedet for som følge af et event. Da der ikke er nogen specifik hændelse i din butik eller fra en app, der starter workflowet, inkluderes der ikke nogen data automatisk.
API-detaljer
Skabeloner
Konverter et kundemetafelt til tags for alle kunder
Dette workflow udfylder tags til alle dine kunder baseret på en metafeltværdi. Workflowet kører hver time og henter op til 100 kunder uden tagget “behandlet”. Workflowet kigger på værdien i et custom.test-metafelt for hver kunde og tilføjer den som et tag. Det tilføjer også tagget “behandlet”, så det ikke returneres i næste planlagte kørsel af workflowet. Hvis du vil bruge workflowet, skal du ændre metafeltets navneområde og nøgle, så de matcher et metafelt i din butik. Se skabelon
Slet inaktive kunder
Slet kunder, der er mere end 5 år gamle og aldrig har afgivet en ordre. Se skabelon