> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.thewhiterabbit.app/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

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

O método Unpack do The White Rabbit (TWR) filtra os acessos por meio de um arquivo PHP instalado na sua hospedagem, sem redirecionamento. Você informa a URL da Safe Page e da Offer Page, baixa o arquivo gerado pelo TWR e instala em um site só para ele. O endereço desse site é o que vai no anúncio.

${youtube}[](iVPByUp8ADg)

## Antes de começar

- Um domínio conectado ao TWR, que gera o arquivo PHP da campanha. Veja [como conectar seu domínio](https://help.thewhiterabbit.app/pt-br/article/como-conectar-seu-dominio-ao-the-white-rabbit-f1e8hy/).
- Uma hospedagem que execute PHP, com um site para receber o arquivo da campanha.
- A Safe Page e a Offer Page publicadas, cada uma com a sua URL. Para montar a Safe Page, veja [como criar e publicar sua Safe Page com IA](https://help.thewhiterabbit.app/pt-br/article/como-criar-e-publicar-sua-safe-page-com-ia-gyzca3/).

## Os dois domínios do Unpack

| Domínio | Função | O que precisa |
| ---- |
| **Domínio no TWR** | Gera o arquivo PHP. Não aparece no anúncio. | Subdomínio e `CNAME` validados |
| **Domínio da hospedagem** | Recebe o `index.php`. É a URL do anúncio. | Um site na hospedagem que execute PHP |

||| Nunca use o mesmo domínio para as duas funções. Com cada um no seu papel, o domínio do anúncio fica sem nenhum vínculo com o TWR.

## Passo a passo

### 1. Abra Campanhas e clique em Nova campanha

No menu lateral, clique em **Campanhas** e depois em **Nova campanha**.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/01-nova-campanha_4gmvqs.gif)

### 2. Dê um nome à campanha e escolha o domínio

Em **Nome da campanha**, use a identificação que preferir. Em **Domínio**, selecione o domínio conectado ao TWR. Ele serve só para gerar o arquivo PHP.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/02-nome-dominio_7qwa9a.gif)

### 3. Escolha a fonte de tráfego

Em **Fonte de tráfego**, selecione a plataforma em que você vai anunciar. As fontes disponíveis variam conforme o [plano da sua assinatura](https://help.thewhiterabbit.app/pt-br/article/como-funcionam-nossos-planos-e-upgrades-7gl1a2/). A configuração é a mesma em todas elas.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/03-fonte-trafego_12otas4.gif)

### 4. Selecione os países e os dispositivos do anúncio

Marque os **países** e os **dispositivos** de acordo com a segmentação do seu anúncio. Se você anuncia para o mundo todo e para todos os dispositivos, selecione todos.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/04-paises-dispositivos_a68lo1.gif)

||| Só os países e dispositivos marcados podem chegar à Offer Page. O resto vai direto para a Safe Page.

### 5. Marque o método de entrega Unpack

Nos blocos **Safe Page** e **Offer Page**, marque **Unpack** em **Método de entrega**. Diferente dos outros métodos, o Unpack não gera uma URL de campanha: ele gera um arquivo PHP para você instalar na hospedagem. Veja [os métodos de entrega no TWR](https://help.thewhiterabbit.app/pt-br/article/entenda-os-metodos-de-entrega-no-twr-yvdds6/).

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/05-metodo-unpack_1iadmkw.gif)

### 6. Informe a URL da Safe Page

No bloco **Safe Page**, em **URL ou arquivo da Safe Page**, cole a URL da página exibida para os acessos indesejados, como bots e ferramentas de espionagem. Ela precisa tratar do mesmo assunto da sua oferta e seguir as políticas das plataformas de anúncio.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/06-safe-page_1rqr53i.gif)

### 7. Informe a URL da Offer Page

No bloco **Offer Page**, deixe o **Tipo de oferta** em **Single Offer** e, em **URL ou arquivo da Offer Page**, cole a URL da página exibida para o tráfego qualificado. Se você usa uma [ferramenta de tracking](https://help.thewhiterabbit.app/pt-br/article/como-integrar-o-the-white-rabbit-com-qualquer-ferramenta-de-tracking-oscvl7/), cole aqui a URL de redirecionamento dela. Para dividir o tráfego entre várias Offer Pages, troque para **A/B Storm**: veja [como fazer teste A/B de páginas de oferta](https://help.thewhiterabbit.app/pt-br/article/como-fazer-teste-ab-de-paginas-de-oferta-no-the-white-rabbit-10bgz8o/).

A página abre no endereço do anúncio, sem redirecionamento, do mesmo jeito que no TWR Mirror. Se ela usa recursos restritos ao endereço original, como checkout, player de vídeo ou script com restrição de domínio, confira o resultado no teste do passo 12 antes de subir o anúncio.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/07-offer-page_9himoi.gif)

|| As páginas informadas por URL não precisam de nenhuma configuração de DNS. O único domínio conectado ao TWR é o que gera o arquivo PHP.

### 8. Ative o Token único (opcional)

Clique em **Mostrar opções avançadas**, ative o **Token único** e confirme. Ele acrescenta uma senha aleatória aos parâmetros da campanha, uma camada extra de proteção que não exige nenhuma configuração a mais.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/08-token-unico_s17arq.gif)

|| Ao lado do Token único fica a **Spy URL**: uma página exibida só para quem tenta espionar a sua campanha. Basta informar a URL, sem configurar DNS. Ela ainda não está disponível em todas as fontes de tráfego. Veja [como monitorar quem espiona a sua campanha](https://help.thewhiterabbit.app/pt-br/article/como-monitorar-quem-espiona-a-sua-campanha-no-the-white-rabbit-spy-71s7fe/).

### 9. Salve a campanha e baixe o arquivo PHP

Clique em **Salvar**. O TWR mostra os **parâmetros** da campanha, que vão no anúncio junto com a URL do site (passo 11). Clique em **Baixar PHP**.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/09-salvar-baixar-php_1c1s3l5.gif)

### 10. Suba o arquivo como index.php na hospedagem

Na hospedagem, abra o gerenciador de arquivos do site que vai receber a campanha e faça o upload do arquivo PHP na pasta pública (em geral, `public_html`). Nesse site fica só o arquivo da campanha.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/10-subir-index-php_1i21brx.gif)

||| O arquivo precisa se chamar exatamente `index.php`. Se você baixou mais de uma vez e o computador acrescentou um número ao nome, renomeie.

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

A URL do anúncio é o **endereço do site onde você instalou o `index.php`**, sempre com `https://`. Cole na sua fonte de tráfego junto com os parâmetros gerados pelo TWR:

* A maioria das fontes tem um campo para a **URL de destino** e outro para os **parâmetros de URL**. Use cada um no seu campo.
* Se a fonte não tiver campo para os parâmetros, junte-os à URL com `?` (ex.: `https://www.seudominio.com/?parametros`). As duas formas funcionam, mas prefira o campo específico quando existir.
* Se você usa parâmetros próprios de tracking, junte-os aos do TWR com `&`, sem espaço e sem outro `?`.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/11-url-parametros_jvlw61.gif)

||| Use os parâmetros exatamente como foram gerados. Alterar qualquer caractere compromete a filtragem do TWR.

### 12. Teste a campanha

Acessando a URL do site direto no navegador, o TWR trata como acesso fora do anúncio e exibe a Safe Page. Para ver a Offer Page, abra a campanha, clique em **Testar Offer**, copie o parâmetro de teste e acrescente à URL depois de `?`. A Offer Page abre no mesmo endereço, sem redirecionamento.

![](https://storage.crisp.chat/users/helpdesk/website/-/4/d/7/d/4d7d7d2dfaedd800/12-testar-offer_aor5p6.gif)

Depois de conferir, desative o modo de teste. Ele só libera o parâmetro de teste e não afeta a campanha, então você pode testar até com o anúncio rodando. Mais detalhes em [como testar se a sua campanha está configurada corretamente](https://help.thewhiterabbit.app/pt-br/article/como-testar-se-a-sua-campanha-esta-configurada-corretamente-44l5fg/).

## Quando atualizar o arquivo PHP

Baixe o PHP de novo e substitua o `index.php` na hospedagem quando você:

* trocar o **domínio** da campanha;
* trocar a URL da **Safe Page** na campanha.

Não precisa atualizar quando você:

* trocar a URL da **Offer Page** ou vincular um teste A/B;
* editar o conteúdo das páginas, sem mudar a URL.

Os parâmetros do anúncio só mudam se você ativar ou desativar o **Token único**. Nesse caso, copie os parâmetros novos e atualize no anúncio.

Para rodar essa mesma campanha em outras contas de anúncio, veja [como escalar a mesma oferta em várias contas de anúncio](https://help.thewhiterabbit.app/pt-br/article/como-escalar-a-mesma-oferta-em-varias-contas-de-anuncio-wc1sxl/).

## Instale o PHP junto com as suas páginas (opcional)

Se você tem acesso aos arquivos da Safe Page ou da Offer Page, pode instalar o `index.php` na mesma pasta delas e informar o caminho do arquivo no lugar da URL. Com tudo na mesma hospedagem, essa é a forma mais compatível do Unpack. Veja [Método Unpack: instale o PHP junto com as suas páginas](https://help.thewhiterabbit.app/pt-br/article/metodo-unpack-instale-o-php-junto-com-as-suas-paginas-6fk9ov/).