Integração com loja online

Rastreamento server-side para Magento 2 e Adobe Commerce

Crie uma integração do Magento com acesso aos pedidos e o ROASaurus busca os pedidos pagos pela REST API a cada 5 minutos e depois os envia às suas plataformas de anúncios a partir do servidor.

O Magento em resumo
Os pedidos chegam porPolling da REST API a cada 5 minutos
CredenciaisToken de acesso da integração; consumer key, consumer secret e access token secret quando o uso de bearer está desativado
Acesso a recursosSales › Operations › Orders
Pedidos pagosEstado processing ou complete
ID do pedidoO ID incremental que os clientes veem

Como o Magento se conecta

  1. Content › Design › Configuration › sua store view › HTML Head › Scripts and Style Sheets: adicione a tag de script do ROASaurus.
  2. System › Extensions › Integrations › Add New Integration, com acesso ao recurso Sales › Operations › Orders. Ative-a e copie o token de acesso.
  3. Informe o token no ROASaurus. Adicione a URL da loja somente se a API rodar em outro endereço que não o domínio da sua loja.

Token bearer ou OAuth 1.0a

Desde o Magento 2.4.4, a opção "Allow OAuth Access Tokens to be used as standalone Bearer tokens" vem desativada por padrão. Se ela estiver desativada na sua loja, informe também a consumer key, o consumer secret e o access token secret da mesma integração. O ROASaurus então assina cada requisição com OAuth 1.0a em vez de enviar um token bearer.

Como os pedidos são lidos

O Magento Open Source não tem webhooks de pedidos, então o ROASaurus pede à REST API os pedidos atualizados desde a última execução, a cada 5 minutos, com uma sobreposição de 30 minutos. Pedidos no estado processing ou complete contam como pagos. O ID do pedido é o increment id. Produtos configuráveis aparecem duas vezes nos dados de pedido do Magento, como pai e filho; o ROASaurus mantém as linhas do pai para que as quantidades não sejam duplicadas.

De cada pedido, ele lê o total geral, a moeda, o e-mail e o nome do cliente, o telefone e o endereço de cobrança com o código da região, o ID do cliente e o endereço IP do cliente.

Ligando os pedidos aos cliques em anúncios

Para uma correspondência exata, peça ao seu desenvolvedor para disparar o snippet de compra do ROASaurus em checkout/onepage/success com o increment id do pedido e o total geral. Sem isso, o ROASaurus usa um e-mail que o visitante informou antes no seu site, por exemplo em um pop-up, e depois o endereço IP, quando só um visitante se encaixa.

Limites

  • Sem webhooks: os pedidos chegam às suas plataformas de anúncios até 5 minutos após o pagamento. "Fetch orders now" executa uma sincronização sob demanda.
  • O snippet da página de sucesso exige um pequeno módulo personalizado, que o seu desenvolvedor adiciona.
  • 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

Por que os pedidos do Magento são buscados a cada 5 minutos?

O Magento Open Source não tem webhooks de pedidos. O ROASaurus consulta a REST API a cada 5 minutos, com uma sobreposição para que nenhum pedido se perca, e ignora os pedidos que já tem.

Meu token está sendo rejeitado. O que devo conferir?

Desde a versão 2.4.4, os tokens bearer independentes vêm desativados por padrão. Informe também a consumer key, o consumer secret e o access token secret, e o ROASaurus assina as requisições com OAuth 1.0a.

Funciona com o Adobe Commerce?

O conector usa a REST API e as integrações do Magento 2, que o Magento Open Source e o Adobe Commerce compartilham.

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 →