Pobierz dane analityczne

Akcja Pobierz dane analityczne uruchamia zapytanie ShopifyQL i zwraca wyniki do wykorzystania w przepływie pracy. ShopifyQL to język zapytań stworzony na potrzeby analiz handlowych. Możesz go użyć do agregowania metryk w różnych okresach, stosowania filtrów oraz grupowania według wymiarów takich 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 oraz przy segmentacji klientów. Możesz dowiedzieć się więcej o zapytaniach i składni ShopifyQL.

Wyzwalacze

Akcja Pobierz dane analityczne jest kompatybilna tylko z wyzwalaczem Zaplanowany czas. Dane analityczne nie są dołączane przez wyzwalacze oparte na zdarzeniach.

Konfiguracja

Pola

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

Pola używane 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 prawidłowe zapytanie ShopifyQL przy użyciu obsługiwanych schematów, takich jak sales, sessions, inventory i payments. Przykładowo, poniższe zapytanie zwraca łączną sprzedaż i liczbę klientów dla dnia uruchomienia przepływu pracy:

FROM sales
  SHOW total_sales, customers
  SINCE today

Pełną dokumentację języka, w tym obsługiwane schematy, funkcje i składnię, można znaleźć w dokumentacji języka ShopifyQL.

Zapytanie jest walidowane po zapisaniu przepływu pracy. Przepływu pracy nie można aktywować, dopóki zapytanie nie zostanie pomyślnie uruchomione względem sklepu.

Zwracane dane

Akcja Pobierz dane analityczne zwraca wiersze pasujące do zapytania, dostępne jako zmienna o nazwie getAnalyticsData. Wiersze są przechowywane w parametrze getAnalyticsData.rows, gdzie każdy wiersz jest obiektem, dla którego kluczami są nazwy kolumn z zapytania.

Zmiennej tej możesz użyć zarówno w warunkach, jak i w akcjach po tym kroku. Na przykład, aby wysłać wewnętrzny e-mail zawierający listę wszystkich wierszy, możesz użyć kodu Liquid podobnego do tego:

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

Aby pracować z każdym wierszem indywidualnie, na przykład w celu zastosowania akcji dla każdego wiersza, możesz użyć akcji Pętla For each (iteracja) z parametrem getAnalyticsData.rows. Aby agregować wartości, np. zliczyć wiersze lub zsumować kolumnę, użyj akcji Zlicz 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, w którym dwukrotnie użyto akcji Pobierz dane zamówienia, pierwszą zmienną dla zwróconych danych jest getOrderData, a drugą – getOrderData1. Nazwy tej nie można dostosować.

Dokumentacja API

Aby dowiedzieć się więcej o API używanym w tej akcji, zapoznaj się z zapytaniem shopifyqlQuery w interfejsie GraphQL Admin API.

Złożoność zapytań

Każde zapytanie ShopifyQL ma koszt złożoności obliczany na podstawie użytych w nim schematów, kolumn, filtrów i przedziałów czasowych. 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ć przedział czasowy albo usunąć kolumny lub łączenia.

Szczegółowe informacje o tym, jak obliczany jest koszt zapytań i jakie są aktualne limity, znajdziesz w sekcji Limity częstotliwości żądań w interfejsie ShopifyQL Admin API.