Skip to main content
Questa pagina raccoglie le regole dettagliate alla base della procedura guidata di configurazione di Subscription Upgrade: come vengono ricavati i prezzi, come si comportano le opzioni di tempistica e di sconto, il trigger di idoneità e perché il prodotto dell’offerta è un segnaposto. Per la guida passo dopo passo, consulta Configurare gli upgrade degli abbonamenti.

Stati di verifica della chiave API

Nel passo 1, Test API key convalida il tuo token presso il provider, verificando che si autentichi, che disponga di tutti gli scope richiesti e che appartenga al tuo negozio. Il risultato mostra uno di due stati:
  • Spunta verde, “API key verified”. Il token si è autenticato, tutti gli scope richiesti sono presenti e il token appartiene al tuo negozio. Continue è abilitato.
  • Icona rossa di annullamento. Il controllo non ha dato esito positivo. Il messaggio accanto all’icona indica quale delle due situazioni si è verificata: il tuo provider ha rifiutato il token (revocato o privo degli scope richiesti, e il messaggio indica il problema specifico), oppure Aftersell non è riuscito a completare il controllo (“Could not verify the API key. Please try again.”), che è una chiamata fallita e non un token errato. Correggi il token se è stato rifiutato; altrimenti ripeti semplicemente il test.
Non esiste un terzo stato intermedio, e un risultato di mancata verifica appare esattamente come un rifiuto, quindi leggi il messaggio anziché basarti sull’icona. Continue resta disabilitato finché il controllo non risulta verde. La modifica del provider o del token cancella il risultato precedente, quindi ripeti il test dopo ogni modifica. Questo controllo esiste per prevenire errori negli upgrade degli abbonamenti che altrimenti emergerebbero solo dopo l’addebito al cliente.

Il trigger di idoneità: Variant on subscription

La procedura guidata configura automaticamente un unico trigger per te; non è necessario impostarlo a mano: Tutti i trigger abilitati usano la logica AND: ogni condizione deve essere soddisfatta affinché il funnel venga mostrato. Puoi aggiungere altri trigger facoltativi nel passaggio Triggers dell’editor del funnel (raggruppati in una sezione comprimibile Additional triggers che mostra un conteggio e si apre automaticamente quando sono impostati trigger facoltativi).
Non sostituirlo con un trigger Product più un trigger Subscription. Quella combinazione precedente è composta da due condizioni indipendenti, quindi un ordine che contiene il tuo prodotto trigger come acquisto una tantum insieme a un articolo in abbonamento non correlato le soddisfa entrambe: il funnel si attiva e l’upgrade poi fallisce a valle perché non esiste un abbonamento corrispondente da modificare. Variant on subscription è un’unica condizione che non può scomporsi in quel modo, e la procedura guidata migra automaticamente i funnel più vecchi da quella combinazione.
Senza un trigger specifico per il prodotto, un funnel può essere mostrato a clienti che non hanno il prodotto in abbonamento idoneo nel loro ordine. Questo spreca impressioni e produce una modifica dell’abbonamento che fallisce silenziosamente: il prodotto dell’offerta viene aggiunto all’ordine, ma nessun abbonamento viene modificato in Recharge, Skio o Loop.
Se Show this funnel for all customers è abilitato, prevale su tutti gli altri trigger e il funnel si attiva per ogni checkout. Non è consigliato per i funnel di upgrade degli abbonamenti.

Quale prezzo mostra il Recurring subtotal

Il Recurring subtotal nell’offerta indica al cliente quanto costerà il suo prossimo rinnovo. Il prodotto da cui viene preso quel prezzo dipende dal tipo di upgrade: Questa è la fonte di confusione più comune. Un upgrade della sola frequenza mantiene per definizione lo stesso prodotto, quindi il suo subtotale ricorrente può mostrare solo il prezzo del prodotto trigger, qualunque sia la frequenza impostata. Se ti aspettavi lì il prezzo di un prodotto diverso, molto probabilmente ti serve invece Both, change frequency and replace subscription product. La quantità usata viene presa da Override subscription quantity, che compare solo nei tipi di sostituzione. In un upgrade della sola frequenza è sempre 1.

Tempistica dell’upgrade

Per impostazione predefinita un upgrade ha effetto dal prossimo ciclo di fatturazione del cliente, mantenendo la data di rinnovo esistente. Se l’opzione di tempistica è abilitata per il tuo negozio, sotto i campi della frequenza compare una casella di controllo:
My fulfillment provider ships the upgraded item on the current order
Selezionandola, il nuovo intervallo di fatturazione inizia immediatamente anziché al prossimo rinnovo, e viene sbloccato il campo One-time upgrade price nel passo 4.
Aftersell non modifica l’ordine appena effettuato dal cliente. Questa impostazione sposta solo l’intervallo di fatturazione. Selezionala solo se il tuo provider di evasione è configurato per riconoscere il prodotto segnaposto dell’upgrade e spedire l’articolo aggiornato con l’ordine corrente.
Questa casella è disattivata per impostazione predefinita e non è disponibile su tutti i negozi. Compare solo nei tipi di upgrade Change delivery or billing frequency e Both, change frequency and replace subscription product, e solo dopo che l’opzione è stata abilitata per il tuo negozio. Contatta il supporto tramite la chat in-app se ti serve.

Sconto ricorrente

Un incentivo facoltativo applicato a ogni rinnovo futuro dell’abbonamento aggiornato (non solo al primo ciclo). Non disponibile per il tipo add-item. Il modo in cui compare il campo dipende dal fatto che il selling plan selezionato abbia o meno politiche di prezzo a scaglioni:
  • Quando è selezionato un selling plan con livelli di sconto (ad esempio, un piano Loop che applica $20 di sconto sul primo addebito e $10 di sconto dal secondo addebito in poi), il campo a inserimento libero viene sostituito da un elenco di pulsanti di opzione, uno per livello. Ogni opzione mostra l’importo dello sconto e l’intervallo di addebiti a cui si applica (ad esempio, “Charge 1” o “Charge 2 onward”). Seleziona il livello da applicare a ogni rinnovo futuro.
  • Quando non è selezionato alcun selling plan, o il piano selezionato non ha livelli di sconto, compare il campo standard a inserimento libero. Inserisci l’importo e scegli Percentage o Fixed amount.

Prezzo dell’upgrade una tantum, per tipo di upgrade

Il One-time upgrade price è ciò che il cliente paga su questo ordine Shopify quando accetta.
  • Nei tipi Change delivery or billing frequency e Both è bloccato a 0 per impostazione predefinita, perché il tuo provider di abbonamenti addebita alla fine del ciclo di fatturazione corrente e il prodotto segnaposto compare nell’ordine Shopify a $0.00. Diventa modificabile solo quando la casella della tempistica dell’upgrade nel passo 3 è selezionata.
  • In Replace with a different subscription product e Add another subscribable item to subscription la casella della tempistica non si applica, quindi il campo del prezzo è sempre modificabile.
Cosa inserire dipende dal tipo di upgrade:
  • Frequenza, sostituzione o entrambe: la differenza di prezzo tra l’abbonamento originale e quello aggiornato. Il cliente mantiene il suo abbonamento e questo addebito copre la differenza.
  • Add another subscribable item: l’addebito per l’articolo aggiunto su questo ordine. Non viene sostituito nulla, quindi non c’è alcuna differenza da calcolare: è semplicemente ciò che il cliente paga ora per il nuovo articolo, che poi si ripete con il suo abbonamento. Consulta Aggiungere un articolo a un abbonamento esistente.
Sconto sul primo ordine. Uno sconto facoltativo applicato solo a questo acquisto di upgrade, inserito come percentuale (%) o come importo fisso. Si trova accanto a One-time upgrade price e compare ogni volta che quel campo è modificabile, sia nella scheda Create new sia in Pick existing. Nel tipo add-item il campo compare comunque ma viene sempre salvato come 0; le offerte add-item non prevedono mai uno sconto, quindi imposta invece il prezzo desiderato sul prodotto dell’offerta.

Perché il prodotto dell’offerta è un segnaposto

Il prodotto dell’offerta è solo un segnaposto visivo, non un prodotto reale acquistato dal cliente. Shopify non consente di mostrare un prodotto in abbonamento come upsell post-acquisto dopo un ordine che contiene già un abbonamento, quindi Aftersell acquisisce il prezzo tra un upgrade e l’altro con uno SKU segnaposto non in abbonamento.
  • L’immagine, il titolo e il prezzo che imposti compaiono nella card dell’offerta.
  • All’accettazione, il prezzo visualizzato viene addebitato sull’ordine Shopify e Recharge, Skio o Loop applica l’upgrade effettivo all’abbonamento al ciclo successivo.
  • Se scegli Pick existing invece di crearne uno, il prodotto deve supportare l’acquisto una tantum; i prodotti solo in abbonamento vengono esclusi dal selettore.