Hent kundedata
I arbeidsflyter som bruker kundedata, kan du bruke handlingen Hent kundedata til å hente kundeinformasjon fra butikken din.
På denne siden
Konfigurasjon
Felt
Handlingen Hent kundedata inneholder følgende felt, som brukes til å bygge søket:
| Felt | Beskrivelse |
|---|---|
| Sorter data etter | Obligatorisk. Parameterne som dataene som returneres av søket sorteres etter. |
| Maksimalt antall resultater | Obligatorisk. Maksimalt antall resultater som kan returneres av søket du velger. Du kan returnere opptil 100 om gangen. |
| Søk | Obligatorisk. Velg fra vanlige søk eller velg Avansert for å opprette ditt eget. |
Søkestreng
Dette er et eksempelsøk for å hente kunder som ble oppdatert i løpet av den siste dagen:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabelen updated_at er et filter som er tilgjengelig i Kundesøk, og kan brukes flere ganger eller kombineres med andre variabler. scheduledAt Liquid-variabelen er tilgjengelig i arbeidsflyter som bruker utløseren for planlagt tid. date_minus Liquid-taggen er en spesiell Flow-tagg som lar deg trekke fra tid fra en dato.
Når du søker etter data, er det nyttig å vite:
- Liste over tilgjengelige kundefiltre
- Søk må følge en bestemt syntaks
- Feltverdier for søk er ikke alltid dokumentert. I noen tilfeller kan verdiene finnes ved å se i API-dokumentasjonen. Alternativt kan du ofte finne feltverdiene i URL-adressene i administratorpanelet når du filtrerer. For å finne noen søkeverdier for bestillinger kan du for eksempel filtrere Ordre-siden i administratorpanelet og deretter sjekke URL-adressen.
- Du kan kjøre eller teste et søk i butikken din ved å bruke Shopify GraphiQL-appen.
- Vær oppmerksom på hva som skjer hvis søket mislykkes. Ofte vil API-et returnere alle resultater (i stedet for ingen).
Returnerte data
Alle Hent data-handlinger returnerer en liste med alt fra 0 til 100 ressurser. Avhengig av bruksområdet ditt, kan det være du vil bruke disse dataene på forskjellige måter:
- Hvis du trenger å håndtere hvert listeelement individuelt, for eksempel for å legge til en tagg for hvert av dem, kan du bruke handlingen For hver.
- Hvis du trenger å aggregere data, for eksempel telle hvor mange resultater som ble returnert, kan du bruke handlingene Tell eller Summer.
- Hvis du trenger å sende listen som utdata, for eksempel sende en e-post med alle varene, kan du bruke de returnerte dataene direkte i påfølgende handlinger.
For å få tilgang til de returnerte dataene i trinn som følger denne handlingen, bruker du variabelen med navnet Hent kundedata, som er en liste over kunder. Du kan bruke denne variabelen i både betingelser og handlinger. Du kan for eksempel sende listen over bestillinger i handlingen Send intern e-post slik:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Utløsere
Du kan bruke denne handlingen i enhver arbeidsflyt, inkludert utløseren Planlagt tid. I en arbeidsflyt som bruker utløseren Planlagt tid, starter arbeidsflyten på et tidspunkt du har angitt, i stedet for som et resultat av en hendelse. Fordi det ikke er noen spesifikk hendelse i butikken din eller fra en app som starter arbeidsflyten, inkluderes ingen data automatisk.
API-detaljer
Maler
Konverter et kundemetafelt til tagger for alle kunder
Denne arbeidsflyten fyller inn tagger på alle kundene dine basert på en metafeltverdi. Den kjører hver time og henter opptil 100 kunder som ikke har en «behandlet»-tagg. For hver kunde ser den på verdien av et custom.test-metafelt og legger den til som en tagg. Arbeidsflyten legger også til en «behandlet»-tagg, slik at den ikke blir returnert i neste planlagte kjøring av arbeidsflyten. For å bruke arbeidsflyten må du endre navnefeltet og nøkkelen for metafeltet slik at det samsvarer med et metafelt i butikken din. Vis mal
Slett inaktive kunder
Slett kunder som er over 5 år gamle og som aldri har lagt inn en bestilling. Vis mal