Pobierz dane analityczne

Akcja Pobierz dane analityczne uruchamia zapytanie w języku ShopifyQL i zwraca wyniki do użycia w przepływie pracy. ShopifyQL to język zapytań stworzony na potrzeby analiz handlowych. Za jego pomocą można agregować metryki z różnych okresów, stosować filtry i grupować według takich wymiarów, jak produkt, kolekcja lub klient. Dane zwrócone przez tę akcję są dostępne dla warunków i akcji następujących po tym kroku.

Wskazówka

Język ShopifyQL jest również używany w raportach Shopify i podczas segmentacji klientów. Dowiedz się więcej o zapytaniach i składni języka ShopifyQL.

Wyzwalacze

Akcja Pobierz dane analityczne jest kompatybilna tylko z wyzwalaczem Zaplanowany czas. Dane analityczne nie są uwzględniane przez wyzwalacze oparte na zdarzeniach.

Konfiguracja

Pola

Akcja Pobierz dane analityczne zawiera następujące pole:

Pola użyte w akcji Pobierz dane analityczne.

Pole	Opis
Zapytanie ShopifyQL	Wymagane. Zapytanie ShopifyQL do uruchomienia względem danych analitycznych sklepu.

Zapytanie ShopifyQL

Możesz napisać dowolne poprawne zapytanie ShopifyQL, używając obsługiwanych schematów, takich jak sales, sessions, inventory i payments. Na przykład poniższe zapytanie zwraca łączną sprzedaż i liczbę klientów dla dnia, w którym odbywa się przebieg przepływu pracy:

FROM sales
  SHOW total_sales, customers
  SINCE today

Aby zapoznać się z pełną dokumentacją języka, w tym z obsługiwanymi schematami, funkcjami i składnią, zapoznaj się z dokumentacją języka ShopifyQL.

Zapytanie jest sprawdzane podczas zapisywania przepływu pracy. Przepływu pracy nie można aktywować, dopóki zapytanie nie zostanie pomyślnie wykonane w sklepie.

Zwrócone dane

Akcja Pobierz dane analityczne zwraca wiersze pasujące do zapytania, dostępne jako zmienna o nazwie getAnalyticsData. Wiersze są przechowywane w getAnalyticsData.rows, gdzie każdy wiersz jest obiektem identyfikowanym przez nazwy kolumn w zapytaniu.

Możesz użyć tej zmiennej zarówno w warunkach, jak i akcjach następujących po tym kroku. Na przykład, aby wysłać wewnętrzny e-mail z listą wszystkich wierszy, możesz użyć języka Liquid w podobny sposób:

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

Aby pracować z każdym wierszem indywidualnie, np. zastosować akcję dla każdego wiersza, możesz użyć akcji Pętla dla każdego (iteruj) z getAnalyticsData.rows. Aby agregować wartości, np. zliczać wiersze lub sumować kolumnę, możesz użyć akcji Policz i Zsumuj.

Uwaga

Jeśli akcja Pobierz dane jest używana wielokrotnie w jednym przepływie pracy, do nazwy zmiennej dodawana jest liczba. Na przykład w przepływie pracy, który dwukrotnie wykorzystuje akcję Pobierz dane zamówienia, pierwszą zmienną dla zwróconych danych jest getOrderData, a drugą zmienną jest getOrderData1. Tej nazwy nie można dostosować.

Dokumentacja API

Więcej informacji o interfejsie API używanym w tej akcji można znaleźć w zapytaniu shopifyqlQuery w interfejsie GraphQL Admin API.

Złożoność zapytania

Każde zapytanie ShopifyQL wiąże się z kosztem złożoności obliczanym na podstawie schematów, kolumn, filtrów i zakresu czasu używanych przez zapytanie. Jeśli zapytanie przekroczy limit złożoności, akcja zakończy się niepowodzeniem, a przepływ pracy nie będzie mógł zostać aktywowany. Aby zmniejszyć koszt zapytania, możesz skrócić zakres czasu lub usunąć kolumny czy złączenia.

Szczegółowe informacje o sposobie obliczania kosztu zapytania oraz o obecnych limitach można znaleźć w artykule Ograniczenie przepustowości w ShopifyQL Admin API.