Recupera dati cliente

Nei flussi di lavoro che utilizzano i dati dei clienti, puoi utilizzare l’azione Recupera dati cliente per recuperare le informazioni sui clienti dal negozio.

In questa pagina

Configurazione

Campi

L'azione Recupera dati cliente contiene i seguenti campi, che vengono utilizzati per creare la query:

Campi utilizzati nelle azioni Recupera dati.
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. Il numero massimo di risultati che possono essere restituiti 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

Questo è un esempio di query per ottenere i clienti aggiornati nell'ultimo giorno:

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

La variabile updated_at è un filtro disponibile nella query Clienti 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 pianificato. Il tag Liquid date_minus è uno speciale tag di Flow che consente di sottrarre del tempo da una data.

Quando esegui query sui dati, è utile sapere quanto segue:

Elenco dei filtri cliente disponibili
Le query devono seguire una sintassi specifica
I valori dei campi della query non sono sempre documentati. In alcuni casi, i valori possono essere trovati consultando la documentazione API. In alternativa, puoi spesso trovare i valori dei campi negli URL nel pannello di controllo quando applichi un filtro. Ad esempio, per trovare alcuni valori della query Ordine, filtra la pagina Ordini nel pannello di controllo e quindi controlla l’URL.
Puoi eseguire o testare una query nel tuo negozio utilizzando l'app Shopify GraphiQL.
Presta attenzione a ciò che accade se la query non riesce. Spesso l’API restituirà tutti i risultati (invece di 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 singolarmente ogni articolo dell'elenco, ad esempio per aggiungere un tag a ciascuno, puoi utilizzare l'azione Per ogni.
Se hai bisogno di aggregare i dati, ad esempio per contare quanti risultati sono stati restituiti, puoi utilizzare le azioni Conteggio o Somma.
Se hai bisogno di utilizzare l'elenco come output, 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 che seguono questa azione, utilizza la variabile denominata Recupera dati cliente, che è un elenco di clienti. Puoi utilizzare questa variabile sia nelle condizioni che nelle azioni. Ad esempio, puoi inviare l'elenco degli ordini in un'azione Invia email interna in questo modo:

{% for single_customer in GetCustomerData %}
* {{ single_customer.name }}
{% endfor %}

Trigger

Puoi utilizzare questa azione in qualsiasi flusso di lavoro, incluso il trigger Orario pianificato. In un flusso di lavoro che utilizza il trigger Orario pianificato, il flusso di lavoro si avvia a un'ora da te specificata, anziché in seguito a un evento. Poiché non c'è nessun evento specifico nel tuo negozio o da un'app che avvia il flusso di lavoro, non vengono inclusi dati automaticamente.

Dettagli API

Modelli

Converti un metafield cliente in tag per tutti i clienti

Questo flusso di lavoro completerà i tag per tutti i tuoi clienti in base al valore di un metafield. Viene eseguito ogni ora e recupera fino a 100 clienti che non dispongono di un tag “processed”. Per ogni cliente, esamina il valore di un metafield custom.test e lo aggiunge come tag. Il flusso di lavoro aggiunge anche un tag “processed” in modo che il cliente non venga restituito nella successiva esecuzione pianificata del flusso di lavoro. Per utilizzare il flusso di lavoro, dovrai modificare lo spazio dei nomi e la chiave del metafield in modo che corrispondano a un metafield nel tuo negozio. Visualizza modello

Elimina clienti inattivi

Elimina i clienti con più di 5 anni che non hanno mai effettuato un ordine. Visualizza modello