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 die is gebouwd voor commerce-analytics. Je kunt de taal 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 voorwaarden en acties die na de stap volgen.

Tip

ShopifyQL wordt ook gebruikt in je Shopify-rapportages en voor klantsegmentering. Lees meer over ShopifyQL-query's en -syntaxis.

Triggers

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

Configuratie

Velden

De actie Analytics-gegevens ophalen bevat het volgende veld:

Velden die worden gebruikt in de actie Analytics-gegevens ophalen.

Veld	Beschrijving
ShopifyQL-query	Vereist. De ShopifyQL-query om uit te voeren voor de analytics-gegevens van je winkel.

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 taalreferentie, inclusief ondersteunde schema's, functies en syntaxis.

De query wordt gevalideerd wanneer je de workflow opslaat. De workflow kan pas worden geactiveerd als de query met succes voor je winkel is uitgevoerd.

Geretourneerde gegevens

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

Je kunt deze variabele gebruiken in zowel voorwaarden als acties die na de stap volgen. Als je bijvoorbeeld een interne e-mail wilt verzenden waarin elke rij wordt vermeld, kun je een Liquid-code als 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 een actie toe te passen op elke rij, kun je de actie Voor elke lus (itereren) gebruiken met getAnalyticsData.rows. Om waarden te aggregeren, zoals rijen tellen of een kolom optellen, kun je de acties Tellen en Optellen gebruiken.

Opmerking

Als een actie Gegevens ophalen meerdere keren in één workflow wordt gebruikt, wordt er een cijfer toegevoegd aan de variabelenaam. In een workflow die de actie Bestelgegevens ophalen bijvoorbeeld twee keer gebruikt, is de eerste variabele voor geretourneerde gegevens getOrderData en de tweede variabele getOrderData1. Deze naam kan niet worden aangepast.

API-referentie

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

Querycomplexiteit

Elke ShopifyQL-query heeft complexiteitskosten die worden berekend op basis van de schema's, kolommen, filters en het tijdsbereik die de query gebruikt. Als een query de complexiteitslimiet overschrijdt, mislukt de actie en kan de workflow niet worden geactiveerd. Je kunt de kosten van een query verlagen door het tijdsbereik in te korten of door kolommen of joins te verwijderen.

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