ANS – SL Marketplace-Integration

Verbinden Sie Ihre SL-Marketplace-Angebote mit AvatarShot über das Automatic Notification System (ANS). Jeder Verkauf im SL Marketplace wird automatisch mit Ihrem AvatarShot-Store synchronisiert.

Was ist ANS?

ANS (Automatic Notification System) ist eine Funktion des Second Life Marketplace. Wenn jemand Ihr Produkt kauft, sendet Linden Lab eine Benachrichtigung an eine von Ihnen angegebene URL. AvatarShot empfängt diese Benachrichtigung und:

Erfasst den Verkauf in Ihrem Dashboard
Aktualisiert Ihre Verkaufsstatistiken und Einnahmen
Stellt die Lieferung über Ihren Delivery Bot in die Warteschlange (für erneute Lieferung)
Verknüpft den Verkauf mit dem richtigen Produkt

Einrichtungsanleitung

Schritt 1: Ihre Zugangsdaten abrufen

Gehen Sie zu Mein Store
Klicken Sie auf den Tab „SL Marketplace"
Kopieren Sie Ihre Benachrichtigungs-URL und Ihr Benachrichtigungs-Salt

Schritt 2: Konfiguration im SL Marketplace

Gehen Sie zu marketplace.secondlife.com/merchants
Klicken Sie auf Ihren Store → Store-Einstellungen
Suchen Sie den Bereich „Automatic Notifications (ANS)"
Fügen Sie Ihre Benachrichtigungs-URL in das URL-Feld ein
Fügen Sie Ihr Benachrichtigungs-Salt in das Salt-Feld ein
Klicken Sie auf Speichern

Schritt 3: Produkte zuordnen

Damit Verkäufe dem richtigen Produkt zugeordnet werden, stellen Sie sicher, dass:

die Produktnamen im SL Marketplace mit den Namen auf AvatarShot übereinstimmen, ODER
Sie die SL Listing ID für jedes Produkt festlegen (zu finden in der SL-Marketplace-URL: /p/Product-Name/12345)

So funktioniert es

Kunde kauft im SL Marketplace
        ↓
Linden Lab sendet POST an Ihre Benachrichtigungs-URL
        ↓
AvatarShot empfängt: Käufername, Artikelname, Betrag, Transaktions-ID
        ↓
Verkauf erfasst → Statistik aktualisiert → Lieferung in Warteschlange
        ↓
Ihr Delivery Bot sendet den Artikel (für erneute Lieferung)

Daten, die wir erhalten

Feld	Beschreibung
TransactionID	Eindeutige Transaktionskennung
BuyerName	Avatarname des Käufers
BuyerKey	UUID des Käufers
ReceiverName	Empfänger des Artikels (bei Geschenken)
ItemName	Produktname
Amount	Gezahlter Preis in L$
Type	order oder gift

FAQ

F: Brauche ich einen Delivery Bot für ANS?
A: Der SL Marketplace übernimmt die Lieferung selbst. ANS synchronisiert nur die Verkaufsdaten mit AvatarShot. Der Delivery Bot wird nur für die erneute Lieferung über das Web benötigt.

F: Kann ich ANS und das Vendor-Skript gemeinsam nutzen?
A: Ja! ANS erfasst Verkäufe im SL Marketplace, das Vendor-Skript erfasst Verkäufe in der Welt. Beide erscheinen in Ihrem Dashboard.

F: Was passiert, wenn ein Verkauf keinem Produkt zugeordnet werden kann?
A: Der Verkauf wird trotzdem mit Artikelname und Betrag erfasst, ist aber keiner bestimmten Produktseite zugeordnet. Fügen Sie die SL Listing ID hinzu, um dies zu beheben.

ANS-Integration