--- title: "Integração BW Commerce" description: "Aprenda a conectar o OneClick Tracking à BW Commerce para rastrear conversões de vendas de e-commerce nas suas campanhas Meta Ads com base nas UTMs." --- > Aprenda a configurar o OneClick Tracking na BW Commerce. O **OneClick Tracking** é uma funcionalidade voltada para anunciantes da Meta Ads que usam a BW Commerce como plataforma de e-commerce. Ele oferece um rastreamento de conversões imediato e preciso. **Com o OneClick Tracking você visualiza no seu gerenciador o volume de conversões reais por período, facilitando uma auditoria rápida e clara, sem a necessidade de dashboards complicados de serem mantidos atualizados.** Nota: O **OneClick Tracking** elimina a necessidade de ferramentas extras de rastreamento! --- :::tip[Você pode conectar várias plataformas ao mesmo tempo] O OneClick Tracking permite conectar **mais de uma plataforma na mesma conta de anúncios** ao mesmo tempo (por exemplo, Hotmart e Eduzz juntas). Cada plataforma tem a sua própria integração — com o seu próprio link de Webhook ou credencial de acesso — e elas convivem sem competir entre si; basta repetir o passo a passo de **"Nova Integração"** para cada uma que você quiser conectar. A atribuição de cada venda à campanha certa é feita pela **UTM**, e não pela plataforma. Por isso, se uma campanha vende por uma plataforma e outras campanhas vendem por outra, cada conversão é ligada automaticamente à campanha de origem, independentemente de qual plataforma originou a venda. O cenário recomendado é **cada campanha atender a uma única plataforma** — evite uma mesma campanha vendendo em duas plataformas ao mesmo tempo. ::: ## Como Plugar o OneClick Tracking na BW Commerce 1. Acesse sua conta OneClick Ads. 2. Vá até a aba "OneClick Tracking", conforme disponível no menu lateral esquerdo do [OneClick Ads](https://app.oneclickads.com.br/oneclick-tracking). ![image1](../../../../../public/oneclick-tracking/common/image-1.png) 3. Clique em "Nova Integração". 4. Selecione o tipo de produto "E-Commerce" e clique em Continuar. 5. Selecione a plataforma "BW Commerce" e clique em Continuar. 6. Informe o **Endereço da sua loja BW Commerce** e o **Token da API da BW Commerce**, e clique em **Conectar BW Commerce**. Com esses dois dados, o OneClick cria o webhook na sua loja automaticamente — você não precisa configurar nada dentro da BW Commerce. :::note[Por que o endereço da loja é necessário] A BW Commerce atende cada loja em um endereço próprio de API. Por isso, além do token, o OneClick precisa saber qual é a sua loja. Todos estes formatos funcionam: - `sualoja.com.br` - `https://www.sualoja.com.br/` - `sualoja.api.bwcommerce.com.br` Nos três casos o OneClick vai acessar sua loja em `https://sualoja.api.bwcommerce.com.br`. **Confira se o nome da loja nesse endereço é o mesmo que aparece no painel da BW Commerce** — se a sua loja usa um domínio próprio diferente do nome dela na plataforma, informe o endereço que aparece no painel. ::: ## Como obter o Token da API da BW Commerce 6.1. Acesse sua conta **BW Commerce**. 6.2. No painel administrativo, vá até **Configurações > Integrações** e gere um token da API. O passo a passo oficial da BW Commerce está em [Como criar e obter o token da API para integração](https://ajuda.bwcommerce.com.br/artigo/como-criar-e-obter-o-token-da-api-para-integracao-). 6.3. Copie o token e cole no campo **"Token da API da BW Commerce"** dentro do OneClick Tracking. :::tip[O token fica guardado com segurança] O token é armazenado cifrado do lado do OneClick e **nunca volta para o navegador**. Ao reeditar a integração, o campo aparece vazio — deixe-o vazio para manter o token atual, ou cole um novo para substituí-lo. O endereço da loja, por não ser secreto, aparece preenchido ao reeditar. Se precisar **alterar o endereço**, cole o token da API novamente junto com o novo endereço. ::: 6.4. Ao clicar em **Concluir**, no fim da configuração, o OneClick registra na sua loja o webhook do tipo **"Alteração de status de pedido"** — é esse evento que a BW Commerce dispara sempre que um pedido muda de status (incluindo quando é pago/aprovado), e é ele que o OneClick Tracking usa para identificar uma conversão confirmada. Se você já tinha conectado essa loja antes, o webhook existente é **atualizado**, não duplicado. 7. Copie o Script de UTM gerado dentro do OneClick Tracking. 7.1. Insira no campo "Parâmetros de URL" dentro de TODOS os seus anúncios no gerenciador de anúncios, como mostrado abaixo: ![image5](../../../../../public/oneclick-tracking/common/image-3.png) 8. Insira o **Script de Passagem de UTMs** em todas as suas páginas de vendas, para que as UTMs sejam carregadas até a página final de checkout: a. Você pode instalar no seu site via Google Tag Manager ou, preferivelmente, instalando diretamente no header do seu site. 9. Defina o Modo de Atribuição. - [Assista este vídeo](https://www.youtube.com/watch?v=JgWkvv4ZNLY) para entender cada modelo. - Clique em Continuar. ![image6](../../../../../public/oneclick-tracking/common/image-4.png) 10. Defina a Nomenclatura que suas campanhas, conjuntos de anúncios e anúncios receberão dentro do seu gerenciador de anúncios e clique em avançar. :::caution[A renomeação da campanha depende de conversões processadas] A nomenclatura configurada aqui **somente será aplicada ao nome da campanha no gerenciador de anúncios quando houver pelo menos 1 conversão processada**. Receber dados brutos do webhook da plataforma integrada não é suficiente — o sistema precisa ter estruturado e atribuído a conversão a uma campanha. Se o webhook está chegando mas o nome da campanha ainda não foi alterado, aguarde a primeira conversão ser registrada. ::: ![image7](../../../../../public/oneclick-tracking/common/image-5.png) ![image8](../../../../../public/oneclick-tracking/common/image-6.png) --- ## Pronto! Aguarde pelo menos 24 horas para que a configuração esteja vigente e todas as suas campanhas (as que receberem conversões) passarão a registrar as conversões dentro do próprio gerenciador de anúncios. ![image9](../../../../../public/oneclick-tracking/common/image-7.png) --- ## Notas Importantes - **Webhook automático:** o webhook de **"Alteração de status de pedido"** é criado pelo OneClick com o token que você forneceu. Não é necessário — nem recomendado — criar um webhook manualmente no painel da BW Commerce apontando para a mesma URL: dois webhooks entregariam o mesmo pedido duas vezes. - **Token revogado:** se você revogar ou regenerar o token na BW Commerce, o rastreamento para de funcionar. Reedite a integração no OneClick Tracking e cole o novo token. - **Origem da conversão:** a BW Commerce não envia campos `utm_*` no pedido. As UTMs são lidas da **URL de origem do pedido**, que é a URL pela qual o cliente chegou à loja — por isso o Script de Passagem de UTMs é obrigatório. - **UTMs nos anúncios:** As UTMs devem estar presentes nas URLs dos anúncios e ser passadas até a página de checkout via o Script de Passagem de UTMs para que o rastreamento funcione corretamente. - **Disponibilidade:** Esta integração está em lançamento gradual e pode não estar visível para todas as contas.