> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aftersell.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Assinaturas em ofertas pós-compra
Este guia é o passo a passo completo do **Subscription Upsell** (upsell de assinatura): oferecer ao cliente uma assinatura recorrente totalmente nova logo após ele concluir o checkout de um pedido avulso. Ele cobre o fluxo completo de configuração, as limitações da plataforma Shopify que todo app pós-compra herda, o que o cliente vê, o fulfillment, os testes e a solução de problemas.
**Trabalhando com assinaturas no pós-compra?** O Aftersell tem três recursos relacionados a assinaturas, e o certo depende de o pedido do cliente já conter ou não uma assinatura:
* **Subscription Upsell** (este guia). Adiciona um novo item de assinatura a um pedido avulso. O cliente mantém a compra avulsa e ganha uma nova assinatura recorrente por cima.
* [**Subscription Upgrade**](/pt/aftersell/subscription-upgrades). Modifica uma assinatura existente do cliente após o checkout (mudar a frequência, trocar o produto, ou ambos).
* [**Replacement Upsell**](/pt/aftersell/replacement_upsells). Troca um produto avulso do pedido por outro produto. A substituição pode ser uma versão por assinatura do mesmo produto, um produto avulso diferente, ou uma variante ou quantidade diferente. O Replacement Upsell não pode atuar em uma linha de assinatura; se o pedido já contém uma assinatura, use o Subscription Upgrade.
**Pense assim:** o Subscription Upgrade *modifica* uma assinatura existente de alguma forma. O Subscription Upsell é *apenas aditivo* — ele cria uma assinatura totalmente nova.
O Subscription Upsell funciona independentemente de o cliente já ter comprado uma assinatura neste pedido. Se ele já tiver uma, conecte o Recharge, Skio ou Loop e o Aftersell cria a segunda assinatura no seu provedor — veja [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers).
**Uma assinatura por pedido — a menos que você conecte um provedor.** A Shopify não permite que um upsell pós-compra adicione uma assinatura a um pedido que já contém uma. Conectar o Recharge, Skio ou Loop remove essa restrição para o Subscription Upsell, porque o Aftersell passa a criar a nova assinatura no seu provedor em vez de pela Shopify ([detalhes](/pt/aftersell/subscription-upsell-existing-subscribers)). Sem um provedor conectado, a regra continua valendo. De qualquer forma, se o seu funil tem mais de uma oferta de assinatura, apenas a primeira aceita será aplicada — as demais são puladas silenciosamente. Veja [Limitações da plataforma Shopify](#shopify-platform-limitations) para o conjunto completo de regras e a configuração de gatilhos recomendada.
## O que é um Subscription Upsell?
O Subscription Upsell usa a API nativa de assinaturas da Shopify para adicionar uma nova assinatura recorrente ao pedido do cliente na página pós-compra. O cliente aceita com um clique, sem reinserir dados de pagamento ou envio. A compra avulsa permanece no pedido como está, e o novo item de assinatura é adicionado ao lado dela.
A jornada do cliente tem quatro passos curtos:
1. **O cliente conclui o checkout** de um produto avulso.
2. **Vê a oferta de Subscription Upsell** na página pós-compra.
3. **Aceita** sem reinserir dados de pagamento ou envio.
4. **O primeiro pedido da assinatura é enviado**, e as renovações futuras são cobradas pelo seu provedor de assinaturas na cadência que você configurou.
Nos bastidores, o Aftersell usa o changeset pós-compra nativo `add_subscription` da Shopify. O Aftersell não chama diretamente a API do seu app de assinaturas nesse fluxo; a assinatura é criada pela Shopify e o seu app de assinaturas a captura por meio da própria integração com a Shopify. É por isso que o Subscription Upsell funciona com qualquer app de assinaturas que use a API nativa de assinaturas da Shopify.
O primeiro ciclo da assinatura é enviado a partir do **pedido original da Shopify** como um item de linha normal. As renovações seguintes são gerenciadas pelo seu provedor de assinaturas, exatamente como qualquer assinatura criada durante o checkout normal.
## Quando usar um Subscription Upsell
O Subscription Upsell funciona melhor quando:
* Seu produto avulso é um **consumível ou item de reposição** (skincare, suplementos, ração para pets, café, produtos para casa). O cliente já vai precisar dele de novo, então a oferta recorrente soa natural.
* O cliente acabou de demonstrar **intenção de compra** ao concluir o checkout, o que o torna mais receptivo a uma assinatura relacionada do que estaria em uma landing page fria.
* Você pode oferecer uma **troca de valor clara**, geralmente um desconto no primeiro ciclo, frete grátis em pedidos de assinatura ou um pequeno brinde na primeira entrega.
Evite usar o Subscription Upsell para produtos com **padrões de uso irregulares**, preços muito altos em que a fricção do compromisso supera o desconto, ou produtos que os clientes normalmente compram como presentes pontuais.
## Plataformas de assinatura compatíveis
O Subscription Upsell é totalmente agnóstico em relação ao provedor no lado do Aftersell. O Aftersell adiciona a assinatura por meio do changeset pós-compra nativo `add_subscription` da Shopify, e a Shopify encaminha a adesão para o app de assinaturas que você tem instalado na API de assinaturas da Shopify. Isso significa que qualquer app de assinaturas que use a API nativa de assinaturas da Shopify funciona sem configuração adicional, incluindo Recharge, Skio, Loop, Stay.ai, Appstle, Smartrr, Bold Subscriptions (quando rodando na API nativa de assinaturas da Shopify) e os planos de venda nativos da Shopify.
Os planos de venda que você cria no seu app de assinaturas são importados para o Aftersell automaticamente.
Para a compatibilidade do Subscription Upgrade, que é diferente e específica por provedor, veja [Subscription Upgrades](/pt/aftersell/subscription-upgrades).
## Criando uma oferta de Subscription Upsell
Para criar um Subscription Upsell, monte uma oferta pós-compra padrão e selecione um produto que tenha planos de venda habilitados na Shopify. Não há um template separado; a oferta se adapta ao produto que você escolher.
Para abrir o editor de ofertas:
1. No seu painel do Aftersell, vá para **Post-purchase funnels**.
2. Abra um funil existente ou clique em **Add Funnel** para criar um novo.
3. Em um slot de oferta vazio, clique em **Create your first offer** (ou **Create offer**) e selecione o produto que deseja oferecer.
Se o produto tiver planos de venda configurados na Shopify, o editor de ofertas mostra automaticamente os controles relacionados a assinatura.
### Oferecendo produtos por assinatura após o checkout
Se um produto tem planos de venda habilitados na Shopify, você pode oferecê-lo de uma destas três formas. Escolha o modo certo para cada oferta.
#### 1. Vender apenas como produto avulso
O produto é oferecido como compra avulsa. Nenhuma opção de assinatura é exibida, mesmo que o produto tenha planos de venda na Shopify. A experiência é a de uma oferta pós-compra típica.
Escolha este modo quando quiser destacar um produto habilitado para assinatura, mas **sem** comprometer a oferta com receita recorrente (por exemplo, um sampler ou tamanho de teste).
#### 2. Vender apenas como assinatura
O produto deve ser comprado como assinatura. Os clientes não podem escolher uma compra avulsa. As opções de assinatura disponíveis vêm diretamente da Shopify.
Escolha este modo quando quiser comprometer totalmente a oferta com receita recorrente.
#### 3. Vender como assinatura e como produto avulso
Os clientes podem escolher entre compra avulsa ou assinatura. O preço e a frequência de entrega vêm da Shopify. Esta é a opção mais flexível e o melhor lugar para se apoiar em um [padrão de assinatura](#choosing-a-default-option) e em um [desconto no primeiro ciclo](#subscription-discounts) para incentivar os clientes a escolher a opção recorrente.
### Escolhendo uma opção padrão
Se você oferece tanto a opção avulsa quanto a assinatura, pode decidir qual delas vem pré-selecionada quando a oferta carrega. Essa seleção padrão:
* Orienta o comportamento do cliente. Pré-selecionar a assinatura se apoia no viés do padrão e aumenta a aceitação de assinaturas.
* Destaca a sua opção preferida (como a assinatura).
* Ainda permite que os clientes troquem antes de aceitar.
Dados do setor mostram consistentemente que **definir a assinatura como padrão** aumenta a aceitação de assinaturas em 10 a 15 por cento em comparação com o padrão avulso. As taxas de aceitação para ofertas de assinatura pós-compra bem alinhadas normalmente ficam na **faixa de 15 a 30 por cento** quando combinadas com um incentivo no primeiro ciclo.
Se o seu objetivo é receita recorrente, defina o padrão como assinatura. Se o seu objetivo é otimizar a compra avulsa com a assinatura como opção para usuários avançados, defina o padrão como compra avulsa.
### Planos de assinatura permitidos
Ao oferecer produtos por assinatura com vários planos de venda, você pode restringir quais planos os clientes podem escolher usando a configuração **Allowed subscription plans**. Isso é útil quando você quer promover frequências ou faixas de preço específicas sem expor todos os planos do produto.
#### Como funcionam os planos de assinatura permitidos
A configuração é uma lista de permissões, aplicada **por variante**. Para a variante que o cliente selecionar, ele vê apenas os planos permitidos disponíveis para aquela variante:
* Se exatamente um plano permitido se aplica, o nome dele é exibido como texto estático e não há escolha a fazer.
* Se vários se aplicam, o cliente escolhe entre eles em um dropdown de **Purchase options**.
* Se nenhum se aplica, aquela variante volta a exibir todos os seus próprios planos.
Esse escopo por variante significa que uma única lista de permissões pode lidar corretamente com um produto cujas variantes têm planos de venda diferentes.
#### Configurando os planos de assinatura permitidos
1. Abra sua oferta pós-compra no editor.
2. Navegue até a seção **Variant & Plan Options**.
3. Use o multi-select **Allowed subscription plans** para buscar e selecionar os planos que você quer permitir. Os planos selecionados aparecem como tags removíveis.
4. Salve a oferta.
Se nenhum plano for selecionado, os clientes podem escolher entre todos os planos disponíveis para a variante selecionada.
O editor avisa se alguma variante de assinatura não estiver coberta pela sua seleção — essas variantes voltam a exibir todos os seus planos.
#### Comportamento de fallback
Se nenhum dos planos permitidos estiver disponível para uma variante — porque um plano foi removido ou desativado na Shopify, por exemplo — a oferta volta a exibir todos os planos disponíveis para aquela variante, para que os clientes ainda possam concluir a compra.
#### Redefinição automática
A configuração de planos permitidos é limpa se você mudar a opção de compra do produto para apenas compra avulsa. Isso evita erros de configuração quando as opções de assinatura são removidas.
Use os planos de assinatura permitidos quando quiser padronizar cadências específicas para a aquisição pós-compra. Se um produto tem planos semanal, quinzenal e mensal, você pode permitir apenas o plano mensal para proteger a margem, mesmo que a página do produto ainda ofereça os três.
### Qual plano de venda é exibido por padrão
Quando nenhum plano está selecionado em **Allowed subscription plans**, a oferta pré-seleciona o **primeiro plano de venda** configurado no produto na Shopify. Se aquela variante tiver mais de um plano disponível, os clientes podem trocá-lo no dropdown de **Purchase options**. Para controlar qual plano os clientes veem:
* **Restrinja os planos** (recomendado). Use o multi-select **Allowed subscription plans**. Permita exatamente um e os clientes verão apenas aquele plano, sem dropdown.
* **Reordene os planos de venda na Shopify**. A ordem dos planos de venda no produto determina qual é exibido primeiro.
* **Remova do produto os planos de venda não utilizados**. Se você tem várias frequências e quer exibir apenas uma, o caminho mais simples é manter apenas o plano de venda relevante vinculado ao produto.
Os clientes podem escolher uma cadência na oferta sempre que mais de um plano se aplicar à variante deles. Se preferir que não escolham, permita um único plano — o dropdown desaparece e o plano é exibido como texto estático. Os clientes ainda podem mudar a cadência depois, no portal do seu provedor de assinaturas.
O fator mais importante para a retenção é alinhar a cadência ao uso real do produto. Uma assinatura de shampoo de 30 dias em que o frasco dura 60 dias será cancelada. Uma assinatura de 60 dias em que o frasco dura 30 dias será pulada. Analise seus dados de recompra avulsa para encontrar a cadência natural por produto. Se você oferece várias cadências, três ou quatro frequências bem escolhidas normalmente superam uma única cadência travada.
## Descontos de assinatura
Quando você aplica um desconto a uma oferta de Subscription Upsell, o desconto vale apenas para o **primeiro ciclo de cobrança**. Os pedidos recorrentes futuros são cobrados pelo preço normal da assinatura. O cliente pode ver isso na experiência da oferta em **Recurring subtotal**, que mostra quanto custarão as renovações futuras.
Isso é diferente do desconto recorrente usado pelo Subscription Upgrade. Para o comportamento de desconto do Subscription Upgrade, veja [Subscription Upgrades](/pt/aftersell/subscription-upgrades).
### Que preço o cliente realmente vê
O local onde o preço aparece na oferta influencia como o cliente o interpreta. A oferta pós-compra mostra dois preços distintos:
* O **botão Accept Offer** e o subtotal do item refletem o **preço do primeiro ciclo**, incluindo qualquer desconto de primeiro ciclo que você tenha configurado.
* O campo **Recurring subtotal** mostra o que o cliente será cobrado nas **renovações seguintes**, pelo preço normal da assinatura.
Isso funciona bem para descontos de primeiro ciclo típicos (10 a 25 por cento de desconto na primeira entrega). Pode ficar confuso se você configurar um desconto de primeiro ciclo extremo, como 100% de desconto na primeira entrega, porque o preço recorrente (e não o preço de \$0 do primeiro ciclo) é o número mais visível na oferta. Se a sua intenção é uma primeira entrega grátis, seja explícito no texto da oferta ("Primeira caixa grátis, depois \$59.99 a cada 30 dias") para que os clientes entendam que o preço recorrente que veem é o valor contínuo.
### Tipos de desconto
Você pode configurar descontos de duas formas:
* **Desconto percentual.** Reduz o preço da assinatura em uma porcentagem (por exemplo, 15% de desconto).
* **Desconto de valor fixo.** Reduz o preço da assinatura em um valor específico em dólares (por exemplo, \$5 de desconto).
**O desconto só chega à assinatura se você marcar "Apply discount to subscriptions".** Sem isso, o changeset `add_subscription` não carrega desconto e a assinatura é cobrada pelo preço cheio — o desconto da oferta se aplica apenas à linha avulsa.
O desconto viaja no changeset pós-compra `add_subscription` da Shopify em vez de ser aplicado pelo seu app de assinaturas, e só afeta a assinatura criada por esta oferta.
### Quanto desconto oferecer
Faixas de desconto comuns para ofertas de assinatura pós-compra:
* **Desconto de 10 a 15 por cento no primeiro ciclo** é a faixa mais comum e produz um bom aumento de aceitação sem perda significativa de margem.
* **Desconto de 20 a 25 por cento no primeiro ciclo** é o limite superior, usado para elevar a aceitação em produtos competitivos ou quando a cadência recorrente é curta (semanal, quinzenal).
* **Brinde grátis na primeira entrega** é uma alternativa que alguns lojistas consideram mais eficaz que um desconto de preço, porque muda a conversa de "economize dinheiro" para "ganhe algo a mais".
Fique com o desconto de primeiro ciclo na maioria dos casos. Os clientes o esperam, e seu provedor de assinaturas o suporta sem trabalho customizado. Descontos escalonados (30% no primeiro, 20% no segundo, 10% contínuo) raramente valem a complexidade, porque são difíceis de comunicar com clareza.
Qualquer que seja o nível escolhido, deixe o desconto visível tanto no botão da oferta quanto no resumo do item, e deixe claro que ele vale apenas para o primeiro ciclo.
## Exemplos práticos
Quatro cenários comuns de Subscription Upsell, com a configuração exata e a experiência do cliente.
### Cenário 1: Avulso padrão + assinatura com desconto no primeiro ciclo
**Configuração.** Seu cliente comprou um frasco avulso de hidratante por \$30. Você quer oferecer a ele uma assinatura mensal do mesmo produto por \$25 por mês, com 20% de desconto no primeiro ciclo como incentivo à aceitação.
**O que você define na oferta:**
* Opção de compra: vender como assinatura e como produto avulso.
* Opção padrão: assinatura.
* Plano de venda: mensal, \$25.
* Desconto no primeiro ciclo: 20% de desconto.
**O que o cliente vê na oferta:**
* A opção de assinatura vem pré-selecionada.
* Botão Accept Offer: \$20.00 (primeiro ciclo, 20% de desconto sobre \$25).
* Recurring subtotal: \$25.00 a cada 30 dias.
**Ao aceitar:**
* A Shopify cobra \$20 adicionais neste pedido.
* Uma assinatura mensal é criada no seu app de assinaturas por \$25.
* A próxima cobrança acontece em 30 dias, por \$25.
**No pedido:**
* Frasco original (avulso): \$30.
* Frasco da assinatura (primeiro ciclo): \$20.
* Total do pedido: \$50.
### Cenário 2: Primeira entrega grátis (100% de desconto no primeiro ciclo)
**Configuração.** Seu cliente comprou um kit de skincare avulso. Você quer oferecer a ele um refil mensal de sérum com a primeira entrega grátis para incentivar a experimentação.
**O que você define na oferta:**
* Opção de compra: vender apenas como assinatura.
* Plano de venda: sérum mensal, \$40.
* Desconto no primeiro ciclo: 100% de desconto.
**O que o cliente vê na oferta:**
* Botão Accept Offer: \$0.00.
* Recurring subtotal: \$40.00 a cada 30 dias.
* Texto da oferta (recomendado): "Primeiro mês grátis, depois \$40 a cada 30 dias. Pause ou cancele quando quiser."
**Ao aceitar:**
* A Shopify cobra \$0 pela linha da assinatura neste pedido.
* Uma assinatura mensal é criada no seu app de assinaturas por \$40.
* A próxima cobrança acontece em 30 dias, por \$40.
**Ponto de atenção.** Como o botão mostra \$0, os clientes podem interpretar como uma oferta grátis para sempre. Sempre inclua o preço recorrente e a política de cancelamento no texto da oferta.
### Cenário 3: Restringindo a um plano específico (você controla a cadência)
**Configuração.** Você vende café com três planos de venda configurados na Shopify: semanal, quinzenal e mensal. Na sua oferta pós-compra, você só quer exibir o plano mensal, porque ele dá a melhor margem.
**O que você define na oferta:**
* Opção de compra: vender apenas como assinatura.
* Allowed subscription plans: mensal (apenas).
**O que o cliente vê na oferta:**
* O nome do plano exibido como texto estático ("Mensal").
* Sem dropdown de seleção de plano.
* Botão Accept Offer: preço mensal.
**Ao aceitar:**
* Uma assinatura mensal é criada.
* O cliente pode mudar a cadência depois da aceitação no portal do cliente do seu app de assinaturas.
**Quando usar:** sempre que você quiser padronizar uma cadência específica para a aquisição pós-compra, mesmo que a sua página de produto exponha mais opções.
### Cenário 4: O cliente já tem uma assinatura no carrinho
**Configuração.** Um cliente está comprando um sabonete facial avulso E um sérum por assinatura no mesmo pedido. Após o checkout, seu funil pós-compra tem um Subscription Upsell oferecendo uma assinatura de vitaminas.
**O que acontece em tempo de execução, se um provedor de assinaturas está conectado:**
* O Aftersell detecta a linha de assinatura existente no pedido.
* A oferta é exibida com a opção de assinatura intacta, e ao aceitar, a nova assinatura é criada no Recharge, Skio ou Loop. Veja [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers).
**O que acontece em tempo de execução, se nenhum provedor está conectado:**
* O Aftersell detecta a linha de assinatura existente no pedido.
* Se a oferta está configurada como **apenas assinatura**, a oferta é removida do funil para esse cliente. Ele nunca a vê.
* Se a oferta está configurada como **avulso e assinatura**, a oferta é automaticamente rebaixada para apenas avulso. O cliente vê o produto de vitaminas disponível como compra avulsa, sem opção de assinatura.
**Por que isso acontece.** A Shopify permite apenas uma assinatura por pedido. Conectar um provedor permite que o Aftersell crie a segunda assinatura fora da Shopify, e é por isso que a oferta sobrevive. Sem um, o Aftersell lida com a restrição de forma elegante em tempo de execução, e você pode evitar exibir a oferta configurando um **gatilho de assinatura** como "não incluir uma assinatura" no funil.
**Boa prática:** os gatilhos ficam no **funil**, não em ofertas individuais — não existe um gatilho de assinatura por oferta. Configure o gatilho de assinatura do funil uma vez, na etapa de Triggers. Veja [Configuração de gatilhos para upsells de assinatura](#trigger-configuration-for-subscription-upsells).
## O que o cliente vê
Quando um cliente aceita um Subscription Upsell, três coisas acontecem em dois sistemas.
### No pedido da Shopify
A confirmação do pedido do cliente na Shopify incluirá ambos:
* O **item avulso original** que ele comprou no checkout.
* O **novo item de assinatura** adicionado pelo upsell, cobrado pelo preço com desconto do primeiro ciclo.
O cliente paga pelas duas linhas no pedido original. O primeiro fulfillment da assinatura é enviado a partir deste pedido como um item de linha normal.
### Nos e-mails de confirmação
A Shopify envia o e-mail de confirmação de pedido padrão com os dois itens. Seu provedor de assinaturas normalmente envia o próprio e-mail de boas-vindas da assinatura, explicando o cronograma recorrente e como gerenciar a assinatura.
Se você oferece uma assinatura, garanta que o e-mail de boas-vindas do seu provedor de assinaturas esteja configurado para ser enviado minutos após a aceitação, com:
* O nome do cliente e o produto assinado.
* A cadência (a cada 30 dias, a cada 60 dias, etc.).
* A data da próxima cobrança.
* Um link direto para o portal do cliente, onde ele pode pausar, pular ou cancelar.
### No portal do provedor de assinaturas
Depois de aceitar, o cliente pode gerenciar a nova assinatura no portal do cliente do seu provedor de assinaturas. Normalmente ele pode:
* Pausar ou pular uma entrega.
* Mudar a cadência.
* Trocar produtos.
* Cancelar a assinatura.
A experiência do portal pertence ao seu provedor de assinaturas, não ao Aftersell. Garanta que o portal esteja acessível pela área de conta da sua loja ou pelo e-mail de boas-vindas; caso contrário, os clientes acionarão o suporte para cancelar.
## Fulfillment da assinatura
Como o primeiro ciclo é enviado depende da configuração da sua loja.
* **Primeiro ciclo.** O primeiro pedido da assinatura faz parte do pedido original da Shopify, então ele passa pelo processo de fulfillment que você usa para pedidos avulsos (3PL, interno, dropshipping). O item da assinatura é enviado junto com a compra avulsa original.
* **Renovações seguintes.** Os ciclos futuros são criados pelo seu provedor de assinaturas na cadência de renovação. Cada renovação vira um novo pedido na Shopify, processado da mesma forma que qualquer outro pedido da sua loja.
Se o seu 3PL se integra diretamente com o seu provedor de assinaturas, as renovações normalmente fluem automaticamente. Se o seu 3PL sincroniza apenas a partir dos pedidos da Shopify, nenhuma configuração extra é necessária, porque cada renovação cria um pedido na Shopify.
## Convertendo uma compra avulsa em assinatura
Você também pode substituir uma compra avulsa por uma versão por assinatura do mesmo produto após o checkout. Funcionalmente, isso é um Replacement Upsell, não um Subscription Upsell, porque a linha avulsa original é removida (reembolsada) e substituída pela assinatura. O cliente fica **apenas** com a assinatura, não com ambos.
Essa é a escolha certa quando o pedido do cliente deve, no fim, ser uma compra recorrente em vez de pontual, e você não quer que ele receba dois envios separados do mesmo produto.
Para o passo a passo completo de configuração, veja [Como configurar um Replacement Upsell para assinaturas](/pt/aftersell/replacement_upsells).
## Subscription Upgrades
O Subscription Upgrade é o recurso que modifica uma assinatura **existente** do cliente após o checkout. Use-o para mudar a frequência de entrega, trocar para um produto de assinatura diferente, fazer os dois ao mesmo tempo, ou adicionar outro item assinável à assinatura existente. A mudança é aplicada diretamente no Recharge, Skio ou Loop. É um recurso separado do Subscription Upsell porque a Shopify bloqueia adicionar uma nova assinatura a um pedido que já contém uma.
Para o guia completo de configuração, veja [Subscription Upgrades](/pt/aftersell/subscription-upgrades).
## Configuração de gatilhos para upsells de assinatura
Os gatilhos controlam quando a sua oferta de upsell de assinatura dispara. Os dois mais relevantes para o Subscription Upsell são:
* **Gatilho de produto.** Configure-o para o produto avulso original que o cliente deve ter comprado para o upsell de assinatura fazer sentido. Sem um gatilho de produto, a oferta pode disparar em pedidos não relacionados.
* **Gatilho de assinatura.** Se **nenhum provedor está conectado**, configure-o como **não incluir uma assinatura**, para que a oferta só apareça para clientes cujos pedidos ainda não contêm uma assinatura. Isso evita que a regra "uma assinatura por pedido" da Shopify derrube a oferta em tempo de execução. Se você **tem** o Recharge, Skio ou Loop conectado, deixe esse gatilho desligado — a oferta pode atender assinantes existentes, e excluí-los custa essas conversões.
Todos os gatilhos habilitados usam lógica AND. Todas as condições devem ser atendidas para o funil aparecer.
Se **Show this funnel for all customers** estiver habilitado, ele sobrepõe todos os outros gatilhos e a oferta dispara em todos os checkouts. Isso raramente é a configuração certa para um Subscription Upsell, porque a oferta vai disparar em pedidos que já contêm uma assinatura e ser pulada silenciosamente.
## Limitações da plataforma Shopify
Algumas regras da plataforma Shopify se aplicam a ofertas pós-compra relacionadas a assinatura, independentemente de qual recurso do Aftersell você usa.
### Uma assinatura por pedido
A Shopify não permite que um upsell pós-compra adicione uma assinatura a um pedido que já contém uma assinatura. Essa restrição é definida pela Shopify e se aplica a todos os apps pós-compra.
**Conectar um provedor de assinaturas remove essa restrição para o Subscription Upsell.** Quando o Recharge, Skio ou Loop está conectado, o Aftersell cria a nova assinatura no seu provedor em vez de pedir para a Shopify adicioná-la, então as ofertas de assinatura alcançam clientes cujo pedido já contém uma assinatura. Veja [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers) para requisitos e observações por provedor.
Se **nenhum provedor está conectado**, o Aftersell lida com o caso de "assinatura já no carrinho" automaticamente de duas formas:
* **Produtos apenas por assinatura** em uma oferta são removidos do funil para aquele cliente.
* **Produtos em modo duplo** (configurados como avulso + assinatura) são automaticamente rebaixados para apenas avulso, então a oferta ainda aparece, mas sem a opção de assinatura.
De qualquer forma, você pode deixar uma oferta de Subscription Upsell no seu funil sem se preocupar que ela dispare incorretamente em pedidos que já têm assinatura — a oferta se adapta em tempo de execução.
Para modificar a assinatura que o cliente já tem, em vez de adicionar uma segunda, use o [Subscription Upgrade](/pt/aftersell/subscription-upgrades).
### Produtos apenas por assinatura
Se um produto na sua oferta está configurado para ser vendido apenas como assinatura (sem opção de compra avulsa) e nenhum provedor de assinaturas está conectado, a oferta será pulada sempre que o pedido do cliente já contiver um produto por assinatura.
O que o editor de funil mostra depende da sua configuração:
* **Um provedor está conectado.** Nenhum banner. A limitação não se aplica, porque o Aftersell cria a assinatura no seu provedor.
* **Nenhum provedor está conectado.** Um banner **Unlock more reach** com uma ação **Connect a provider**, explicando que clientes cujo pedido já contém uma assinatura não veem a opção de assinatura desta oferta. Conectar um provedor resolve a limitação em vez de contorná-la.
* **O funil já exclui pedidos com assinatura.** Nenhum banner, já que a oferta nunca alcança esses clientes de qualquer forma.
Onde o banner de aviso mais antigo **Subscription limitations** aparece, ele lista os produtos afetados e inclui uma dica: configure o **gatilho de assinatura** como **não incluir uma assinatura**, para que a oferta só apareça para clientes cujos pedidos ainda não têm uma assinatura.
### Várias ofertas de assinatura no mesmo funil
Se mais de uma oferta no seu funil contém um produto por assinatura, apenas a primeira assinatura aceita é adicionada ao pedido. As ofertas de assinatura seguintes são puladas. O editor de funil avisa quando esse conflito é detectado, listando as outras ofertas do funil que também contêm produtos por assinatura.
Para evitar ofertas puladas, limite o seu funil a uma oferta de assinatura, ou use o **gatilho de assinatura** para excluir pedidos que já contêm uma assinatura.
## Testando um Subscription Upsell
Antes de colocar no ar uma nova oferta de Subscription Upsell:
Faça um pedido de teste real e de baixo valor na sua loja; não dependa do Preview Mode para esta etapa. O Preview Mode renderiza o funil visualmente e permite clicar em Accept e Decline para percorrer a experiência do cliente, mas ele é isolado: nenhum pedido é criado, nenhuma assinatura é criada no seu provedor de assinaturas, nenhuma cobrança acontece e nenhum e-mail ou webhook dispara. Use o Preview Mode para revisar layout e texto, e um pedido de teste real para a verificação de ponta a ponta.
Após o checkout, a oferta pós-compra aparecerá. Aceite o upsell de assinatura para disparar o changeset real.
Em **Shopify Admin -> Orders**, encontre o pedido de teste. Você deve ver os dois itens: o produto avulso original e o novo produto por assinatura, com qualquer desconto de primeiro ciclo aplicado.
Encontre a nova assinatura do cliente no painel do seu provedor. Confirme a cadência, a data da próxima cobrança e o produto.
Se o seu provedor de assinaturas suporta renovações de teste, adiante a data da próxima cobrança e confirme que a renovação cria um novo pedido na Shopify pelo preço normal (sem desconto).
Se algo parecer errado, veja a [Solução de problemas](#troubleshooting) abaixo.
## Solução de problemas
Para que os controles de assinatura apareçam no editor de ofertas, o produto selecionado deve ter pelo menos um plano de venda ativo na Shopify. Verifique se o seu app de assinaturas criou planos de venda para este produto e se os planos de venda estão ativos e atribuídos ao produto.
A oferta pré-seleciona o primeiro plano de venda configurado no produto na Shopify, e os clientes podem trocá-lo no dropdown de **Purchase options** quando mais de um plano se aplica à variante deles. Para controlar qual plano eles veem, restrinja a oferta com o multi-select **Allowed subscription plans**, reordene os planos de venda no produto na Shopify para que o desejado fique primeiro, ou remova completamente os planos de venda não utilizados do produto. Permitir exatamente um plano remove o dropdown.
Sim, quando mais de um plano se aplica à variante que ele seleciona — a oferta mostra um dropdown de **Purchase options**. Para evitar isso, use **Allowed subscription plans** para permitir um único plano; a cadência então é exibida como texto estático. Os clientes ainda podem mudar a cadência depois, no portal do seu provedor de assinaturas.
Use o modo **One-time purchase only** na configuração de opção de compra da oferta. O Aftersell tem três modos para produtos habilitados para assinatura: **One-time purchase only**, **Subscription only** e **One-time purchase and subscription**. Selecionar **One-time purchase only** oculta a opção de assinatura por completo, mesmo quando o produto tem planos de venda ativos. Veja [Oferecendo produtos por assinatura após o checkout](#offering-subscription-products-after-checkout) para detalhes dos três modos.
Este é um dos modos de falha mais graves do Subscription Upsell, porque o cliente foi cobrado, mas a assinatura nunca foi criada no seu provedor de assinaturas. A causa raiz mais comum, de longe, é um **plano de venda que foi desativado entre a renderização da oferta e a aceitação do cliente**. A Shopify aceita o changeset porque ele tem um ID de plano de venda válido no momento da renderização da oferta, mas se o plano for desativado antes de o cliente aceitar, nenhuma assinatura é criada em seguida e nenhum erro é exibido.
Outras causas comuns:
* **O webhook do app de assinaturas está falhando.** Qualquer app de assinaturas que capta novas assinaturas da Shopify depende dos webhooks da Shopify. Verifique a saúde da entrega de webhooks nos logs do seu app de assinaturas.
* **O plano de venda foi desvinculado do produto**, mas ainda tem um ID ativo. A Shopify aceita o changeset e o item entra no pedido, mas o provedor de assinaturas não tem registro para processar.
**Importante:** não há retentativa automática no caminho nativo `add_subscription` — a Shopify é dona da adesão ali, então o Aftersell não tem nada para reprocessar. (O caminho separado via provedor, usado quando o pedido já contém uma assinatura, *é* coberto pelo [workflow de retentativa do subscription upgrade](/pt/aftersell/subscription-upgrades-troubleshooting).) Se isso acontecer com um cliente:
1. Confirme que o plano de venda ainda está ativo na Shopify e atribuído ao produto.
2. Verifique os logs de importação de pedidos / webhooks do seu app de assinaturas para o pedido afetado.
3. Se a assinatura realmente estiver ausente, a equipe de suporte do seu app de assinaturas normalmente pode inscrever o cliente manualmente a partir do ID do pedido.
Se vários clientes forem afetados, contate o suporte do Aftersell com os IDs dos pedidos e o seu provedor de assinaturas, mas espere que a correção aconteça no lado do provedor de assinaturas, não no Aftersell.
Isso geralmente aparece quando o desconto do primeiro ciclo é extremo (por exemplo, 100% de desconto no primeiro ciclo). O botão Accept reflete o preço do primeiro ciclo, mas se esse preço parecer idêntico ao preço recorrente (por casos extremos ou formatação), pode dar a impressão de que o desconto não foi aplicado. Confirme na pré-visualização da oferta que o desconto está configurado corretamente e use o texto da oferta ("Primeira caixa grátis, depois \$X a cada Y dias") para deixar os termos inequívocos para os clientes.
Os descontos se aplicam apenas ao **primeiro ciclo de cobrança** por padrão. Se o seu cliente está perguntando por que o segundo ou terceiro pedido não tem o desconto, esse é o comportamento esperado. Os pedidos recorrentes são cobrados pelo preço normal da assinatura, que o cliente viu como **Recurring subtotal** na oferta.
Se você tem o Recharge, Skio ou Loop conectado, isso é esperado e a oferta funciona: o Aftersell cria a nova assinatura no seu provedor. Veja [upsell para assinantes existentes](/pt/aftersell/subscription-upsell-existing-subscribers).
Se nenhum provedor está conectado, a Shopify bloqueia a adição de uma segunda assinatura e a oferta é pulada silenciosamente em tempo de execução. Conecte um provedor, ou impeça a oferta de aparecer para esses clientes configurando o **gatilho de assinatura** como **não incluir uma assinatura**.
A Shopify permite apenas uma assinatura por pedido. Se você tem várias ofertas de assinatura no mesmo funil, a primeira aceita vence e as demais são puladas. Limite o seu funil a uma oferta de assinatura, ou use o gatilho de assinatura para excluir pedidos que já têm uma assinatura.
A nova assinatura é gerenciada no portal do cliente do seu provedor de assinaturas, não diretamente na Shopify. Garanta que o portal esteja vinculado à área de conta da sua loja e confirme que o e-mail de boas-vindas do seu provedor de assinaturas está configurado para ser enviado imediatamente após a aceitação.
O primeiro ciclo foi pago como parte do pedido da Shopify, então os reembolsos funcionam como em qualquer outro item. O cancelamento dos ciclos futuros acontece no seu provedor de assinaturas, não no Aftersell. Reembolsar a linha na Shopify não cancela automaticamente a assinatura; você precisa cancelá-la também no portal do provedor.