Configurações de tags
O app pode adicionar tags aos seus clientes e pedidos da Shopify de acordo com o status da assinatura, por exemplo has active subscription em um cliente ou recurring order em um pedido de renovação. Use essas tags para filtrar clientes e pedidos na Shopify, criar segmentos de clientes e direcionar assinantes em ferramentas de e-mail marketing como Shopify Email ou Klaviyo.
Índice
- Como as tags de assinatura funcionam
- Tags de cliente
- Tags de pedido
- Alterar o texto da tag
- Variáveis nas tags
- Usar tags para enviar e-mails ou segmentar assinantes
- Perguntas frequentes
- Guias relacionados
Como as tags de assinatura funcionam
Toda tag fica desativada até você marcá-la. Marque as tags que você quer, clique em Salvar na barra de salvamento e confirme com Atualizar tags.
Quando você salva, o app atualiza na hora as tags dos seus clientes e pedidos de assinatura existentes, então você não precisa esperar por novos pedidos. Aguarde alguns minutos para todas as tags serem atualizadas. Desativar uma tag, ou alterar o texto dela, remove a tag antiga do mesmo modo.
Depois disso, as tags se mantêm atualizadas sozinhas: são adicionadas e removidas conforme as assinaturas começam, renovam, são pausadas, canceladas ou falham.
Tags de cliente
Configuração | Tag adicionada (texto padrão) | Adicionada a clientes que têm |
|---|---|---|
Tem contrato de assinatura | has subscription contract | qualquer assinatura, em qualquer status |
Tem assinatura ativa | has active subscription | pelo menos 1 assinatura ativa |
Tem assinatura pausada | has paused subscription | pelo menos 1 assinatura pausada |
Tem assinatura cancelada | has cancelled subscription | pelo menos 1 assinatura cancelada |
Tem assinatura concluída | has completed subscription | pelo menos 1 assinatura concluída (que chegou ao fim) |
Tem assinatura com falha | has failed subscription | pelo menos 1 assinatura com falha (por exemplo quando o pagamento falha) |
Um cliente pode ter várias delas ao mesmo tempo, por exemplo uma assinatura ativa e uma cancelada.
Tags de pedido
Tags aplicadas aos pedidos de acordo com o papel deles em uma assinatura:
Configuração | Tag adicionada (texto padrão) | Adicionada a |
|---|---|---|
Pedido de assinatura | subscription order | todo pedido que faz parte de uma assinatura |
Número do pedido na assinatura | subscription order #1, #2, #3... | todo pedido de assinatura, contando o primeiro pedido como nº 1 |
Pedido inicial | initial subscription order | o primeiro pedido de uma assinatura |
Pedido recorrente | recurring order | todo pedido de renovação |
Número da renovação da assinatura | subscription renewal #1, #2, #3... | apenas pedidos de renovação, contando a primeira renovação como nº 1 (o primeiro pedido não entra) |
Para colocar o ID da assinatura, o nome da opção de assinatura ou o número do pedido em uma tag, use uma variável.
Alterar o texto da tag
Clique no botão de lápis abaixo de uma tag para abrir Editar tag, digite o novo texto e clique em Editar. As duas tags de número precisam manter a variável de número ({{ contract_order_number }} ou {{ contract_renewal_number }}), que o app substitui pelo número do pedido. As tags salvas com a forma antiga de chave única, como { contract_order_number }, continuam funcionando.
Variáveis nas tags
As tags de pedido e a tag de cliente Tem contrato de assinatura podem incluir variáveis, que o app preenche para cada pedido ou assinatura. Clique em uma variável abaixo da tag em Editar tag para adicioná-la, e o exemplo abaixo dela mostra como a tag vai ficar.
Variável | Preenchida com | Exemplo |
|---|---|---|
| o nome da opção de assinatura | Entrega todo mês |
| o ID da assinatura | 50748162284 |
| com que frequência entrega | 1 mês |
| com que frequência é cobrada (mais longa que a frequência de entrega em uma assinatura pré-paga) | 3 meses |
| o título do produto, uma tag por produto | Grãos de café |
| o título da variante, uma tag por produto | 1 kg |
| o ID do pedido (apenas tags de pedido) | 6123456789012 |
| o nome do pedido (apenas tags de pedido) | #1001 |
| o número do pedido na assinatura, o primeiro pedido é 1 (apenas tags de pedido) | 3 |
| o número da renovação, a primeira renovação é 1 (apenas tags de pedido) | 2 |
Por exemplo, uma tag de pedido plan {{ subscription_name }} fica plan Entrega todo mês, e uma tag Tem contrato de assinatura subscriber {{ subscription_id }} dá ao cliente uma tag por assinatura.
- As tags de status (Tem assinatura ativa, Tem assinatura pausada e as demais) descrevem o cliente como um todo, então continuam sendo texto simples e não aceitam variáveis.
- Uma tag com
{{ product_title }}ou{{ variant_title }}é escrita uma vez para cada produto da assinatura, então uma assinatura de grãos de café e chá verde recebe duas tags. - Tags escritas antes de
{{ delivery_frequency }}existir podem usar{{ frequency }}. Ela continua funcionando e é preenchida com a frequência de entrega. - A Shopify permite até 40 caracteres em uma tag. Quando uma tag preenchida fica mais longa, o app encurta primeiro o nome do produto ou da variante (ou o nome da opção), para que as suas próprias palavras e números permaneçam. O texto que você digita, sem as variáveis, precisa caber em 40 caracteres, ou Editar tag o recusa.
- A Shopify não permite vírgulas em uma tag, então uma vírgula em um valor preenchido vira um espaço.
- Quando você altera uma tag que usa variáveis, o app substitui as tags que o texto antigo escreveu nos seus clientes e pedidos existentes.
Usar tags para enviar e-mails ou segmentar assinantes
O app não envia e-mails de marketing nem em massa por conta própria. Em vez disso, adicione tags aos seus assinantes e use as tags na sua ferramenta de e-mail:
- Ative as tags de cliente de que você precisa, por exemplo Tem assinatura ativa e Tem assinatura pausada, depois salve e confirme com Atualizar tags.
- No admin da Shopify, vá em Clientes > Segmentos e crie um segmento em que as tags do cliente contenham a tag, por exemplo
has paused subscription. - Envie para esse segmento pelo Shopify Email ou use a tag no seu app de marketing. Apps que sincronizam as tags de clientes da Shopify, como o Klaviyo, podem criar listas ou segmentos a partir delas.
Alguns exemplos:
- Reconquistar assinantes pausados ou cancelados: um segmento em has paused subscription ou has cancelled subscription.
- Fazer upsell para quem compra uma única vez: clientes sem has subscription contract nunca assinaram.
- Distinguir primeiros pedidos de renovações em relatórios ou em apps que leem tags de pedido (por exemplo apps de afiliados ou de processamento): use Pedido inicial, Pedido recorrente e as tags de número.
As tags de assinatura são separadas da sua lista de newsletter: um assinante não necessariamente concordou em receber e-mails de marketing, então respeite o consentimento de e-mail marketing de cada cliente.
Perguntas frequentes
- Por que os meus pedidos de renovação não têm uma tag de assinatura?
As tags de pedido ficam desativadas até você ativá-las aqui. Marque Pedido de assinatura ou Pedido recorrente, clique em Salvar e confirme com Atualizar tags. Os pedidos de assinatura existentes também recebem a tag.
- Como envio e-mails apenas para clientes com uma assinatura ativa?
Ative Tem assinatura ativa e depois crie um segmento com a tag has active subscription em Clientes > Segmentos ou no seu app de e-mail.
- Como crio um segmento de assinantes pausados (ou cancelados, ou com falha)?
Ative a tag de cliente correspondente e crie um segmento da Shopify em que as tags do cliente a contenham. A tag é removida automaticamente quando o cliente não tem mais uma assinatura nesse status.
- O meu app de afiliados ou de indicações consegue distinguir um primeiro pedido de uma renovação?
Sim, se ele consegue ler tags de pedido: ative Pedido inicial, Pedido recorrente, Número do pedido na assinatura ou Número da renovação da assinatura. Outros apps não conseguem ler a assinatura em si, porque a Shopify só a compartilha com o app que a criou. Veja Using the API para vincular pedidos a assinaturas a partir dos seus próprios sistemas.
- As tags valem para clientes que assinaram antes de eu ativá-las?
Sim. Salvar a configuração atualiza os seus clientes e pedidos de assinatura existentes em alguns minutos.
Guias relacionados
- How to Offer a One-Time Use Subscription Discount, que usa a tag Tem contrato de assinatura para criar um segmento só de novos assinantes.
- Subscription Analytics
- Using Supr Bundles & Subscriptions with other apps and tools
Atualizado em: 24/10/2026
Obrigado!