TL;DR

Campanhas conectam paywalls ao seu app com segmentação inteligente. Configure no dashboard, apresente com uma linha de código.

Campanhas

Configure quando e para quem exibir seus paywalls usando campanhas inteligentes

O que são Campanhas?

Campanhas conectam seus paywalls aos placements do app e definem regras de quem deve ver cada paywall. Com campanhas você pode:

Mostrar paywalls diferentes para usuários iOS vs Android
Fazer testes A/B comparando múltiplos designs de paywall
Segmentar por país, versão do app, ou propriedades customizadas
Controlar quando a campanha fica ativa (datas de início e fim)

Como Funcionam

Fluxo de uma campanha

App chama presentCampaign()

O SDK envia o placement para o servidor (ex: "onboarding")

Servidor busca campanhas ativas

Todas as campanhas ativas para aquele placement são avaliadas

Regras de segmentação aplicadas

Verifica se o usuário match com os filtros (plataforma, país, etc)

Paywall retornado ao SDK

O SDK renderiza o paywall na tela do usuário

Se múltiplas campanhas match para o mesmo placement, o servidor escolhe uma baseado na prioridade configurada ou de forma aleatória (útil para testes A/B).

Exemplo Rápido

Criando uma campanha no dashboard

Acesse Campanhas no menu lateral
Clique em Nova Campanha
Configure:
- Nome: "Onboarding iOS Premium"
- Placement: "onboarding"
- Paywall: Selecione o paywall criado
- Plataforma: Apenas iOS
- Status: Ativa
Salve a campanha
No app, chame Paywallo.presentCampaign('onboarding')

Opções de Segmentação

Filtros disponíveis

Configure quais usuários verão o paywall desta campanha

Filtro	Opções	Exemplo de Uso
`Plataforma`	iOS, Android, Todas	Preços diferentes por plataforma
`Países`	Lista de códigos ISO	Paywall em português para BR
`Versão do App`	Comparação semântica	Apenas para v2.0.0+
`Propriedades Custom`	Chave-operador-valor	isPremium = false
`Datas`	Início e fim	Promoção de Black Friday

Testes A/B

Como fazer teste A/B de paywalls

Para comparar diferentes designs de paywall, crie múltiplas campanhas para o mesmo placement:

Crie 2 ou mais paywalls com designs diferentes
Crie uma campanha para cada paywall:
- Campanha A: Paywall com trial de 7 dias
- Campanha B: Paywall com desconto de 30%
Configure ambas com o mesmo placement (ex: "onboarding")
Deixe ambas ativas com mesma prioridade
O servidor distribuirá o tráfego de forma aleatória (50/50 por padrão) entre as variantes
Acompanhe as métricas em Analytics para ver qual converteu melhor

Use Métricas Customizadas para criar análises avançadas comparando taxa de conversão entre diferentes campanhas.

Gerenciando no Código

Apresentando Campanhas no Código

Use presentCampaign() para exibir uma campanha por placement:

import { Paywallo } from '@virex-tech/paywallo-sdk'; // Apresentar campanha por placement const result = await Paywallo.presentCampaign('onboarding'); if (result.purchased) { console.log('Campaign:', result.campaignId, 'Variant:', result.variantKey); }

O servidor decide qual paywall mostrar baseado nas campanhas ativas. Isso significa que você pode:

Trocar paywalls sem atualizar o app
Fazer testes A/B sem código adicional
Criar promoções sazonais que ligam/desligam automaticamente
Segmentar por região sem lógica condicional no código

presentCampaign vs presentPaywall

presentCampaign(placement) - Usa o sistema de campanhas para decidir qual paywall exibir
presentPaywall(paywallId) - Exibe um paywall específico diretamente pelo ID

CampaignResult

Objeto de Retorno

O método presentCampaign() retorna uma Promise com este objeto (estende PaywallResult):

Propriedade	Tipo	Descrição
`presented`	boolean	true se o paywall foi exibido
`purchased`	boolean	true se o usuário completou uma compra
`cancelled`	boolean	true se o usuário fechou sem comprar
`restored`	boolean	true se o usuário restaurou compras anteriores
`productId`	string?	ID do produto comprado (se purchased = true)
`campaignId`	string?	ID da campanha que foi exibida
`variantKey`	string?	Identificador da variante (útil para testes A/B)
`error`	Error?	Erro (se houver falha)

Dicas de Boas Práticas

•Use nomes descritivos para campanhas: "Black Friday iOS" é melhor que "Campanha 3"
•Configure datas de fim para campanhas promocionais para evitar esquecer de desativá-las
•Ao fazer testes A/B, espere dados estatisticamente significantes antes de decidir o vencedor
•Sempre tenha uma campanha "padrão" ativa sem filtros como fallback para garantir que todos os usuários vejam algo