Klanten op de hoogte stellen van een productupdate

Wat Klanten op de hoogte stellen doet

Klanten op de hoogte stellen stuurt één e-mail naar elke eerdere koper van een product, met een knop die de eigen download van die koper met de nieuwste bestanden opent. Je start het vanaf de pagina van het product in de Alva-admin: open het product, klik op Klanten op de hoogte stellen, kies wie de mail krijgt, voeg eventueel een notitie toe, controleer het voorbeeld en verzend.

De e-mail is een vaste productupdatemelding in de taal van je storefront, geen marketingmail. Hij gaat uit via een verzendstroom die losstaat van je bezorgmails, met open- en kliktracking uitgeschakeld zodat de downloadlink nooit wordt herschreven. Iedereen die zich heeft afgemeld of een eerdere e-mail als spam heeft gemarkeerd, wordt automatisch overgeslagen.

Wie de e-mail ontvangt

Elke klant die een van de geselecteerde varianten heeft gekocht en nog is aangemeld voor e-mail, ontvangt precies één bericht. Leveren de varianten van een product verschillende bestanden, dan toont het venster één selectievakje per set bestanden, met als label de varianten die de set bedient; standaard zijn ze allemaal geselecteerd. Een koper van meerdere geselecteerde varianten krijgt één e-mail.

Die ene e-mail linkt naar de meest recente aankoop van de koper binnen de geselecteerde varianten. De andere variant blijft bereikbaar via de oorspronkelijke downloadlink en de bestelstatuspagina. Het aantal ontvangers wordt bijgewerkt terwijl je de selectie wijzigt, en eronder staat hoeveel kopers zich hebben afgemeld — zij zijn vanaf hier niet te bereiken.

Aankopen waarvan de downloadtoegang is uitgeschakeld, of die je fraudecontrole niet hebben doorstaan, blijven buiten beschouwing. Gepersonaliseerde producten hebben geen gedeeld bestand om opnieuw te versturen, dus daar verschijnt de knop helemaal niet, en voor een product waarvan de koppelingen geen bestanden, pakketten of links bevatten, kun je geen melding versturen.

Wat er in de e-mail staat

De e-mail is een vergrendelde template: het onderwerp, de aanhef, de introregel, de knop Bestanden downloaden en de voettekst staan vast en zijn vertaald in de taal van je storefront. Het enige dat je kunt toevoegen is een notitie in platte tekst van maximaal 2.000 tekens, die als “Een bericht van {je winkel}:” tussen de introregel en de knop verschijnt. Kopers zien, in deze volgorde:

• Onderwerp: Update voor je aankoop van {producttitel}
• Hoi {voornaam},
• {Winkelnaam} heeft je aankoop van {producttitel} bijgewerkt. Klik hieronder om de nieuwste versie te downloaden.
• Een bericht van {winkelnaam}: gevolgd door je notitie — alleen als je er een hebt toegevoegd
• De knop Bestanden downloaden, die de eigen downloadpagina van de koper opent
• Een voettekst met je winkelnaam en een afmeldlink

Een notitie toevoegen

Typ de notitie in het veld Voeg een notitie toe (optioneel). Alleen platte tekst: links en e-mailadressen zijn niet toegestaan — webadressen, www. en losse domeinnamen inbegrepen — en het veld weigert ze voordat je kunt verzenden, zodat de knop Bestanden downloaden de enige link in de e-mail blijft. Zet geen kortingen of acties in de notitie: deze e-mail is een productupdate, geen marketing.

Variabelen die je in de notitie kunt gebruiken

Drie knoppen onder het veld voegen de eerste drie variabelen in; een menu Productmetaveld toont de metavelden van het product voor de vierde:

• {customer.first_name} — de voornaam van de koper, met een neutrale terugvaltekst als die onbekend is. Leest het best aan het begin van een regel.
• {shop.name} — je winkelnaam.
• {product.title} — de titel van het product, zoals in het onderwerp.
• {product.metafields.<namespace>.<key>} — de waarde van een van de Shopify-metavelden van het product, bijvoorbeeld {product.metafields.custom.edition}. Een notitie kan maximaal vijf verschillende metavelden gebruiken. Het menu toont de eerste 50 metavelden van het product met hun huidige waarden.

Ondersteunde metaveldtypen zijn tekst van één of meer regels, gehele en decimale getallen, datums (uitgeschreven in de taal van je storefront) en lijsten met tekst. Een metaveld van een ander type — een link, een waar/onwaar-waarde, een referentie, opgemaakte tekst of een bestand — kan niet in een e-mail worden weergegeven, dus de notitie wordt met een inline foutmelding geweigerd totdat je het verwijdert. Hetzelfde geldt voor een metaveld zonder waarde bij dit product, een variabele die Alva niet kent, een niet-gesloten accolade en een link in de waarde van een metaveld.

Voorbeeld bekijken voor het verzenden

Het E-mailvoorbeeld onder de notitie toont het onderwerp en de inhoud precies zoals een koper ze zal zien, in de taal van je storefront, met de notitie en de variabelen ingevuld vanuit de echte waarden van het product. Het voorbeeld en de verzonden e-mail worden door dezelfde code opgebouwd, dus wat je ziet is wat er uitgaat. Verandert een metaveld terwijl het venster open is, dan wordt het voorbeeld vernieuwd en word je gevraagd het opnieuw te controleren.

ZIP-producten: de e-mail wacht op het archief

Levert een product een ZIP-archief en heb je net de bestanden vervangen, dan wacht de verzending tot Alva klaar is met het opnieuw opbouwen van het archief, zodat geen koper de oude versie downloadt. Tot die tijd toont de meldingsgeschiedenis “Wacht tot het archief klaar is met opbouwen voordat er wordt verzonden.”; de verzending staat nog in de wachtrij en kan nog worden geannuleerd.

Mislukt de opbouw, dan mislukt de verzending met de reden “Het ZIP-archief voor dit product kon niet worden opgebouwd, dus er is niets verzonden.” Herstel de bestanden — vervangen start een nieuwe opbouw — en stel klanten opnieuw op de hoogte. Is het archief na een uur nog steeds in opbouw, dan mislukt de verzending ook, met die melding, en kun je klanten opnieuw op de hoogte stellen zodra de opbouw klaar is. In beide gevallen is er niets verzonden, dus de 7-dagenlimiet wordt niet verbruikt.

Producten die losse bestanden of links leveren, hebben geen archief en worden nooit vastgehouden.

De meldingsgeschiedenis

Onder de kaart Instellingen van het product toont Meldingsgeschiedenis de laatste tien verzendingen voor het product: de datum, het aantal ontvangers, hoeveel e-mails zijn verzonden, mislukt, onderdrukt of als spam gemeld, wie de verzending heeft gestart, en de status — In wachtrij, Verzenden, Voltooid, Gedeeltelijk, Mislukt of Geannuleerd. Een badge toont waar de verzending vandaan kwam: Beheer, API of Koppeling bijgewerkt (API).

Een rij toont ook op hoeveel varianten die gericht was en de eerste regels van de notitie. Een rij met Mislukt zegt in woorden waarom: klant-e-mails stonden uit, dus er is niets verzonden; de opgeslagen notitie kon niet worden weergegeven; de notitie bevatte een link; het archief werd na een uur nog steeds opnieuw opgebouwd; het ZIP-archief kon niet worden opgebouwd; of het verzenden is onderbroken door een herstart van de server. Gedeeltelijk betekent dat sommige e-mails zijn mislukt of onderdrukt — de aantallen zeggen hoeveel.

Via de API

Alles wat de knop doet, is ook beschikbaar via de externe API van Alva, voor winkels waarvan het eigen systeem de bestanden bijwerkt. POST /api/v1/products/{id}/notifications zet een campagne voor een product in de wachtrij; stuur "dry_run": true om dezelfde controles uit te voeren en het aantal ontvangers, het onderwerp en de gerenderde notitie te krijgen zonder iets te verzenden. GET /api/v1/notifications/{id} leest het resultaat.

POST /api/v1/notifications/{id}/cancel stopt een campagne die nog in de wachtrij staat; net als annuleren in de admin behoudt het de 7-dagenlimiet van het product. Maakt of vervangt je systeem al koppelingen via de API, voeg dan notify_customers toe aan POST /api/v1/mappings of PUT /api/v1/mappings/{id} en de kopers van die koppeling worden op de hoogte gesteld zodra de nieuwe bestanden klaarstaan — het wachten op het archief geldt daar ook. De limiet wordt gedeeld met de knop: binnen de week antwoordt de API 429 notification_cooldown met het tijdstip waarop het product weer vrij is, dus plan de volgende aanroep voor dan in plaats van het opnieuw te proberen. Request-bodies, foutcodes en idempotentieregels staan in de API-referentie.