ANS - SL Marketplace 集成
使用自动通知系统(ANS)将你的 SL Marketplace 商品与 AvatarShot 关联起来。SL Marketplace 上的每一笔销售都会自动同步到你的 AvatarShot 店铺。
什么是 ANS?
ANS(自动通知系统)是 Second Life Marketplace 的一项功能。当有人购买你的商品时,Linden Lab 会向你指定的网址发送通知。AvatarShot 接收到该通知后会:
- 在你的仪表盘中记录这笔销售
- 更新你的销售统计数据和收入
- 通过你的发货机器人排队进行发货(用于补发)
- 将销售记录关联到正确的商品
设置说明
第一步:获取你的凭据
- 前往我的店铺
- 点击“SL Marketplace”标签页
- 复制你的通知网址和通知盐值
第二步:在 SL Marketplace 上进行配置
- 前往 marketplace.secondlife.com/merchants
- 点击你的店铺 → 店铺设置
- 找到“自动通知 (ANS)”部分
- 将你的通知网址粘贴到网址字段中
- 将你的通知盐值粘贴到盐值字段中
- 点击保存
第三步:匹配商品
为确保销售记录能关联到正确的商品,请确认以下任一情况:
- SL Marketplace 上的商品名称与 AvatarShot 上的名称一致,或者
- 你已在每个商品上设置了 SL 商品编号(可在 SL Marketplace 网址中找到:
/p/Product-Name/12345)
工作原理
顾客在 SL Marketplace 上购买
↓
Linden Lab 向你的通知网址发送 POST 请求
↓
AvatarShot 接收:买家名称、商品名称、金额、交易ID
↓
记录销售 → 更新统计数据 → 排队发货
↓
你的发货机器人发送商品(用于补发)
我们接收的数据
| 字段 | 说明 |
|---|---|
| TransactionID | 唯一交易标识符 |
| BuyerName | 买家的化身名称 |
| BuyerKey | 买家的 UUID |
| ReceiverName | 实际接收商品的人(用于礼物赠送) |
| ItemName | 商品名称 |
| Amount | 以 L$ 计的支付金额 |
| Type | order(订单)或 gift(礼物) |
常见问题
问:使用 ANS 还需要发货机器人吗?
答:SL Marketplace 会自行处理发货。ANS 只负责将销售数据同步到 AvatarShot。发货机器人仅用于从网站发起的补发。
问:我可以同时使用 ANS 和售货机脚本吗?
答:可以!ANS 追踪 SL Marketplace 的销售,售货机脚本追踪虚拟世界内的销售。两者都会显示在你的仪表盘中。
问:如果某笔销售没有匹配到商品怎么办?
答:该销售仍会被记录下来,包含商品名称和金额,但不会关联到具体的商品页面。添加 SL 商品编号即可解决此问题。