Hämta kunddata
I arbetsflöden som använder kunddata kan du använda åtgärden Hämta kunddata för att hämta kundinformation från din butik.
På den här sidan
Konfiguration
Fält
Åtgärden Hämta kunddata innehåller följande fält, som används för att bygga frågan:
| Fält | Beskrivning |
|---|---|
| Sortera data efter | Obligatoriskt. De parametrar som returnerad data från sökfrågan sorteras efter. |
| Maximalt antal resultat | Krävs. Det maximala antalet resultat som kan returneras av sökfrågan du väljer. Du kan returnera upp till 100 åt gången. |
| Sökfråga | Krävs. Välj bland vanliga sökfrågor eller välj Avancerat för att skapa en egen. |
Sökfrågesträng
Det här är ett exempel på en sökfråga för att hämta kunder som uppdaterades under det senaste dygnet:
updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'Variabeln updated_at är ett filter som är tillgängligt för kundsökfrågan och kan användas flera gånger eller kombineras med andra variabler. Liquid-variabeln scheduledAt är tillgänglig i arbetsflöden som använder utlösaren Schemalagd tid. Liquid-taggen date_minus är en särskild Flow-tagg som låter dig subtrahera tid från ett datum.
När du söker efter data kan det vara bra att känna till följande:
- Lista över tillgängliga kundfilter
- Sökfrågor måste följa en viss syntax
- Sökfrågefältvärden är inte alltid dokumenterade. I vissa fall kan värdena hittas genom att titta i API-dokumenten. Alternativt kan du ofta hitta fältvärdena i URL:erna i din adminpanel när du filtrerar. Om du till exempel vill hitta några värden för ordersökfrågor filtrerar du sidan Ordrar i din adminpanel och kontrollerar sedan URL:en.
- Du kan köra eller testa en sökfråga i din butik med hjälp av Shopify GraphiQL-appen.
- Var medveten om vad som händer om din sökfråga misslyckas. API:et returnerar ofta alla resultat (i stället för inga).
Returnerade data
Alla åtgärder för Hämta data returnerar en lista med 0 till 100 resurser. Beroende på ditt användningsfall kan du använda dessa data på olika sätt:
- Om du behöver hantera varje listobjekt individuellt, till exempel för att lägga till en tagg för varje, kan du använda åtgärden För varje.
- Om du behöver aggregera data, till exempel för att räkna hur många resultat som returnerades, kan du använda åtgärderna Räkna eller Summera.
- Om du behöver mata ut listan, till exempel för att skicka ett e-postmeddelande med alla artiklar, kan du använda returnerade data direkt i efterföljande åtgärder.
För att komma åt returnerade data i steg som följer efter den här åtgärden använder du variabeln med namnet Hämta kunddata, som är en lista över kunder. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan över ordrar i en Skicka internt e-postmeddelande-åtgärd så här:
{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}Utlösare
Du kan använda den här åtgärden i alla arbetsflöden, inklusive utlösaren Schemalagd tid. I ett arbetsflöde som använder utlösaren Schemalagd tid startar arbetsflödet vid en tidpunkt som du har angett, i stället för till följd av en händelse. Eftersom det inte finns någon specifik händelse i din butik eller från en app som startar arbetsflödet, inkluderas inga data automatiskt.
API-detaljer
Mallar
Konvertera ett kundmetafält till taggar för alla kunder
Det här arbetsflödet kompletterar med taggar för alla dina kunder baserat på ett metafältvärde. Det körs varje timme och hämtar upp till 100 kunder som inte har taggen ”bearbetad”. För varje kund tittar det på värdet för ett custom.test-metafält och lägger till det som en tagg. Arbetsflödet lägger även till taggen ”bearbetad” så att kunden inte returneras i nästa schemalagda körning av arbetsflödet. För att kunna använda arbetsflödet måste du ändra namnrymd och nyckel för metafältet så att de matchar ett metafält i din butik. Visa mall
Radera inaktiva kunder
Radera kunder som är äldre än 5 år och som aldrig har lagt en order. Visa mall