Integração com loja online

Rastreamento server-side para BigCommerce

Dê ao ROASaurus uma conta de API somente leitura no nível da loja e clique em Create webhook. Os pedidos pagos do BigCommerce passam a ir para as suas plataformas de anúncios a partir do servidor assim que chegam.

O BigCommerce em resumo
Os pedidos chegam porWebhooks (pedido criado, status atualizado) mais polling a cada 5 minutos
Configuração do webhookAutomática, com o botão Create webhook
CredenciaisHash da loja e um token de acesso com Orders: somente leitura
Pedidos pagosAwaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped, Completed
Snippet de agradecimentoScript na página Order confirmation usando {{checkout.order.id}}

Como o BigCommerce se conecta

  1. Storefront › Script Manager › Create a Script: local Footer, páginas All pages, tipo Script, com a tag de script do ROASaurus.
  2. Crie um segundo script para a página Order confirmation com o snippet de agradecimento.
  3. Settings › API › Store-level API accounts › Create API account, com Orders: read-only. Informe o hash da loja (a parte depois de /stores/ no caminho da sua API) e o token de acesso no ROASaurus.
  4. Salve e depois clique em Create webhook.

O que o Create webhook faz

O ROASaurus registra dois webhooks do BigCommerce, um para pedido criado e outro para status do pedido atualizado. Cada entrega leva um cabeçalho secreto exclusivo da sua loja, que o ROASaurus verifica. O webhook só diz qual pedido mudou, então o ROASaurus busca o pedido e os produtos dele na API. Ele também verifica a cada 5 minutos se há pedidos alterados, caso alguma entrega se perca.

Quais pedidos contam

Pedidos em um status que indica que o pagamento foi concluído: Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped e Completed. Pedidos pendentes ou recusados não são enviados. O ROASaurus lê o total com impostos, o e-mail, telefone, nome e endereço de cobrança, o ID do cliente, o endereço IP e cada produto com o preço com impostos.

Ligando os pedidos aos cliques em anúncios

O snippet da página de confirmação do pedido dispara a compra do ROASaurus com {{checkout.order.id}}, o que liga o pedido ao visitante. Sem ele, o ROASaurus tenta um e-mail que o visitante informou antes no seu site, por exemplo em um pop-up, e depois o endereço IP do pedido, mas apenas quando exatamente um visitante foi visto nesse IP de 3 horas antes a 15 minutos depois do pedido.

Limites

  • Os pedidos do BigCommerce não dão ao ROASaurus um user agent, então em IPs compartilhados (escritórios, redes móveis) a alternativa por IP muitas vezes não consegue decidir. O snippet evita isso.
  • 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 frequentes

Perguntas respondidas

De que acesso à API o ROASaurus precisa?

Uma conta de API no nível da loja com Orders definido como somente leitura. O ROASaurus a usa para ler os pedidos e para criar os seus dois webhooks de pedidos.

E se um webhook falhar?

O ROASaurus também consulta o BigCommerce a cada 5 minutos, com uma sobreposição de 30 minutos. Os pedidos que ele já tem são ignorados, então nada é enviado duas vezes.

Quais status do BigCommerce contam como pagos?

Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped e Completed. Os outros status ficam de fora até que o pedido passe para um desses.

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 →