Skip to main content
O Aftersell permite acionar funis com base em parâmetros UTM, um recurso opcional voltado especificamente para casos de uso avançados. Você pode configurar seu funil para ser ativado quando um cliente visita seu site com uma query string UTM específica. Essa configuração é opcional e normalmente necessária apenas para necessidades avançadas de rastreamento, como links direto para o checkout ou ofertas específicas de campanha.

Como funcionam os gatilhos UTM

Os gatilhos UTM permitem exibir funis pós-compra específicos com base em parâmetros UTM na URL. Isso é útil para:
  • Ofertas específicas de campanha - Exiba upsells diferentes de acordo com a campanha de marketing
  • Links direto para o checkout - Acione funis quando os clientes pulam a vitrine da loja
  • Atribuição de canal - Personalize ofertas com base na origem do tráfego (e-mail, redes sociais, anúncios)
  • Testes A/B - Teste ofertas diferentes para variações diferentes de campanha

Início rápido: configuração básica de gatilho UTM

Para visitas padrão à vitrine da loja (não direto para o checkout), você pode configurar gatilhos UTM usando o app embed do Aftersell. Para ver como começar rapidamente com gatilhos UTM, confira este vídeo:

Ative o app embed de UTM

Para rastrear parâmetros UTM nas páginas da vitrine da loja:
  1. No seu admin da Shopify, vá em Online Store > Themes
  2. Clique em Customize no seu tema ativo
  3. No editor de tema, clique no ícone de App embeds (peça de quebra-cabeça) na barra lateral esquerda
  4. Encontre Aftersell UTM Tracker e ative o botão
  5. Clique em Save
Depois de ativado, o Aftersell capturará automaticamente os parâmetros UTM quando os clientes visitarem sua vitrine com links UTM.

Configure gatilhos UTM no seu funil

Depois de ativar o app embed:
  1. Vá em Post-purchase Funnels no admin do Aftersell
  2. Crie ou edite um funil
  3. Na seção Triggers, adicione um gatilho de UTM Parameter
  4. Configure o parâmetro UTM e o valor que você quer corresponder
  5. Salve seu funil

Parâmetros UTM compatíveis

O Aftersell é compatível com os seguintes parâmetros UTM padrão:
  • utm_source - Identifica a origem do tráfego (por exemplo, google, newsletter, facebook)
  • utm_medium - Identifica o meio de marketing (por exemplo, email, cpc, social)
  • utm_campaign - Identifica a campanha específica (por exemplo, spring_sale, product_launch)
  • utm_term - Identifica palavras-chave de busca paga (por exemplo, running+shoes)
  • utm_content - Diferencia conteúdos ou links semelhantes (por exemplo, banner_ad, text_link)
  • utm_id - Identifica o ID da campanha (por exemplo, campaign_123)
Todos os seis parâmetros são rastreados e podem ser usados para acionar funis.

Correspondência parcial de campos

Ao configurar gatilhos UTM, o Aftersell oferece suporte a correspondência parcial para valores de parâmetros UTM. Isso significa:
  • Valor do gatilho: springCorresponde a: spring_sale, spring_2026, early_spring
  • Valor do gatilho: emailCorresponde a: email_newsletter, promotional_email
  • Valor do gatilho: saleCorresponde a: spring_sale, flash_sale, sale_2026
Essa flexibilidade permite criar gatilhos mais amplos que correspondem a múltiplas variações de campanha sem precisar criar gatilhos separados para cada uma. Exemplo: Se você definir um gatilho para utm_campaign contendo sale, ele corresponderá a qualquer campanha com “sale” no nome, como spring_sale, summer_sale ou flash_sale_2026. A configuração básica mostrada no vídeo acima não oferece suporte a links que enviam os clientes diretamente para o checkout. Por padrão, o Aftersell só consegue detectar parâmetros UTM nas páginas da vitrine da loja. Isso ocorre porque ele depende de um theme app embed, que funciona apenas nas páginas da vitrine e não no checkout nem na página de agradecimento.

Ative o rastreamento de UTM nas páginas de checkout

Para rastrear parâmetros UTM na página de checkout (para links direto para o checkout), você precisa adicionar um Shopify Pixel à sua loja. ⚠️ Limitações importantes:
  • Essa configuração exige que o visitante tenha um token de carrinho quando chegar ao checkout por um link UTM. Sem um token de carrinho, os dados de UTM não serão capturados.
  • Os métodos de checkout expresso (Shop Pay, Apple Pay, Google Pay) não são compatíveis porque eles pulam o carrinho e não geram um token de carrinho. Clientes que usam checkout expresso não acionarão funis baseados em UTM.

Configurando o pixel da Shopify

Siga estas instruções passo a passo para configurar o rastreamento de UTM direto para o checkout:
  1. No seu admin da Shopify, vá em Settings > Customer Events.
  2. Clique em Add Custom Pixel e dê o nome que preferir.
  3. No menu suspenso Permission, selecione Analytics. Essa é a única permissão necessária.
  4. No menu suspenso Data Sale, você pode escolher Data collected does not qualify as data sale. O Aftersell mantém todos os dados coletados privados e nunca os compartilha com ninguém além de você.
  5. No editor de código que aparecer, cole o código fornecido abaixo.
  6. Clique em Save e depois em Connect.
Observações importantes de configuração:
  • Edite MYSHOPIFY_DOMAIN: Você deve substituir a string vazia pelo domínio myshopify.com da sua loja (por exemplo, 'example-store.myshopify.com')
  • Ative o modo de depuração (opcional): Defina enableDebug = true para ver logs no console para solução de problemas
  • Parâmetros compatíveis: O pixel rastreia todos os seis parâmetros UTM padrão listados no array allowedUrlParams

Testando sua configuração de gatilho UTM

Depois de configurar os gatilhos UTM, use esta lista de verificação para confirmar que tudo está funcionando corretamente:

Para rastreamento de UTM na vitrine (app embed)

  • App embed ativado: Verifique se o app embed Aftersell UTM Tracker está ativado nas configurações do seu tema
  • URL de teste: Visite sua loja com um parâmetro UTM (por exemplo, yourstore.com?utm_campaign=test)
  • Conclua a compra: Adicione um produto ao carrinho e finalize o checkout
  • Verifique o funil: Confirme que o funil correto aparece na página de agradecimento
  • Order browser: Confira o Aftersell Order Browser para confirmar que o gatilho UTM foi detectado

Para rastreamento de UTM direto para o checkout (pixel da Shopify)

  • Pixel instalado: Verifique se o pixel personalizado está salvo e conectado em Settings > Customer Events
  • Domínio configurado: Confirme que MYSHOPIFY_DOMAIN está definido corretamente no código do pixel
  • Token de carrinho presente: Garanta que o cliente tenha itens no carrinho antes de ir para o checkout (obrigatório para o rastreamento)
  • URL de teste: Use um link direto para o checkout com parâmetros UTM (por exemplo, yourstore.com/checkout?utm_campaign=test)
  • Conclua a compra: Finalize o processo de checkout
  • Verifique o funil: Confirme que o funil correto aparece na página de agradecimento
  • Order browser: Confira o Aftersell Order Browser para confirmar que o gatilho UTM foi detectado
  • ⚠️ Checkout expresso: Lembre-se de que Shop Pay, Apple Pay e Google Pay NÃO funcionam com gatilhos UTM

Dicas de solução de problemas

Se os gatilhos UTM não estiverem funcionando:
  1. Ative o modo de depuração: Defina enableDebug = true no código do pixel e verifique o console do navegador em busca de mensagens de erro
  2. Verifique o token de carrinho: Garanta que os clientes tenham itens no carrinho antes de chegar ao checkout (o pixel exige token de carrinho)
  3. Verifique a configuração do gatilho: Confirme que o parâmetro UTM e o valor no gatilho do seu funil correspondem aos parâmetros da URL
  4. Teste a correspondência parcial: Lembre-se de que os gatilhos usam correspondência parcial - sale corresponderá a spring_sale, flash_sale, etc.
  5. Verifique a prioridade dos funis: Se vários funis corresponderem, apenas o funil de maior prioridade será exibido
  6. Revise o Order Browser: Use o Aftersell Order Browser para ver quais gatilhos foram acionados em cada pedido

Boas práticas para gatilhos UTM

  • Use nomenclatura consistente: Estabeleça uma convenção de nomenclatura para seus parâmetros UTM (por exemplo, utm_campaign=email_spring_2026)
  • Aproveite a correspondência parcial: Use valores de gatilho mais amplos para corresponder a múltiplas variações de campanha
  • Teste antes de lançar: Sempre teste seus links UTM e gatilhos antes de enviá-los aos clientes
  • Documente suas campanhas: Mantenha um registro de quais parâmetros UTM você está usando em cada campanha
  • Combine com outros gatilhos: Use gatilhos UTM junto com gatilhos de produto ou de valor do pedido para uma segmentação mais precisa
  • Monitore o desempenho: Verifique regularmente o Order Browser para ver quais campanhas UTM estão gerando mais upsells