> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://supr-bundles-and-subscriptions.crisp.help/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Configurações de tags

| Para acessar esta página de configurações, vá em [**Supr Bundles & Subscriptions > Configurações > Tags**](https://admin.shopify.com/apps/super-subscriptions/app/settings/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](#3-como-as-tags-de-assinatura-funcionam)
* [Tags de cliente](#3-tags-de-cliente)
* [Tags de pedido](#3-tags-de-pedido)
* [Alterar o texto da tag](#3-alterar-o-texto-da-tag)
* [Variáveis nas tags](#3-variaveis-nas-tags)
* [Usar tags para enviar e-mails ou segmentar assinantes](#3-usar-tags-para-enviar-e-mails-ou-segmentar-assinantes)
* [Perguntas frequentes](#3-perguntas-frequentes)
* [Guias relacionados](#3-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

|| Use estas tags para identificar clientes com base no status da assinatura.

| 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](#3-variaveis-nas-tags).

### 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.

|| Outros guias e os seus próprios segmentos podem depender do texto padrão. [How to Offer a One-Time Use Subscription Discount](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-to-offer-a-one-time-use-subscription-discount-17nguhy/), por exemplo, usa **has subscription contract**. Se você renomear uma tag, atualize qualquer segmento que a use.

### 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 |
| --- | --- | --- |
| `{{ subscription_name }}` | o nome da opção de assinatura | Entrega todo mês |
| `{{ subscription_id }}` | o ID da assinatura | 50748162284 |
| `{{ delivery_frequency }}` | com que frequência entrega | 1 mês |
| `{{ billing_frequency }}` | com que frequência é cobrada (mais longa que a frequência de entrega em uma assinatura pré-paga) | 3 meses |
| `{{ product_title }}` | o título do produto, uma tag por produto | Grãos de café |
| `{{ variant_title }}` | o título da variante, uma tag por produto | 1 kg |
| `{{ order_id }}` | o ID do pedido (apenas tags de pedido) | 6123456789012 |
| `{{ order_name }}` | o nome do pedido (apenas tags de pedido) | #1001 |
| `{{ contract_order_number }}` | o número do pedido na assinatura, o primeiro pedido é 1 (apenas tags de pedido) | 3 |
| `{{ contract_renewal_number }}` | 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:

1. 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**.
2. 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`.
3. 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](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/using-the-api-1bkxr3t/) 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](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/how-to-offer-a-one-time-use-subscription-discount-17nguhy/), que usa a tag **Tem contrato de assinatura** para criar um segmento só de novos assinantes.
* [Subscription Analytics](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/subscription-analytics-fqnmn/)
* [Using Supr Bundles & Subscriptions with other apps and tools](https://supr-bundles-and-subscriptions.crisp.help/pt-br/article/using-the-app-with-other-apps-1vtgstq/)