Notifica ai clienti l'aggiornamento di un prodotto

Cosa fa Notifica clienti

Notifica clienti invia un'email a ciascun acquirente passato di un prodotto, con un pulsante che apre il download dei file più recenti di quell'acquirente. Lo avvii dalla pagina del prodotto nell'admin di Alva: apri il prodotto, clicca Notifica clienti, scegli chi la riceve, aggiungi una nota facoltativa, controlla l'anteprima e invia.

L'email è una notifica di aggiornamento prodotto fissa nella lingua del tuo storefront, non un'email di marketing. Parte su uno stream di invio separato dalle tue email di consegna, con il tracciamento di aperture e clic disattivato, così il link di download non viene mai riscritto. Chi si è disiscritto o ha segnalato un'email precedente come spam viene escluso automaticamente.

Chi riceve l'email

Ogni cliente che ha acquistato una delle varianti selezionate ed è ancora iscritto alle email riceve esattamente un messaggio. Se le varianti di un prodotto consegnano file diversi, la finestra modale mostra una casella di controllo per ogni insieme di file, etichettata con le varianti che serve; sono tutte selezionate per impostazione predefinita. Chi ha acquistato più varianti selezionate riceve una sola email.

Quell'unica email rimanda all'acquisto più recente dell'acquirente tra le varianti selezionate. L'altra variante resta raggiungibile tramite il suo link di download originale e la pagina di stato dell'ordine. Il numero di destinatari si aggiorna mentre cambi la selezione, e sotto di esso è indicato il numero di acquirenti che si sono disiscritti — da qui non possono essere raggiunti.

Gli acquisti con accesso ai download disattivato, o che non hanno superato il tuo controllo antifrode, vengono esclusi. I prodotti personalizzati non hanno un file condiviso da inviare di nuovo, quindi non mostrano affatto il pulsante, e un prodotto le cui mappature non contengono file, pack o link non può essere notificato.

Cosa dice l'email

L'email è un template bloccato: oggetto, saluto, riga introduttiva, pulsante Scarica i file e footer sono fissi e tradotti nella lingua del tuo storefront. L'unica parte che puoi aggiungere è una nota in testo semplice di massimo 2.000 caratteri, mostrata come “Un messaggio da {il tuo negozio}:” tra la riga introduttiva e il pulsante. Gli acquirenti vedono, nell'ordine:

• Oggetto: Aggiornamento del tuo acquisto di {titolo prodotto}
• Ciao {nome},
• {Nome negozio} ha aggiornato il tuo acquisto di {titolo prodotto}. Clicca qui sotto per scaricare l'ultima versione.
• Un messaggio da {nome negozio}: seguito dalla tua nota — solo se ne hai aggiunta una
• Il pulsante Scarica i file, che apre la pagina di download dell'acquirente
• Un footer con il nome del tuo negozio e un link per disiscriversi

Aggiungi una nota

Scrivi la nota nel campo Aggiungi una nota (facoltativo). Solo testo semplice: link e indirizzi email non sono consentiti — inclusi indirizzi web, www. e nomi di dominio nudi — e il campo li rifiuta prima che tu possa inviare, così il pulsante Scarica i file resta l'unico link nell'email. Non inserire sconti o promozioni nella nota: questa email è un aggiornamento prodotto, non marketing.

Variabili utilizzabili nella nota

Tre pulsanti sotto il campo inseriscono le prime tre variabili; un menu Metacampo del prodotto elenca i metacampi del prodotto per la quarta:

• {customer.first_name} — il nome dell'acquirente, con un'alternativa neutra quando non è noto. Rende meglio all'inizio di una riga.
• {shop.name} — il nome del tuo negozio.
• {product.title} — il titolo del prodotto, come nell'oggetto.
• {product.metafields.<namespace>.<key>} — il valore di uno dei metacampi Shopify del prodotto, per esempio {product.metafields.custom.edition}. Una nota può usare fino a cinque metacampi diversi. Il menu elenca i primi 50 metacampi del prodotto con i loro valori attuali.

I tipi di metacampo supportati sono testo a riga singola e multiriga, numeri interi e decimali, date (scritte per esteso nella lingua del tuo storefront) ed elenchi di testo. Un metacampo di altro tipo — un link, un valore vero/falso, un riferimento, testo formattato o un file — non può essere mostrato in un'email, quindi la nota viene rifiutata con un errore in linea finché non lo rimuovi. Lo stesso vale per un metacampo senza valore su questo prodotto, per una variabile che Alva non conosce, per una parentesi graffa non chiusa e per un link all'interno del valore di un metacampo.

Anteprima prima dell'invio

L'Anteprima email sotto la nota mostra oggetto e corpo esattamente come li vedrà un acquirente, nella lingua del tuo storefront, con la nota e le sue variabili compilate con i valori reali del prodotto. L'anteprima e l'email inviata sono generate dallo stesso codice, quindi ciò che vedi è ciò che parte. Se un metacampo cambia mentre la finestra modale è aperta, l'anteprima si aggiorna e ti chiede di ricontrollarla.

Prodotti ZIP: l'email attende l'archivio

Se un prodotto consegna un archivio ZIP e hai appena sostituito i suoi file, l'invio attende che Alva abbia finito di rigenerare l'archivio, così nessun acquirente scarica la vecchia versione. Fino ad allora la cronologia notifiche mostra “In attesa che l'archivio finisca di essere generato prima dell'invio.”; l'invio è ancora in coda e può ancora essere annullato.

Se la rigenerazione fallisce, l'invio fallisce con il motivo “Impossibile generare l'archivio ZIP di questo prodotto, quindi non è stato inviato nulla.” Correggi i file — sostituirli avvia una nuova rigenerazione — e notifica di nuovo. Se dopo un'ora l'archivio è ancora in rigenerazione, anche in questo caso l'invio fallisce, indicandolo, e puoi notificare di nuovo quando la rigenerazione è terminata. In entrambi i casi non è stato inviato nulla, quindi il limite di 7 giorni non viene consumato.

I prodotti che consegnano file singoli o link non hanno un archivio e non vengono mai trattenuti.

La cronologia notifiche

Sotto la scheda Impostazioni del prodotto, Cronologia notifiche elenca gli ultimi dieci invii del prodotto: la data, il numero di destinatari, quante email sono state inviate, fallite, soppresse o segnalate come spam, chi ha inviato e lo stato — In coda, Invio, Completato, Parziale, Fallito o Annullato. Un badge indica da dove proviene: Admin, API o Aggiornamento mapping (API).

Una riga mostra anche quante varianti ha interessato e le prime righe della sua nota. Una riga Fallito spiega il motivo, a parole: le email ai clienti erano disattivate, quindi non è stato inviato nulla; la nota salvata non è stata renderizzata; la nota conteneva un link; l'archivio era ancora in rigenerazione dopo un'ora; impossibile generare l'archivio ZIP; oppure l'invio è stato interrotto da un riavvio del server. Parziale significa che alcune email sono fallite o sono state soppresse — i conteggi dicono quante.

Tramite l'API

Tutto ciò che fa il pulsante è disponibile anche tramite l'API esterna di Alva, per i negozi il cui sistema aggiorna i file in autonomia. POST /api/v1/products/{id}/notifications mette in coda una campagna per un prodotto; invia "dry_run": true per eseguire gli stessi controlli e ottenere il numero di destinatari, l'oggetto e la nota renderizzata senza inviare nulla. GET /api/v1/notifications/{id} legge l'esito.

POST /api/v1/notifications/{id}/cancel ferma una campagna ancora in coda; come l'annullamento dall'admin, mantiene il limite di 7 giorni del prodotto. Se il tuo sistema crea o sostituisce già le mappature tramite l'API, aggiungi notify_customers a POST /api/v1/mappings o PUT /api/v1/mappings/{id} e gli acquirenti di quella mappatura vengono notificati una volta che i nuovi file sono al loro posto — anche qui vale l'attesa dell'archivio. Il limite è condiviso con il pulsante: entro la settimana l'API risponde 429 notification_cooldown con l'istante in cui il prodotto torna libero, quindi pianifica la chiamata successiva per quel momento invece di riprovare. Corpi delle richieste, codici di errore e regole di idempotenza sono nel riferimento API.