Geração de códigos de desconto nativos da loja
O MailInApp oferece suporte à geração dinâmica de códigos de desconto nativos da loja para lojas Shopify e WooCommerce conectadas.
Em vez de forçar os compradores por um checkout de terceiros ou cupons públicos genéricos, o MailInApp gera automaticamente códigos de desconto de uso único e restritos ao cliente diretamente na sua loja, no momento do envio — através de dois mecanismos independentes, que um único projeto pode usar juntos, separadamente, ou nenhum dos dois:
- Oferta de desconto em nível de projeto — uma configuração da página de Envio que gera um código por destinatário correspondente, restrito à sua loja inteira ou a um produto escolhido em uma lista suspensa, pensada para combinar com um segmento de público de Histórico de compras. Veja Oferta de desconto.
- Desconto por produto do bloco Produto — um alternador no próprio bloco Produto do Estúdio, restrito exatamente ao item que aquele bloco importou do seu catálogo, sem precisar de filtro de público ou configuração na página de Envio. Percorrido de ponta a ponta em Códigos de desconto de produto do Shopify e Códigos de desconto de produto do WooCommerce.
Ambos geram os códigos através da mesma conexão de loja subjacente e compartilham a mecânica descrita abaixo; um desconto por produto apenas restringe adicionalmente o código a um único item e mantém seu próprio marcador de período de espera, separado do da oferta em nível de projeto e do de cada outro bloco Produto.
Como funciona
Quando uma campanha ou jornada inclui uma oferta de desconto:
- Resolução dinâmica de cliente:
- Shopify: resolve o ID GraphQL de cliente do destinatário (
gid://shopify/Customer/...) via Admin GraphQL antes de gerar o nó de desconto. - WooCommerce: restringe o cupom gerado ao endereço de e-mail exato do destinatário usando a API REST do WooCommerce.
- Shopify: resolve o ID GraphQL de cliente do destinatário (
- De uso único e seguro:
- Os códigos carregam sufixos criptográficos aleatórios (ex.:
MIA-7F3A91B2). - Cada código é restrito a um único uso (
usage_limit: 1) e vinculado exclusivamente ao endereço de e-mail do destinatário, evitando que o cupom seja vazado em sites de promoções. A única exceção é um código do WooCommerce para um produto que abre um link de checkout: ele continua de uso único, restrito àquele produto e de curta duração, mas não fica vinculado ao e-mail, porque o WooCommerce remove de um link de checkout um cupom vinculado a um e-mail antes de o comprador ter digitado o dele.
- Os códigos carregam sufixos criptográficos aleatórios (ex.:
- Restrição opcional a um produto:
- Um código gerado para a loja inteira se aplica a qualquer compra. Um restrito a um produto — pelo próprio seletor de Escopo da oferta em nível de projeto, ou pelo desconto por produto de um bloco Produto — fica limitado a apenas esse item: no Shopify via
customerGets.items.products.productsToAddem um GID de produto real, no WooCommerce via o campoproduct_idsdo cupom.
- Um código gerado para a loja inteira se aplica a qualquer compra. Um restrito a um produto — pelo próprio seletor de Escopo da oferta em nível de projeto, ou pelo desconto por produto de um bloco Produto — fica limitado a apenas esse item: no Shopify via
- Pré-aplicação no checkout da loja:
- O link de um código restrito à loja inteira ou ao projeto abre a sua loja com o código: o Shopify o aplica (
/discount/MIA-...redirecionando para/); o WooCommerce não tem um link que aplique um código a um carrinho vazio, então o link dele (/cart/?coupon=MIA-...) abre o carrinho e o comprador digita no checkout o código que o e-mail mostra. - O desconto por produto de um bloco Produto, por sua vez, leva o comprador àquele produto específico com o código já aplicado. No Shopify é a página do produto (
/discount/MIA-...?redirect=<product path>). No WooCommerce 10 ou posterior é um link de checkout (/checkout-link/?products=<id>:1&coupon=MIA-...) que coloca o produto, ou a variação escolhida pelo comprador, no carrinho e abre o checkout com o cupom aplicado. Uma loja WooCommerce mais antiga recebe a página do produto com?coupon=MIA-..., e o comprador digita o código no checkout.
- O link de um código restrito à loja inteira ou ao projeto abre a sua loja com o código: o Shopify o aplica (
- Visível antes de o comprador clicar:
- A tela do Estúdio mostra o mesmo selo de desconto e preço riscado do e-mail enviado e da Visualização ao vivo no momento em que você ativa o desconto por produto de um bloco Produto — sem precisar abrir a Visualização ao vivo para conferir.
- Para lojas Shopify, um selo de desconto opcional mostra esse mesmo selo diretamente na página do produto ao vivo, para um comprador que clicou a partir do e-mail, antes do checkout — veja Mostrando o desconto na página do seu produto (Shopify) abaixo para a configuração. Não há equivalente no WooCommerce — os cupons do WooCommerce não têm mecanismo para alterar o que a página de um produto exibe.
Mostrando o desconto na página do seu produto (Shopify)
A tela do Estúdio já mostra o selo de desconto e o preço riscado no momento em que você ativa o desconto por produto de um bloco Produto — sem necessidade de configuração. Colocar esse mesmo selo na sua vitrine Shopify ao vivo é uma etapa manual e única por loja, já que o MailInApp nunca edita seu tema automaticamente. Você cola um pequeno trecho de código na página do produto; não há nada para instalar:
- No MailInApp, vá em Configurações → Integrações. No card da sua loja Shopify, abra Mostrar o desconto nas páginas de produto e clique em Copiar código.
- No Shopify Admin, vá em Online Store → Themes e clique em Customize no seu tema ativo (ou em um rascunho).
- Mude o seletor de página no topo para uma página de Product.
- Na seção Product information, clique em Add block (não em "Add section") e escolha Custom Liquid.
- Cole o código na caixa Liquid code do bloco, arraste o bloco para baixo do preço e depois clique em Save.
O código carrega o selo de mailinapp.com e lê os preços do produto no seu tema, então mostra o preço do tamanho ou da cor que o comprador escolheu e acompanha quando ele troca. Requer um tema Online Store 2.0 (o Dawn e seus forks têm um bloco Custom Liquid na seção do produto).
O selo permanece invisível em uma visita comum à vitrine por design — ele só é renderizado quando a página do produto carrega com o link assinado que um e-mail real de desconto por produto produz. Então navegar até a página você mesmo não vai mostrá-lo, e nem o Enviar teste (que renderiza o e-mail diretamente e pula a etapa de geração de desconto que assina o link do selo). Para realmente vê-lo, envie de verdade para um destinatário — mesmo que seja só para você — e clique em Comprar agora no e-mail entregue. É uma pré-visualização apenas de exibição, calculada a partir do próprio preço da variante escolhida; o desconto real continua se aplicando apenas no checkout, através do código de uso único, de qualquer forma.
Recompensas diferentes por variante
Um experimento pode dar a cada uma das suas variantes a própria oferta da loja, para você testar qual recompensa vende mais. Os códigos são gerados pela mesma conexão com a loja: um código de uso único por destinatário, vinculado ao endereço dele, na loja conectada à lista de contatos do experimento. Você os define na etapa Recompensa e atribuição do experimento:
- Desconto percentual, Desconto de valor fixo ou Frete grátis para cada variante. Ou todas as variantes recebem recompensa, ou nenhuma recebe, e os códigos de todas valem pelo mesmo número de dias, para que nenhuma oferta tenha mais tempo para funcionar.
- O Frete grátis só é oferecido às variantes de um experimento. Na Shopify, é um código de frete grátis restrito ao destinatário. No WooCommerce, é um cupom que dá frete grátis, e ele só funciona se a loja tiver um método Free Shipping configurado para exigir um cupom de frete grátis válido. A etapa avisa quando sua loja não tem nenhum.
- Sem período de espera. Os códigos de uma variante ignoram os marcadores de período de espera acima, então todos os destinatários de uma variante recebem a mesma oferta.
- Mostrados com tags de personalização. Coloque
{{discount_code}}ou{{discount_url}}em um bloco, por exemplo no prêmio e no link de uma raspadinha. O bloqueio só é liberado quando algum bloco mostra a recompensa. O link também leva o experimento e a variante na tagutm_content, para a atribuição descrita abaixo. - Um código que a loja não consegue gerar não segura o envio. O e-mail desse destinatário sai sem a oferta, e o cartão Códigos de recompensa da página de resultados conta esses casos por variante.
Para o frete grátis, informe também o Custo médio de frete por pedido. Ele é contado como custo promocional em cada pedido com frete grátis. Descubra qual recompensa vende mais com um teste A/B de raspadinha mostra um exemplo completo.
Como os pedidos são associados às variantes
Cada pedido pago da loja é comparado com as regras de Atribuição de pedidos do experimento, em uma ordem fixa. A primeira regra que corresponde decide a variante, e as outras não são mais verificadas.
Pedido com o código da variante
- 1Código de descontoO pedido usou o código da variante. A correspondência mais forte, mesmo dias depois.Corresponde
- 2Link rastreadoO comprador chegou pelo link com tag do e-mail.Não verificado
- 3Checkout no e-mailComprou pelo checkout de um bloco de produto.Não verificado
- 4Endereço de e-mail (provável)O endereço do comprador corresponde a um destinatário que clicou durante a janela. Informado como provável.Não verificado
| Etapa | Regra | Resultado |
|---|---|---|
| 1 | Código de desconto | Corresponde |
| 2 | Link rastreado | Não verificado |
| 3 | Checkout no e-mail | Não verificado |
| 4 | Endereço de e-mail (provável) | Não verificado |
| Etapa | Regra | Resultado |
|---|---|---|
| 1 | Código de desconto | Não corresponde |
| 2 | Link rastreado | Não corresponde |
| 3 | Checkout no e-mail | Não corresponde |
| 4 | Endereço de e-mail (provável) | Corresponde |
- Código de desconto: o pedido usou um código enviado a um dos destinatários do experimento.
- Link rastreado: o
utm_contentdo pedido indica o experimento e a variante, e o endereço do comprador está nesse experimento. - Checkout no e-mail: o comprador pagou pelo checkout próprio de um bloco de produto do e-mail. Um pedido da loja nunca corresponde a esta regra.
- Endereço de e-mail (provável): o endereço do comprador é o de um destinatário que clicou para a loja durante a janela, antes de fazer o pedido. Esses pedidos são informados como prováveis.
As regras são escolhidas antes do bloqueio, e só as escolhidas são verificadas. As três primeiras vêm ligadas por padrão. Endereço de e-mail (provável) fica desligada até você escolhê-la. Um grupo de exclusão, que não recebe e-mail, só pode ser associado por endereço de e-mail, então escolha essa regra quando tiver um. Só contam os pedidos feitos durante a janela de observação.
Receita e custo promocional
Os pedidos associados alimentam o cartão Receita e promoções da página de resultados, por variante e por moeda:
- Receita é a mercadoria do pedido depois dos descontos, sem impostos e frete, menos os reembolsos feitos durante a janela.
- Custo promocional são os descontos dos pedidos, mais o custo médio de frete que você informou para cada pedido com frete grátis.
- Uso de códigos são os códigos usados em um pedido associado, divididos pelos códigos emitidos para os destinatários da variante.
Receita
- Variante A · 10% de descontoUS$ 5.616
- Variante B · Frete grátisUS$ 7.056
Custo promocional
- Variante A · 10% de descontoUS$ 624
- Variante B · Frete grátisUS$ 539
| Medida | Variante A · 10% de desconto | Variante B · Frete grátis |
|---|---|---|
| Receita | US$ 5.616 | US$ 7.056 |
| Custo promocional | US$ 624 | US$ 539 |
Nenhum dos dois números é lucro: o custo dos produtos vendidos não está em nenhum deles. Pedidos em moedas diferentes aparecem separados e nunca são somados.
Os reembolsos vêm das notificações de reembolso da Shopify e das atualizações de pedido do WooCommerce. Uma loja Shopify conectada antes de existirem as recompensas de experimento só recebe notificações de reembolso depois que você a reconectar. Métricas de receita explica como a página de resultados lê esses números.
Tipos de oferta suportados
- Desconto percentual: por exemplo, 15% ou 20% de desconto para toda a loja, uma coleção, ou um único produto.
- Desconto de valor fixo: por exemplo, US$ 10 ou US$ 25 de desconto no valor total do carrinho, ou em um produto.
- Frete grátis: só para as variantes de um experimento. Veja Recompensas diferentes por variante.
- Janelas de expiração: os códigos carregam uma data de expiração calculada automaticamente (por exemplo, 7 ou 14 dias a partir do momento do envio), para reforçar a urgência na loja do comerciante.
- Períodos de espera da conta: marcadores de período de espera embutidos evitam cupons excessivos para o mesmo contato em múltiplos agendamentos ou projetos — um marcador para a oferta em nível de projeto, e um separado por bloco Produto, então descontar um produto nunca bloqueia o período de espera de outro ou o da oferta em nível de projeto.
Cota mensal
Cada plano inclui um número de códigos de desconto da loja por mês, visível em Configurações → Plano e uso como Códigos de desconto da loja. Cada código que a MailInApp cria na sua loja para um contato conta uma vez, venha ele da oferta de desconto de um projeto, do desconto por produto de um bloco Produto, da recompensa de uma variante de experimento ou do prêmio de loja de um jogo.
| Free | Starter | Lite | Pro | Business | Enterprise |
|---|---|---|---|---|---|
| 200 | 500 | 2.500 | 15.000 | 75.000 | Ilimitado |
- Um contato que recebe de novo a oferta de um bloco durante o período de espera recebe o mesmo código, contado uma vez.
- A MailInApp avisa você por email quando 80% dos códigos do mês foram usados, e de novo quando todos foram usados.
- Depois que os códigos do mês são usados, os emails continuam saindo no horário com o link da sua loja no lugar do código, e um jogo para em um dos seus outros prêmios. Uma nova cota começa no dia 1º de cada mês.
- Todo o seu catálogo de produtos é sincronizado em todos os planos, então cada produto fica pronto para importar.
Configuração e integração via API
- Shopify: requer credenciais de loja conectada com o escopo
write_discounts(um dos scopes com que o seu app da Shopify é criado, veja Conecte sua loja). - WooCommerce: requer uma consumer key e um secret de API REST da loja conectada, com permissões de leitura/escrita.
O desconto por produto de um bloco Produto exige adicionalmente que esse bloco tenha um produto real importado pelo seletor Importar da loja (não uma URL externa digitada à mão) — a geração do código precisa do id numérico do produto na sua própria loja para restringir o código a ele.

