Ottieni dati mercato
Nei flussi di lavoro che richiedono dati sul mercato, puoi utilizzare l'azione Ottieni dati mercato per recuperare le informazioni sul mercato dal negozio Shopify. I mercati sono gruppi di aree geografiche o sedi a cui sono destinate le vendite.
In questa pagina
Configurazione
Campi
L’azione Ottieni dati mercato contiene i campi seguenti:
| Campo | Descrizione |
|---|---|
| Ordina dati per | Obbligatorio. I parametri in base ai quali vengono ordinati i dati restituiti dalla query di ricerca. |
| Numero massimo di risultati | Obbligatorio. La quantità massima di risultati che può essere restituita dalla query di ricerca selezionata. Puoi restituire fino a 100 risultati alla volta. |
| Query | Obbligatorio. Scegli tra le query comuni o seleziona Avanzate per crearne una personalizzata. |
Stringa di query
Questo è un esempio di query per ottenere tutti i mercati attivi:
status:ACTIVELa variabile status è un filtro disponibile nella query Markets e può essere utilizzata più volte o combinata con altre variabili.
Quando esegui query sui dati, è utile sapere che:
Le query devono seguire una sintassi specifica
I valori dei campi delle query non sono sempre documentati. In alcuni casi, i valori possono essere trovati consultando la documentazione delle API. In alternativa, spesso puoi trovare i valori dei campi negli URL nel pannello di controllo quando applichi dei filtri. Ad esempio, per trovare alcuni valori della query Ordini, filtra la pagina Ordini nel pannello di controllo, quindi controlla l'URL.
Puoi eseguire o testare una query nel tuo negozio utilizzando l'app Shopify GraphiQL.
Fai attenzione a cosa succede se la query non va a buon fine. Spesso le API restituiscono tutti i risultati (anziché nessuno).
Dati restituiti
Tutte le azioni Ottieni dati restituiscono un elenco contenente da 0 a 100 risorse. A seconda del caso d'uso, potresti voler utilizzare questi dati in vari modi:
- Se devi gestire ciascun elemento dell'elenco singolarmente, ad esempio per aggiungere un tag a ognuno, puoi usare l'azione Per ciascuno.
- Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conta o Somma.
- Se devi generare in output l'elenco, ad esempio per inviare un'email con tutti gli elementi, puoi utilizzare i dati restituiti direttamente nelle azioni successive.
Per accedere ai dati restituiti nei passaggi successivi a questa azione, usa la variabile denominata Ottieni dati del mercato, che consiste in un elenco di mercati. Puoi usare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco dei mercati in un'azione Invia email interna in questo modo:
{% for single_market in GetMarketData %}
* {{ single_market.name }}
{% endfor %}Trigger
Puoi utilizzare questa azione in qualsiasi flusso di lavoro, incluso il trigger Orario programmato. In un flusso di lavoro che utilizza il trigger Orario programmato, il flusso di lavoro si avvia all'orario specificato, anziché in seguito a un evento. Poiché non c'è alcun evento specifico nel tuo negozio o da un'app che avvia il flusso di lavoro, nessun dato viene incluso automaticamente.
Riferimenti API
Per maggiori informazioni sulle API utilizzate in questa azione, consulta la query Markets.