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

1. 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).

   

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

   

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

4. Volte ao app e confira se o status diz Enabled.

   O selo de status ao lado de App embed muda para Enabled. O app pergunta de novo à Shopify sempre que você volta para a aba dele, então normalmente não é preciso recarregar nada. 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

Primeiro, ele pergunta à Shopify. O app pergunta à Shopify se o embed Promotions está ligado no seu tema publicado. A resposta da Shopify não depende da sua loja virtual — uma página de senha não muda nada — e o app pergunta de novo sempre que você volta para a aba dele, por exemplo depois de salvar o tema no editor de temas.

Alternativa: as verificações dele. Só quando a Shopify não dá uma resposta clara (ligado ou desligado) o app recorre a duas verificações próprias, que 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.

Essa alternativa é calculada quando a página carrega, então nesse caso recarregue o app para verificar de novo. Em uma loja virtual protegida por senha a alternativa não consegue ler o marcador, então o reporte é o único sinal dela: abra a sua loja virtual uma vez com o embed ligado, depois recarregue o app.

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. A resposta da Shopify é sobre o seu tema publicado, e a alternativa lê a sua loja virtual publicada.
• As mudanças levam um instante para aparecer. As mudanças costumam chegar à sua loja em até um minuto; em algumas páginas pode demorar mais, raramente mais de meia hora.

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.