ANS - Integrazione SL Marketplace

Collega le tue inserzioni SL Marketplace ad AvatarShot usando l'Automatic Notification System (ANS). Ogni vendita sul SL Marketplace si sincronizzerà automaticamente con il tuo negozio AvatarShot.

Cos'è ANS?

ANS (Automatic Notification System) è una funzionalità del Second Life Marketplace. Quando qualcuno acquista il tuo prodotto, Linden Lab invia una notifica a un URL che specifichi tu. AvatarShot riceve questa notifica e:

Registra la vendita nella tua dashboard
Aggiorna le tue statistiche di vendita e i ricavi
Mette in coda la consegna tramite il tuo Delivery Bot (per la riconsegna)
Collega la vendita al prodotto corretto

Istruzioni per la Configurazione

Passo 1: Ottieni le Tue Credenziali

Vai su Il Mio Negozio
Clicca sulla scheda "SL Marketplace"
Copia il tuo Notification URL e il tuo Notification Salt

Passo 2: Configura su SL Marketplace

Vai su marketplace.secondlife.com/merchants
Clicca sul tuo negozio → Store Settings
Trova la sezione "Automatic Notifications (ANS)"
Incolla il tuo Notification URL nel campo URL
Incolla il tuo Notification Salt nel campo Salt
Clicca su Save

Passo 3: Abbina i Prodotti

Perché le vendite vengano collegate al prodotto corretto, assicurati che:

I nomi dei prodotti su SL Marketplace corrispondano ai nomi su AvatarShot, OPPURE
Tu imposti l'SL Listing ID su ogni prodotto (si trova nell'URL di SL Marketplace: /p/Product-Name/12345)

Come Funziona

Il cliente acquista su SL Marketplace
        ↓
Linden Lab invia una POST al tuo Notification URL
        ↓
AvatarShot riceve: nome dell'acquirente, nome articolo, importo, ID transazione
        ↓
Vendita registrata → Statistiche aggiornate → Consegna in coda
        ↓
Il tuo Delivery Bot invia l'articolo (per la riconsegna)

Dati che Riceviamo

Campo	Descrizione
TransactionID	Identificativo univoco della transazione
BuyerName	Nome avatar dell'acquirente
BuyerKey	UUID dell'acquirente
ReceiverName	Chi riceve l'articolo (per i regali)
ItemName	Nome del prodotto
Amount	Prezzo pagato in L$
Type	order o gift

Domande Frequenti

D: Mi serve un Delivery Bot per ANS?
R: Il SL Marketplace gestisce la consegna da solo. ANS si limita a sincronizzare i dati di vendita con AvatarShot. Il Delivery Bot serve solo per la riconsegna dal web.

D: Posso usare ANS e il Vendor Script insieme?
R: Sì! ANS traccia le vendite sul SL Marketplace, il Vendor Script traccia le vendite in-world. Entrambe compaiono nella tua dashboard.

D: Cosa succede se una vendita non corrisponde a un prodotto?
R: La vendita viene comunque registrata con il nome dell'articolo e l'importo, ma non sarà collegata a una pagina prodotto specifica. Aggiungi l'SL Listing ID per risolvere il problema.

Integrazione ANS