Hae analytiikkatietoja

Hae analytiikkatietoja -toiminto suorittaa ShopifyQL-kyselyn ja palauttaa tulokset työnkulussasi käytettäviksi. ShopifyQL on kyselykieli, joka on kehitetty verkkokaupan analytiikkaa varten. Sen avulla voit koota mittareita eri ajanjaksoilta, käyttää suodattimia ja ryhmitellä tietoja eri 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 analytiikkatietoja -toiminto on yhteensopiva vain Ajoitettu aika -käynnistimen kanssa. Tapahtumapohjaiset käynnistimet eivät sisällytä analytiikkatietoja.

Määritys

Kentät

Hae analytiikkatietoja -toiminto sisältää seuraavan kentän:

Kentät, joita käytetään Hae analytiikkatietoja -toiminnossa.
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 asiakkaiden lukumäärän siltä päivältä, jona työnkulku suoritetaan:

FROM sales
  SHOW total_sales, customers
  SINCE today

Kielen täydellinen viite, mukaan lukien tuetut skeemat, funktiot ja syntaksi, löytyy ShopifyQL-kielen dokumentaatiosta.

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

Palautetut tiedot

Hae analytiikkatietoja -toiminto palauttaa kyselyäsi vastaavat rivit, jotka ovat käytettävissä muuttujana nimeltä getAnalyticsData. Rivit on tallennettu muuttujaan getAnalyticsData.rows, jossa kukin rivi on objekti, jonka avaimina toimivat kyselyn sarakkeiden nimet.

Voit käyttää tätä muuttujaa sekä ehto- että toimintovaiheissa, jotka seuraavat tätä vaihetta. Jos haluat esimerkiksi lähettää sisäisen sähköpostiviestin, jossa luetellaan kaikki rivit, voit käyttää seuraavanlaista Liquid-koodia:

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

Jos haluat käsitellä kutakin riviä erikseen, esimerkiksi soveltaa toimintoa jokaiselle riville, voit käyttää Toista jokaiselle (iteroi) -toimintoa muuttujalle getAnalyticsData.rows. Arvojen kokoamiseen, kuten rivien laskemiseen tai sarakkeen summaamiseen, voit käyttää toimintoja Laske ja Summa.

API-viite

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

Kyselyn monimutkaisuus

Jokaisella ShopifyQL-kyselyllä on monimutkaisuuteen perustuva kustannus, joka lasketaan kyselyn käyttämien skeemojen, sarakkeiden, suodattimien ja aikavälin perusteella. Jos kysely ylittää monimutkaisuusrajan, toiminto epäonnistuu eikä työnkulkua voi aktivoida. Voit pienentää kyselyn kustannusta lyhentämällä aikaväliä tai poistamalla sarakkeita tai liitoksia.

Lisätietoja kyselyn kustannuksen laskemisesta ja nykyisistä rajoituksista on kohdassa Pyyntörajoitukset ShopifyQL Admin API -rajapinnassa.