Unpack Method: Install Your TWR Campaign on Your Hosting

The White Rabbit (TWR) Unpack method installs its filtering technology directly on your hosting through a PHP file, with no external redirect. This way, you freely define the URL used in your ad. Bots and competitor spy tools receive the safe page, while qualified traffic reaches the offer page.

Before you begin

• You need a domain registered and verified in TWR, with the CNAME record pointing a subdomain to the service. See the article How to Register a Domain in The White Rabbit if you haven't done this yet.
• You need access to the file manager of the hosting where your pages are located.

Step by step

1. Open the panel and create a new campaign

In the Campaigns module, click Create to add a new campaign.

2. Fill in the name and select the domain

Enter a name of your choice to identify the campaign and select the domain you registered in the tool.

3. Select the traffic source

Under Traffic Source, choose the source where you will advertise. The configuration process is similar for all sources.

4. Choose the Unpack method

Among the campaign's display methods, select Unpack. Unlike Redirect, Prepage, and Mirror — which generate a ready-to-use URL for your ad — Unpack generates a PHP file that you install on your hosting. That's why, in the next fields, you enter the file path instead of the pages' URL.

5. Locate your pages' files on the hosting

Open your hosting's file manager and go to your site's public folder. That's where your pages' files live and where you will install the script.

• The safe page is shown to unwanted visitors, such as bots and competitor spy tools.
• The offer page is shown to qualified traffic — the potential customers interested in what you advertise.

In this example, each page is organized in its own subfolder: safe/safe.html for the safe page and offer/offer.html for the offer page.

6. Enter the file paths in the panel

Unlike the other methods, with Unpack you don't enter the pages' full URL — you enter the file path relative to the script. The script (index.php) sits in your site's public folder, and the path tells it where to find each page from there.

The ./ at the beginning means "from the folder where the script is installed". What comes next is the path to the file:

In Safe Page, enter ./safe/safe.html. In Offer Page, enter ./offer/offer.html.

7. Set up countries and devices

Under countries and devices, select according to your ad's targeting. To advertise globally, select all of them. Tags are optional and only serve for organization.

8. Enable the Unique Token (supported sources)

Under Advanced Options, enable the Unique Token when the option is available for your traffic source. It generates a random password that goes along with the campaign's parameters, adding an extra layer of protection.

9. Save the campaign and download the PHP file

Click Save. TWR generates the campaign's PHP file and parameters. Download the file and copy the parameters into a plain text editor.

10. Install the file on your hosting as index.php

Upload the PHP file to your site's public folder — by dragging it into the file manager or using the upload button. Then rename the file to index.php.

11. Enter the URL and parameters in your ad

The ad URL is the address where you installed index.php — the same URL that loads this file in the browser. Always use it with https://. Combine it with the parameters generated by TWR according to your traffic source:

Updated on: 15/06/2026