> ## Documentation Index
> Fetch the complete documentation index at: https://docs.octasend.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Popups personalizadas

> Mostre na sua loja uma oferta diferente para cada visitante, a partir do que ele navegou e comprou, e acompanhe exibições, cliques e vendas

As **popups personalizadas** aparecem na sua loja com uma mensagem que muda conforme o visitante: quem viu um produto e não comprou, quem navegou numa categoria, quem costuma comprar um item e já passou da hora de repetir. Você define a regra, o conteúdo e o formato, e a OctaSend decide, para cada pessoa, qual popup mostrar (se houver alguma).

Depois, a tela de resultados mostra quantas vezes a popup apareceu, quantos cliques recebeu e quanto foi vendido, inclusive as vendas feitas com o cupom da popup.

> [!NOTE]
>
> As popups aparecem na loja pela [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md). Sem a tag instalada no site, nada é exibido.

## Antes de começar

* **OctaTag instalada na loja.** O módulo de popups carrega sob demanda, como os outros recursos da tag. Veja [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md).
* **Loja conectada.** Nesta primeira versão, as popups funcionam com **Nuvem Shop**, **Yampi** e **Shopify**: a OctaTag lê da própria página o produto, a categoria e o cliente logado. As demais plataformas ficam para depois.
* **Cupom criado na loja.** A OctaSend não cria cupom: você cria o cupom na plataforma da loja e só digita o código na popup.
* **Permissão no perfil de acesso.** O item **Popups** aparece no menu para quem tem a permissão de visualizar a página. Veja *Quem pode usar*, abaixo.

> [!NOTE]
>
> Se o item **Popups** não aparecer no menu ou a tela mostrar "Módulo não liberado", fale com a OctaSend para ativar o módulo na sua conta.

## Onde fica

No menu **Popups**. A lista mostra, para cada popup:

| Coluna | O que mostra |
| - | - |
| **Nome** | O nome interno da popup. Só você vê. |
| **Regra** | O tipo de regra (veja abaixo). |
| **Formato** | Janela central, cartão no canto, barra no topo ou barra no rodapé. |
| **Situação** | **Rascunho**, **Ativa**, **Pausada** ou **Arquivada**. |
| **Prioridade** | O número de prioridade da popup. |
| **Ações** | **Editar** e **Resultados**. |

Para quem só pode visualizar, a linha leva direto aos resultados.

## Criar uma popup

**1. Abra o editor**

Em **Popups**, clique em **Nova popup**. Com a lista vazia, o botão fica no centro da tela.

**2. Dê um nome**

Em **Identificação**, preencha **Nome da popup**. É obrigatório e só você o vê.

**3. Escolha a regra**

Em **Regra**, escolha quem deve ver a popup (veja *Regras*, abaixo).

**4. Defina público e região**

Em **Público e região**, escolha entre **Clientes identificados** e **Todos os visitantes**, e, se quiser, limite por estado e cidade.

**5. Escreva o conteúdo**

Em **Conteúdo**, preencha título, texto, imagem, cupom e botão. A **Prévia**, ao lado, acompanha o que você digita.

**6. Escolha formato, páginas e frequência**

Em **Formato** e **Onde e quando**, defina como e em quais páginas a popup aparece.

**7. Salve ou ative**

**Salvar rascunho** guarda a popup sem exibi-la. **Ativar** coloca a popup no ar.

Para tirar uma popup do ar sem perdê-la, abra o editor e clique em **Pausar**. **Ativar** volta a exibi-la. Pausar e ativar exigem a permissão de publicar.

## Regras

Cada popup tem uma regra, que define a quem ela vale.

| Regra | Quando a popup vale | Ajuste |
| - | - | - |
| **Produto navegado** | A pessoa viu um produto e não comprou depois. | **Considerar navegação dos últimos**: de 1 a 90 dias (padrão 7). |
| **Categoria navegada** | A pessoa navegou numa categoria. | **Considerar navegação dos últimos** (padrão 7 dias) e **O que mostrar**: o último produto visto na categoria ou a própria categoria. |
| **Produto em promoção** | Um produto com preço promocional (preço cheio maior que o de venda). | **Só produtos que a pessoa viu**, ligado por padrão. |
| **Recompra** | A pessoa compra o produto com frequência e a recompra está atrasada. | **Dias de atraso para mostrar**: de 0 a 90 (padrão 7). Com 0, a popup aparece assim que a data de recompra passa. |
| **Geral** | Todos que navegam na loja, sem personalização. | Nenhum. |

Detalhes:

* **Recompra** usa a mesma lógica do critério *Atrasado no padrão de compra* das [automações](https://docs.octasend.com.br/plataforma/automacoes.md): é preciso ter pelo menos 3 pedidos do produto, e a popup aparece quando o tempo desde a última compra passa da média entre as compras, somada à margem que você definiu.
* A popup **não oferece um produto que a pessoa já comprou** depois de vê-lo.
* Se vários produtos se qualificam, a popup mostra o visto mais recentemente (navegado), o mais atrasado (recompra) ou o mais visto da categoria.

## Público e região

| Campo | Opções |
| - | - |
| **Público** | **Clientes identificados**: quem a loja já reconhece pelo cadastro ou compra. **Todos os visitantes**: disponível só na regra **Geral**. |
| **Estados** | Sigla do estado, como `SP`. Vazio mostra em todo o país. |
| **Cidades** | Vazio mostra em todas as cidades. |

* Visitante anônimo só recebe popup da regra **Geral** com público **Todos os visitantes**.
* A regra **Recompra** exige público **Clientes identificados**.
* A região vem do **endereço do cliente** (pedidos e cadastro da loja). Sem endereço, a OctaSend tenta a região da conexão, mas essa informação normalmente **não está disponível hoje**. Na prática, o filtro de região vale para quem tem endereço conhecido.

## Conteúdo

| Campo | O que faz |
| - | - |
| **Título** | Obrigatório. |
| **Texto** | Texto de apoio da oferta. |
| **Imagem** | Endereço de uma imagem. Vazio usa a foto do produto. |
| **Cupom** | O código criado na loja. O editor grava em maiúsculas. |
| **Texto do botão** | O padrão é "Ver produto". |
| **Destino do botão** | **Página do produto** ou **Outro endereço** (que precisa começar com `https://`). |

No título e no texto, você pode usar três variáveis:

| Variável | Vira |
| - | - |
| `{{produto}}` | O nome do produto da popup. |
| `{{preco}}` | O preço do produto. |
| `{{nome}}` | O primeiro nome do cliente. |

> [!TIP]
>
> Um bom título para a regra **Produto navegado**: "Ainda pensando no {{produto}}?". Um bom texto: "Ele está por {{preco}} e ainda dá tempo."

O botão leva à página do produto ou ao endereço que você informou. Ele **não** adiciona o produto ao carrinho.

## Formato, páginas e frequência

| Campo | Opções |
| - | - |
| **Formato** | **Janela central**, **Cartão no canto**, **Barra no topo** ou **Barra no rodapé**. |
| **Páginas** | Padrão de endereço, com `*` como curinga, como `/produtos/*`. Só `*` mostra em todas as páginas. |
| **Quando aparecer** | **Ao abrir a página** ou **Ao tentar sair da página**. |
| **Esperar antes de aparecer** | De 0 a 60 segundos. |
| **Frequência** | **Uma vez por pessoa**, **De novo após um intervalo** (com o campo **Intervalo**, em dias) ou **Toda vez que a regra valer**. |

## Prioridade e janela de atribuição

* **Prioridade:** se duas popups valem para a mesma pessoa ao mesmo tempo, aparece uma só: a de **número maior**.
* **Janela de atribuição:** vendas feitas até esse prazo depois de a pessoa ver a popup contam para ela. O padrão é 7 dias, e o limite vai até 365.

## Prévia

A **Prévia** do editor mostra a popup no formato escolhido, com o texto e a imagem que você digitou. Se a sua loja tem produtos sincronizados, a prévia usa um produto seu; senão, usa um produto de exemplo ("Camiseta básica") e avisa para conectar a loja. A prévia não registra exibições nem cliques.

## Resultados

Em **Popups**, clique em **Resultados** na linha da popup. O seletor **Período** oferece **7 dias**, **30 dias** (padrão) ou **90 dias**.

| Indicador | O que conta |
| - | - |
| **Exibições** | Quantas vezes a popup apareceu. |
| **Cliques** | Cliques no botão, com a taxa de clique em relação às exibições. |
| **Vendas com cupom** | Valor dos pedidos importados cujo cupom é o código da popup, com a quantidade de pedidos. |
| **Vendas atribuídas sem cupom** | Valor dos pedidos de quem viu ou clicou na popup e comprou dentro da **janela de atribuição**, sem usar o cupom. |

As duas medidas de venda são separadas de propósito: uma conta quem usou o cupom, a outra conta quem comprou depois de ver a popup, mesmo sem cupom. Uma nota abaixo dos cartões lembra a janela usada (por exemplo, "Quem comprou em até 7 dias depois de ver a popup").

> [!NOTE]
>
> O cupom é lido dos pedidos que a loja conectada sincroniza para o painel (Nuvem Shop, Yampi e Shopify). Pedidos antigos da Nuvem Shop receberam o cupom a partir dos dados já guardados.

## Privacidade

* A navegação só é registrada para visitante **identificado** e que deu **consentimento de marketing** no banner de cookies. Veja [Cookies e LGPD](https://docs.octasend.com.br/plataforma/cookies-lgpd.md).
* As visualizações de produto são apagadas depois de **90 dias**.
* A resposta enviada ao navegador nunca traz dado pessoal além do **primeiro nome**: só produto, preço, imagem e cupom.
* A identidade do visitante vem do cliente logado que a loja expõe na página e **não é verificada criptograficamente**. Por isso a resposta é limitada como descrito acima.
* A navegação de visitante anônimo não é registrada nem ligada a um contato depois.

## Quem pode usar

O acesso é controlado pelos [perfis de acesso](https://docs.octasend.com.br/plataforma/configuracoes.md) (**Configurações → Perfis de acesso**, página **Popups**):

| Permissão | O que libera |
| - | - |
| **Visualizar** | Ver a lista e os resultados. |
| **Criar** | Criar popups. |
| **Editar** | Editar popups existentes. |
| **Publicar** | Ativar e pausar. |
| **Excluir** | Excluir popups. |

Os perfis **Master** e **Padrão** já têm todas as permissões. Perfis criados pela sua conta precisam recebê-las.

## Limites desta versão

* O filtro de região depende do endereço do cliente (veja *Público e região*).
* O botão leva à página do produto; não adiciona ao carrinho.
* A navegação não é usada em outros canais, como e-mail e WhatsApp.
* Não há teste A/B nem editor livre de layout.
* Na Yampi, o formato do cupom nos pedidos ainda precisa de conferência numa loja real. Confirme os números de **Vendas com cupom** antes de depender deles nessa plataforma.

## Solução de problemas

> [accordion] A popup está ativa, mas não aparece na loja
>
> Confira, nesta ordem:
>
> 1. A [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md) está instalada e o domínio da loja aparece em **Configurações → Instalação**?
> 2. A regra se aplica a quem está testando? Visitante anônimo só vê popup da regra **Geral** com público **Todos os visitantes**.
> 3. O visitante deu consentimento de marketing no banner de cookies? Sem ele, a navegação não é registrada e as regras de navegação não valem.
> 4. O padrão de **Páginas** cobre a página aberta?
> 5. A **Frequência** já foi cumprida para essa pessoa (por exemplo, **Uma vez por pessoa**)?
> 6. Há outra popup com **Prioridade** maior valendo ao mesmo tempo?

> [accordion] Não consigo escolher Todos os visitantes
>
> Esse público só existe na regra **Geral**. As outras regras dependem do que a pessoa navegou ou comprou, e isso só é conhecido para visitantes identificados.

> [accordion] As vendas com cupom estão zeradas
>
> As vendas contam pedidos importados cujo cupom tem o mesmo código da popup. Confira se o código digitado na popup é igual ao da loja e se a integração está sincronizando os pedidos.

## Veja também

> [card] [OctaTag](https://docs.octasend.com.br/plataforma/octatag.md)
>
> A tag que exibe as popups no seu site.

> [card] [Cookies e LGPD](https://docs.octasend.com.br/plataforma/cookies-lgpd.md)
>
> O consentimento de marketing que libera o registro de navegação.

> [card] [E-commerce](https://docs.octasend.com.br/plataforma/ecommerce.md)
>
> Clientes, pedidos e produtos que alimentam as regras.

> [card] [Automações](https://docs.octasend.com.br/plataforma/automacoes.md)
>
> A mesma lógica de recompra, aplicada a mensagens.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.