Recupera dati buoni regalo
Nei flussi di lavoro che richiedono i dati dei buoni regalo, puoi usare l'azione Recupera dati buoni regalo per recuperare le informazioni sui buoni regalo dal tuo negozio.
È importante sottolineare che il tuo negozio ha sia i prodotti buono regalo, che vengono utilizzati per generare i buoni regalo, sia i buoni regalo stessi, che sono i buoni regalo effettivi che i clienti possono utilizzare per effettuare acquisti. L'azione Recupera dati buoni regalo recupera le informazioni sui buoni regalo stessi. Per ottenere informazioni sui prodotti buono regalo, utilizza le azioni Recupera dati prodotto o Recupera dati variante di prodotto.
In questa pagina
Configurazione
Campi
L'azione Recupera dati buoni regalo contiene i seguenti campi, che vengono utilizzati per creare la query:
| 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 restituirne fino a 100 alla volta. |
| Query | Obbligatorio. Scegli tra le query comuni o seleziona Avanzate per crearne una personalizzata. |
Stringa di query
Di seguito è riportato un esempio di query per ottenere i buoni regalo aggiornati nell'ultimo giorno:
created_at:<='{{ scheduledAt }}' AND created_at:>'{{ scheduledAt | date_minus: "1 day" }}'La variabile created_at è un filtro disponibile nella query dei buoni regalo e può essere utilizzata più volte o combinata con altre variabili. La variabile Liquid scheduledAt è disponibile nei flussi di lavoro che hanno utilizzato il trigger Orario programmato. Il tag Liquid date_minus è un tag speciale di Flow che ti consente di sottrarre del tempo da una data.
Quando si eseguono query sui dati, è utile sapere quanto segue:
Le query devono seguire una determinata sintassi
I valori dei campi delle query non sono sempre documentati. In alcuni casi, i valori possono essere trovati consultando la documentazione API. In alternativa, spesso puoi trovare i valori dei campi negli URL del pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori di query per gli ordini, filtra la pagina Ordini nel pannello di controllo e quindi controlla l'URL.
Puoi eseguire o testare una query nel negozio utilizzando l'app Shopify GraphiQL.
Fai attenzione a cosa succede se la query fallisce. Spesso l'API restituirà tutti i risultati (anziché nessuno).
Dati restituiti
Tutte le azioni Recupera dati restituiscono un elenco da 0 a 100 risorse. A seconda del tuo caso d'uso, potresti voler utilizzare questi dati in vari modi:
- Se devi gestire ogni elemento dell'elenco singolarmente, ad esempio per aggiungere un tag a ciascuno, puoi utilizzare l'azione Per ogni.
- Se devi aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
- Se devi utilizzare l'intero elenco, ad esempio per inviare un'email con tutti gli articoli, puoi utilizzare i dati restituiti direttamente nelle azioni successive.
Per accedere ai dati restituiti nei passaggi successivi a questa azione, utilizza la variabile denominata Recupera dati dei buoni regalo, che è un elenco di buoni regalo. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco di buoni regalo in un'azione Invia email interna in questo modo:
{% for single_gift_card in GetGiftCardData %}
* {{ single_gift_card.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 a un orario da te specificato, anziché in seguito a un evento. Poiché non c'è un evento specifico nel negozio o da un'app che avvia il flusso di lavoro, non vengono inclusi dati automaticamente.