Obtener datos de informes y estadísticas

La acción Obtener datos de informes y estadísticas ejecuta una consulta ShopifyQL y devuelve los resultados para usarlos en el flujo de trabajo. ShopifyQL es un lenguaje de consulta creado para los informes y estadísticas de comercio. Puedes usarlo para agregar métricas en distintos períodos, aplicar filtros y agrupar por dimensiones, como producto, colección o cliente. Los datos que devuelve esta acción están disponibles para las condiciones y acciones que siguen a este paso.

Consejo

ShopifyQL también se usa en los informes de Shopify y en la segmentación de clientes. Puedes obtener más información sobre las consultas y la sintaxis de ShopifyQL.

Activadores

La acción Obtener datos de informes y estadísticas solo es compatible con el activador Hora programada. Los datos de informes y estadísticas no se incluyen en los activadores basados en eventos.

Configuración

Campos

La acción Obtener datos de informes y estadísticas contiene el siguiente campo:

Campos usados en la acción Obtener datos de informes y estadísticas.

Campo	Descripción
Consulta ShopifyQL	Obligatorio. La consulta ShopifyQL que se ejecutará en los datos de informes y estadísticas de la tienda.

Consulta ShopifyQL

Puedes escribir cualquier consulta ShopifyQL válida mediante esquemas compatibles, como sales, sessions, inventory y payments. Por ejemplo, la siguiente consulta devuelve las ventas totales y la cantidad de clientes del día en que se ejecuta el flujo de trabajo:

FROM sales
  SHOW total_sales, customers
  SINCE today

Para obtener la referencia completa del lenguaje, que incluye los esquemas compatibles, las funciones y la sintaxis, consulta la documentación de ShopifyQL.

La consulta se valida cuando guardas el flujo de trabajo. El flujo de trabajo no se puede activar hasta que la consulta se ejecute correctamente en la tienda.

Datos devueltos

La acción Obtener datos de informes y estadísticas devuelve las filas que coinciden con tu consulta, disponibles como una variable llamada getAnalyticsData. Las filas se almacenan en getAnalyticsData.rows, donde cada fila es un objeto cuyas claves son los nombres de las columnas de la consulta.

Puedes usar esta variable en las condiciones y acciones que sigan a este paso. Por ejemplo, para enviar un correo electrónico interno donde aparezca cada fila, puedes usar Liquid de la siguiente forma:

{% for row in getAnalyticsData.rows %}
* {{ row.total_sales }} in sales from {{ row.customers }} customers
{% endfor %}

Para trabajar con cada fila individualmente, como aplicar una acción por fila, puedes usar la acción Bucle For each (iterar) con getAnalyticsData.rows. Para agregar valores, como contar filas o sumar una columna, puedes usar las acciones Contar y Sumar.

Nota

Si la acción Obtener datos se usa varias veces en un solo flujo de trabajo, se agrega un número al nombre de la variable. Por ejemplo, en un flujo de trabajo que usa la acción Obtener datos del pedido dos veces, la primera variable de los datos devueltos es getOrderData y la segunda es getOrderData1. Este nombre no se puede personalizar.

Referencia de la API

Para obtener más información sobre la API usada en esta acción, revisa la consulta shopifyqlQuery en la GraphQL Admin API.

Complejidad de la consulta

Cada consulta ShopifyQL tiene un costo de complejidad que se calcula a partir de los esquemas, las columnas, los filtros y el intervalo de tiempo que usa. Si una consulta supera el límite de complejidad, la acción falla y el flujo de trabajo no se puede activar. Para reducir el costo de una consulta, puedes acortar el intervalo de tiempo, o bien eliminar columnas o combinaciones.

Para obtener más detalles sobre cómo se calcula el costo de una consulta y los límites actuales, consulta la información sobre los límites de frecuencia en la Admin API de ShopifyQL.