Rastreamento server-side para Shopware 6
Adicione uma integração do Shopware com acesso de leitura aos pedidos e o ROASaurus sincroniza os pedidos pagos pela Admin API. Um webhook do Flow Builder faz com que eles cheguem no momento em que são pagos.
| O Shopware em resumo | |
|---|---|
| Os pedidos chegam por | Polling da Admin API a cada 5 minutos; instantâneo com um webhook do Flow Builder |
| Credenciais | ID da chave de acesso e chave de acesso secreta da integração |
| Pedidos pagos | Uma transação no estado paid |
| ID do pedido | O número do pedido do Shopware |
| Snippet de agradecimento | Template checkout/finish, usando page.order.orderNumber |
Como o Shopware se conecta
- Adicione o script do ROASaurus ao seu tema (
base.html.twig, blocobase_script_tracking) ou com um plugin de gerenciador de tags. - Settings › System › Integrations › Add integration, com acesso de leitura aos pedidos. Informe o ID da chave de acesso e a chave de acesso secreta no ROASaurus.
- Para uma correspondência exata, adicione o snippet de agradecimento em
storefront/page/checkout/finish/index.html.twig.
O ROASaurus troca as chaves da integração por um token da Admin API de curta duração e busca os pedidos atualizados desde a última execução, a cada 5 minutos. Um pedido conta como pago quando uma das suas transações está no estado paid. O número do pedido é usado como ID, que é também o que o snippet de agradecimento envia.
Pedidos instantâneos com o Flow Builder
No Shopware Evolve e superiores, crie um fluxo com o gatilho State Enter / Order Transaction / State / Paid e a ação Call URL (Webhook), com POST para a URL de webhook do seu ROASaurus. A chamada é apenas um sinal: o ROASaurus não confia no conteúdo dela e, em vez disso, busca os pedidos das últimas duas horas pela API autenticada. Os pedidos que ele já tem são ignorados.
O que o ROASaurus lê de cada pedido
O total, a moeda, a data do pedido, o e-mail e o nome do cliente, o telefone, a cidade, o CEP e o país de cobrança, o ID do cliente e os itens de produto com a quantidade, o preço unitário e o número do produto.
Ligando os pedidos aos cliques em anúncios
O snippet de agradecimento dispara a compra do ROASaurus com o número e o total do pedido, o que liga o pedido ao visitante. Sem ele, o ROASaurus usa um e-mail que o visitante informou antes no seu site, por exemplo em um pop-up.
Limites
- O Shopware anonimiza por padrão o endereço IP do cliente, então a alternativa por IP raramente ajuda. Adicione o snippet de agradecimento.
- Os webhooks do Flow Builder exigem o Shopware Evolve ou superior. Sem eles, os pedidos levam até 5 minutos.
- 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
Preciso do Flow Builder?
Não. Sem ele, o ROASaurus busca os pedidos pagos a cada 5 minutos. O webhook do Flow Builder, disponível no Shopware Evolve e superiores, só faz com que eles cheguem na hora.
O webhook do Flow Builder é seguro?
O ROASaurus o trata apenas como um sinal. Ele nunca pega dados de pedido da chamada; busca os pedidos recentes pela Admin API com as chaves da sua integração.
De que acesso a integração precisa?
Acesso de leitura aos pedidos. O ROASaurus usa o ID da chave de acesso e o segredo da integração para obter um token da Admin API de curta duração.
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 →