Artigos sobre: CRIAÇÃO DE CAMPANHAS

Método Unpack: instale a campanha do TWR na sua hospedagem

O método Unpack do The White Rabbit (TWR) instala a tecnologia de filtragem dentro da sua própria hospedagem, por meio de um arquivo PHP, sem redirecionamento externo. Dois domínios entram em jogo: o que você cadastra no TWR, que gera o arquivo, e o da hospedagem, que guarda as páginas e vai na URL do anúncio. A recomendação é que sejam diferentes.

Antes de começar

Um domínio cadastrado e verificado no TWR, de preferência diferente do domínio da hospedagem. Veja a seção abaixo.
Acesso ao gerenciador de arquivos de uma hospedagem que execute PHP.

Os dois domínios do Unpack

No Unpack, o domínio cadastrado no TWR e o domínio que aparece no anúncio têm funções diferentes:

Domínio	Para que serve	Recomendação
Domínio no TWR	Gera o arquivo PHP da campanha. Não entra na URL do anúncio.	Cadastrado e verificado no TWR, com subdomínio e `CNAME`. Veja como cadastrar seu domínio
Domínio da hospedagem	Guarda a Safe Page, a Offer Page e o `index.php`. É a URL que vai no anúncio.	De preferência um domínio novo, sem histórico anterior

Nada impede usar o mesmo domínio nos dois papéis, mas separar é mais seguro: assim os registros de DNS da hospedagem ficam só com os apontamentos do próprio site, sem nenhum vínculo com o TWR.

Passo a passo

1. Crie a campanha e informe nome, domínio e fonte de tráfego

No menu Campanhas, clique em Nova campanha. Dê um nome de sua preferência para identificar a campanha, selecione o domínio cadastrado no TWR e escolha a fonte de tráfego onde você vai anunciar. O método Unpack está disponível para ADSkeeper, Axon, BigoAds, Facebook, Google, Kwai, MediaGo, MGID, Microsoft, NewsBreak, Outbrain, Reddit, Revcontent, Rumble, SmartNews, Snapchat, Taboola, Telegram, TikTok, Traffic-Factory e Upsell Funnel. As fontes que aparecem para você também dependem do plano da sua assinatura.

2. Configure os países e dispositivos

Selecione os países e dispositivos conforme a segmentação do seu anúncio. Para anunciar globalmente, deixe todos marcados.

Essa configuração define quem está autorizado a passar pelo filtro e poderá chegar à Offer Page. O que ficar de fora vai direto para a Safe Page, então mantenha sempre alinhado com a segmentação do anúncio.

3. Selecione o método Unpack

Entre os métodos de entrega da campanha, selecione Unpack. Diferente do TWR Redirect, do Pre Page e do TWR Mirror, que geram uma URL pronta para o anúncio, o Unpack gera um arquivo PHP que você instala na sua hospedagem. Por isso, nos campos da Safe Page e da Offer Page você informa o caminho dos arquivos, e não a URL das páginas.

4. Coloque os arquivos das páginas na mesma pasta

Suba os arquivos da Safe Page e da Offer Page para a pasta pública do seu site. Os dois ficam na mesma pasta, junto com o arquivo PHP da campanha. O nome de cada arquivo é livre e não fica visível para quem acessa o anúncio.

5. Informe o caminho da Safe Page e da Offer Page

O ./ significa "a partir da pasta onde o arquivo PHP está instalado". Com tudo na mesma pasta, basta informar o nome de cada página. Para rodar mais de uma Offer Page, veja como fazer teste A/B de páginas de oferta.

Campo	Caminho	O que o script entende
Safe Page	`./safe.html`	Use o arquivo `safe.html` da mesma pasta (a Safe Page)
Offer Page	`./offer.html`	Use o arquivo `offer.html` da mesma pasta (a Offer Page)

O caminho informado aqui precisa corresponder exatamente ao nome real do arquivo na hospedagem. Se não bater, o script não encontra a página.

6. Ative o Token único (opcional)

Ative o Token único quando a opção estiver disponível para a sua fonte de tráfego. Ele gera uma senha aleatória que entra junto com os parâmetros da campanha, adicionando uma camada extra de proteção. Não exige nenhuma configuração adicional, por isso a recomendação é ativar.

Ao ativar o Token único, use exatamente os parâmetros gerados nesta campanha, sem nenhuma alteração. Se forem modificados, a campanha não funciona.

7. Salve a campanha e baixe o arquivo PHP

Clique em Salvar campanha. O TWR gera o arquivo PHP da campanha e os parâmetros que você vai usar na fonte de tráfego. Baixe o arquivo e copie os parâmetros para um bloco de notas.

8. Suba o arquivo PHP para a hospedagem

Faça o upload do arquivo PHP na mesma pasta dos arquivos da Safe Page e da Offer Page. Você pode arrastar o arquivo para o gerenciador ou usar o botão de upload.

O arquivo precisa ter o nome exato index.php, então renomeie antes de continuar.

9. Insira a URL e os parâmetros no anúncio

A URL que vai no seu anúncio é o endereço do domínio da hospedagem onde você instalou o index.php, a mesma URL que carrega esse arquivo no navegador. Use sempre com https://.

Combine essa URL com os parâmetros gerados pelo TWR, conforme a sua fonte de tráfego:

Cenário	Como inserir
Fonte com campo separado para parâmetros	URL no campo de destino do anúncio + parâmetros no campo específico da ferramenta
Fonte sem campo separado para parâmetros	`URL?parâmetros`: adicione `?` após a URL e cole os parâmetros em seguida

Se você usa uma ferramenta de tracking, o rastreamento precisa ser feito por script instalado na Offer Page, e não por URL de redirecionamento: veja como usar o método Unpack com uma ferramenta de tracking.

Quando a fonte tiver um campo exclusivo para parâmetros, dê prioridade a ele.

10. Teste o redirecionamento da campanha

Ao acessar a URL do index.php diretamente pelo navegador, o TWR identifica um acesso fora do anúncio e exibe a Safe Page. Para conferir a Offer Page, use o botão Testar Offer: ele gera um parâmetro de teste que você adiciona à URL. Com esse parâmetro, você é redirecionado para a Offer Page definida na campanha. Desative o modo de teste ao terminar.

O teste não afeta a performance da campanha e pode ser feito mesmo com o anúncio ativo.

11. Acompanhe o gráfico de requisições e bots

No gráfico da campanha você vê, em tempo real, o total de requisições que chega e para onde cada uma vai: Offer Page ou Safe Page. Os bots que tentam acessar o funil são todos encaminhados para a Safe Page e contabilizados à parte, porque não são cobrados.

Se você editar depois os caminhos da Safe Page ou da Offer Page, o TWR gera um novo arquivo PHP, que você deve substituir na hospedagem. Os parâmetros da campanha permanecem sempre os mesmos.

Atualizado em: 07/08/2026

Este artigo foi útil?

Obrigado!