Hent kundedata

I workflows, der bruger kundedata, kan du bruge handlingen Hent kundedata til at hente kundeoplysninger fra din butik.

Bemærk

Dette er en type Hent data-handling. Hvis du vil have mere at vide om, hvordan du bruger denne type handling med udløseren Planlagt tidspunkt og For each-løkker, kan du se Tidsplaner, hent data og gentagne workflows i Shopify Flow.

Konfiguration

Felter

Handlingen Hent kundedata indeholder følgende felter, som bruges til at opbygge forespørgslen:

Felter, der bruges i Hent data-handlinger.

Felt	Beskrivelse
Sortér data efter	Påkrævet. De parametre, som de returnerede data fra søgeforespørgslen sorteres efter.
Maksimalt antal resultater	Obligatorisk. Det maksimale antal resultater, der kan returneres af den søgeforespørgsel, du vælger. Du kan returnere op til 100 ad gangen.
Forespørgsel	Obligatorisk. 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 til at hente kunder, der blev 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 forespørgslen Kunder, og kan bruges flere gange eller kombineres med andre variabler. scheduledAt Liquid-variablen er tilgængelig i workflows, der bruger udløseren Planlagt tid. date_minus Liquid-tagget er et særligt Flow-tag, der giver dig mulighed for at trække tid fra en dato.

Når du forespørger på data, er det en hjælp at vide:

• Liste over tilgængelige kundefiltre
• Forespørgsler skal følge en bestemt syntaks
• Feltværdier for forespørgsler er ikke altid dokumenterede. I nogle tilfælde kan værdierne findes ved at kigge i API-dokumentationen. Alternativt kan du ofte finde feltværdierne i webadresserne i administratoren, når du filtrerer. Hvis du f.eks. vil finde nogle forespørgselsværdier for ordrer, 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 din forespørgsel mislykkes. Ofte returnerer API'en alle resultater (i stedet for ingen).

Returnerede data

Alle handlinger af typen Hent data returnerer en liste med mellem 0 og 100 ressourcer. Afhængigt af dit anvendelsesformål kan du bruge disse data på forskellige måder:

• Hvis du har brug for at håndtere hvert listeelement individuelt, f.eks. for at tilføje et tag til hvert enkelt, kan du bruge handlingen For hvert.
• Hvis du har brug for at aggregere data, f.eks. for at tælle, hvor mange resultater der blev returneret, kan du bruge handlingerne Tæl eller Sum.
• Hvis du har brug for at bruge listen som output, f.eks. til at sende en mail med alle varerne, kan du bruge de returnerede data direkte i efterfølgende handlinger.

For at få adgang til de returnerede data i trin, der følger efter denne handling, skal du bruge variablen med navnet Hent kundedata, som er en liste over kunder. Du kan bruge denne variabel i både betingelser og handlinger. Du kan f.eks. sende listen over ordrer i handlingen Send intern mail på denne måde:

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

Bemærk

Hvis handlingen Hent data bruges flere gange i det samme workflow, tilføjes der et tal til variablens navn. I et workflow, der f.eks. bruger handlingen Hent ordredata to gange, er den første variabel for returnerede data getOrderData, og den anden variabel er getOrderData1. Dette navn kan ikke tilpasses.

Udløsere

Du kan bruge denne handling i alle workflows, herunder udløseren Planlagt tid. I et workflow, der bruger udløseren Planlagt tid, starter workflowet på et tidspunkt, du har angivet, i stedet for som resultat af en hændelse. Da der ikke er nogen specifik hændelse i din butik eller fra en app, der starter workflowet, medtages der ikke automatisk nogen data.

API-oplysninger

• Kunderessource
• Forespørgselsfiltre for kunder

Skabeloner

Konverter et kundemetafelt til tags for alle kunder

Dette workflow udfylder tags på alle dine kunder baseret på en metafeltværdi. Det kører hver time og henter op til 100 kunder, der ikke har tagget “behandlet”. For hver kunde ser det på værdien af et custom.test-metafelt og tilføjer det som et tag. Workflowet tilføjer også tagget “behandlet”, så det ikke returneres i den næste planlagte kørsel af workflowet. For at 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 over 5 år gamle, og som aldrig har afgivet en ordre. Se skabelon