Klantgegevens ophalen

In workflows die klantgegevens gebruiken, kun je de actie Klantgegevens ophalen gebruiken om klantinformatie op te halen uit je winkel.

Opmerking

Dit is een type Gegevens ophalen-actie. Raadpleeg Workflows plannen, gegevens ophalen en herhalen in Shopify Flow voor meer informatie over hoe je dit type actie gebruikt met de Geplande tijd-trigger en Voor elke-loops.

Configuratie

Velden

De actie Klantgegevens ophalen bevat de volgende velden, die worden gebruikt om de query op te bouwen:

Velden die worden gebruikt in de acties Gegevens ophalen.

Veld	Beschrijving
Gegevens sorteren op	Vereist. De parameters waarop de gegevens die door de zoekopdracht worden geretourneerd, worden gesorteerd.
Maximum aantal resultaten	Vereist. Het maximale aantal resultaten dat kan worden geretourneerd door de zoekopdracht die je selecteert. Je kunt er maximaal 100 per keer retourneren.
Query	Vereist. Kies uit veelvoorkomende query's of selecteer Geavanceerd om er zelf een aan te maken.

Query-tekenreeks

Dit is een voorbeeld van een query om klanten op te halen die de afgelopen dag zijn bijgewerkt:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

De variabele updated_at is een filter die beschikbaar is voor de Klantenquery en kan meerdere keren worden gebruikt of worden gecombineerd met andere variabelen. De Liquid-variabele scheduledAt is beschikbaar in workflows die de trigger 'Geplande tijd' gebruiken. De Liquid-tag date_minus is een speciale Flow-tag waarmee je tijd van een datum kunt aftrekken.

Wanneer je gegevens opvraagt, is het handig om het volgende te weten:

• Lijst met beschikbare klantfilters
• Query's moeten een bepaalde syntaxis volgen
• De waarden van queryvelden zijn niet altijd gedocumenteerd. In sommige gevallen kun je de waarden vinden door in de API-documenten te kijken. Je kunt de veldwaarden ook vaak vinden in de URL's in het beheerpaneel wanneer je filtert. Als je bijvoorbeeld bepaalde waarden voor de Bestelling-query wilt vinden, filter je de pagina Bestellingen in het beheerpaneel en controleer je vervolgens de URL.
• Je kunt een query in je winkel uitvoeren of testen met de Shopify GraphiQL-app.
• Houd er rekening mee wat er gebeurt als je query mislukt. Vaak retourneert de API alle resultaten (in plaats van geen).

Geretourneerde gegevens

Alle acties van het type Gegevens ophalen retourneren een lijst van 0 tot 100 resources. Afhankelijk van je use-case, wil je deze gegevens misschien op verschillende manieren gebruiken:

• Als je elk lijstitem afzonderlijk moet verwerken, bijvoorbeeld om voor elk item een tag toe te voegen, kun je de actie Voor elke gebruiken.
• Als je gegevens moet aggregeren, bijvoorbeeld om te tellen hoeveel resultaten zijn geretourneerd, kun je de acties Tellen of Som gebruiken.
• Als je de lijst als uitvoer wilt gebruiken, bijvoorbeeld om een e-mail met alle artikelen te verzenden, kun je de geretourneerde gegevens rechtstreeks in de volgende acties gebruiken.

Om toegang te krijgen tot de geretourneerde gegevens in stappen die op deze actie volgen, gebruik je de variabele met de naam Klantgegevens ophalen. Dit is een lijst met klanten. Je kunt deze variabele zowel in voorwaarden als in acties gebruiken. Je kunt bijvoorbeeld de lijst met bestellingen verzenden in een actie Interne e-mail verzenden, zoals hier:

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

Opmerking

Als een actie Gegevens ophalen meerdere keren in één workflow wordt gebruikt, wordt er een nummer aan de naam van de variabele toegevoegd. In een workflow die de actie Bestelgegevens ophalen bijvoorbeeld twee keer gebruikt, is de eerste variabele voor geretourneerde gegevens getOrderData en de tweede getOrderData1. Deze naam kan niet worden aangepast.

Triggers

Je kunt deze actie in elke workflow gebruiken, inclusief de trigger Geplande tijd. In een workflow die de trigger Geplande tijd gebruikt, start de workflow op een door jou opgegeven tijdstip in plaats van naar aanleiding van een gebeurtenis. Omdat er geen specifieke gebeurtenis in je winkel of vanuit een app is die de workflow start, worden er niet automatisch gegevens meegestuurd.

API-gegevens

• Resource Klant
• Queryfilters voor klanten

Templates

Een metaveld voor klanten omzetten in tags voor alle klanten

Deze workflow vult tags aan voor al je klanten op basis van een metaveldwaarde. De workflow wordt elk uur uitgevoerd en haalt tot 100 klanten op die geen tag ‘verwerkt’ hebben. Voor elke klant wordt de waarde van een metaveld custom.test bekeken en als tag toegevoegd. De workflow voegt ook een tag ‘verwerkt’ toe, zodat deze niet wordt geretourneerd bij de volgende geplande run van de workflow. Om de workflow te gebruiken, moet je de naamruimte en sleutel van het metaveld wijzigen, zodat deze overeenkomen met een metaveld in je winkel. Template bekijken

Inactieve klanten verwijderen

Klanten verwijderen die ouder zijn dan 5 jaar en nog nooit een bestelling hebben geplaatst. Template bekijken