Λήψη δεδομένων πελάτη

Σε ροές εργασίας που χρησιμοποιούν δεδομένα πελατών, μπορείτε να χρησιμοποιήσετε την ενέργεια Λήψη δεδομένων πελάτη για να ανακτήσετε πληροφορίες πελατών από το κατάστημά σας.

Σημείωση

Αυτός είναι ένας τύπος ενέργειας Λήψη δεδομένων. Για να κατανοήσετε πώς να χρησιμοποιείτε αυτόν τον τύπο ενέργειας με το στοιχείο ενεργοποίησης Προγραμματισμένη ώρα και τους βρόχους Για κάθε, ανατρέξτε στο Προγραμματισμοί, λήψη δεδομένων και επαναλαμβανόμενες ροές εργασίας στο Shopify Flow.

Διαμόρφωση

Πεδία

Η ενέργεια Λήψη δεδομένων πελάτη περιέχει τα παρακάτω πεδία, τα οποία χρησιμοποιούνται για τη δημιουργία του ερωτήματος:

Πεδία που χρησιμοποιούνται στις ενέργειες «Λήψη δεδομένων».

Πεδίο	Περιγραφή
Ταξινόμηση δεδομένων κατά	Υποχρεωτικό. Οι παράμετροι με βάση τις οποίες ταξινομούνται τα δεδομένα που επιστρέφονται από το ερώτημα αναζήτησης.
Μέγιστος αριθμός αποτελεσμάτων	Απαιτείται. Ο μέγιστος αριθμός αποτελεσμάτων που μπορεί να επιστραφεί από το ερώτημα αναζήτησης που επιλέγετε. Μπορείτε να επιστρέψετε έως και 100 κάθε φορά.
Ερώτημα	Απαιτείται. Επιλέξτε από κοινά ερωτήματα ή επιλέξτε Για προχωρημένους για να δημιουργήσετε το δικό σας.

Συμβολοσειρά ερωτήματος

Αυτό είναι ένα παράδειγμα ερωτήματος για τη λήψη πελατών που ενημερώθηκαν την τελευταία ημέρα:

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

Η μεταβλητή updated_at είναι ένα φίλτρο διαθέσιμο στο ερώτημα «Πελάτες» και μπορεί να χρησιμοποιηθεί πολλές φορές ή να συνδυαστεί με άλλες μεταβλητές. Η μεταβλητή Liquid scheduledAt είναι διαθέσιμη σε ροές εργασίας που χρησιμοποιούν το στοιχείο ενεργοποίησης «Προγραμματισμένη ώρα». Η ετικέτα Liquid date_minus είναι μια ειδική ετικέτα του Flow που σας επιτρέπει να αφαιρείτε χρόνο από μια ημερομηνία.

Κατά την υποβολή ερωτημάτων για δεδομένα, είναι χρήσιμο να γνωρίζετε τα εξής:

• Λίστα με τα διαθέσιμα φίλτρα πελατών
• Τα ερωτήματα πρέπει να ακολουθούν μια συγκεκριμένη σύνταξη
• Οι τιμές των πεδίων ερωτημάτων δεν τεκμηριώνονται πάντα. Σε ορισμένες περιπτώσεις, οι τιμές μπορούν να βρεθούν ανατρέχοντας στην τεκμηρίωση του API. Εναλλακτικά, μπορείτε συχνά να βρείτε τις τιμές των πεδίων στα URL στον πίνακα διαχειριστή όταν εφαρμόζετε φίλτρα. Για παράδειγμα, για να βρείτε ορισμένες τιμές ερωτημάτων παραγγελίας, φιλτράρετε τη σελίδα «Παραγγελίες» στον πίνακα διαχειριστή και, στη συνέχεια, ελέγξτε το URL.
• Μπορείτε να εκτελέσετε ή να δοκιμάσετε ένα ερώτημα στο κατάστημά σας χρησιμοποιώντας την εφαρμογή Shopify GraphiQL.
• Προσέξτε τι συμβαίνει αν το ερώτημά σας αποτύχει. Συχνά, το API θα επιστρέψει όλα τα αποτελέσματα (αντί για κανένα).

Επιστρεφόμενα δεδομένα

Όλες οι ενέργειες «Λήψη δεδομένων» επιστρέφουν μια λίστα από 0 έως 100 πόρους. Ανάλογα με την περίπτωση χρήσης σας, μπορεί να θέλετε να χρησιμοποιήσετε αυτά τα δεδομένα με διάφορους τρόπους:

• Αν χρειάζεται να διαχειριστείτε κάθε στοιχείο της λίστας ξεχωριστά, για παράδειγμα για να προσθέσετε μια ετικέτα σε καθένα, τότε μπορείτε να χρησιμοποιήσετε την ενέργεια «Για κάθε».
• Αν χρειάζεται να συγκεντρώσετε δεδομένα, για παράδειγμα να μετρήσετε πόσα αποτελέσματα επιστράφηκαν, τότε μπορείτε να χρησιμοποιήσετε τις ενέργειες «Καταμέτρηση» ή «Άθροισμα».
• Αν χρειάζεται να εξάγετε τη λίστα, για παράδειγμα να στείλετε ένα email με όλα τα στοιχεία, τότε μπορείτε να χρησιμοποιήσετε τα επιστρεφόμενα δεδομένα απευθείας σε επόμενες ενέργειες.

Για να αποκτήσετε πρόσβαση στα επιστρεφόμενα δεδομένα σε βήματα που ακολουθούν αυτήν την ενέργεια, χρησιμοποιήστε τη μεταβλητή με το όνομα Get customer data (Λήψη δεδομένων πελάτη), η οποία είναι μια λίστα πελατών. Μπορείτε να χρησιμοποιήσετε αυτήν τη μεταβλητή τόσο σε συνθήκες όσο και σε ενέργειες. Για παράδειγμα, μπορείτε να στείλετε τη λίστα των παραγγελιών σε μια ενέργεια Αποστολή εσωτερικού email ως εξής:

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

Σημείωση

Αν μια ενέργεια «Λήψη δεδομένων» χρησιμοποιείται πολλές φορές σε μία ροή εργασίας, τότε προστίθεται ένας αριθμός στο όνομα της μεταβλητής. Για παράδειγμα, σε μια ροή εργασίας που χρησιμοποιεί την ενέργεια Get order data (Λήψη δεδομένων παραγγελίας) δύο φορές, η πρώτη μεταβλητή για τα επιστρεφόμενα δεδομένα είναι getOrderData και η δεύτερη μεταβλητή είναι getOrderData1. Αυτό το όνομα δεν μπορεί να προσαρμοστεί.

Στοιχεία ενεργοποίησης

Μπορείτε να χρησιμοποιήσετε αυτήν την ενέργεια σε οποιαδήποτε ροή εργασίας, συμπεριλαμβανομένου του στοιχείου ενεργοποίησης «Προγραμματισμένη ώρα». Σε μια ροή εργασίας που χρησιμοποιεί το στοιχείο ενεργοποίησης «Προγραμματισμένη ώρα», η ροή εργασίας ξεκινά σε μια ώρα που έχετε καθορίσει, αντί ως αποτέλεσμα ενός συμβάντος. Επειδή δεν υπάρχει κάποιο συγκεκριμένο συμβάν στο κατάστημά σας ή από μια εφαρμογή που ξεκινά τη ροή εργασίας, δεν περιλαμβάνονται αυτόματα δεδομένα.

Λεπτομέρειες API

• Πόρος πελάτη
• Φίλτρα ερωτημάτων πελατών

Πρότυπα

Μετατροπή ενός μετα-πεδίου πελάτη σε ετικέτες για όλους τους πελάτες

Αυτή η ροή εργασίας θα συμπληρώσει ετικέτες σε όλους τους πελάτες σας με βάση μια τιμή μετα-πεδίου. Εκτελείται κάθε ώρα και ανακτά έως και 100 πελάτες που δεν έχουν την ετικέτα «processed». Για κάθε πελάτη, εξετάζει την τιμή ενός μετα-πεδίου custom.test και την προσθέτει ως ετικέτα. Η ροή εργασίας προσθέτει επίσης μια ετικέτα «processed», ώστε να μην επιστρέφεται στην επόμενη προγραμματισμένη εκτέλεση της ροής εργασίας. Για να χρησιμοποιήσετε τη ροή εργασίας, θα χρειαστεί να αλλάξετε τον χώρο ονομάτων και το κλειδί του μετα-πεδίου ώστε να αντιστοιχούν σε ένα μετα-πεδίο στο κατάστημά σας. Προβολή προτύπου

Διαγραφή ανενεργών πελατών

Διαγραφή πελατών ηλικίας άνω των 5 ετών που δεν έχουν υποβάλει ποτέ παραγγελία. Προβολή προτύπου