ANS - Intégration SL Marketplace

Connectez vos annonces SL Marketplace à AvatarShot grâce au système de notification automatique (ANS). Chaque vente sur le SL Marketplace sera automatiquement synchronisée avec votre boutique AvatarShot.

Qu'est-ce que l'ANS ?

L'ANS (Automatic Notification System) est une fonctionnalité du Second Life Marketplace. Lorsque quelqu'un achète votre produit, Linden Lab envoie une notification à une URL que vous spécifiez. AvatarShot reçoit cette notification et :

Enregistre la vente dans votre tableau de bord
Met à jour vos statistiques de vente et vos revenus
Met la livraison en file d'attente via votre Delivery Bot (pour la re-livraison)
Relie la vente au bon produit

Instructions de configuration

Étape 1 : récupérer vos identifiants

Rendez-vous sur Ma boutique
Cliquez sur l'onglet « SL Marketplace »
Copiez votre URL de notification et votre Salt de notification

Étape 2 : configurer sur le SL Marketplace

Rendez-vous sur marketplace.secondlife.com/merchants
Cliquez sur votre boutique → Paramètres de la boutique
Trouvez la section « Automatic Notifications (ANS) »
Collez votre URL de notification dans le champ URL
Collez votre Salt de notification dans le champ Salt
Cliquez sur Enregistrer

Étape 3 : faire correspondre les produits

Pour que les ventes soient reliées au bon produit, assurez-vous que :

Les noms des produits sur le SL Marketplace correspondent aux noms sur AvatarShot, OU
Vous avez défini l'ID d'annonce SL sur chaque produit (visible dans l'URL du SL Marketplace : /p/Nom-Du-Produit/12345)

Comment ça marche

Le client achète sur le SL Marketplace
        ↓
Linden Lab envoie un POST vers votre URL de notification
        ↓
AvatarShot reçoit : nom de l'acheteur, nom de l'article, montant, ID de transaction
        ↓
Vente enregistrée → Statistiques mises à jour → Livraison mise en file d'attente
        ↓
Votre Delivery Bot envoie l'article (pour la re-livraison)

Données que nous recevons

Champ	Description
TransactionID	Identifiant unique de la transaction
BuyerName	Nom d'avatar de l'acheteur
BuyerKey	UUID de l'acheteur
ReceiverName	Qui reçoit l'article (pour les cadeaux)
ItemName	Nom du produit
Amount	Prix payé en L$
Type	order ou gift

FAQ

Q : Ai-je besoin d'un Delivery Bot pour l'ANS ?
R : Le SL Marketplace gère lui-même la livraison. L'ANS ne fait que synchroniser les données de vente avec AvatarShot. Le Delivery Bot n'est nécessaire que pour la re-livraison depuis le web.

Q : Puis-je utiliser l'ANS et le script Vendor ensemble ?
R : Oui ! L'ANS suit les ventes SL Marketplace, le script Vendor suit les ventes in-world. Les deux apparaissent dans votre tableau de bord.

Q : Que se passe-t-il si une vente ne correspond à aucun produit ?
R : La vente est tout de même enregistrée avec le nom de l'article et le montant, mais ne sera pas reliée à une page produit spécifique. Ajoutez l'ID d'annonce SL pour corriger cela.

Intégration ANS