Rastreamento server-side para lojas Ecwid
O ROASaurus lê os pedidos pagos do Ecwid por meio de um token de app personalizado e os envia às suas plataformas de anúncios a partir do servidor. Peça webhooks ao suporte do Ecwid e os pedidos chegam na hora.
| O Ecwid em resumo | |
|---|---|
| Os pedidos chegam por | Polling da API a cada 5 minutos; webhooks assim que o suporte do Ecwid os ativar |
| Credenciais | ID da loja, o token secreto do app personalizado e o client secret dele para webhooks |
| Verificação do webhook | Assinatura HMAC com o client secret |
| Pedidos pagos | Status de pagamento PAID |
| Snippet de agradecimento | Ecwid.OnOrderPlaced, depois do script de rastreamento |
Como o Ecwid se conecta
- Adicione o script do ROASaurus ao site que incorpora a sua loja Ecwid, ou ao código personalizado do seu Instant Site.
- Adicione o snippet de agradecimento depois dele. Ele escuta o evento
OnOrderPlaceddo Ecwid e dispara a compra do ROASaurus com o número, o total e o e-mail do pedido. - Em my.ecwid.com/#develop-apps, crie um app personalizado com acesso de leitura aos pedidos. Informe no ROASaurus o ID da sua loja (mostrado na URL do seu admin e em Account › Summary) e o token
secret_…do app.
O ROASaurus então busca os pedidos atualizados desde a última execução, a cada 5 minutos, e envia os que têm status de pagamento PAID.
Pedidos instantâneos com webhooks
O Ecwid define as URLs de webhook de apps personalizados por meio da equipe de suporte da API. Peça a eles que definam a URL de webhook do seu app como a que aparece na Connection tab do seu ROASaurus, com os eventos order.created e order.updated. Cole o client secret do app no ROASaurus: cada webhook é verificado pela assinatura HMAC, e o pedido é então buscado na API.
O que o ROASaurus lê de cada pedido
O total, a moeda, o e-mail, o nome, o telefone e o endereço de cobrança, o ID do cliente e os itens com a combinação, a quantidade, o preço e o SKU. Os pedidos do Ecwid incluem o endereço IP e o user agent do comprador, então o ROASaurus também consegue fazer a correspondência pelo mesmo IP e navegador, apenas quando exatamente um visitante se encaixa.
Limites
- Os webhooks exigem uma solicitação ao suporte do Ecwid. Até lá, os pedidos levam até 5 minutos.
- O Ecwid fornece um único campo de nome, que o ROASaurus divide em nome e sobrenome.
- O conector foi criado com base na documentação oficial da API da plataforma. Clique em Test connection depois de salvar as suas credenciais, faça um pedido de teste e confira o Event log.
Relacionados
Perguntas respondidas
Por que preciso falar com o Ecwid para ter webhooks?
O Ecwid configura a URL de webhook de um app personalizado por meio do suporte da API. O polling a cada 5 minutos funciona sem eles.
Para que serve o client secret?
Ele confirma que um webhook realmente vem do Ecwid. O ROASaurus verifica a assinatura HMAC de cada webhook com ele antes de buscar o pedido.
Funciona com o Ecwid incorporado em outro site?
Sim. Adicione o script do ROASaurus e o snippet de agradecimento ao site que incorpora a sua loja Ecwid.
Cada venda, rastreada até o anúncio que a gerou
Rastreamento server-side, lucro e valor vitalício em um só app. 14 dias de teste grátis, sem cartão de crédito.
Comece seu teste grátis →