Rastreamento server-side para Squarespace Commerce
O ROASaurus lê os pedidos pagos da Squarespace Commerce API a cada 5 minutos e os envia às suas plataformas de anúncios a partir do servidor. Um snippet na página de status do pedido liga cada pedido ao clique no anúncio.
| O Squarespace em resumo | |
|---|---|
| Os pedidos chegam por | Polling da Commerce API a cada 5 minutos |
| Credenciais | Chave de API de desenvolvedor com Orders: read |
| Plano | As chaves de API exigem o plano Commerce Advanced |
| Pedidos pagos | Estado de pagamento PAID |
| Snippet de agradecimento | Injeção de código na Order Status Page, usando {orderId} e {orderGrandTotal} |
Como o Squarespace se conecta
- Settings › Advanced › Code Injection › Header: cole a tag de script do ROASaurus.
- Na mesma página, em Order Status Page (e Order Confirmation Page para produtos digitais), cole o snippet de agradecimento.
- Settings › Advanced › Developer API Keys › Generate Key com Orders: read, e informe-a no ROASaurus.
Por que polling e não webhooks
O Squarespace envia webhooks apenas para apps OAuth, não para integrações que um lojista configura com uma chave de API. Por isso o ROASaurus busca os pedidos modificados desde a última execução, a cada 5 minutos, com uma sobreposição de 30 minutos. Os pedidos com estado de pagamento PAID são enviados; duplicatas são ignoradas.
Ligando os pedidos aos cliques em anúncios
O snippet usa as variáveis do próprio Squarespace, {orderId}, {orderGrandTotal} e {customerEmailAddress}, para disparar a compra do ROASaurus com o mesmo ID de pedido. Ele fica dentro de {.if firstPageView}, de modo que um comprador que recarrega a página de status do pedido não o dispara duas vezes. Sem o snippet, o ROASaurus recorre a um e-mail que o visitante informou antes no seu site, por exemplo em um pop-up.
O que o ROASaurus lê de cada pedido
O número do pedido, o total geral e a moeda, o e-mail e o ID do cliente, o nome, o telefone e o endereço de cobrança e, de cada item do pedido, o produto, a variante, a quantidade, o preço pago e o SKU.
Limites
- As chaves de API exigem o plano Commerce Advanced.
- Os pedidos chegam até 5 minutos após o pagamento. "Fetch orders now" sincroniza sob demanda.
- Os pedidos do Squarespace não incluem o endereço IP do comprador, então a alternativa por IP não está disponível. Adicione o snippet.
- 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
De qual plano do Squarespace eu preciso?
As chaves de API de desenvolvedor para pedidos exigem o plano Commerce Advanced. O script de rastreamento e o snippet funcionam pela Code Injection.
Por que o Squarespace não consegue enviar os pedidos na hora?
O Squarespace só envia webhooks para apps OAuth, não para chaves de API de lojistas. O ROASaurus consulta a Commerce API a cada 5 minutos no lugar disso.
Recarregar a página do pedido conta duas vezes?
Não. O snippet só roda na primeira visualização da página de status do pedido, e o ROASaurus ignora uma segunda compra com o mesmo ID de pedido.
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 →