Skip to main content
Questa pagina descrive il funzionamento completo di Replacement Upsell: come viene elaborata una sostituzione, quali scenari sono supportati o bloccati silenziosamente, le regole su pagamenti e sconti, il failsafe della Beta e il catalogo completo per la risoluzione dei problemi. Per sapere come crearne uno, consulta la guida Upsell di sostituzione.

​
Come viene elaborata una sostituzione

Quando un cliente accetta un Replacement Upsell:
  1. L’articolo una tantum originale viene rimborsato in Shopify.
  2. L’articolo sostitutivo viene aggiunto allo stesso ordine, come acquisto una tantum o come abbonamento (a seconda di ciò che hai configurato).
  3. Il cliente paga la sostituzione sullo stesso ordine.
  4. Il suo estratto conto mostra due transazioni: il rimborso dell’originale e l’addebito per la sostituzione. Il pulsante Accept Offer visualizzato riflette la differenza netta tra i due prezzi.
Tutto questo è implementato tramite l’API post-purchase di Shopify:
  • Per una sostituzione una tantum (variante, quantità o prodotto diversi), Aftersell invia un changeset add_variant.
  • Per una sostituzione con abbonamento, Aftersell invia un changeset add_subscription.
  • L’articolo originale viene rimosso tramite l’API di rimborso di Shopify.
Per le sostituzioni con abbonamento, Aftersell non chiama direttamente l’API della tua app di abbonamenti. L’abbonamento viene creato dalla Subscription API nativa di Shopify e la tua app di abbonamenti lo rileva tramite la propria integrazione con Shopify.

​
Scenari supportati

Replacement Upsell supporta quattro scenari. In ogni caso, l’articolo originale deve essere un acquisto una tantum. La sostituzione può essere una tantum o in abbonamento.
  • Da una tantum a una tantum, stesso prodotto, variante diversa. Ad esempio, sostituire la misura Twin con la misura Queen.
  • Da una tantum a una tantum, stesso prodotto, quantità diversa. Ad esempio, sostituire una singola bottiglia con una confezione da 3 dello stesso articolo. Abilita Override quantity sulla sostituzione per impostare la quantità spedita.
  • Da una tantum a una tantum, prodotto completamente diverso. Ad esempio, sostituire una bottiglia starter con una versione in formato pieno di uno SKU diverso.
  • Da una tantum ad abbonamento. Ad esempio, sostituire la bottiglia una tantum con un abbonamento mensile alla stessa bottiglia, o con la versione in abbonamento di un prodotto diverso. È il caso d’uso più comune.

​
Scenari bloccati

Questi scenari sono bloccati da Aftersell al momento della visualizzazione dell’offerta. L’offerta viene saltata silenziosamente se l’ordine del cliente corrisponde a uno di essi.
  • Da abbonamento a una tantum. La rimozione dell’articolo in abbonamento non annulla il contratto di abbonamento in Recharge, Skio o Loop. Al cliente verrebbe comunque addebitato l’abbonamento e riceverebbe anche la sostituzione.
  • Da abbonamento a un abbonamento diverso. Stessa causa di fondo, in più la regola di Shopify “un abbonamento per ordine” impedisce di aggiungere un nuovo abbonamento a un ordine che ne contiene già uno.
  • Da abbonamento ad abbonamento con cambio di variante o frequenza. Stessa causa di fondo.
Se devi modificare l’abbonamento esistente di un cliente, usa invece Subscription Upgrade. Subscription Upgrade modifica direttamente il contratto esistente in Recharge, Skio o Loop, senza tentare di rimuovere e riaggiungere la riga dell’abbonamento.
Ogni volta che un Replacement Upsell viene saltato (uno degli scenari bloccati sopra, un gateway di pagamento non supportato o una riga trigger scontata), Aftersell prova automaticamente a mostrare al suo posto l’offerta di downsell dello stesso funnel. Configura un downsell come riserva ogni volta che usi Replacement Upsell, in modo che l’acquirente veda comunque un’offerta.

​
Cosa vede il cliente

Capire il punto di vista del cliente previene il ticket di supporto più comune: “Perché mi è stato addebitato due volte?”

​
Nell’offerta post-acquisto

Il pulsante Accept Offer mostra la differenza netta tra l’originale e la sostituzione. Ad esempio, se il cliente ha acquistato una bottiglia da $30 e tu offri una confezione da 3 da $45, il pulsante Accept riporta “Add $15.00 to your order”. Se la sostituzione costa meno dell’originale, il pulsante viene mostrato come un credito. La card dell’offerta mostra l’immagine, il titolo e il prezzo del prodotto sostitutivo. La card dell’offerta usa l’immagine specifica della variante quando ne è associata una alla variante in Shopify. Se la variante non ha un’immagine associata, la card dell’offerta usa la prima immagine del prodotto principale. Ciò significa che il passaggio tra due varianti dello stesso prodotto può cambiare o meno l’immagine, a seconda che ogni variante abbia una propria immagine configurata in Shopify.

​
Sull’ordine Shopify dopo l’accettazione

L’ordine finisce per mostrare entrambi:
  • L’articolo originale con un rimborso applicato.
  • Il nuovo articolo per la sostituzione, addebitato a prezzo pieno.
Il totale dell’ordine riflette il risultato netto, ma l’estratto conto bancario del cliente mostrerà due transazioni: un addebito per la sostituzione e un rimborso per l’originale. È così che Aftersell elabora le accettazioni dei Replacement Upsell a livello di pagamento. L’importo netto corrisponde al pulsante Accept Offer visualizzato. Per ridurre la confusione:
  • Includi nel testo dell’offerta una frase che descriva esplicitamente il meccanismo di rimborso e sostituzione. Ad esempio: “Quando accetti, rimborseremo l’articolo originale e addebiteremo la sostituzione. Vedrai due voci sul tuo estratto conto: l’importo netto è il prezzo dell’upgrade mostrato su questo pulsante.”
  • Abilita l’email automatica di notifica del rimborso di Aftersell per gli upsell di sostituzione, che invia al cliente una conferma con la spiegazione del rimborso.

​
Nel portale del provider di abbonamenti (quando la sostituzione è un abbonamento)

Se la sostituzione è un abbonamento, il cliente vedrà il nuovo abbonamento nel portale clienti del tuo provider di abbonamenti (Recharge, Skio, Loop, Appstle, Smartrr, Stay.ai). Il portale appartiene al tuo provider di abbonamenti, non ad Aftersell. Assicurati che l’email di benvenuto del tuo provider di abbonamenti sia configurata per essere inviata entro pochi minuti dall’accettazione.

​
Piattaforme di abbonamento compatibili

Quando la sostituzione è un abbonamento, Replacement Upsell funziona con qualsiasi app di abbonamenti che usa la Subscription API nativa di Shopify. Per questo flusso Aftersell non chiama direttamente le API dei provider; l’abbonamento viene creato da Shopify e la tua app di abbonamenti lo rileva tramite la propria integrazione con Shopify. I provider compatibili includono Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (quando funziona sulla subscriptions API nativa di Shopify) e i selling plan nativi di Shopify. Se il prodotto sostitutivo ha un piano di abbonamento prepagato configurato (ad esempio, ogni 3 mesi con addebito anticipato), verifica con il tuo provider di abbonamenti che il prepagato sia supportato come destinazione di sostituzione. La gestione del prepagato varia in base al provider.

​
Requisiti dei metodi di pagamento

Aftersell blocca esplicitamente Replacement Upsell su alcuni gateway di pagamento perché non possono supportare in modo affidabile lo schema di rimborso e nuovo addebito nella finestra post-acquisto:
  • Authorize.net (authorize_net). Authorize.net richiede che le transazioni vengano regolate prima di poter emettere rimborsi, e la regolazione avviene con un ritardo, quindi Aftersell non può rimborsare in modo affidabile l’originale e aggiungere la sostituzione sullo stesso ordine Shopify. Se Authorize.net è il tuo processore di pagamento, indirizza invece quei clienti verso le offerte della pagina di ringraziamento.
  • Gateway di pagamento manuali (manual). Questa categoria comprende il pagamento alla consegna, i metodi di pagamento personalizzati, i checkout di ordini bozza e qualsiasi altro processore di pagamento manuale che non acquisisce un’autorizzazione memorizzata. Replacement Upsell ha bisogno di un pagamento memorizzato attivo per emettere un addebito successivo, cosa che i gateway manuali non forniscono.
Quando il gateway di pagamento dell’ordine è uno di questi, Replacement Upsell salta silenziosamente l’offerta. Il motivo del salto compare nell’order browser di Aftersell come “Payment gateway does not support replacement upsells.” Per l’elenco più ampio dei metodi di pagamento che influiscono su tutte le offerte post-acquisto di Aftersell (non solo su Replacement Upsell), consulta Metodi di pagamento.

​
Gestione degli sconti

Replacement Upsell ha un comportamento specifico riguardo agli sconti che coglie spesso di sorpresa i partner.

​
Gli sconti sulla riga originale non vengono trasferiti alla sostituzione

Quando Aftersell rimborsa l’articolo originale, qualsiasi sconto applicato a esso viene rimosso insieme all’articolo. La riga sostitutiva viene addebitata a prezzo pieno (o con lo sconto dell’offerta di sostituzione, se ne hai configurato uno), ma lo sconto originale del cliente non viene trasferito. Se vuoi che il cliente mantenga uno sconto equivalente, configuralo direttamente sull’offerta di sostituzione.

​
Allow replacement when target has a discount

Per impostazione predefinita, Replacement Upsell salta l’offerta se la riga trigger ha uno sconto a livello di ordine. È un’impostazione predefinita di protezione per evitare discrepanze negli importi rimborsati. Per consentire all’offerta di attivarsi anche quando il trigger ha uno sconto, abilita l’interruttore Allow replacement when target has a discount nelle impostazioni avanzate dell’offerta. Quando è abilitato, il rimborso copre il prezzo scontato (non il prezzo pieno) e la sostituzione viene addebitata in base alla configurazione dell’offerta.

​
Sconto sul primo ciclo nelle sostituzioni con abbonamento

Quando la sostituzione è un abbonamento, lo sconto configurato sull’offerta si applica solo al primo ciclo di fatturazione. Gli ordini ricorrenti successivi vengono addebitati al prezzo regolare dell’abbonamento. Il cliente vede il prezzo ricorrente sotto Recurring subtotal nell’offerta.

​
Funnel per variante

Una singola offerta Replacement Upsell punta a un prodotto e a una variante specifici su ciascun lato. Se i tuoi piani di abbonamento differiscono per variante (taglie, gusti o prezzi diversi), non puoi configurare un’unica offerta che dica “sostituisci qualunque variante abbia acquistato il cliente con la variante in abbonamento corrispondente”. Ogni abbinamento di varianti ha bisogno di un proprio funnel. Ad esempio, se vendi un siero in tre formati (Small / Medium / Large) e vuoi che ciascuno venga sostituito con la sua controparte in abbonamento, dovresti creare tre funnel:
  • Funnel 1: trigger = Small una tantum, sostituzione = Small in abbonamento.
  • Funnel 2: trigger = Medium una tantum, sostituzione = Medium in abbonamento.
  • Funnel 3: trigger = Large una tantum, sostituzione = Large in abbonamento.
Aftersell attualmente non include una funzione integrata di abbinamento delle varianti, quindi ogni coppia di varianti ha bisogno di un proprio funnel.

​
Analitiche e reporting

I rimborsi generati da un Replacement Upsell riportano in Shopify la nota “AfterSell Post-Purchase Replacement Upsell”, che rende facile identificare i rimborsi legati alle sostituzioni. Le analitiche di Aftersell non sottraggono l’importo rimborsato dal valore dell’upsell. La sostituzione di un prodotto da $100 con un prodotto da $200 viene riportata come un upsell da $200, non come $100 netti.

​
Il failsafe della Beta

Finché Replacement Upsell è in Beta, Aftersell tiene traccia degli errori su ogni offerta e smette di mostrare l’offerta ai nuovi clienti quando il conteggio degli errori supera una soglia. In questo modo sei protetto da un errore di configurazione diffuso che colpisce silenziosamente molti clienti.
Failsafe della Beta di Replacement Upsell nell'Order Browser

​
Configurare la soglia del failsafe

La soglia del failsafe è configurabile in Settings → Replacement Upsells. Conta gli errori di sostituzione in una finestra mobile di 7 giorni e sospende gli upsell di sostituzione una volta raggiunta la soglia scelta all’interno di quella finestra. Puoi scegliere tra:
  • Stop on any issue in the past 7 days (consigliata e predefinita). L’offerta si interrompe non appena fallisce la prima sostituzione nella finestra mobile.
  • Stop after 3 issues in the past 7 days.
  • Stop after 5 issues in the past 7 days.
  • Stop after 7 issues in the past 7 days (la più permissiva).
  • Custom mostra un campo numerico in cui puoi inserire qualsiasi numero intero da 1 a 100. Usala se il tuo negozio elabora volumi elevati di ordini e le preimpostazioni scattano troppo rapidamente.
Scegli una soglia più alta se sei sicuro della configurazione dell’offerta e vuoi assorbire qualche errore temporaneo di Shopify o del provider di abbonamenti senza disattivare l’offerta. Scegli una soglia più bassa se gli errori visibili ai clienti hanno un costo elevato per il tuo negozio.

​
Cosa fa scattare il failsafe

Qualsiasi eccezione nel flusso di sostituzione conta come errore all’interno della finestra mobile di 7 giorni. Le cause più comuni:
  • Shopify rifiuta il changeset perché il checkout è già stato completato.
  • Il prodotto sostitutivo è stato eliminato o rimosso dalla pubblicazione tra la configurazione dell’offerta e l’accettazione da parte del cliente.
  • Il selling plan di una sostituzione con abbonamento è stato disattivato.
  • Un’interruzione temporanea dell’API di Shopify o del provider di abbonamenti.

​
Quando scatta il failsafe

Quando il conteggio degli errori nella finestra mobile di 7 giorni raggiunge la tua soglia, l’offerta smette di essere mostrata ai nuovi clienti. Lo saprai in due punti:
  • Banner della home page. Sulla home page di Aftersell compare un banner di avviso intitolato “Replacement upsells are paused”, con un pulsante Review failsafe che rimanda a Settings → Replacement Upsells.
  • Card dello stato del failsafe (Settings → Replacement Upsells). Una card di stato mostra un badge Failsafe tripped (ambra) o Not tripped (verde), oltre al conteggio attuale nella finestra mobile e alla soglia, ad esempio “4 of 5 errors in the past 7 days”.
Poiché il failsafe usa una finestra mobile di 7 giorni, si ripristina da solo: una volta che il conteggio degli errori scende sotto la soglia, gli upsell di sostituzione riprendono automaticamente, senza alcuna azione richiesta.

​
Come reimpostarlo

Puoi reimpostare il failsafe in autonomia da Settings → Replacement Upsells. Una volta risolto il problema sottostante, clicca su Reset failsafe e conferma nel modale. Il conteggio degli errori nella finestra mobile si azzera immediatamente e gli upsell di sostituzione riprendono per i nuovi ordini. (Il pulsante è disattivato quando il conteggio attuale degli errori è già zero.) Reimposta solo dopo aver risolto la causa principale, altrimenti il failsafe scatterà di nuovo una volta raggiunta la soglia. Se non sei sicuro di cosa abbia causato gli errori, contatta il supporto tramite la chat in-app prima di reimpostare.

​
Risoluzione dei problemi

Replacement Upsell è una funzione in Beta che richiede l’attivazione manuale da parte del supporto Aftersell. Contatta il supporto tramite la chat in-app per richiedere l’accesso. Una volta attivata, l’interruttore Replace item in original order with upsell comparirà nelle impostazioni avanzate dell’offerta.
Tre possibili cause:
  • Trigger del funnel non corrispondente. Verifica che il prodotto trigger sia lo stesso prodotto presente nel carrello dell’ordine di test.
  • L’ordine contiene già un abbonamento. Replacement Upsell salta qualsiasi ordine in cui la riga trigger è un abbonamento. In quel caso usa invece Subscription Upgrade.
  • La riga originale ha uno sconto. Per impostazione predefinita, Replacement Upsell salta le righe con uno sconto a livello di ordine. Abilita Allow replacement when target has a discount nelle impostazioni avanzate dell’offerta.
Un’offerta Replacement Upsell ha tre selezioni di prodotto separate nell’editor, che devono essere configurate in modo coerente affinché la sostituzione si attivi:
  1. Trigger del funnel. Impostato a livello di funnel. Determina quali ordini vedono l’offerta.
  2. Prodotto in upsell. Impostato nella sezione Upsell Products dell’offerta. È il prodotto che viene aggiunto all’ordine quando il cliente accetta.
  3. Edit product to replace. Impostato all’interno della sezione Replace item in original order with upsell, cliccando sul pulsante Edit product to replace. È il prodotto e la variante esatti nel carrello del cliente che verranno rimborsati e rimossi.
L’errore di configurazione più comune: il prodotto da sostituire non corrisponde alla variante effettivamente presente nel carrello del cliente. Quando ciò accade, Aftersell non riesce a trovare un articolo corrispondente da rimuovere e la sostituzione non si attiva, senza alcun avviso.Per risolvere:
  • Apri l’offerta Replacement Upsell.
  • Clicca su Edit product to replace e verifica che il prodotto e la variante selezionati corrispondano esattamente al prodotto+variante che il cliente dovrebbe aver acquistato (in base al trigger del funnel).
  • Se stai sostituendo tra varianti dello stesso prodotto (Small → Large), il “prodotto da sostituire” deve puntare specificamente alla variante Small. Se lo fai puntare a Large o a qualsiasi variante che il cliente non ha acquistato, l’offerta verrà saltata.
  • Salva e testa con un ordine reale a basso prezzo che includa esattamente la variante da cui vuoi effettuare la sostituzione.
È il comportamento previsto. La riga originale viene rimborsata e la sostituzione viene addebitata, quindi l’estratto conto bancario del cliente mostra due transazioni anche se l’importo netto è il prezzo dell’offerta visualizzato. Per ridurre la confusione:
  • Aggiungi al testo dell’offerta una frase che spieghi il meccanismo di rimborso e sostituzione.
  • Abilita l’email automatica di notifica del rimborso di Aftersell per gli upsell di sostituzione.
  • Forma il tuo team di supporto affinché sappia spiegare lo schema delle due voci quando un cliente lo contatta.
Alcuni gateway di pagamento (tra cui Authorize.net e altri che regolano le transazioni in batch con un ritardo) non consentono rimborsi finché la transazione originale non è stata regolata. Poiché un Replacement Upsell addebita la sostituzione e rimborsa l’originale subito dopo il checkout, il passaggio di rimborso può fallire con l’errore “Partial refunds are not allowed until the transaction is settled. Please try again later.” Aftersell non ritenta automaticamente il rimborso dopo la regolazione, quindi dovrai emettere il rimborso manualmente dall’ordine Shopify una volta regolata la transazione originale (in genere entro 24 ore, a seconda del calendario di regolazione del tuo gateway). Per evitare questo scenario, Replacement Upsell viene saltato del tutto per i gateway noti come non supportati. Se continui a vederlo su un gateway supportato, contatta il supporto affinché possiamo indagare.
Quando Aftersell rimborsa l’articolo originale, qualsiasi sconto applicato a esso viene rimosso con il rimborso. La riga sostitutiva viene addebitata separatamente. Se vuoi che il cliente mantenga lo sconto, configuralo direttamente sull’offerta di sostituzione usando il campo sconto dell’offerta.
No. Se l’articolo originale nell’ordine è già un abbonamento, Replacement Upsell non si attiva. Questo perché la rimozione dell’articolo in abbonamento non annulla il contratto di abbonamento nella tua app di abbonamenti; al cliente verrebbe comunque addebitato l’abbonamento e riceverebbe anche la sostituzione. Per modificare un abbonamento esistente (cambiare frequenza, sostituire il prodotto o entrambi), usa invece Subscription Upgrade.
Replacement Upsell tiene traccia degli errori per offerta in una finestra mobile di 7 giorni e smette di mostrare l’offerta quando il conteggio degli errori supera la soglia configurata in Settings → Replacement Upsells (predefinita: interrompi al primo problema negli ultimi 7 giorni). Quando scatta il failsafe, sulla home page di Aftersell compare un banner “Replacement upsells are paused” con un link Review failsafe a Settings → Replacement Upsells, dove una card di stato mostra il conteggio attuale degli errori e se il failsafe è scattato.Se gli errori non si verificano più, l’offerta riprende automaticamente una volta che il conteggio nella finestra mobile di 7 giorni scende sotto la soglia. Per riprendere immediatamente dopo aver risolto il problema, clicca su Reset failsafe in quella pagina delle impostazioni. Se non sei sicuro della causa principale, contatta il supporto tramite la chat in-app.
La card dell’offerta usa l’immagine specifica della variante quando ne è associata una alla variante in Shopify. Se la variante non ha un’immagine associata, la card dell’offerta usa la prima immagine del prodotto principale. Se stai sostituendo tra varianti dello stesso prodotto e l’immagine non cambia, verifica che ogni variante abbia una propria immagine configurata in Shopify.
Crea un funnel per variante. Ogni funnel ha un trigger prodotto+variante e un prodotto+variante sostitutivo corrispondente. Aftersell attualmente non include una funzione integrata di abbinamento delle varianti.
Stesso tipo di errore del Subscription Upsell: molto spesso un selling plan è stato disattivato tra la visualizzazione dell’offerta e l’accettazione da parte del cliente. Shopify accetta il changeset ma nessun abbonamento viene attivato a valle. Verifica che il selling plan sia ancora attivo in Shopify e assegnato al prodotto sostitutivo. Controlla l’importazione degli ordini o i log dei webhook della tua app di abbonamenti per l’ordine interessato. Se l’abbonamento manca, il team di supporto della tua app di abbonamenti di solito può iscrivere manualmente il cliente.
Aftersell non gestisce l’annullamento degli abbonamenti. L’annullamento dei cicli futuri avviene nel portale clienti del tuo provider di abbonamenti o da parte del cliente stesso. Il meccanismo di rimborso di Shopify per il primo ciclo funziona come per qualsiasi altro articolo.
È il comportamento previsto. Authorize.net è esplicitamente bloccato per Replacement Upsell nel codice di Aftersell perché richiede che le transazioni vengano regolate prima di poter emettere rimborsi, e la regolazione avviene con un ritardo che compromette lo schema di rimborso e nuovo addebito su cui si basa Replacement Upsell. In alternativa, usa le offerte della pagina di ringraziamento per i clienti Authorize.net. Puoi confermare che la causa è questa aprendo l’ordine nell’order browser di Aftersell; il motivo del salto riporterà “Payment gateway does not support replacement upsells.”
I gateway di pagamento manuali (pagamento alla consegna, metodi di pagamento personalizzati, checkout di ordini bozza) sono esplicitamente bloccati per Replacement Upsell perché non memorizzano una carta per gli addebiti successivi. L’order browser mostrerà “Payment gateway does not support replacement upsells” come motivo del salto. Per le limitazioni più ampie dei metodi di pagamento sulle offerte post-acquisto, consulta Metodi di pagamento.