> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Riferimento dei Subscription Upsell
Questa pagina raccoglie il funzionamento e le regole della piattaforma alla base di Subscription Upsell: come viene aggiunto l'abbonamento, come vengono risolti piani e sconti, cosa vede il cliente, l'evasione, le limitazioni della piattaforma Shopify e il catalogo completo per la risoluzione dei problemi. Per sapere come crearne uno, consulta [Abbonamenti nelle offerte post-acquisto](/it/aftersell/subscriptions_in_post_purchase_offers).
## Come viene aggiunto l'abbonamento
Subscription Upsell usa il changeset post-acquisto nativo `add_subscription` di Shopify. Per questo flusso Aftersell non chiama direttamente l'API della tua app di abbonamenti: l'abbonamento viene creato da Shopify e la tua app di abbonamenti lo rileva tramite la propria integrazione con Shopify. Per questo motivo Subscription Upsell funziona con qualsiasi app di abbonamenti che usa la Subscription API nativa di Shopify.
Il primo ciclo dell'abbonamento viene evaso dall'**ordine Shopify originale** come un normale articolo. I rinnovi successivi sono gestiti dal tuo provider di abbonamenti, come per qualsiasi abbonamento creato durante il normale checkout.
## Piattaforme di abbonamento compatibili
Lato Aftersell, Subscription Upsell è completamente indipendente dal provider. Aftersell aggiunge l'abbonamento tramite il changeset nativo `add_subscription` di Shopify, e Shopify indirizza l'iscrizione all'app di abbonamenti installata sulla Shopify Subscription API. Qualsiasi app di abbonamenti che usa la Subscription API nativa di Shopify funziona senza configurazioni aggiuntive, tra cui Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (quando funziona sulla subscriptions API nativa di Shopify) e i selling plan nativi di Shopify.
I selling plan creati nella tua app di abbonamenti vengono importati automaticamente in Aftersell. (La compatibilità di Subscription Upgrade è diversa e specifica per provider; consulta [Upgrade degli abbonamenti](/it/aftersell/subscription-upgrades).)
## Come vengono risolti i selling plan
### Allowed subscription plans
L'impostazione **Allowed subscription plans** è una lista di piani consentiti, applicata **per variante**. Per la variante selezionata, il cliente vede solo i piani consentiti disponibili per quella variante:
* Se si applica esattamente un piano consentito, il suo nome viene mostrato come testo statico e non c'è nessuna scelta da fare.
* Se se ne applicano diversi, il cliente sceglie tra di essi in un menu a tendina **Purchase options**.
* Se non se ne applica nessuno, quella variante torna a mostrare tutti i propri piani.
Questo ambito per variante significa che un'unica lista di piani consentiti può gestire correttamente un prodotto le cui varianti hanno selling plan diversi. Se nessuno dei piani consentiti è disponibile per una variante (perché un piano è stato rimosso o disattivato in Shopify), l'offerta torna a mostrare tutti i piani disponibili per quella variante, così i clienti possono comunque completare l'acquisto. L'impostazione dei piani consentiti viene inoltre cancellata automaticamente se modifichi l'opzione di acquisto del prodotto in solo acquisto una tantum, evitando errori di configurazione quando le opzioni di abbonamento vengono rimosse.
### Quale selling plan viene mostrato per impostazione predefinita
Quando non è selezionato alcun piano in **Allowed subscription plans**, l'offerta preseleziona il **primo selling plan** configurato sul prodotto in Shopify. Se quella variante ha più di un piano disponibile, i clienti possono cambiarlo nel menu a tendina **Purchase options**. Per controllare quale piano vedono i clienti:
* **Limita i piani** (consigliato). Usa la selezione multipla **Allowed subscription plans**. Consentine esattamente uno e i clienti vedranno solo quel piano, senza menu a tendina.
* **Riordina i selling plan in Shopify.** L'ordine dei selling plan sul prodotto determina quale viene mostrato per primo.
* **Rimuovi dal prodotto i selling plan non utilizzati.** Se hai più frequenze e vuoi che ne compaia solo una, mantieni associato al prodotto solo il selling plan pertinente.
Il fattore più importante per la fidelizzazione è far corrispondere la cadenza all'uso effettivo del prodotto. Un abbonamento a uno shampoo ogni 30 giorni, quando il flacone dura 60 giorni, verrà annullato; un abbonamento ogni 60 giorni, quando il flacone dura 30 giorni, verrà saltato. Analizza i dati di riacquisto una tantum per trovare la cadenza naturale di ogni prodotto.
## Come vengono mostrati gli sconti sugli abbonamenti
Uno sconto su un'offerta Subscription Upsell si applica **solo al primo ciclo di fatturazione**; gli ordini ricorrenti successivi vengono addebitati al prezzo regolare dell'abbonamento. L'offerta post-acquisto mostra due prezzi distinti:
* Il **pulsante Accept Offer** e il subtotale dell'articolo riflettono il **prezzo del primo ciclo**, incluso l'eventuale sconto sul primo ciclo.
* Il campo **Recurring subtotal** mostra quanto verrà addebitato al cliente nei **rinnovi successivi** al prezzo regolare dell'abbonamento.
Questo risulta chiaro con i tipici sconti sul primo ciclo (dal 10 al 25 percento sulla prima consegna). Può risultare confuso con uno sconto estremo sul primo ciclo, come il 100%, perché il prezzo ricorrente (e non il prezzo di \$0 del primo ciclo) è il numero più visibile. Se intendi offrire una prima consegna gratuita, sii esplicito nel testo dell'offerta ("Prima confezione gratis, poi \$59.99 ogni 30 giorni").
Gli sconti possono essere una **percentuale** (ad esempio il 15% di sconto) o un **importo fisso** (ad esempio \$5 di sconto). Lo sconto viaggia sul changeset `add_subscription` di Shopify anziché essere applicato tramite la tua app di abbonamenti, e riguarda solo l'abbonamento creato da questa offerta.
Lo sconto raggiunge l'abbonamento solo se selezioni **Apply discount to subscriptions**. Senza questa opzione, il changeset `add_subscription` non contiene alcuno sconto e l'abbonamento viene fatturato a prezzo pieno; lo sconto dell'offerta si applica quindi solo alla riga una tantum.
## Cosa vede il cliente
Quando un cliente accetta un Subscription Upsell, accadono tre cose su due sistemi.
**Sull'ordine Shopify.** La conferma d'ordine include sia l'**articolo una tantum originale** sia il **nuovo articolo in abbonamento** (fatturato al prezzo scontato del primo ciclo). Il cliente paga entrambe le righe sull'ordine originale e la prima evasione dell'abbonamento viene spedita da questo ordine come un normale articolo.
**Nelle email di conferma.** Shopify invia la conferma d'ordine standard con entrambi gli articoli. Il tuo provider di abbonamenti in genere invia una propria email di benvenuto all'abbonamento che spiega la pianificazione ricorrente. Configura quell'email di benvenuto in modo che venga inviata entro pochi minuti dall'accettazione, con il nome del cliente e il prodotto, la cadenza, la data del prossimo addebito e un link diretto al portale clienti.
**Nel portale del provider di abbonamenti.** Il cliente gestisce il nuovo abbonamento nel portale del tuo provider, dove in genere può mettere in pausa o saltare una consegna, cambiare la cadenza, sostituire i prodotti o annullare. Il portale appartiene al tuo provider, non ad Aftersell; assicurati che sia accessibile dall'area account del tuo negozio o dall'email di benvenuto, altrimenti i clienti contatteranno il supporto per annullare.
## Evasione degli abbonamenti
* **Primo ciclo.** Il primo ordine dell'abbonamento fa parte dell'ordine Shopify originale, quindi segue qualunque processo di evasione tu usi per gli ordini una tantum (3PL, interno, dropshipping). La riga dell'abbonamento viene spedita insieme all'acquisto una tantum originale.
* **Rinnovi successivi.** I cicli futuri vengono creati dal tuo provider di abbonamenti secondo la cadenza di rinnovo. Ogni rinnovo diventa un nuovo ordine Shopify, evaso come qualsiasi altro ordine.
Se il tuo 3PL si integra direttamente con il tuo provider di abbonamenti, i rinnovi di solito vengono gestiti automaticamente. Se il tuo 3PL si sincronizza solo dagli ordini Shopify, non serve alcuna configurazione aggiuntiva perché ogni rinnovo crea un ordine Shopify.
## Limitazioni della piattaforma Shopify
Alcune regole della piattaforma Shopify si applicano alle offerte post-acquisto legate agli abbonamenti, indipendentemente dalla funzione di Aftersell che usi.
### Un abbonamento per ordine
Shopify non consente a un upsell post-acquisto di aggiungere un abbonamento a un ordine che ne contiene già uno. Questa restrizione è imposta da Shopify e si applica a tutte le app post-acquisto.
**Il collegamento di un provider di abbonamenti rimuove questo vincolo per Subscription Upsell.** Quando Recharge, Skio o Loop è collegato, Aftersell crea il nuovo abbonamento nel tuo provider anziché chiedere a Shopify di aggiungerlo, così le offerte in abbonamento raggiungono i clienti il cui ordine contiene già un abbonamento. Consulta [upsell agli abbonati esistenti](/it/aftersell/subscription-upsell-existing-subscribers).
Se **nessun provider è collegato**, Aftersell gestisce automaticamente il caso "abbonamento già nel carrello":
* I **prodotti solo in abbonamento** di un'offerta vengono rimossi dal funnel per quel cliente.
* I **prodotti a doppia modalità** (una tantum e abbonamento) vengono automaticamente ridotti a solo una tantum, quindi l'offerta viene comunque mostrata ma senza l'opzione di abbonamento.
In entrambi i casi, puoi lasciare un'offerta Subscription Upsell nel tuo funnel senza preoccuparti che si attivi in modo errato sugli ordini che contengono già un abbonamento. Per modificare l'abbonamento che il cliente ha già, anziché aggiungerne un secondo, usa [Subscription Upgrade](/it/aftersell/subscription-upgrades).
### Prodotti solo in abbonamento
Se un prodotto della tua offerta è configurato per essere venduto solo in abbonamento e nessun provider è collegato, l'offerta viene saltata ogni volta che l'ordine del cliente contiene già un prodotto in abbonamento. Ciò che mostra l'editor del funnel dipende dalla tua configurazione:
* **Un provider è collegato.** Nessun banner; la limitazione non si applica.
* **Nessun provider è collegato.** Un banner **Unlock more reach** con un'azione **Connect a provider**, che spiega che i clienti il cui ordine contiene già un abbonamento non vedono l'opzione di abbonamento di questa offerta.
* **Il funnel esclude già gli ordini con abbonamento.** Nessun banner, poiché l'offerta non raggiunge mai quei clienti.
Dove compare il vecchio banner di avviso **Subscription limitations**, elenca i prodotti interessati e suggerisce di impostare il **Subscription trigger** su **do not include a subscription**.
### Più offerte in abbonamento nello stesso funnel
Se più di un'offerta nel tuo funnel contiene un prodotto in abbonamento, all'ordine viene aggiunto solo il primo abbonamento accettato; le offerte in abbonamento successive vengono saltate. L'editor del funnel ti avvisa quando rileva questo conflitto, elencando le altre offerte che contengono prodotti in abbonamento. Per evitare offerte saltate, limita il tuo funnel a un'unica offerta in abbonamento, oppure usa il **Subscription trigger** per escludere gli ordini che contengono già un abbonamento.
## Risoluzione dei problemi
Affinché compaiano i controlli dell'abbonamento, il prodotto selezionato deve avere almeno un selling plan attivo in Shopify. Verifica che la tua app di abbonamenti abbia creato i selling plan per questo prodotto e che siano attivi e assegnati al prodotto.
L'offerta preseleziona il primo selling plan configurato sul prodotto in Shopify, e i clienti possono cambiarlo nel menu a tendina **Purchase options** quando alla loro variante si applica più di un piano. Per controllare quale piano vedono, limita l'offerta con la selezione multipla **Allowed subscription plans**, riordina i selling plan sul prodotto in Shopify in modo che quello desiderato sia il primo, oppure rimuovi completamente dal prodotto i selling plan non utilizzati. Consentire esattamente un piano rimuove il menu a tendina.
Sì: quando alla variante selezionata si applica più di un piano, l'offerta mostra un menu a tendina **Purchase options**. Per evitarlo, usa **Allowed subscription plans** per consentire un solo piano; la cadenza viene quindi mostrata come testo statico. I clienti possono comunque cambiare la cadenza in seguito nel portale del tuo provider di abbonamenti.
Usa la modalità **One-time purchase only** nell'impostazione dell'opzione di acquisto dell'offerta. Aftersell ha tre modalità per i prodotti abilitati all'abbonamento: **One-time purchase only**, **Subscription only** e **One-time purchase and subscription**. Selezionando **One-time purchase only** l'opzione di abbonamento viene nascosta completamente, anche quando il prodotto ha selling plan attivi.
È uno dei tipi di errore più problematici, perché al cliente è stato addebitato l'importo ma l'abbonamento non è mai stato creato nel tuo provider. La causa principale di gran lunga più comune è un **selling plan disattivato tra la visualizzazione dell'offerta e l'accettazione da parte del cliente**. Shopify accetta il changeset perché al momento della visualizzazione c'è un ID di selling plan valido, ma se il piano viene disattivato prima che il cliente accetti, nessun abbonamento viene attivato a valle e non viene segnalato alcun errore.
Altre cause comuni:
* **Il webhook dell'app di abbonamenti non funziona.** Qualsiasi app di abbonamenti che rileva i nuovi abbonamenti da Shopify si basa sui webhook di Shopify. Controlla lo stato di consegna dei webhook nei log della tua app di abbonamenti.
* **Il selling plan è stato scollegato dal prodotto** ma ha ancora un ID attivo. Shopify accetta il changeset e l'articolo viene aggiunto, ma il provider di abbonamenti non ha alcun record su cui agire.
**Importante:** non esiste alcun nuovo tentativo automatico sul percorso nativo `add_subscription`; lì l'iscrizione è gestita da Shopify, quindi Aftersell non ha nulla da ripetere. (Il percorso separato tramite provider, usato quando l'ordine contiene già un abbonamento, *è* coperto dal [flusso di nuovi tentativi degli upgrade di abbonamento](/it/aftersell/subscription-upgrades-troubleshooting).) Se succede:
1. Verifica che il selling plan sia ancora attivo in Shopify e assegnato al prodotto.
2. Controlla l'importazione degli ordini / i log dei webhook della tua app di abbonamenti per l'ordine interessato.
3. Se l'abbonamento manca davvero, il team di supporto della tua app di abbonamenti di solito può iscrivere manualmente il cliente a partire dall'ID dell'ordine.
Se sono interessati più clienti, contatta il supporto Aftersell con gli ID degli ordini e il nome del tuo provider di abbonamenti, ma aspettati che la correzione avvenga lato provider di abbonamenti, non in Aftersell.
Di solito accade quando lo sconto sul primo ciclo è estremo (ad esempio il 100% di sconto sul primo ciclo). Il pulsante Accept riflette il prezzo del primo ciclo, ma se quel prezzo appare identico al prezzo ricorrente, può sembrare che lo sconto non sia applicato. Verifica nell'anteprima dell'offerta che lo sconto sia configurato correttamente e affidati al testo dell'offerta ("Prima confezione gratis, poi \$X ogni Y giorni") per rendere i termini inequivocabili.
Per impostazione predefinita, gli sconti si applicano **solo al primo ciclo di fatturazione**. Se un cliente chiede perché il secondo o il terzo ordine non ha lo sconto, è il comportamento previsto. Gli ordini ricorrenti vengono addebitati al prezzo regolare dell'abbonamento, che il cliente ha visto come **Recurring subtotal** nell'offerta.
Se hai collegato Recharge, Skio o Loop, è il comportamento previsto e l'offerta funziona: Aftersell crea il nuovo abbonamento nel tuo provider. Consulta [upsell agli abbonati esistenti](/it/aftersell/subscription-upsell-existing-subscribers).
Se nessun provider è collegato, Shopify impedisce di aggiungere un secondo abbonamento e l'offerta viene saltata silenziosamente durante l'esecuzione. Collega un provider, oppure impedisci che l'offerta venga mostrata a quei clienti impostando il **Subscription trigger** su **do not include a subscription**.
Shopify consente un solo abbonamento per ordine. Se hai più offerte in abbonamento nello stesso funnel, prevale la prima accettata e le altre vengono saltate. Limita il tuo funnel a un'unica offerta in abbonamento, oppure usa il Subscription trigger per escludere gli ordini che hanno già un abbonamento.
Il nuovo abbonamento viene gestito nel portale clienti del tuo provider di abbonamenti, non direttamente in Shopify. Assicurati che il portale sia collegato dall'area account del tuo negozio e verifica che l'email di benvenuto del tuo provider sia configurata per essere inviata subito dopo l'accettazione.
Il primo ciclo è stato pagato come parte dell'ordine Shopify, quindi i rimborsi funzionano come per qualsiasi altro articolo. L'annullamento dei cicli futuri avviene nel tuo provider di abbonamenti, non in Aftersell. Il rimborso della riga in Shopify non annulla automaticamente l'abbonamento; devi annullarlo anche nel portale del provider.