Integração com loja online

Tracking server-side para BigCommerce

Dê à ROASaurus uma conta de API ao nível da loja só de leitura e clique em Create webhook. As encomendas pagas do BigCommerce seguem então para as suas plataformas de anúncios a partir do servidor, à medida que chegam.

O BigCommerce em resumo
As encomendas chegam porWebhooks (encomenda criada, estado atualizado) mais polling a cada 5 minutos
Configuração do webhookAutomática, com o botão Create webhook
CredenciaisStore hash e um token de acesso com Orders: read-only
Encomendas pagasAwaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped, Completed
Snippet da página de agradecimentoScript na página Order confirmation com {{checkout.order.id}}

Como o BigCommerce se liga

  1. Storefront › Script Manager › Create a Script: localização Footer, páginas All pages, tipo Script, com a tag de script da ROASaurus.
  2. Crie um segundo script para a página Order confirmation com o snippet da página de agradecimento.
  3. Settings › API › Store-level API accounts › Create API account com Orders: read-only. Introduza o store hash (a parte a seguir a /stores/ no seu caminho de API) e o token de acesso na ROASaurus.
  4. Guarde e clique em Create webhook.

O que faz o Create webhook

A ROASaurus regista dois webhooks do BigCommerce, um para encomenda criada e outro para estado da encomenda atualizado. Cada entrega traz um cabeçalho secreto exclusivo da sua loja, que a ROASaurus verifica. O webhook só indica qual a encomenda que mudou, por isso a ROASaurus obtém a encomenda e os seus produtos a partir da API. Verifica também a existência de encomendas alteradas a cada 5 minutos, caso uma entrega se perca.

Que encomendas contam

Encomendas num estado que significa que o pagamento foi concluído: Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped e Completed. As encomendas pendentes ou recusadas não são enviadas. A ROASaurus lê o total com impostos, o email, o telefone, o nome e a morada de faturação, o ID do cliente, o endereço IP e cada produto com o seu preço com impostos.

Associar as encomendas aos cliques em anúncios

O snippet da página de confirmação da encomenda dispara a compra da ROASaurus com {{checkout.order.id}}, o que associa a encomenda ao visitante. Sem ele, a ROASaurus tenta um email que o visitante indicou antes no seu site, por exemplo num popup, e depois o endereço IP da encomenda, mas só quando foi visto exatamente um visitante nesse IP desde 3 horas antes até 15 minutos depois da encomenda.

Limites

  • As encomendas do BigCommerce não dão à ROASaurus nenhum user agent, pelo que, em IPs partilhados (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 guardar as suas credenciais, faça uma encomenda de teste e verifique o Event log.

Relacionado

FAQ

Perguntas e respostas

De que acesso à API precisa a ROASaurus?

Uma conta de API ao nível da loja com Orders definido como só de leitura. A ROASaurus usa-a para ler encomendas e para criar os seus dois webhooks de encomendas.

E se um webhook falhar?

A ROASaurus também consulta o BigCommerce a cada 5 minutos, com uma sobreposição de 30 minutos. As encomendas que já tem são ignoradas, por isso nada é enviado duas vezes.

Que estados do BigCommerce contam como pagos?

Awaiting Fulfillment, Awaiting Shipment, Partially Shipped, Shipped e Completed. Os outros estados ficam de fora até a encomenda passar para um destes.

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 →