Cupons

Os pools de cupons no Pushwoosh permitem que você personalize notificações push, e-mails, mensagens do WhatsApp e outras mensagens, inserindo códigos de cupom exclusivos. Um pool de cupons é uma coleção de códigos que compartilham configurações comuns, como nome e data de validade opcional.

Criar um pool de cupons

Para criar um novo pool de cupons:

1. Vá para Conteúdo > Cupons no Painel de Controle do Pushwoosh.
2. Clique em Criar Pool de Cupons.

3. Faça o upload de um arquivo .csv contendo seus códigos de cupom na janela que se abre.

Requisitos do CSV

• O arquivo deve ter uma coluna chamada vouchers.
• O tamanho do arquivo não deve exceder 10 MB.
• Se o arquivo contiver códigos duplicados, apenas uma cópia de cada um será adicionada.
• Salve o arquivo no formato .csv e certifique-se de que ele esteja codificado em UTF-8.

Exemplo de arquivo CSV

vouchers
WELCOME2025-A1
WELCOME2025-B2
WELCOME2025-C3
WELCOME2025-D4
WELCOME2025-E5

4. Insira o nome do pool (máximo de 300 caracteres).
5. Opcionalmente, habilite Usar data de validade para definir por quanto tempo o pool de cupons permanecerá ativo. Defina o período de validade em GMT.

Quando o pool expirar:

• Ele não aparecerá mais na lista de pools de cupons disponíveis na Customer Journey.
• Cupons do pool expirado não serão enviados.
• Qualquer tentativa de enviar uma notificação push com eles resultará em um drop-off com o motivo: Voucher pool has expired.

Observação: A criação de um pool pode levar até 10 segundos se o arquivo enviado contiver um grande número de cupons.

Adicionar cupons a um pool existente

Para adicionar mais cupons a um pool existente:

1. Na página da lista de pools de cupons, clique nos três pontos ao lado do pool desejado e selecione Adicionar cupons.

2. Faça o upload de um arquivo .csv que inclua uma coluna vouchers com os códigos a serem adicionados.
3. Clique em Adicionar cupons. Quaisquer duplicatas já existentes no pool serão ignoradas.

Excluir cupons

Para remover cupons de um pool:

1. Na página da lista de pools de cupons, clique nos três pontos ao lado do pool desejado e selecione Excluir cupons.
2. Faça o upload de um arquivo .csv que inclua uma coluna vouchers com os códigos a serem removidos. O tamanho máximo do arquivo é de 10 MB.
3. Na etapa Confirmar Ação, clique em Excluir cupons para confirmar, ou em Cancelar. Você também pode clicar em Fazer upload de outro arquivo para alterar a seleção.

Excluir pool

Para excluir um pool de cupons inteiro:

1. Na página da lista de pools de cupons, clique nos três pontos ao lado do pool desejado e selecione Excluir pool.
2. Na caixa de diálogo de confirmação, verifique o nome do pool e clique em Excluir para confirmar.

Cuidado

Esta ação não pode ser desfeita.

Enviar cupons via Customer Journey

Você pode enviar códigos de cupom exclusivos para os usuários por meio de vários canais de mensagens na Customer Journey do Pushwoosh, incluindo push, e-mail, SMS, LINE, Dados para o aplicativo e WhatsApp.

Este exemplo mostra como enviar cupons por meio de notificações push usando a Customer Journey do Pushwoosh. Siga estes passos:

1. Crie uma predefinição de push que inclua o placeholder {{voucher}}. Ele pode ser colocado no título, subtítulo ou corpo da mensagem.

2. Na Customer Journey, adicione um elemento Push e selecione uma predefinição com cupons.

3. Em Sobrescrever personalização, habilite a opção Usar Cupons. Selecione o pool de cupons que você deseja usar.
4. Opcionalmente, defina uma tag. Essa tag é um atributo personalizado que será salvo no dispositivo do usuário quando um cupom for enviado.

O código exato do cupom entregue será armazenado nesta tag, permitindo que você o visualize mais tarde na seção Visualizar Assinante no perfil do dispositivo ou do usuário.

Dica

Certifique-se de criar a tag com antecedência. Dê a ela um nome claro e descritivo, defina o Tipo de valor como String e marque o Tipo de tag como Específica do usuário. Isso é necessário para armazenar os valores dos cupons individualmente para cada usuário.

Exibir um cupom como código de barras

Em vez de mostrar o cupom como texto simples, exiba-o como um código de barras ou código QR escaneável.

Em e-mail ou in-app

Use o bloco Código de Barras integrado. Ele constrói a imagem para você:

• Blocos de conteúdo de e-mail
• Blocos do editor in-app
• Mensagens in-app nativas

As Cloud Pages têm o mesmo bloco de Código de Barras. Uma página é um arquivo compartilhado para todos os visitantes, então use-o para um código que seja o mesmo para todos. Para um cupom exclusivo para cada destinatário, use e-mail ou in-app.

Em uma notificação push

Funciona a partir de uma Customer Journey

Isso funciona quando a predefinição é enviada por um elemento Push da Customer Journey com a opção Usar Cupons ativada e um pool selecionado (passo 3 abaixo).

Para uma notificação push, construa você mesmo a URL e cole-a na predefinição:

https://render.pushwoosh.com/barcode/v1/code.png?sym=code128&v={{voucher}}&hri=1&w=600

1. Copie a URL acima. Se sua conta estiver hospedada no data center dos EUA, altere o host para render.pushwoosh.us. Se você não tiver certeza de qual data center sua conta usa, entre em contato com seu Gerente de Sucesso do Cliente ou com o Suporte da Pushwoosh.
2. Na predefinição de push, ative Conteúdo de mídia e cole a URL em URL do Banner. Use URL do Banner, não Ícone: o ícone é renderizado muito pequeno para ser escaneado.

3. No elemento Push da Customer Journey, ative Usar Cupons e selecione um pool. Consulte Enviar cupons via Customer Journey.

Para alterar o tipo de código de barras, o tamanho ou se os dígitos são impressos sob o código, edite estes parâmetros na URL:

• sym. Tipo de código de barras:
  • qr. Um código 2D quadrado que os telefones podem escanear. Aceita qualquer texto, incluindo códigos alfanuméricos como WELCOME2025-A1
  • code128. Um código de barras linear para qualquer texto, incluindo os mesmos códigos alfanuméricos
  • ean13. O código de barras de varejo comum na Europa e em muitas outras regiões. Apenas dígitos, 12–13 caracteres
  • ean8. Um código de barras de varejo mais curto para embalagens pequenas. Apenas dígitos, 7–8 caracteres
  • upca. O código de barras de varejo comum na América do Norte. Apenas dígitos, 11–12 caracteres
• v. O valor a ser codificado. Mantenha {{voucher}} (ou uma tag de Conteúdo Dinâmico) para que seja resolvido para o código de cada destinatário no momento do envio
• hri. 1 imprime o código sob o código de barras. 0 o oculta
• w. Largura em pixels, de 32 a 2000. Use pelo menos 600 para que os scanners possam lê-lo de forma confiável
• h. Altura em pixels, de 32 a 2000

Cuidado

Use ean13, ean8 ou upca apenas para um cupom que contenha apenas dígitos, no comprimento que cada um espera (veja a lista acima). Para códigos alfanuméricos como WELCOME2025-A1, use code128 ou qr.

Mantenha v não vazio. {{voucher}} em um elemento Push da Customer Journey já cobre isso — a jornada pula o envio quando o pool não tem mais cupons (consulte Motivos de drop-off). Se você mesmo colocar uma tag diferente na URL, defina um padrão para essa tag.

Motivos de drop-off

Erros possíveis durante o envio da mensagem:

No vouchers left in the pool	Todos os cupons no pool selecionado foram usados. Adicione mais cupons para continuar.
Voucher pool has expired	A data de validade do pool passou. Cupons deste pool não podem mais ser enviados.