Referência de variáveis dinâmicas

As variáveis dinâmicas exibem dados ao vivo do produto e da pessoa cliente dentro do texto do selo, sendo substituídas pelo valor real quando alguém visualiza o produto.

Por exemplo, um selo com o texto Save {sale}! aparece como Save 25%! em um produto com 25% de desconto.

Tabela de variáveis

Variável	Descrição	Exemplo de resultado	Plano
{product_vendor}	Nome do fornecedor do produto	“Nike”	FREE
{product_type}	Tipo do produto	“T-Shirt”	FREE
{product_sku}	SKU do produto	“SKU-12345”	FREE
{inventory}	Total de itens em estoque	“42”	FREE
{sale}	Porcentagem de desconto	“25%”	FREE
{sale_amount}	Valor do desconto	“$10.00”	FREE
{product_variant_count}	Número de variantes	“3”	FREE
{customer_order_total}	Total de pedidos da pessoa cliente	“5”	FREE
{customer_spent_total}	Total gasto pela pessoa cliente	“$250.00”	FREE
{product_rating_star}	Nota média em estrelas do produto	“4.8”	FREE
{product_number_of_star}	Número de avaliações do produto	“126”	FREE
{product_metafield}	Valor do metacampo do produto	(varia)	DIAMOND
{variant_metafield}	Valor do metacampo da variante	(varia)	DIAMOND
{countdown}	Contagem regressiva até a data final, Estilo 1	“12Days 20Hrs 50Mins”	GOLD
{countdown_2}	A mesma contagem regressiva no Estilo 2, com cada unidade em uma caixa	“12 : 20 : 50”	GOLD

Variáveis de desconto Sami

Estas quatro variáveis leem o valor de um desconto criado na página Discounts do app. Em Insert dynamic text, elas ficam agrupadas na guia Sami Discount.

Variável	Descrição	Exemplo de resultado
{sami_discount_value_percent}	A porcentagem de desconto do desconto Sami aplicado ao produto	“20%”
{sami_discount_value_amount}	O valor do desconto Sami aplicado ao produto	“Save 10.00”
{sami_discount_code}	O código de desconto do desconto Sami aplicado ao produto (somente descontos com código)	“SUMMER20”
{sami_new_price}	O preço do produto depois da aplicação do desconto Sami	“Now 40.00”

Cuidado

Uma variável de desconto Sami só tem valor em um selo restrito àquele desconto: a guia Products do selo precisa usar Products matching conditions com a condição Sami discount is equal to o desconto. Ao salvar um desconto e clicar em Create badge, isso é configurado para você.

Variáveis de avaliações de produto

Estas duas variáveis leem o valor do app de avaliações usado pela sua loja: Judge.me, Loox, Junip, CWILL(Trustoo), LAI Product Reviews ou AG Product Reviews. Em Insert dynamic text, elas ficam na guia Advanced.

Variável	Descrição	Exemplo de resultado
{product_rating_star}	A nota média em estrelas do produto, sempre com uma casa decimal	“4.8”
{product_number_of_star}	Quantas avaliações o produto tem	“126”

Cuidado

Uma variável de avaliações só tem valor em um selo restrito a um app de avaliações: a guia Products do selo precisa usar Products matching conditions com a condição Product review app is equal to o seu app. Sem isso, o salvamento é bloqueado e um aviso informa o nome da variável. Consulte Exiba selos com base no seu app de avaliações.

Nota

Um produto sem avaliações deixa as duas variáveis vazias, então o app oculta o selo por completo em vez de exibir “stars” sem número na frente.

Observações

Nota

Variáveis de venda e ocultação automática
{sale} e {sale_amount} oferecem uma opção para ocultar o selo automaticamente quando o produto não está em promoção, evitando “0%” ou “$0.00” em produtos com preço cheio.

Nota

Variáveis de metacampo
{product_metafield} e {variant_metafield} exigem o plano DIAMOND. Ao selecionar uma delas, as definições de metacampo da sua loja são listadas como caixas de seleção: marque as que quiser e o app monta o token correto para você, como {product.metafields.custom.material}.

Nota

Contagem regressiva
A contagem regressiva exige o plano GOLD e uma end date definida em Display > Visibility Date & Countdown no editor de selos. Ela é atualizada em tempo real, mostrando o tempo restante até essa data. Os dois estilos são dois tokens separados: o Style 1 insere {countdown} e o Style 2 insere {countdown_2}. Por isso, escolha o estilo em Insert dynamic text antes de inserir.

Cuidado

As variáveis diferenciam maiúsculas de minúsculas: digite-as exatamente como mostrado, incluindo as chaves. {sale} funciona; {Sale} ou {SALE} não funcionam.

---

Próximas etapas

• Como usar variáveis dinâmicas: aprenda passo a passo como adicionar variáveis ao texto do selo.
• Crie um selo de texto: crie seu primeiro selo de texto com conteúdo dinâmico.