ANS - SL Marketplace統合

Automatic Notification System(ANS)を使用して、あなたのSL Marketplace出品をAvatarShotに接続しましょう。SL Marketplaceでの販売はすべて自動的にあなたのAvatarShotストアに同期されます。

ANSとは?

ANS(Automatic Notification System)はSecond Life Marketplaceの機能です。あなたの商品が購入されると、Linden Labが指定したURLに通知を送信します。AvatarShotはこの通知を受け取り、以下を行います。

ダッシュボードに販売を記録
販売統計と収益を更新
(再配送のため)Delivery Bot経由での配送をキューに追加
販売を正しい商品に紐付け

設定手順

ステップ1:認証情報を取得する

マイストアにアクセス
「SL Marketplace」タブをクリック
通知URLと通知ソルトをコピー

ステップ2:SL Marketplace側で設定する

marketplace.secondlife.com/merchantsにアクセス
自分のストアをクリック →ストア設定
「Automatic Notifications (ANS)」セクションを見つける
URL欄に通知URLを貼り付け
Salt欄に通知ソルトを貼り付け
保存をクリック

ステップ3:商品を一致させる

販売を正しい商品に紐付けるためには、以下のいずれかを満たす必要があります。

SL MarketplaceとAvatarShot上で商品名が一致している、または
各商品にSL出品IDを設定している(SL MarketplaceのURL内に記載:/p/Product-Name/12345)

仕組み

お客様がSL Marketplaceで購入
        ↓
Linden LabがあなたのNotification URLにPOSTを送信
        ↓
AvatarShotが受信:購入者名、商品名、金額、取引ID
        ↓
販売を記録 → 統計を更新 → 配送をキューに追加
        ↓
Delivery Botが商品を送信(再配送用)

取得するデータ

フィールド	説明
TransactionID	一意の取引識別子
BuyerName	購入者のアバター名
BuyerKey	購入者のUUID
ReceiverName	商品の受取人(ギフトの場合)
ItemName	商品名
Amount	支払われた金額(L$)
Type	order(通常注文)またはgift(ギフト)

よくある質問

Q: ANSを使うのにDelivery Botは必要ですか?
A: 配送自体はSL Marketplaceが行います。ANSは販売データをAvatarShotに同期するだけです。Delivery Botはウェブからの再配送を行う場合にのみ必要です。

Q: ANSとベンダースクリプトを併用できますか?
A: はい!ANSはSL Marketplaceでの販売を追跡し、ベンダースクリプトはインワールドでの販売を追跡します。どちらもダッシュボードに表示されます。

Q: 販売が商品と一致しない場合はどうなりますか?
A: 商品名と金額とともに販売は記録されますが、特定の商品ページには紐付けられません。これを解決するにはSL出品IDを追加してください。

ANS統合