Ottieni i dati delle varianti di prodotto

Nota

Un prodotto ha una o più varianti di prodotto. Ad esempio, una camicia potrebbe avere una variante di prodotto per ogni combinazione di taglia e colore.

Nei flussi di lavoro che utilizzano i dati delle varianti di prodotto, puoi utilizzare l'azione Get product variant data (Ottieni i dati delle varianti di prodotto) per recuperare queste informazioni dal tuo negozio.

Nota

Questo è un tipo di azione Get data (Ottieni dati). Per capire come utilizzare questo tipo di azione con il trigger Scheduled time (Orario programmato) e i cicli For each (Per ogni), consulta questa guida.

Configurazione

Campi

L'azione Get product variant data (Ottieni i dati delle varianti di prodotto) contiene i seguenti campi, utilizzati per creare la query:

Campi utilizzati nelle azioni Get data (Ottieni dati).

Campo	Descrizione
Sort data by (Ordina dati per)	Obbligatorio. I parametri secondo i quali vengono ordinati i dati restituiti dalla query di ricerca.
Maximum number of results (Numero massimo di risultati)	Obbligatorio. Il numero massimo di risultati che possono essere restituiti dalla query di ricerca selezionata. Possono esserne restituiti fino a 100 alla volta.
Query	Obbligatorio. Scegli tra le query più comuni o seleziona Advanced (Avanzato) per crearne di nuove.

Stringa di query

Questa è una query di esempio per ottenere le varianti di prodotto aggiornate nell'ultimo giorno:

updated_at:<='{{ scheduledAt }}' AND updated_at:>'{{ scheduledAt | date_minus: "1 day" }}'

La variabile updated_at è un filtro disponibile nella query delle varianti di prodotto 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 Scheduled time (Orario programmato). Il tag Liquid date_minus è un tag Flow speciale che ti consente di sottrarre del tempo da una data.

Quando si eseguono query sui dati, è utile conoscere quanto segue:

• Elenco dei filtri delle varianti di prodotto disponibili - Le query devono seguire una determinata sintassi.
• I valori dei campi di query non sono sempre documentati. In alcuni casi, si possono trovare consultando i documenti API. In alternativa, spesso puoi trovare i valori dei campi negli URL nel pannello di controllo quando applichi filtri. Ad esempio, per trovare alcuni valori di query degli ordini, filtra la pagina Ordini nel pannello di controllo e verifica l'URL.
• Puoi eseguire o provare una query nel tuo negozio utilizzando l'app GraphiQL di Shopify.
• Presta attenzione a cosa succede se la query non va a buon fine. Spesso l'API restituisce tutti i risultati (anziché nessuno).

Dati restituiti

Tutte le azioni Get data (Ottieni dati) restituiscono un elenco contenente da 0 a 100 risorse. A seconda del tuo caso d'uso, potresti utilizzare questi dati in diversi modi:

• Se devi gestire singolarmente ogni voce di elenco, ad esempio per aggiungere un tag per ogni voce, puoi utilizzare l'azione For each (Per ogni).
• Se devi aggregare i dati, ad esempio contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Count (Conta) o Sum (Somma).
• Se hai bisogno di generare l'elenco, ad esempio per inviare un'email con tutte le voci, puoi utilizzare i dati restituiti direttamente nelle azioni successive.

Per accedere ai dati restituiti nei passaggi che seguono questa azione, utilizza la variabile denominata Get product variant data (Ottieni i dati delle varianti di prodotto), che è un elenco delle varianti di prodotto. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco degli ordini in un'azione Send internal email (Invia email interna) in questo modo:

{% for single_variant in GetProductVariantData %}
- {{ single_variant.name }}
{% endfor %}

Nota

Se un'azione Get data (Ottieni dati) è utilizzata più volte in un singolo flusso di lavoro, allora viene aggiunto un numero al nome della variabile. Ad esempio, in un flusso di lavoro che utilizza l'azione Get order data (Ottieni dati degli ordini) due volte, la prima variabile dei dati restituiti è getOrderData, mentre la seconda variabile è getOrderData1. Questo nome non può essere personalizzato.

Trigger

Puoi utilizzare questa azione in qualsiasi flusso di lavoro, compreso il trigger Scheduled time (Orario programmato). Un flusso di lavoro che utilizza il trigger Scheduled time (Orario programmato) inizia nel momento da te specificato, anziché a seguito di un evento. Poiché nel tuo negozio o in un'app non c'è un evento specifico che avvii il flusso di lavoro, non ci sono dati inclusi automaticamente.

Dettagli API

• Risorsa variante di prodotto
• Filtri della query delle varianti di prodotto

Modelli

Aggiunta di un articolo gratuito (scontato del 100%) ai nuovi ordini

Questo modello aggiunge un articolo gratuito e scontato ai nuovi ordini se l'articolo è disponibile. Controlla le scorte, applica uno sconto del 100% e aggiorna l'ordine senza informare il cliente. Questa automazione potrebbe essere utile per (1) migliorare la soddisfazione del cliente includendo nell'ordine un articolo gratuito a sorpresa, (2) promuovere prodotti nuovi o meno noti aggiungendoli come campioni gratuiti negli ordini o (3) semplificare le promozioni automatizzando l'inclusione e lo sconto di articoli gratuiti. Visualizza modello

Invio di riepiloghi settimanali via email con elenchi delle varianti con livelli bassi di scorte

Questo flusso di lavoro viene eseguito secondo un programma (per esempio una volta alla settimana). Ottiene una lista di varianti di prodotto che hanno bassi livelli di scorte, conta i risultati e invia un riepilogo tramite email con i titoli delle varianti e un link alla pagina del pannello di controllo per la variante. Visualizza modello