Tracking server-side para Squarespace Commerce
A ROASaurus lê as encomendas pagas a partir da API do Squarespace Commerce a cada 5 minutos e envia-as para as suas plataformas de anúncios a partir do servidor. Um snippet na página de estado da encomenda associa cada encomenda ao clique no anúncio.
| O Squarespace em resumo | |
|---|---|
| As encomendas chegam por | Polling da Commerce API a cada 5 minutos |
| Credenciais | Chave de API de programador com Orders: read |
| Plano | As chaves de API requerem o plano Commerce Advanced |
| Encomendas pagas | Estado de pagamento PAID |
| Snippet da página de agradecimento | Code injection da Order Status Page, com {orderId} e {orderGrandTotal} |
Como o Squarespace se liga
- Settings › Advanced › Code Injection › Header: cole a tag de script da ROASaurus.
- Na mesma página, em Order Status Page (e Order Confirmation Page para produtos digitais), cole o snippet da página de agradecimento.
- Settings › Advanced › Developer API Keys › Generate Key com Orders: read e introduza-a na ROASaurus.
Porquê polling e não webhooks
O Squarespace envia webhooks apenas para apps OAuth, não para integrações que um comerciante configura com uma chave de API. Por isso, a ROASaurus obtém as encomendas modificadas desde a sua última execução, a cada 5 minutos, com uma sobreposição de 30 minutos. As encomendas com estado de pagamento PAID são enviadas; os duplicados são ignorados.
Associar as encomendas aos cliques em anúncios
O snippet usa as variáveis do próprio Squarespace, {orderId}, {orderGrandTotal} e {customerEmailAddress}, para disparar a compra da ROASaurus com o mesmo ID de encomenda. Está envolvido em {.if firstPageView}, pelo que um comprador que recarregue a página de estado da encomenda não o dispara duas vezes. Sem o snippet, a ROASaurus recorre a um email que o visitante indicou antes no seu site, por exemplo num popup.
O que a ROASaurus lê de cada encomenda
O número da encomenda, o total geral e a moeda, o email e o ID do cliente, o nome, o telefone e a morada de faturação e, de cada artigo, o produto, a variante, a quantidade, o preço pago e o SKU.
Limites
- As chaves de API requerem o plano Commerce Advanced.
- As encomendas chegam até 5 minutos após o pagamento. “Fetch orders now” sincroniza a pedido.
- As encomendas do Squarespace não incluem o endereço IP do comprador, pelo que 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 guardar as suas credenciais, faça uma encomenda de teste e verifique o Event log.
Relacionado
Perguntas e respostas
De que plano do Squarespace preciso?
As chaves de API de programador para encomendas requerem o plano Commerce Advanced. O script de tracking e o snippet funcionam através do Code Injection.
Porque é que o Squarespace não pode enviar encomendas de imediato?
O Squarespace só envia webhooks para apps OAuth, não para chaves de API de comerciantes. Por isso, a ROASaurus consulta a Commerce API a cada 5 minutos.
Recarregar a página da encomenda conta duas vezes?
Não. O snippet só é executado na primeira visualização da página de estado da encomenda, e a ROASaurus ignora uma segunda compra com o mesmo ID de encomenda.
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 →