Tracking server-side para lojas Ecwid
A ROASaurus lê as encomendas pagas do Ecwid através de um token de app personalizada e envia-as para as suas plataformas de anúncios a partir do servidor. Peça ao suporte do Ecwid os webhooks e as encomendas chegam de imediato.
| O Ecwid em resumo | |
|---|---|
| As encomendas chegam por | Polling da API a cada 5 minutos; webhooks assim que o suporte do Ecwid os ativar |
| Credenciais | Store ID, o token secreto da app personalizada e o seu client secret para webhooks |
| Verificação do webhook | Assinatura HMAC com o client secret |
| Encomendas pagas | Estado de pagamento PAID |
| Snippet da página de agradecimento | Ecwid.OnOrderPlaced, depois do script de tracking |
Como o Ecwid se liga
- Adicione o script da ROASaurus ao site que incorpora a sua loja Ecwid, ou ao código personalizado do seu Instant Site.
- Adicione o snippet da página de agradecimento a seguir. Ele escuta o evento
OnOrderPlaceddo Ecwid e dispara a compra da ROASaurus com o número da encomenda, o total e o email. - Em my.ecwid.com/#develop-apps, crie uma app personalizada com acesso de leitura às encomendas. Introduza o ID da sua loja (mostrado no URL da sua administração e em Account › Summary) e o token
secret_…da app na ROASaurus.
A ROASaurus obtém então as encomendas atualizadas desde a sua última execução, a cada 5 minutos, e envia as que têm estado de pagamento PAID.
Encomendas instantâneas com webhooks
O Ecwid define os URLs de webhook das apps personalizadas através da sua equipa de suporte de API. Peça-lhes que definam o URL de webhook da sua app para o que consta no separador Connection da ROASaurus, com os eventos order.created e order.updated. Cole o client secret da app na ROASaurus: cada webhook é verificado com a sua assinatura HMAC e a encomenda é depois obtida a partir da API.
O que a ROASaurus lê de cada encomenda
O total, a moeda, o email, o nome, o telefone e a morada de faturação, o ID do cliente e os artigos com a sua combinação, quantidade, preço e SKU. As encomendas do Ecwid incluem o endereço IP e o user agent do comprador, pelo que a ROASaurus também pode associar pelo mesmo IP e navegador, apenas quando exatamente um visitante corresponde.
Limites
- Os webhooks requerem um pedido ao suporte do Ecwid. Até lá, as encomendas demoram até 5 minutos.
- O Ecwid fornece um único campo de nome, que a ROASaurus divide em nome próprio e apelido.
- O conector foi criado com base na documentação oficial da API da plataforma. Clique em Test connection depois de guardar as suas credenciais, faça uma encomenda de teste e verifique o Event log.
Relacionado
Perguntas e respostas
Porque tenho de contactar o Ecwid para obter webhooks?
O Ecwid configura o URL de webhook de uma app personalizada através do seu suporte de API. O polling a cada 5 minutos funciona sem eles.
Para que serve o client secret?
Verifica que um webhook vem mesmo do Ecwid. A ROASaurus verifica com ele a assinatura HMAC de cada webhook antes de obter a encomenda.
Funciona com o Ecwid incorporado noutro site?
Sim. Adicione o script da ROASaurus e o snippet da página de agradecimento ao site que incorpora a sua loja Ecwid.
Cada venda, associada ao anúncio que a gerou
Tracking server-side, lucro e valor vitalício do cliente numa só app. Teste gratuito de 14 dias, sem cartão de crédito.
Comece o seu teste gratuito →