Získať analytické údaje

Akcia Získať analytické údaje spustí dopyt ShopifyQL a vráti výsledky na použitie v pracovnom postupe. ShopifyQL je dotazovací jazyk vytvorený pre analytiku obchodu. Môžete ho použiť na agregáciu metrík za rôzne časové obdobia, aplikovanie filtrov a zoskupovanie podľa rozmerov, ako je produkt, kolekcia alebo zákazník. Údaje vrátené touto akciou sú k dispozícii pre podmienky a akcie, ktoré nasledujú po danom kroku.

Tip

ShopifyQL sa používa aj v prehľadoch Shopify a pri segmentácii zákazníkov. Ďalšie informácie nájdete v časti Dopyty a syntax jazyka ShopifyQL.

Spúšťače

Akcia Získať analytické údaje je kompatibilná len so spúšťačom Plánovaný čas. Analytické údaje nie sú súčasťou spúšťačov na základe udalostí.

Konfigurácia

Polia

Akcia Získať analytické údaje obsahuje nasledujúce pole:

Polia použité v akcii Získať analytické údaje.

Pole	Popis
Dopyt ShopifyQL	Povinné. Dopyt ShopifyQL, ktorý sa má spustiť pre analytické údaje obchodu.

Dopyt ShopifyQL

Môžete napísať akýkoľvek platný dopyt ShopifyQL pomocou podporovaných schém, ako sú sales, sessions, inventory a payments. Nasledujúci dopyt napríklad vráti celkový predaj a počet zákazníkov za deň spustenia pracovného postupu:

FROM sales
  SHOW total_sales, customers
  SINCE today

Úplnú referenčnú príručku jazyka vrátane podporovaných schém, funkcií a syntaxe nájdete v dokumentácii jazyka ShopifyQL.

Dopyt sa overí pri uložení pracovného postupu. Pracovný postup nie je možné aktivovať, kým sa dopyt úspešne nespustí vo vašom obchode.

Vrátené údaje

Akcia Získať analytické údaje vráti riadky, ktoré zodpovedajú dopytu, dostupné ako premenná s názvom getAnalyticsData. Riadky sú uložené v parametri getAnalyticsData.rows, pričom každý riadok je objekt spárovaný s názvami stĺpcov vo vašom dopyte.

Túto premennú môžete použiť v podmienkach aj akciách, ktoré nasledujú po tomto kroku. Napríklad na odoslanie interného e-mailu, v ktorom bude uvedený každý riadok, môžete použiť kód Liquid podobný tomuto:

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

Ak chcete pracovať s každým riadkom jednotlivo, napríklad aplikovať akciu na každý riadok, môžete použiť akciu Cyklus pre každú položku (iterovať) s premennou getAnalyticsData.rows. Na agregáciu hodnôt, napríklad na spočítanie riadkov alebo sčítanie hodnôt v stĺpci, môžete použiť akcie Spočítať a Sčítať.

Poznámka

Ak sa akcia Získať údaje použije vo viacerých krokoch v rámci jedného pracovného postupu, k názvu premennej sa pridá číslo. Napríklad v pracovnom postupe, ktorý dvakrát použije akciu Získať údaje o objednávke, bude prvá premenná pre vrátené údaje getOrderData a druhá premenná getOrderData1. Tento názov nemožno prispôsobiť.

Referencia k API

Ďalšie informácie o rozhraní API použitom v tejto akcii nájdete v dopyte shopifyqlQuery v rozhraní GraphQL Admin API.

Zložitosť dopytu

Každý dopyt ShopifyQL má náklady na zložitosť, ktoré sa vypočítavajú zo schém, stĺpcov, filtrov a časového rozsahu, ktoré dopyt používa. Ak dopyt prekročí limit zložitosti, akcia zlyhá a pracovný postup sa nebude dať aktivovať. Ak chcete znížiť náklady na dopyt, môžete skrátiť časový rozsah, odstrániť stĺpce alebo odstrániť spojenia.

Podrobnosti o tom, ako sa vypočítavajú náklady na dopyt a aké sú aktuálne limity, nájdete v časti Obmedzenie frekvencie požiadaviek v rozhraní ShopifyQL Admin API.