Gere Cupons WooCommerce de Uso Único para Um Produto a Partir de um Bloco Produto

A Oferta de desconto em nível de projeto atinge um público inteiro com um cupom para a loja toda (ou para um produto). Este é o irmão mais estreito, em nível de bloco: um desconto que mora no próprio bloco Produto, vinculado a um produto real importado do seu catálogo WooCommerce, gerado por destinatário no momento em que o e-mail dele é enviado, e aplicado direto na própria página daquele produto — sem precisar de um segmento de Histórico de compras nem de configurar uma Oferta de desconto.

Um bloco Produto do Estúdio vinculado à sua loja WooCommerce pode gerar seu próprio cupom de uso único por destinatário, restrito àquele produto específico — sem precisar de um segmento de Histórico de compras nem de uma Oferta de desconto em nível de projeto.

O MailInApp já tem uma Oferta de desconto em nível de projeto para atingir um público inteiro correspondente com um único cupom. Esta é a ferramenta mais estreita: um desconto que mora no próprio bloco Produto, vinculado a qualquer produto real que você importou do seu catálogo WooCommerce, gerado automaticamente para cada destinatário daquele e-mail, e aplicado direto na própria página daquele produto.

Passo 1 — Conecte o WooCommerce

No seu próprio site WordPress, vá em WooCommerce → Configurações → Avançado → API REST e crie uma chave com acesso de Leitura. De volta em Configurações → Integrações do MailInApp, cole a URL da sua loja e essa chave para conectar. O MailInApp só cria cupons através do próprio recurso REST de Cupons da sua loja — ele nunca pede acesso de escrita além disso.

Passo 2 — Importe o produto para um bloco Produto

No Estúdio, adicione um bloco Produto e abra sua busca Importar da loja. Escolha o item real do seu catálogo WooCommerce sincronizado em vez de digitar uma URL manualmente. Importar faz três coisas de uma vez: preenche nome, descrição, imagem e preço; muda o Checkout para Vincular ao checkout externo da loja; e preenche a URL da página externa do produto a partir da própria URL de página do produto. As três coisas importam para o próximo passo — uma URL digitada manualmente não tem um id real de produto da loja por trás, então o alternador de desconto permanece oculto até você importar.

Passo 3 — Ative o Desconto por produto

Com um produto real importado no bloco, um alternador de Desconto por produto aparece no Inspetor. Ative-o e defina:

  • Tipo de desconto — porcentagem ou valor fixo de desconto.
  • Valor do desconto — o número em si.
  • Expira (dias após o envio) — por quanto tempo um cupom gerado permanece válido.

Isso é independente de qualquer Oferta de desconto em nível de projeto que o projeto também possa ter — um envio pode carregar ambos, nenhum, ou um sem o outro.

Passo 4 — Envie, e o MailInApp gera um cupom restrito só a este produto

Pouco antes de o e-mail de cada destinatário renderizar, o MailInApp cria um cupom através da API REST de Cupons da sua loja: de uso único (usage_limit: 1), restrito ao próprio endereço de e-mail daquele destinatário (email_restrictions), e restrito a apenas este produto através do campo product_ids do WooCommerce, em vez do seu carrinho inteiro. O próprio link Comprar agora do bloco é reescrito automaticamente para carregá-lo — nada para montar com uma tag de personalização manualmente, já que um id de bloco não é algo que você pode digitar em um título.

Passo 5 — O comprador cai de volta exatamente no produto, com o cupom já aplicado

O link aplica o cupom como um parâmetro de consulta direto na própria página deste produto — não na URL genérica /cart/ que o link da oferta em nível de projeto usa. Isso é proposital: o e-mail mostrou a ele um item específico, então o link com desconto deve levá-lo a esse mesmo item, sem precisar procurá-lo de novo. Assim como na oferta em nível de projeto, a auto-aplicação não é garantida em todo tema de checkout personalizado — na pior das hipóteses, o comprador digita o código manualmente, e o link nunca fica morto de qualquer forma.

A atribuição funciona igual a qualquer outro clique da loja

O link ainda carrega o mesmo utm_campaign que os outros links de saída do seu projeto carregam. Um pedido feito com o cupom é atribuído de volta a este envio através dos próprios metadados de Atribuição de pedido do WooCommerce (ativados por padrão desde o WooCommerce 8.5), da mesma forma que qualquer outro pedido de clique-through do WooCommerce — veja rastreando pedidos, checkouts e receita do Shopify para como essa atribuição realmente funciona de ponta a ponta (o WooCommerce funciona de forma idêntica assim que conectado).

Se a geração falhar para um destinatário

O e-mail dele ainda é enviado. Se a chamada da API ao vivo tiver uma instabilidade ou um token precisar ser reconectado, o Comprar agora desse destinatário simplesmente recorre ao link de produto simples e sem desconto do bloco — nunca um link quebrado, e nunca um envio bloqueado.

Em que isso difere da Oferta de desconto em nível de projeto

A Oferta de desconto da página de Envio atinge um público inteiro correspondente — frequentemente combinado com um segmento de Histórico de compras — com um escopo de cupom único escolhido em um menu suspenso (loja toda ou um produto). Este recurso pula tudo isso: ele é restrito a qualquer produto que o próprio bloco carregue, não precisa de filtro de público, e gera um cupom para qualquer um que receba o e-mail. Cada um também mantém seu próprio marcador de período de espera, então um desconto por produto em um item nunca bloqueia o desconto de outro item, nem a oferta em nível de projeto, para o mesmo contato. Veja reconquiste compradores anteriores com segmentos de histórico de compras e códigos de desconto para a versão voltada a público deste padrão.

Primeiros passos

Conecte o WooCommerce, importe um produto real para um bloco Produto, ative um Desconto por produto modesto, e envie primeiro para uma lista pequena para confirmar que o link de resgate cai onde você espera. Veja Bloco Produto, Integração com o WooCommerce, e Descontos nativos da loja para a referência completa.

Uma sequência típica de criação e envio

  1. 1

    Conecte o WooCommerce

    No seu próprio site WordPress, vá em WooCommerce → Configurações → Avançado → API REST e crie uma chave com acesso de Leitura. De volta em Configurações → Integrações do MailInApp, cole a URL da sua loja e essa chave para conectar. O MailInApp só cria cupons através do próprio recurso REST de Cupons da sua loja — ele nunca pede acesso de escrita além disso.

  2. 2

    Importe o produto para um bloco Produto

    No Estúdio, adicione um bloco Produto e use sua busca Importar da loja para escolher o item real do seu catálogo WooCommerce sincronizado. Importar define o Checkout como Vincular ao checkout externo da loja e preenche a URL da página externa do produto automaticamente a partir da própria URL de página do produto — ambos necessários para que o próximo passo apareça.

  3. 3

    Ative o Desconto por produto

    Assim que o bloco carrega um produto real importado, um alternador de Desconto por produto aparece no Inspetor. Ative-o e defina uma porcentagem ou um valor fixo de desconto e quantos dias um cupom gerado permanece válido — independentemente de qualquer Oferta de desconto em nível de projeto que este projeto também possa ter. A tela do Estúdio se redesenha imediatamente com o mesmo selo de desconto e preço riscado que os destinatários verão, para que você possa conferir sem abrir a Visualização ao vivo.

  4. 4

    Envie — o MailInApp gera um cupom restrito só a este produto

    Pouco antes de o e-mail de cada destinatário renderizar, o MailInApp cria um cupom através da API REST de Cupons da sua loja, restrito ao próprio endereço de e-mail daquele destinatário e, através do campo product_ids do WooCommerce, a apenas este produto — não ao seu carrinho inteiro.

  5. 5

    O Comprar agora já carrega o cupom

    O link Comprar agora do bloco é reescrito para aplicar o código do cupom como um parâmetro de consulta direto na própria página deste produto — não em uma URL genérica /cart/, como funciona o link da oferta em nível de projeto.

  6. 6

    A atribuição funciona igual a qualquer outro clique da loja

    O link ainda carrega o mesmo utm_campaign que os outros links de saída do seu projeto carregam, então um pedido feito com o cupom é atribuído de volta a este envio da mesma forma que qualquer outro clique-through do WooCommerce, através dos próprios dados de Atribuição de pedido da loja.

Perguntas frequentes

Como isso é diferente da Oferta de desconto em nível de projeto?

A Oferta de desconto da página de Envio atinge um público inteiro correspondente — frequentemente combinado com um segmento de Histórico de compras — com um escopo de cupom único para todos (loja toda ou um produto, escolhido em um menu suspenso). O próprio Desconto por produto de um bloco Produto é restrito a esse único item importado pelo bloco e não precisa de filtro de público nem de configuração na página de Envio; ele gera automaticamente para qualquer um que receba aquele e-mail. Um projeto pode usar um, outro, os dois, ou nenhum — eles rodam de forma independente, com períodos de espera separados.

Preciso de um segmento de Histórico de compras para isso funcionar?

Não. A segmentação por Histórico de compras combina com a Oferta de desconto em nível de projeto, não com esta. O desconto por produto de um bloco Produto gera um cupom para todo destinatário do e-mail em que está, independentemente de ele já ter comprado aquele item — ou qualquer coisa — antes.

O cupom se auto-aplica assim que a página carrega?

Ele é carregado como um parâmetro de consulta com o objetivo de se auto-aplicar na sua página de produto, a mesma convenção de melhor esforço que o próprio link da oferta em nível de projeto já usa — confiável na maioria dos temas, mas não garantida em todo fluxo de checkout personalizado. O link em si nunca fica morto de qualquer forma: na pior das hipóteses, o comprador digita o código manualmente no checkout.

Os compradores conseguem ver o desconto antes mesmo de clicar para o checkout?

No Estúdio, sim, automaticamente — a tela mostra o mesmo selo e preço riscado no momento em que você ativa o alternador, então você não precisa abrir a Visualização ao vivo para conferir. Na própria vitrine, ainda não existe um equivalente do WooCommerce para mostrar um selo na página de produto ao vivo antes do checkout — isso só está disponível para lojas Shopify conectadas, através de um app block de tema opcional. O cupom continua se aplicando corretamente de qualquer forma; isso só afeta se o desconto fica visível antes de o comprador chegar ao checkout.

Por que o alternador de desconto não aparece no meu bloco Produto?

Ele só aparece assim que o bloco carrega um produto real importado através de Importar da loja — a geração precisa do próprio id numérico de produto da sua loja para restringir o cupom a ele, e uma URL de página externa digitada manualmente não carrega isso. Ele também fica completamente oculto no modo de checkout do MailInApp, já que esse modo nunca toca na sua loja WooCommerce.

Posso rodar isso em mais de um produto no mesmo e-mail?

Sim — cada bloco Produto gera e rastreia seu próprio cupom e período de espera de forma independente, vinculado a esse bloco, então descontar um produto nunca bloqueia nem interfere no desconto de um produto diferente, nem na Oferta de desconto em nível de projeto.

O cupom continua funcionando se o destinatário encaminhar o e-mail?

O cupom permanece de uso único e restrito ao próprio endereço de e-mail do destinatário original através das restrições de e-mail do WooCommerce, então um e-mail encaminhado não entrega um desconto utilizável a um estranho — só o próprio e-mail de checkout do destinatário original pode resgatá-lo.

Construa isso no estúdio

Comece no plano gratuito — todos os blocos interativos e o motor de fallback completo estão incluídos em todos os planos.