Obtenir dades dels clients

En els fluxos de treball que utilitzen dades dels clients, pots utilitzar l'acció d'Obtenir dades dels clients per recuperar informació dels clients de la teva botiga.

Nota

Aquest és un tipus d'acció d'Obtenir dades. Per entendre com pots utilitzar aquest tipus d'acció amb l'esdeveniment desencadenant d'Hora programada i les iteracions Per a cada, consulta l'article Programacions, obtenció de dades i fluxos de treball iteratius a Shopify Flow.

Configuració

Camps

L'acció d'Obtenir dades dels clients conté els camps següents, que s'utilitzen per crear la consulta:

Camps que s'utilitzen a les accions d'Obtenir dades.

Camp	Descripció
Ordena les dades per	Obligatori. Els paràmetres pels quals s'ordenen les dades que retorna la consulta de cerca.
Nombre màxim de resultats	Obligatori. La quantitat màxima de resultats que pot retornar la consulta de cerca que seleccionis. Se'n poden retornar fins a 100 a la vegada.
Consulta	Obligatori. Tria entre consultes habituals o selecciona Avançada per crear-ne una de pròpia.

Cadena de la consulta

Aquest és un exemple de consulta per obtenir clients que s'hagin actualitzat durant l'últim dia:

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

La variable updated_at és un filtre disponible a la consulta de clients i es pot utilitzar diverses vegades o combinar-se amb altres variables. La variable de Liquid scheduledAt està disponible en fluxos de treball que han fet servir l'esdeveniment desencadenant d'hora programada. L'etiqueta de Liquid date_minus és una etiqueta de Flow especial que et permet restar temps a una data.

A l'hora de consultar dades, és útil saber el següent:

• Llista de filtres de client disponibles
• Les consultes han de seguir una sintaxi determinada
• Els valors dels camps de la consulta no sempre estan documentats. En alguns casos, els valors es poden trobar consultant la documentació de l'API. D'altra banda, sovint pots trobar els valors dels camps a les URL del panell d'administració quan filtres. Per exemple, per trobar alguns valors de consulta de les comandes, filtra la pàgina Comandes al panell d'administració i, a continuació, revisa l'URL.
• Pots executar o provar una consulta a la teva botiga mitjançant l'aplicació Shopify GraphiQL.
• Tingues en compte què passa si la teva consulta falla. Sovint l'API retornarà tots els resultats (en lloc de cap).

Dades retornades

Totes les accions d'Obtenir dades retornen una llista d'entre 0 i 100 recursos. Depenent del teu cas d'ús, és possible que vulguis utilitzar aquestes dades de diverses maneres:

• Si necessites gestionar cada element de la llista individualment, per exemple, per afegir una etiqueta a cadascun, pots utilitzar l'acció Per a cada.
• Si necessites agregar dades, per exemple, per comptar quants resultats s'han retornat, pots utilitzar les accions Comptar o Sumar.
• Si necessites donar sortida a la llista, per exemple, per enviar un correu electrònic amb tots els elements, pots utilitzar les dades retornades directament en accions posteriors.

Per accedir a les dades retornades en els passos que segueixen a aquesta acció, utilitza la variable Obtenir dades de clients, que és una llista de clients. Pots utilitzar aquesta variable tant en condicions com en accions. Per exemple, pots enviar la llista de comandes en una acció Enviar correu electrònic intern d'aquesta manera:

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

Nota

Si l'acció d'Obtenir dades s'utilitza diverses vegades en un mateix flux de treball, s'afegirà un número al nom de la variable. Per exemple, en un flux de treball que utilitza l'acció d'Obtenir dades de comandes dues vegades, la primera variable de les dades retornades és getOrderData i la segona és getOrderData1. Aquest nom no es pot personalitzar.

Esdeveniments desencadenants

Pots utilitzar aquesta acció en qualsevol flux de treball, inclòs l'esdeveniment desencadenant Hora programada. En un flux de treball que utilitza l'esdeveniment desencadenant Hora programada, el flux de treball comença a una hora especificada per tu en lloc de fer-ho com a resultat d'un esdeveniment. Atès que no hi ha un esdeveniment específic a la teva botiga o des d'una aplicació que iniciï el flux de treball, no s'inclouen dades automàticament.

Detalls de l'API

• Recurs de client
• Filtres de consulta de clients

Plantilles

Converteix un metacamp de client en etiquetes per a tots els clients

Aquest flux de treball emplenarà etiquetes retroactivament per a tots els teus clients en funció d'un valor de metacamp. S'executa cada hora i recupera fins a 100 clients que no tinguin l'etiqueta "processed". Per a cada client, observa el valor del metacamp custom.test i l'afegeix com a etiqueta. El flux de treball també afegeix l'etiqueta "processed" perquè no es retorni a la següent execució programada del flux de treball. Per utilitzar el flux de treball, hauràs de canviar l'espai de noms i la clau del metacamp perquè coincideixin amb un metacamp de la teva botiga. Veure la plantilla

Elimina els clients inactius

Elimina els clients amb més de 5 anys d'antiguitat que no han fet mai cap comanda. Veure la plantilla