Obtenir dades de l'anàlisi de dades

L'acció Obtenir dades de l'anàlisi de dades executa una consulta ShopifyQL i retorna els resultats per utilitzar-los al flux de treball. ShopifyQL és un llenguatge de consulta creat per a l'anàlisi de dades de comerç. Pots utilitzar-lo per agregar mètriques entre períodes, aplicar filtres i agrupar per dimensions, com ara producte, col·lecció o client. Les dades de retorn per aquesta acció estan disponibles a les condicions i accions posteriors al pas.

Consell

ShopifyQL també s'utilitza als informes i la segmentació de clients de Shopify. Pots obtenir més informació sobre les consultes i la sintaxi de ShopifyQL.

Esdeveniments desencadenants

L'acció Obtenir dades de l'anàlisi de dades només és compatible amb l'esdeveniment desencadenant Hora programada. Els esdeveniments desencadenants basats en esdeveniments no inclouen dades de l'anàlisi de dades.

Configuració

Camps

L'acció Obtenir dades de l'anàlisi de dades conté el camp següent:

Camps utilitzats a l'acció Obtenir dades de l'anàlisi de dades.

Camp	Descripció
Consulta de ShopifyQL	Obligatori. La consulta de ShopifyQL per executar a les dades de l'anàlisi de dades de la teva botiga.

Consulta de ShopifyQL

Pots escriure qualsevol consulta de ShopifyQL vàlida mitjançant els esquemes admesos, com ara sales, sessions, inventory i payments. Per exemple, la consulta següent retorna el total de vendes i el nombre de clients del dia que s'executa el flux de treball:

FROM sales
  SHOW total_sales, customers
  SINCE today

Per obtenir tota la referència de l'idioma, inclosos els esquemes, funcions i sintaxis admeses, consulta la documentació de ShopifyQL.

La consulta es valida quan deses el flux de treball. El flux de treball no pot activar-se fins que la consulta s'executi correctament a la botiga.

Dades de retorn

L'acció Obtenir dades de l'anàlisi de dades retorna les files que coincideixen amb la teva consulta i les posa a la teva disposició com a variable anomenada getAnalyticsData. Les files s'emmagatzemen a getAnalyticsData.rows, on cada fila és un objecte indexat pels noms de les columnes de la consulta.

Pots utilitzar aquesta variable a les condicions i accions posteriors al pas. Per exemple, per enviar un correu electrònic intern en què s'enumeri cada fila, pots utilitzar un Liquid similar a aquest:

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

Per treballar amb cada fila individualment, com ara aplicar una acció per a cada fila, pots utilitzar l'acció Iteració 'per a cada' (iterar) amb getAnalyticsData.rows. Per agregar valors, com ara comptar files o sumar una columna, pots utilitzar les accions Comptar i Sumar.

Nota

Si s'utilitza una acció Obtenir dades diverses vegades en un únic flux de treball, s'afegeix un número al nom de la variable. Per exemple, en un flux de treball que utilitza l'acció Obtenir dades de la comanda dues vegades, la primera variable per a les dades retornades és getOrderData i la segona és getOrderData1. Aquest nom no es pot personalitzar.

Referència de l'API

Per obtenir més informació sobre l'API utilitzada en aquesta acció, consulta la consulta shopifyqlQuery a la GraphQL Admin API.

Complexitat de la consulta

Cada consulta de ShopifyQL té un cost de complexitat que es calcula a partir dels esquemes, les columnes, els filtres i l'interval de temps que utilitza la consulta. Si una consulta supera el límit de complexitat, l'acció falla i el flux de treball no es pot activar. Per reduir el cost d'una consulta, pots escurçar l'interval de temps o bé eliminar columnes o unions.

Per obtenir informació sobre com es calcula el cost de les consultes i els límits actuals, consulta Límits de freqüència a la ShopifyQL Admin API.