Tracking server-side para Shopware 6
Adicione uma integração do Shopware com acesso de leitura às encomendas e a ROASaurus sincroniza as encomendas pagas a partir da Admin API. Um webhook do Flow Builder faz com que cheguem no momento em que são pagas.
| O Shopware em resumo | |
|---|---|
| As encomendas chegam por | Polling da Admin API a cada 5 minutos; instantâneo com um webhook do Flow Builder |
| Credenciais | Access key ID e secret access key da integração |
| Encomendas pagas | Uma transação no estado paid |
| ID da encomenda | O número da encomenda do Shopware |
| Snippet da página de agradecimento | Template checkout/finish, com page.order.orderNumber |
Como o Shopware se liga
- Adicione o script da ROASaurus ao seu tema (
base.html.twig, blocobase_script_tracking) ou com um plugin de tag manager. - Settings › System › Integrations › Add integration, com acesso de leitura às encomendas. Introduza o access key ID e o secret access key na ROASaurus.
- Para uma associação exata, adicione o snippet da página de agradecimento a
storefront/page/checkout/finish/index.html.twig.
A ROASaurus troca as chaves da integração por um token de curta duração da Admin API e procura as encomendas atualizadas desde a sua última execução, a cada 5 minutos. Uma encomenda conta como paga quando uma das suas transações está no estado paid. O número da encomenda é usado como ID, que é também o que o snippet da página de agradecimento envia.
Encomendas instantâneas com o Flow Builder
No Shopware Evolve ou superior, crie um fluxo com o acionador State Enter / Order Transaction / State / Paid e a ação Call URL (Webhook), em POST para o URL do webhook da ROASaurus. A chamada é apenas um sinal: a ROASaurus não confia no seu conteúdo e, em vez disso, obtém as encomendas das últimas duas horas através da API autenticada. As encomendas que já tem são ignoradas.
O que a ROASaurus lê de cada encomenda
O total, a moeda, a data da encomenda, o email e o nome do cliente, o telefone, a cidade, o código postal e o país de faturação, o ID do cliente e as linhas de produto com a quantidade, o preço unitário e o número do produto.
Associar as encomendas aos cliques em anúncios
O snippet da página de agradecimento dispara a compra da ROASaurus com o número e o total da encomenda, o que associa a encomenda ao visitante. Sem ele, a ROASaurus usa um email que o visitante indicou antes no seu site, por exemplo num popup.
Limites
- O Shopware anonimiza por predefinição o endereço IP do cliente, pelo que a alternativa por IP raramente ajuda. Adicione o snippet da página de agradecimento.
- Os webhooks do Flow Builder requerem o Shopware Evolve ou superior. Sem eles, as encomendas demoram até 5 minutos.
- 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
Preciso do Flow Builder?
Não. Sem ele, a ROASaurus obtém as encomendas pagas a cada 5 minutos. O webhook do Flow Builder, disponível no Shopware Evolve ou superior, só faz com que cheguem de imediato.
O webhook do Flow Builder é seguro?
A ROASaurus trata-o apenas como um sinal. Nunca retira dados de encomendas da chamada; obtém as encomendas recentes através da Admin API com as chaves da sua integração.
De que acesso precisa a integração?
Acesso de leitura às encomendas. A ROASaurus usa o access key ID e o secret da integração para obter um token de curta duração da Admin API.
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 →