Analytics-gegevens ophalen

De actie Analytics-gegevens ophalen voert een ShopifyQL-query uit en retourneert de resultaten voor gebruik in je workflow. ShopifyQL is een querytaal speciaal ontworpen voor commerce-analytics. Je kunt deze gebruiken om statistieken over tijdsperioden te aggregeren, filters toe te passen en te groeperen op dimensies zoals product, collectie of klant. De gegevens die door deze actie worden geretourneerd, zijn beschikbaar voor de voorwaarden en acties die na deze stap volgen.

Op deze pagina

Triggers

De actie Analytics-gegevens ophalen is alleen compatibel met de trigger Geplande tijd. Analytics-gegevens worden niet opgenomen door gebeurtenisgebaseerde triggers.

Configuratie

Velden

De actie Analytics-gegevens ophalen bevat het volgende veld:

Velden die in de actie Analytics-gegevens ophalen worden gebruikt.
Veld	Beschrijving
ShopifyQL-query	Vereist. De ShopifyQL-query die je op de analytics-gegevens van je winkel wilt uitvoeren.

ShopifyQL-query

Je kunt elke geldige ShopifyQL-query schrijven met behulp van ondersteunde schema's, zoals sales, sessions, inventory en payments. De volgende query retourneert bijvoorbeeld de totale omzet en het aantal klanten voor de dag waarop de workflow wordt uitgevoerd:

FROM sales
  SHOW total_sales, customers
  SINCE today

Raadpleeg de ShopifyQL-documentatie voor de volledige referentie, inclusief de ondersteunde schema's, functies en syntaxis.

De query wordt gevalideerd wanneer je de workflow opslaat. De workflow kan pas worden geactiveerd als de query succesvol in je winkel is uitgevoerd.

Geretourneerde gegevens

De actie Analytics-gegevens ophalen retourneert de rijen die met je query overeenkomen. Deze zijn beschikbaar als de variabele getAnalyticsData. De rijen worden opgeslagen in getAnalyticsData.rows, waarbij elke rij een object is met de kolomnamen uit je query als sleutel.

Je kunt deze variabele gebruiken in zowel voorwaarden als acties die na de stap volgen. Als je bijvoorbeeld een interne e-mail wilt verzenden met een overzicht van elke rij, dan kun je een Liquid-code zoals deze gebruiken:

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

Als je met elke rij afzonderlijk wilt werken, bijvoorbeeld om voor elke rij een actie toe te passen, kun je de actie Voor elke lus (itereren) gebruiken in combinatie met getAnalyticsData.rows. Als je waarden wilt aggregeren, bijvoorbeeld om rijen te tellen of een kolom op te tellen, kun je de acties Tellen en Optellen gebruiken.

API-referentie

Zie voor meer informatie over de API die in deze actie wordt gebruikt de query shopifyqlQuery in de GraphQL Admin API.

Query-complexiteit

Elke ShopifyQL-query heeft een complexiteitskost die wordt berekend op basis van de schema's, kolommen, filters en het tijdsbereik die in de query worden gebruikt. Als een query de complexiteitslimiet overschrijdt, mislukt de actie en kan de workflow niet worden geactiveerd. Om de kosten van een query te verlagen, kun je het tijdsbereik inkorten of kolommen of joins verwijderen.

Raadpleeg Snelheidslimieten in de ShopifyQL Admin API voor meer informatie over hoe de querykosten worden berekend en de huidige limieten.