Λήψη στοιχείων ανάλυσης

Η ενέργεια Λήψη στοιχείων ανάλυσης εκτελεί ένα ερώτημα ShopifyQL και επιστρέφει τα αποτελέσματα για χρήση στη ροή εργασίας σας. Το ShopifyQL είναι μια γλώσσα επερωτημάτων σχεδιασμένη για τα στοιχεία ανάλυσης εμπορίου. Μπορείτε να το χρησιμοποιήσετε για να συγκεντρώσετε ποσοτικά μεγέθη σε διάφορες χρονικές περιόδους, να εφαρμόσετε φίλτρα και να τα ομαδοποιήσετε βάσει ποιοτικών μεταβλητών, όπως το προϊόν, η συλλογή ή ο πελάτης. Τα δεδομένα που επιστρέφει αυτή η ενέργεια είναι διαθέσιμα για τις συνθήκες και τις ενέργειες που ακολουθούν το βήμα.

Συμβουλή

Το ShopifyQL χρησιμοποιείται επίσης στις αναφορές σας στο Shopify και στην τμηματοποίηση πελατών. Μπορείτε να μάθετε περισσότερα για τα ερωτήματα και τη σύνταξη του ShopifyQL.

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

Η ενέργεια Λήψη στοιχείων ανάλυσης είναι συμβατή μόνο με το στοιχείο ενεργοποίησης Προγραμματισμένος χρόνος. Τα στοιχεία ανάλυσης δεν περιλαμβάνονται από στοιχεία ενεργοποίησης που βασίζονται σε συμβάντα.

Διαμόρφωση

Πεδία

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

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

Πεδίο	Περιγραφή
Ερώτημα ShopifyQL	Απαιτείται. Το ερώτημα ShopifyQL προς εκτέλεση στα στοιχεία ανάλυσης του καταστήματός σας.

Ερώτημα ShopifyQL

Μπορείτε να γράψετε οποιοδήποτε έγκυρο ερώτημα ShopifyQL χρησιμοποιώντας υποστηριζόμενα σχήματα, όπως sales, sessions, inventory και payments. Για παράδειγμα, το ακόλουθο ερώτημα επιστρέφει τις συνολικές πωλήσεις και τον αριθμό των πελατών για την ημέρα που εκτελείται η ροή εργασίας:

FROM sales
  SHOW total_sales, customers
  SINCE today

Για την πλήρη αναφορά της γλώσσας, συμπεριλαμβανομένων των υποστηριζόμενων σχημάτων, των συναρτήσεων και της σύνταξης, ανατρέξτε στην τεκμηρίωση του ShopifyQL.

Το ερώτημα επικυρώνεται όταν αποθηκεύετε τη ροή εργασίας. Η ροή εργασίας δεν μπορεί να ενεργοποιηθεί έως ότου το ερώτημα εκτελεστεί με επιτυχία στο κατάστημά σας.

Δεδομένα που επιστρέφονται

Η ενέργεια Λήψη στοιχείων ανάλυσης επιστρέφει τις σειρές που ταιριάζουν στο ερώτημά σας, διαθέσιμες ως μεταβλητή με το όνομα getAnalyticsData. Οι σειρές αποθηκεύονται στο getAnalyticsData.rows, όπου κάθε σειρά είναι ένα αντικείμενο με κλειδιά τα ονόματα των στηλών στο ερώτημά σας.

Μπορείτε να χρησιμοποιήσετε αυτήν τη μεταβλητή τόσο στις συνθήκες όσο και στις ενέργειες που ακολουθούν το βήμα. Για παράδειγμα, για να στείλετε ένα εσωτερικό email που παραθέτει κάθε σειρά, μπορείτε να χρησιμοποιήσετε κώδικα Liquid παρόμοιο με τον εξής:

{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}

Για να εργαστείτε με κάθε σειρά ξεχωριστά, όπως για να εφαρμόσετε μια ενέργεια για κάθε σειρά, μπορείτε να χρησιμοποιήσετε την ενέργεια Βρόχος for each (επανάληψη) με το getAnalyticsData.rows. Για να συγκεντρώσετε τιμές, όπως για την καταμέτρηση σειρών ή το άθροισμα μιας στήλης, μπορείτε να χρησιμοποιήσετε τις ενέργειες Καταμέτρηση και Άθροισμα.

Σημείωση

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

Αναφορά API

Για περισσότερες πληροφορίες σχετικά με το API που χρησιμοποιείται σε αυτήν την ενέργεια, ανατρέξτε στο ερώτημα shopifyqlQuery στο GraphQL Admin API.

Πολυπλοκότητα ερωτήματος

Κάθε ερώτημα ShopifyQL έχει ένα κόστος πολυπλοκότητας το οποίο υπολογίζεται από τα σχήματα, τις στήλες, τα φίλτρα και το χρονικό εύρος που χρησιμοποιεί το ερώτημα. Εάν ένα ερώτημα υπερβεί το όριο πολυπλοκότητας, τότε η ενέργεια αποτυγχάνει και η ροή εργασίας δεν μπορεί να ενεργοποιηθεί. Για να μειώσετε το κόστος ενός ερωτήματος, μπορείτε να μικρύνετε το χρονικό εύρος, να αφαιρέσετε στήλες ή να αφαιρέσετε συνδέσεις.

Για λεπτομέρειες σχετικά με το πώς υπολογίζεται το κόστος του ερωτήματος και τα τρέχοντα όρια, ανατρέξτε στην ενότητα Περιορισμός ρυθμού (Rate limiting) στο ShopifyQL Admin API.