Ottieni dati delle analisi

L’azione Ottieni dati delle analisi esegue una query ShopifyQL e restituisce i risultati per utilizzarli nel flusso di lavoro. ShopifyQL è un linguaggio di query creato per le analisi del commercio. Puoi utilizzarlo per aggregare le metriche in base ai periodi di tempo, applicare filtri e raggrupparle per dimensioni, come prodotto, collezione o cliente. I dati restituiti da questa azione sono disponibili per le condizioni e le azioni successive al passaggio.

Suggerimento

ShopifyQL viene utilizzato anche nei report Shopify e nella segmentazione dei clienti. Maggiori informazioni su query e sintassi ShopifyQL.

Trigger

L’azione Ottieni dati delle analisi è compatibile solo con il trigger Orario programmato. I dati delle analisi non sono inclusi dai trigger basati su eventi.

Configurazione

Campi

L’azione Ottieni dati delle analisi contiene il campo seguente:

Campi utilizzati nell’azione Ottieni dati delle analisi.

Campo	Descrizione
Query ShopifyQL	Obbligatorio. La query ShopifyQL da eseguire sui dati delle 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, le funzioni e la sintassi supportati, consulta la documentazione su ShopifyQL.

La query viene convalidata quando salvi il flusso di lavoro. Il flusso di lavoro non può essere attivato finché la query non viene eseguita correttamente nel negozio.

Dati restituiti

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

Puoi utilizzare questa variabile sia nelle condizioni sia nelle azioni successive al passaggio. Ad esempio, per inviare un’email interna che elenchi ogni riga, puoi utilizzare un codice Liquid simile a questo:

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

Per lavorare con ogni riga individualmente, ad esempio per applicare un’azione per ciascuna di esse, puoi utilizzare l’azione Ciclo for each (itera) con getAnalyticsData.rows. Per aggregare i valori, ad esempio per contare le righe o sommare i valori di una colonna, puoi utilizzare le azioni Conta e Somma.

Nota

Se in un singolo flusso di lavoro viene utilizzata più volte un’azione Ottieni dati, al nome della variabile viene aggiunto un numero. Ad esempio, in un flusso di lavoro che utilizza due volte l’azione Ottieni dati ordine, la prima variabile per i dati restituiti è getOrderData e la seconda è getOrderData1. Questo nome non può essere personalizzato.

Riferimento API

Per maggiori informazioni sull’API utilizzata in questa azione, consulta la query shopifyqlQuery nella GraphQL Admin API.

Complessità della query

Ogni query ShopifyQL ha un costo di complessità calcolato in base agli schemi, alle colonne, ai filtri e all’intervallo di tempo utilizzati. 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 o rimuovere colonne o join.

Per dettagli su come viene calcolato il costo della query e sui limiti attuali, consulta la pagina Limiti di frequenza per la ShopifyQL Admin API.