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

Η ενέργεια Λήψη δεδομένων στοιχείων ανάλυσης εκτελεί ένα επερώτημα ShopifyQL και επιστρέφει τα αποτελέσματα για χρήση στη ροή εργασίας σας. Η 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. Για να συγκεντρώσετε τιμές, όπως για να μετρήσετε γραμμές ή να αθροίσετε μια στήλη, μπορείτε να χρησιμοποιήσετε τις ενέργειες Καταμέτρηση και Άθροισμα.

Αναφορά API

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

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

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

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