Hae analytiikan tiedot

Hae analytiikan tiedot ‑toiminto suorittaa ShopifyQL-kyselyn ja palauttaa tulokset työnkulussasi käytettäviksi. ShopifyQL on kyselykieli, joka on kehitetty verkkokaupan analytiikkaa varten. Voit käyttää sitä mittarien yhdistämiseen aikajaksoittain, suodattimien soveltamiseen ja ryhmittelyyn ulottuvuuksien, kuten tuotteen, kokoelman tai asiakkaan, mukaan. Tämän toiminnon palauttamat tiedot ovat käytettävissä vaihetta seuraavissa ehdoissa ja toiminnoissa.

Tällä sivulla

Käynnistimet

Hae analytiikan tiedot ‑toiminto on yhteensopiva vain Ajoitettu aika ‑käynnistimen kanssa. Tapahtumapohjaiset käynnistimet eivät sisällä analytiikkatietoja.

Määritys

Kentät

Hae analytiikan tiedot ‑toiminto sisältää seuraavan kentän:

Hae analytiikan tiedot ‑toiminnossa käytettävät kentät.
Kenttä	Kuvaus
ShopifyQL-kysely	Pakollinen. ShopifyQL-kysely, joka suoritetaan kauppasi analytiikkatietoihin.

ShopifyQL-kysely

Voit kirjoittaa minkä tahansa kelvollisen ShopifyQL-kyselyn käyttämällä tuettuja skeemoja, kuten sales, sessions, inventory ja payments. Esimerkiksi seuraava kysely palauttaa kokonaismyynnin ja työnkulun suorituspäivän asiakkaiden määrän:

FROM sales
  SHOW total_sales, customers
  SINCE today

Kielen koko viitteen, mukaan lukien tuetut skeemat, funktiot ja syntaksi, löydät ShopifyQL-dokumentaatiosta.

Kysely vahvistetaan, kun tallennat työnkulun. Työnkulkua ei voi aktivoida, ennen kuin kysely on suoritettu onnistuneesti kaupassasi.

Palautetut tiedot

Hae analytiikan tiedot ‑toiminto palauttaa kyselyäsi vastaavat rivit, jotka ovat käytettävissä muuttujana nimeltä getAnalyticsData. Rivit on tallennettu muuttujaan getAnalyticsData.rows, jossa jokainen rivi on objekti ja jonka avaimina toimivat kyselysi sarakkeiden nimet.

Voit käyttää tätä muuttujaa vaihetta seuraavissa ehdoissa ja toiminnoissa. Jos haluat esimerkiksi lähettää sisäisen sähköpostin, jossa luetellaan jokainen rivi, voit käyttää tämänkaltaista Liquid-koodia:

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

Voit käsitellä kutakin riviä erikseen (esimerkiksi soveltaa toimintoa jokaiselle riville) käyttämällä For each -silmukka (iterointi) ‑toimintoa muuttujan getAnalyticsData.rows kanssa. Arvojen yhdistämiseen, kuten rivien laskemiseen tai sarakkeen summaamiseen, voit käyttää Laske- ja Summaa‑toimintoja.

API-viite

Lisätietoja tässä toiminnossa käytetystä APIsta on GraphQL Admin API:n kyselyssä shopifyqlQuery.

Kyselyn monimutkaisuus

Jokaisella ShopifyQL-kyselyllä on monimutkaisuuden kustannus, joka lasketaan kyselyn käyttämistä skeemoista, sarakkeista, suodattimista ja aikajaksoista. Jos kysely ylittää monimutkaisuusrajan, toiminto epäonnistuu eikä työnkulkua voi aktivoida. Voit pienentää kyselyn kustannusta lyhentämällä aikajaksoa tai poistamalla sarakkeita tai liitoksia.

Lisätietoja kyselyn kustannuksen laskemisesta ja nykyisistä rajoituksista on kohdassa ShopifyQL Admin APIn nopeusrajoitukset.