Anpassade utlösare för butiksfronter

De inbyggda utlösarna för webbutiken täcker de händelser som Shopify rapporterar. En anpassad utlösare för webbutiken täcker allt annat som händer i din webbutik: du publicerar en händelse från ditt tema med en rad JavaScript-kod, och den blir en utlösare som du kan använda i Shopify Flow.

Det tydligaste exemplet är varukorgsmenyn. Shopifys händelse för varukorgsvisningen utlöses på sidan /cart, men de flesta moderna teman navigerar aldrig dit - istället öppnar de en meny med en glidande rörelse. Shopify rapporterar ingenting, så ingen app kan se det. Genom att publicera en egen händelse när menyn öppnas kan du fylla den luckan.

Andra användningsområden i butikerna:

• Ett tillägg till önskelistan eller ett klick på ”Meddela mig” - inget av detta rapporteras av Shopify.
• En storleksguide eller returpolicy som öppnats, som en indikation på en produkt.
• En variantändring i urvalsverktyget, som inte innebär en ny sidvisning (se Utlösare för butiksfronter).
• Allt som ditt tema eller en app från tredje part redan har information om, men som Shopify inte har.

Så här fungerar det

1. Skapa utlösaren i appen och ge den ett händelsenamn, till exempel cart_drawer_opened. Precis som alla Storefront-utlösare kräver den behörigheten ”Storefront Behaviour Access”, som beviljas en gång på sidan ”Behörigheter”.
2. Kopiera den enda raden som appen visar och klistra in den i ditt tema där det ska hända. Om du är osäker på vad du ska klistra in eller var, så skriver Skapa triggerkod med AI fram kodsnuttarna för ditt tema utifrån en beskrivning på vanlig engelska.
3. Skriv en omvandling om du vill filtrera eller omforma det som skickas, eller lämna fältet tomt för att vidarebefordra allt.
4. **Aktivera funktionen **och lägg sedan till ”Custom Storefront Trigger” i Shopify Flow, och skapa en gren baserad på händelsens namn.

Kodsnuttarna utgör hela integrationen på temasidan:

Shopify.analytics.publish("cart_drawer_opened", {
  // anything you want the Flow to receive
  itemCount: 3,
  total: "129.90"
});

Att ge evenemanget ett namn

Evenemangsnamnet är det som avgör hur ditt Shopify Flow-arbetsflöde förgrenar sig, så välj ett namn som är lätt att förstå och ändra det inte när arbetsflödena väl använder det.

Namn får innehålla bokstäver, siffror, understreck och bindestreck, måste börja med en bokstav eller en siffra och får bestå av upp till 64 tecken. Appen omvandlar det du skriver till en kortare form, så Cart drawer opened blir cart_drawer_opened.

Namnet tillhör ett internt namnområde, vilket innebär att det aldrig kan kollidera med en Shopify-händelse eller med en anpassad webhook-utlösare med samma namn.

Filtrering och omformning

De data du skickar som det andra argumentet kommer in i Shopify Flow som utlösarens output. Om det är allt du behöver är du klar.

Om du endast vill utlösa händelsen i vissa fall, eller skicka andra fält än de som publiceras av temat, skriver du en transform - samma JavaScript-modul som används av Anpassade utlösare. Returnera ett objekt för att utlösa händelsen, returnera null för att hoppa över den:

export async function transform(payload, topic, shop, ctx) {
  // Anything you published is on `payload`.
  if ((payload.itemCount || 0) < 2) return null;

  return {
    itemCount: payload.itemCount,
    total: payload.total,
    // Present only when the shopper is signed in.
    customerId: payload.customerId,
  };
}

Använda det i Shopify Flow

Varje anpassad butiksutlösare registreras i Shopify Flow som samma utlösare: Anpassad butiksutlösare. Lägg till den i ett arbetsflöde och lägg sedan till ett villkor där eventName ska vara lika med det namn du valt.

Det är detta som gör att en Shopify Flow-utlösare kan återge alla händelser i din butik. Utlösaren innehåller också det namn du gav den i appen samt utdata från din omvandling.

Den skiljer sig medvetet från ”Custom Trigger”, som ligger till grund för den webhook-baserade Anpassade utlösare. Det finns en viktig skillnad mellan de två som är värd att känna till: en anpassad webhook-trigger körs på våra servrar och är tillförlitlig, medan en händelse i webbutiken är beroende av att kundens webbläsare når oss och av kundens samtycke till analys.

Vad man inte ska skicka

Det andra argumentet till publish ligger helt under din kontroll, vilket innebär att det är ditt ansvar att se till att inga personuppgifter ingår i det.

Skicka identifierare och uppgifter: produkt- och variant-ID:n, antal, priser samt namnet på händelsen. ID:t för den inloggade kunden läggs till automatiskt om det finns ett, så du behöver aldrig skicka det själv.

Skicka inte namn, e-postadresser, telefonnummer eller postadresser. Ditt arbetsflöde kan hämta alla dessa uppgifter utifrån kund-ID:t i Shopify Flow, så det finns ingen fördel med att lägga in dem i en butikshändelse - och om du gör det förvandlas en analyshändelse till en händelse som innehåller personuppgifter.

Nästa steg

• Utlösare för butiksfronter - de inbyggda utlösarna för webbutiken och hur pixeln fungerar.
• Skapa triggerkod med AI - låt AI skriva temakoden eller omvandlingen åt dig.
• Anpassade utlösare - samma princip som för Shopify-webhook-händelser, men med tillförlitlighet på serversidan.
• Planer och användning - vad som räknas som en händelse.