ANS - Integração com o SL Marketplace

Conecte seus anúncios do SL Marketplace ao AvatarShot usando o Automatic Notification System (ANS). Toda venda no SL Marketplace será sincronizada automaticamente com sua loja no AvatarShot.

O que é o ANS?

O ANS (Automatic Notification System) é um recurso do Second Life Marketplace. Quando alguém compra seu produto, a Linden Lab envia uma notificação para uma URL especificada por você. O AvatarShot recebe essa notificação e:

Registra a venda no seu painel
Atualiza suas estatísticas de vendas e receita
Enfileira a entrega via seu Delivery Bot (para reentrega)
Vincula a venda ao produto correto

Instruções de Configuração

Passo 1: Obtenha Suas Credenciais

Acesse Minha Loja
Clique na aba "SL Marketplace"
Copie sua Notification URL e seu Notification Salt

Passo 2: Configure no SL Marketplace

Acesse marketplace.secondlife.com/merchants
Clique na sua loja → Store Settings
Encontre a seção "Automatic Notifications (ANS)"
Cole sua Notification URL no campo de URL
Cole seu Notification Salt no campo de Salt
Clique em Save

Passo 3: Corresponda os Produtos

Para que as vendas sejam vinculadas ao produto correto, certifique-se de que:

Os nomes dos produtos no SL Marketplace correspondem aos nomes no AvatarShot, OU
Você definiu o SL Listing ID em cada produto (encontrado na URL do SL Marketplace: /p/Product-Name/12345)

Como Funciona

Cliente compra no SL Marketplace
        ↓
Linden Lab envia POST para sua Notification URL
        ↓
AvatarShot recebe: nome do comprador, nome do item, valor, ID da transação
        ↓
Venda registrada → Estatísticas atualizadas → Entrega enfileirada
        ↓
Seu Delivery Bot envia o item (para reentrega)

Dados Que Recebemos

Campo	Descrição
TransactionID	Identificador único da transação
BuyerName	Nome do avatar do comprador
BuyerKey	UUID do comprador
ReceiverName	Quem recebe o item (para presentes)
ItemName	Nome do produto
Amount	Preço pago em L$
Type	order ou gift

Perguntas Frequentes

P: Preciso de um Delivery Bot para o ANS?
R: O SL Marketplace cuida da entrega por conta própria. O ANS apenas sincroniza os dados da venda com o AvatarShot. O Delivery Bot só é necessário para reentrega a partir da web.

P: Posso usar o ANS e o Vendor Script juntos?
R: Sim! O ANS rastreia as vendas do SL Marketplace, o Vendor Script rastreia as vendas in-world. Ambas aparecem no seu painel.

P: E se uma venda não corresponder a nenhum produto?
R: A venda ainda é registrada com o nome do item e o valor, mas não será vinculada a uma página de produto específica. Adicione o SL Listing ID para corrigir isso.

Integração ANS