Ottieni dati di analisi

L'azione Ottieni dati di analisi esegue una query ShopifyQL e restituisce i risultati per l'uso nel flusso di lavoro. ShopifyQL è un linguaggio di query creato per le analisi relative al commercio. Puoi usarlo per aggregare metriche in periodi di tempo, applicare filtri e raggruppare per dimensioni come prodotto, collezione o cliente. I dati restituiti da questa azione sono disponibili per le condizioni e le azioni che seguono il passaggio.

In questa pagina

Trigger

L'azione Ottieni dati di analisi è compatibile solo con il trigger Orario programmato. I dati di analisi non sono inclusi nei trigger basati sugli eventi.

Configurazione

Campi

L'azione Ottieni dati di analisi contiene il seguente campo:

Campi utilizzati nell'azione Ottieni dati di analisi.
Campo	Descrizione
Query ShopifyQL	Obbligatorio. La query ShopifyQL da eseguire rispetto ai dati di analisi del negozio.

Query ShopifyQL

Puoi scrivere qualsiasi query ShopifyQL valida utilizzando gli schemi supportati, come sales, sessions, inventory e payments. Ad esempio, la query seguente restituisce le vendite totali e il numero di clienti per il giorno in cui viene eseguito il flusso di lavoro:

FROM sales
  SHOW total_sales, customers
  SINCE today

Per il riferimento completo del linguaggio, inclusi gli schemi supportati, le funzioni e la sintassi, consulta la documentazione ShopifyQL.

La query viene convalidata al momento del salvataggio del flusso di lavoro. Il flusso di lavoro non può essere attivato finché la query non viene eseguita correttamente sul negozio.

Dati restituiti

L'azione Ottieni dati di analisi restituisce le righe che corrispondono alla query, disponibili come variabile denominata getAnalyticsData. Le righe sono memorizzate in getAnalyticsData.rows, in cui ogni riga è un oggetto le cui chiavi corrispondono ai nomi delle colonne nella query.

Puoi utilizzare questa variabile sia nelle condizioni sia nelle azioni che seguono il passaggio. Ad esempio, per inviare un'email interna che elenca ogni riga, puoi utilizzare codice Liquid simile a questo:

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

Per operare singolarmente su ogni riga, ad esempio applicando un'azione per ciascuna di esse, puoi usare l'azione Ciclo For each (itera) con getAnalyticsData.rows. Per aggregare i valori, ad esempio contare le righe o sommare una colonna, puoi usare le azioni Conta e Somma.

Riferimento API

Per maggiori informazioni sulle API utilizzate in questa azione, consulta la query shopifyqlQuery nelle GraphQL Admin API.

Complessità della query

Ogni query ShopifyQL ha un costo in termini di complessità calcolato a partire da schemi, colonne, filtri e intervallo di tempo utilizzati dalla query stessa. Se una query supera il limite di complessità, l'azione non va a buon fine e il flusso di lavoro non può essere attivato. Per ridurre il costo di una query, puoi accorciare l'intervallo di tempo oppure rimuovere colonne o join.

Per dettagli su come viene calcolato il costo delle query e sui limiti attuali, consulta la sezione Limiti di frequenza nelle ShopifyQL Admin API.