Získať analytické údaje

Akcia Získať analytické údaje spustí dotaz ShopifyQL a vráti výsledky na použitie v pracovnom postupe. ShopifyQL je dotazovací jazyk vytvorený pre obchodnú analytiku. Môžete ho použiť na agregáciu metrík za rôzne časové obdobia, použitie filtrov a zoskupenie 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 tomto kroku.

Tip

ShopifyQL sa používa aj v prehľadoch Shopify a pri segmentácii zákazníkov. Získajte viac informácií o dotazoch a syntaxi ShopifyQL.

Spúšťače

Akcia Získať analytické údaje je kompatibilná iba so spúšťačom Plánovaný čas. Analytické údaje nie sú zahrnuté v spúšťačoch založených na udalostiach.

Konfigurácia

Polia

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

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

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

Dotaz ShopifyQL

Môžete napísať akýkoľvek platný dotaz ShopifyQL pomocou podporovaných schém, ako napríklad sales, sessions, inventory a payments. Napríklad nasledujúci dotaz vráti celkové tržby a počet zákazníkov pre daný deň, keď sa spustí pracovný postup:

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 k ShopifyQL.

Dotaz sa overí pri uložení pracovného postupu. Pracovný postup nie je možné aktivovať, kým sa dotaz úspešne nespustí pre váš obchod.

Vrátené údaje

Akcia Získať analytické údaje vráti riadky, ktoré zodpovedajú dotazu. Sú dostupné ako premenná s názvom getAnalyticsData. Riadky sú uložené v getAnalyticsData.rows, pričom každý riadok predstavuje objekt s kľúčmi podľa názvov stĺpcov v dotaze.

Túto premennú môžete použiť v podmienkach aj v akciách, ktoré po tomto kroku nasledujú. Ak chcete napríklad odoslať interný e‑mail so zoznamom jednotlivých riadkov, 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 samostatne, napríklad použiť akciu pre každý riadok, môžete použiť akciu Slučka pre každý (iterovať) s premennou getAnalyticsData.rows. Na agregáciu hodnôt, napríklad na spočítanie riadkov alebo sčítanie stĺpca, môžete použiť akcie Počet a Súčet.

Poznámka

Ak sa akcia Získať údaje použije v jednom pracovnom postupe viackrát, k názvu premennej sa pridá číslo. Napríklad v pracovnom postupe, ktorý dvakrát použije akciu Získať údaje objednávky, je prvá premenná pre vrátené údaje getOrderData a druhá premenná je getOrderData1. Tento názov nie je možné prispôsobiť.

Referencia API

Viac informácií o API použitom v tejto akcii nájdete v dotaze shopifyqlQuery v rozhraní GraphQL Admin API.

Zložitosť dotazu

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

Podrobnosti o spôsobe výpočtu nákladov na dotaz a aktuálnych limitoch nájdete v časti Obmedzenie rýchlosti v rozhraní ShopifyQL Admin API.