Skip to main content

Panoramica

Upcart è un’app separata da Aftersell, quindi le Strategy non sono integrate nel modulo Upsells come lo sono nei flussi post-acquisto e di checkout di Aftersell. Puoi però fare da ponte tra le due app con un piccolo script che chiama direttamente la Strategies API e passa il risultato al modulo Upsells esistente di Upcart tramite l’API pubblica di Upcart. Lo script è pronto all’uso: incollalo una volta nell’HTML personalizzato di Upcart, sostituisci due valori (la tua Strategy API key e lo Strategy ID) e il modulo Upsells inizierà a mostrare i prodotti restituiti dalla Strategy.

Di cosa avrai bisogno

  1. La tua Strategy API key. In Aftersell, vai su Settings → Product Strategy e, nella scheda Security Token, copia il tuo token (questa è la tua Strategy API key).
  2. Lo Strategy ID. Apri la Strategy che vuoi eseguire nell’editor delle Strategy di Aftersell e copia il suo ID.
  3. Il modulo Upsells abilitato in Upcart. Lo script sovrascrive l’elenco dei prodotti mostrati nel blocco di upsell esistente, quindi il modulo deve essere attivo perché venga visualizzato qualcosa.

Aggiungere lo script

In Upcart, vai su Settings → Custom HTML → Scripts (before load) e incolla lo script qui sotto. Sostituisci STRATEGY_ID e STRATEGY_API_KEY con i valori di Aftersell, poi salva.
La tua Strategy API key autorizza le chiamate verso le Strategy del tuo negozio. Lo script qui sopra la inserisce nel codice lato client, che è l’unico modo pratico per invocare l’API dal cart drawer. Tratta la chiave come qualsiasi altra credenziale pubblica della vetrina e ruotala da Aftersell Settings → Product Strategy se dovesse mai essere esposta in un modo non voluto.

Cosa vede la Strategy

Poiché questo viene eseguito dal carrello della vetrina, il contesto è un sottoinsieme ridotto di quanto disponibile sulle superfici native di Aftersell:

Contesto prodotto

Le voci attualmente nel carrello Upcart vengono inviate come prodotti di input. Trigger come product type, vendor, product handle, product title e qualsiasi trigger su product ID / variant ID vengono tutti valutati rispetto a questi articoli.

Contesto carrello

  • Subtotal - il subtotale del carrello nelle unità principali della valuta del negozio (es. dollari). Il total_price di Upcart è in unità minori (centesimi), quindi lo script divide per 100 per allinearsi alle unità usate dal resto della Strategies API - e alle unità in cui sono scritte le tue regole cart_subtotal.
  • Item count - la quantità totale su tutte le righe.
  • Line count - il numero di voci distinte.

Contesto sessione

  • Codice valuta - ricavato da window.Shopify.currency.active.
I trigger su cliente e UTM non troveranno corrispondenza. Lo script predefinito non invia tag cliente, numero di ordini, posizione o parametri UTM, quindi qualsiasi regola che usa questi trigger non si attiverà mai. Usa trigger su prodotto, carrello e valuta, oppure un Catch all, per assicurarti che venga sempre restituito qualcosa.

Cosa succede quando la Strategy restituisce un risultato

I prodotti restituiti dalla Strategy sostituiscono completamente l’elenco che Upcart mostrerebbe altrimenti nel modulo Upsells. L’elenco di upsell definito dal merchant viene sovrascritto per la durata di quel carrello: non viene unito. Ogni prodotto della Strategy viene mappato nella forma di prodotto attesa da Upcart (varianti, immagini, opzioni, metafield, ecc.) in modo da essere visualizzato all’interno del blocco di upsell esattamente come qualsiasi altro prodotto.

Quando nessun prodotto viene restituito

Se la Strategy non restituisce alcun prodotto, il modulo Upsells viene visualizzato vuoto: nessun upsell viene mostrato. Per evitarlo, configura un Catch all nella Strategy in modo che ci sia sempre un prodotto di riserva da restituire. Consulta la pagina Costruire le Strategy per scoprire come impostare un Catch all.

Rivalutazione alle modifiche del carrello

A differenza degli upsell al checkout, l’implementazione Upcart rivaluta la Strategy ogni volta che il carrello cambia: articoli aggiunti, rimossi o con quantità aggiornata. Lo script si iscrive all’evento cartUpdated di Upcart, invia il nuovo carrello alla Strategies API e aggiorna il cart drawer con il nuovo elenco di upsell. Un controllo sulla firma del carrello salta le chiamate ridondanti se le voci e le quantità non sono effettivamente cambiate, quindi eventi del carrello consecutivi che non lo modificano in modo sostanziale non richiameranno l’API.

Suggerimenti per le Strategy in Upcart

  • Progetta intorno al carrello. I trigger sulla composizione del carrello e sui prodotti sono i segnali più forti che hai qui. La cronologia del cliente e il targeting basato su UTM non vengono inviati dallo script predefinito.
  • Usa il Catch all come rete di sicurezza. Senza di esso, il modulo Upsells non mostrerà nulla quando nessuna regola corrisponde.
  • Cache-friendly per impostazione predefinita. La protezione basata sulla firma del carrello evita di richiamare l’API se il carrello non è cambiato in modo sostanziale: ottimo per gli acquirenti che aprono e chiudono il carrello senza modificarlo.