App embed

O app embed (incorporação do app no tema) do DiscountOS é um único interruptor no editor do seu tema. Com ele ligado, o app consegue pintar coisas na sua loja virtual: Sale Badges, Price Drops, e o brinde adicionado ao carrinho automaticamente em um desconto de brinde na compra. Com ele desligado, esses três não mostram nada — os seus descontos continuam sendo aplicados, então os compradores continuam ganhando o dinheiro.

Configuração

Abra Promotions no app DiscountOS.

Na barra lateral do admin da Shopify, em Apps, o DiscountOS tem três entradas: Manage discounts, Block codes e Promotions (Beta).
Clique em Enable in theme editor.

Enquanto o embed está desligado, a página Promotions mostra um cartão App embed dizendo “Sale Badges and Price Drops need the app embed enabled in your theme”, com um botão Enable in theme editor. O botão abre o editor do seu tema direto no painel de app embeds.

Na página de uma promoção, o mesmo status fica na coluna da direita como uma linha permanente App embed com um botão Enable ou Disable.
Ligue o app embed Promotions e salve o tema.

No painel App embeds do editor de temas, ligue Promotions e clique em Save.

Ligue no tema que você publicou. Um app embed habilitado apenas em um tema não publicado ou em rascunho não chega aos compradores, e o app não o considera.
Volte ao app e confira se o status diz Enabled.

O selo de status ao lado de App embed muda para Enabled. Enquanto o app ainda está descobrindo a resposta, ele mostra um indicador de carregamento em vez de um selo.

Ajustes

O app embed tem dois ajustes próprios, no editor de temas, sob o título Free gift. Eles só importam se você usa um desconto de brinde na compra.

Refresh cart pages after gift changes

Ligado por padrão. Depois de o app adicionar ou remover um brinde, a página do carrinho recarrega para o seu tema mostrar o novo carrinho. Desligue apenas se o seu tema atualiza o carrinho sem recarregar — a observação do próprio ajuste diz que, quando ele está desligado, a página nunca é atualizada depois de mudanças de brinde, então combine-o com o evento abaixo ou os compradores podem ver linhas de brinde desatualizadas até a próxima interação.

Custom cart update event

Opcional. O nome do evento de atualização de carrinho do seu tema. O app o dispara depois de mudanças de brinde para que o tema possa atualizar o carrinho no lugar em vez de recarregar.

Como o app descobre o status

Duas coisas dizem ao app se o embed está ligado, e elas se confirmam mutuamente.

A verificação na loja virtual. O app abre a página inicial da sua loja virtual e procura o marcador que a Shopify imprime na página para todo app embed habilitado. Essa é uma resposta definitiva, ligado ou desligado, e não custa nada a você — é a mesma página pública que um comprador vê. O app a relê no máximo uma vez por minuto por loja.

O reporte vindo do embed. Quando o embed roda, ele se reporta — a partir da sua loja virtual publicada, e a partir da prévia do editor de temas no momento em que você o liga. É por isso que o status normalmente vira Enabled poucos instantes depois de você salvar o tema.

Os dois são combinados:

Marcador encontrado → Enabled.
Marcador ausente, mas o embed se reportou nos últimos 10 minutos → Enabled. Um reporte ao vivo é o embed realmente rodando, o que vale mais que uma página que não mostrou o marcador.
Marcador ausente e nenhum reporte recente → Not enabled.
O app não conseguiu ler a página de jeito nenhum — a sua loja virtual está protegida por senha, ou a requisição expirou → os reportes decidem sozinhos: um reporte nas últimas 48 horas é lido como Enabled, e sem reporte o status fica desconhecido e o app continua verificando.

Em uma loja virtual protegida por senha o app não consegue ler o marcador, então o reporte é o único sinal. Abra a sua loja virtual uma vez com o embed ligado, depois recarregue o app. Até isso acontecer, o status pode ficar atrás do que o seu tema já tem.

Limites e observações

Os quatro blocos de widget não precisam do embed. Quantity Break Table, Quantity Break Picker, Spend More Save More e Cart Goal Bar são blocos de tema que você coloca em uma seção; cada um se renderiza sozinho. Veja Widgets da loja virtual.
Desligar o embed nunca para um desconto. A Shopify continua verificando o carrinho e continua aplicando o desconto. O que para é a exibição: os selos, os preços riscados e o brinde sendo colocado no carrinho no lugar do comprador. Em um desconto de brinde na compra, os compradores ainda podem adicionar o brinde sozinhos e ele continua ficando grátis.
O que conta é o tema publicado. O app lê a sua loja virtual publicada.
As mudanças levam um instante para aparecer. As promoções normalmente chegam à sua loja em até um minuto, às vezes em até 15.

Relacionado

Sale Badge — um selo como “20% off” nas imagens dos seus produtos.
Price Drop — o preço antigo riscado junto do preço com desconto.
Brinde na compra — o desconto cujo brinde o embed adiciona ao carrinho.
O app embed aparece como desativado — o que fazer quando o interruptor está ligado mas o app discorda.