Hämta marknadsdata

I arbetsflöden som kräver marknadsdata kan du använda åtgärden Hämta marknadsdata för att hämta marknadsinformation från din Shopify-butik. Marknader är grupper av regioner eller platser som du riktar in dig på för försäljning.

På den här sidan

Konfiguration

Fält

Åtgärden Hämta marknadsdata innehåller följande fält:

Fält som används i Hämta data-åtgärderna.
Fält	Beskrivning
Sortera data efter	Obligatoriskt. Parametrarna som används för att sortera data som returneras av sökfrågan.
Maximalt antal resultat	Obligatoriskt. Det maximala antalet resultat som kan returneras av den valda sökfrågan. Du kan returnera upp till 100 åt gången.
Sökfråga	Krävs. Välj bland vanliga sökfrågor eller välj Avancerat för att skapa en egen.

Söksträng

Detta är en exempelsökfråga för att hämta alla aktiva marknader:

status:ACTIVE

Variabeln status är ett filter som är tillgängligt för sökfrågan för marknader och kan användas flera gånger eller kombineras med andra variabler.

När du söker efter data är det bra att veta följande:

Lista över tillgängliga marknadsfilter
Sökfrågor måste följa en viss syntax
Värden för sökfrågefält är inte alltid dokumenterade. I vissa fall kan värdena hittas genom att titta i API-dokumentationen. Alternativt kan du ofta hitta fältvärdena i URL:erna i adminpanelen när du filtrerar. För att till exempel hitta vissa värden för en ordersökfråga kan du filtrera sidan Ordrar i adminpanelen och sedan kontrollera URL:en.
Du kan köra eller testa en sökfråga i din butik genom att använda appen Shopify GraphiQL.
Tänk på vad som händer om din sökfråga misslyckas. Ofta returnerar API:et alla resultat (i stället för inga).

Returnerad data

Alla Hämta data-åtgärder returnerar en lista med allt från 0 till 100 resurser. Beroende på ditt användningsfall kanske du vill använda den här datan på olika sätt:

Om du behöver hantera varje listartikel individuellt, till exempel för att lägga till en tagg för varje, kan du använda åtgärden För varje.
Om du behöver aggregera data, till exempel räkna hur många resultat som returnerades, kan du använda åtgärderna Räkna eller Summera.
Om du behöver mata ut listan, till exempel skicka ett e-postmeddelande med alla artiklar, kan du använda returnerad data direkt i efterföljande åtgärder.

För att få åtkomst till den returnerade datan i steg som följer efter den här åtgärden använder du variabeln Hämta marknadsdata, som är en lista över marknader. Du kan använda den här variabeln i både villkor och åtgärder. Du kan till exempel skicka listan över marknader i åtgärden Skicka internt e-postmeddelande på liknande sätt:

{% for single_market in GetMarketData %}
    * {{ single_market.name }}
    {% endfor %}

Utlösare

Du kan använda den här åtgärden i alla arbetsflöden, inklusive utlösaren Schemalagd tid. I ett arbetsflöde som använder utlösaren Schemalagd tid startar arbetsflödet vid en tidpunkt som du har angett, snarare än som ett resultat av en händelse. Eftersom det inte finns någon specifik händelse i din butik eller från en app som startar arbetsflödet inkluderas ingen data automatiskt.

API-referens

Mer information om det API som används i den här åtgärden finns i sökfrågan för marknader.