Obtener datos de informes y estadísticas

La acción Obtener datos de informes y estadísticas ejecuta una consulta de ShopifyQL y devuelve los resultados para que se usen en el flujo de trabajo. ShopifyQL es un lenguaje de consulta diseñado para informes y estadísticas de comercio. Puedes usarlo para agregar métricas en distintos períodos, aplicar filtros y agrupar por dimensiones, como el producto, la colección o el 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 activadores basados en eventos no incluyen los datos de informes y estadísticas.

Configuración

Campos

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

Campos que se usan en la acción Obtener datos de informes y estadísticas.

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

Consulta de ShopifyQL

Puedes escribir cualquier consulta válida de ShopifyQL con los 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, incluidos los esquemas, funciones y la sintaxis que son compatibles, consulta la documentación de ShopifyQL.

La consulta se valida cuando guardas el flujo de trabajo. El flujo de trabajo no puede activarse 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 la consulta. Estas filas están disponibles en la variable getAnalyticsData. Las filas se almacenan en getAnalyticsData.rows y cada fila es un objeto que tiene como clave los nombres de las columnas en la consulta.

Puedes usar esta variable en las condiciones y acciones que siguen a este paso. Por ejemplo, para enviar un correo electrónico interno con la lista de 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 de forma individual, como aplicar una acción a cada 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 se usa una acción de Obtener datos varias veces en un único flujo de trabajo, se agrega un número al nombre de la variable. Por ejemplo, en un flujo de trabajo en el que se usa la acción Obtener datos del pedido dos veces, la primera variable de los datos que se devuelven 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 que se usa en esta acción, revisa la consulta shopifyqlQuery en la GraphQL Admin API.

Complejidad de la consulta

Cada consulta de ShopifyQL tiene un costo de complejidad que se calcula según los esquemas, las columnas, los filtros y el rango de tiempo que esta usa. Si una consulta excede 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 rango de tiempo o eliminar columnas o combinaciones.

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