Tracking server-side para Magento 2 e Adobe Commerce
Crie uma integração do Magento com acesso às encomendas e a ROASaurus obtém as encomendas pagas através da API REST a cada 5 minutos e envia-as depois para as suas plataformas de anúncios a partir do servidor.
| O Magento em resumo | |
|---|---|
| As encomendas chegam por | Polling da API REST a cada 5 minutos |
| Credenciais | Token de acesso da integração; consumer key, consumer secret e access token secret quando o uso como bearer está desativado |
| Acesso a recursos | Sales › Operations › Orders |
| Encomendas pagas | Estado processing ou complete |
| ID da encomenda | O increment id que os clientes veem |
Como o Magento se liga
- Content › Design › Configuration › a sua store view › HTML Head › Scripts and Style Sheets: adicione a tag de script da ROASaurus.
- System › Extensions › Integrations › Add New Integration, com o acesso a recursos Sales › Operations › Orders. Ative-a e copie o token de acesso.
- Introduza o token na ROASaurus. Adicione o URL da loja apenas se a API correr noutro endereço que não o domínio da sua loja.
Bearer token ou OAuth 1.0a
Desde o Magento 2.4.4, “Allow OAuth Access Tokens to be used as standalone Bearer tokens” está desativado por predefinição. Se estiver desativado na sua loja, introduza também a consumer key, o consumer secret e o access token secret da mesma integração. A ROASaurus assina então cada pedido com OAuth 1.0a em vez de enviar um bearer token.
Como as encomendas são lidas
O Magento Open Source não tem webhooks de encomendas, por isso a ROASaurus pede à API REST as encomendas atualizadas desde a sua última execução, a cada 5 minutos, com uma sobreposição de 30 minutos. As encomendas no estado processing ou complete contam como pagas. O ID da encomenda é o increment id. Os produtos configuráveis aparecem duas vezes nos dados de encomendas do Magento, como pai e filho; a ROASaurus mantém as linhas do pai para que as quantidades não sejam duplicadas.
De cada encomenda, lê o total geral, a moeda, o email e o nome do cliente, o telefone e a morada de faturação com o código da região, o ID do cliente e o endereço IP do cliente.
Associar as encomendas aos cliques em anúncios
Para uma associação exata, peça ao seu programador que dispare o snippet de compra da ROASaurus em checkout/onepage/success com o increment id da encomenda e o total geral. Sem ele, a ROASaurus usa um email que o visitante indicou antes no seu site, por exemplo num popup, e depois o endereço IP, quando só um visitante corresponde.
Limites
- Sem webhooks: as encomendas chegam às suas plataformas de anúncios até 5 minutos após o pagamento. “Fetch orders now” executa uma sincronização a pedido.
- O snippet da página de sucesso requer um pequeno módulo personalizado, que o seu programador adiciona.
- 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
Porque é que as encomendas do Magento são obtidas a cada 5 minutos?
O Magento Open Source não tem webhooks de encomendas. Por isso, a ROASaurus consulta a API REST a cada 5 minutos, com uma sobreposição para que nenhuma encomenda se perca, e ignora as encomendas que já tem.
O meu token é rejeitado. O que devo verificar?
Desde a versão 2.4.4, os bearer tokens autónomos estão desativados por predefinição. Introduza também a consumer key, o consumer secret e o access token secret, e a ROASaurus assina os pedidos com OAuth 1.0a.
Funciona com o Adobe Commerce?
O conector usa a API REST e as integrações do Magento 2, que o Magento Open Source e o Adobe Commerce partilham.
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 →