Articles on: CAMPAIGN CREATION

Unpack method: install the campaign on your hosting

The White Rabbit (TWR) Unpack method installs the filtering technology directly on your hosting through a PHP file, with no external redirect. You freely define the ad URL: you set the path to the safe page and the offer page, upload the file as index.php, test the redirect, and track requests in real time.

Before you start

Have a domain registered and verified in TWR. If you haven't done that yet, see the article How to register your domain in The White Rabbit.
Have access to the file manager of the hosting where your safe page and offer page files live.

Step by step

1. Create the campaign and set name, domain, and traffic source

In the Campaigns module, click Create. Give the campaign a name of your choice, select the domain registered in the tool, and pick the traffic source where you'll advertise. The available source depends on your subscription plan.

2. Set the countries and devices

Select the countries and devices according to your ad targeting. To advertise globally, leave them all checked.

This setting defines who is allowed to pass through the filter and reach the offer page. Always keep it aligned with your ad targeting.

3. Select the Unpack method

Among the campaign delivery methods, select Unpack. Unlike TWR Redirect, Pre Page, and TWR Mirror, which generate a ready-to-use ad URL, Unpack generates a PHP file that you install on your hosting. That's why, in the safe page and offer page fields, you enter the file path, not the page URL.

4. Set the path to the safe page and the offer page

The Unpack file (index.php) will sit in your site's public folder, in the same folder as the page files. The path tells the script where to find each page from there. The ./ at the start means "from the folder where the script is installed".

With the three files in the same folder, just enter each file's name:

Field	Path	What the script reads
Safe Page	`./safe.html`	Use the `safe.html` file in the same folder (the safe page)
Offer Page	`./offer.html`	Use the `offer.html` file in the same folder (the offer page)

The path you enter here must match the real location of the files on your hosting exactly. If it doesn't, the script won't find the page.

5. Enable the Unique Token (optional)

Enable the Unique Token when the option is available for your traffic source. It generates a random password that goes in with the campaign parameters, adding an extra layer of protection.

When you enable the Unique Token, use exactly the parameters generated in this campaign, with no changes. If they're modified, the campaign won't work.

6. Save the campaign and download the PHP file

Click Save. TWR generates the campaign's PHP file and the parameters you'll use in your traffic source. Download the file and copy the parameters to a notepad.

7. Upload the PHP file to your hosting

Upload the PHP file to your site's public folder, in the same folder as the safe page and offer page files. You can drag the file into the manager or use the upload button.

The file must be named exactly index.php. If it downloads with a different name, rename it to index.php before continuing.

8. Set the ad URL and parameters

The URL that goes in your ad is the address where you installed index.php, the same URL that loads that file in the browser. Always use it with https://.

Combine that URL with the parameters generated by TWR, according to your traffic source:

Scenario	How to enter it
Source with a separate field for parameters	URL in the ad's destination field + parameters in the tool's dedicated field
Source with no separate field for parameters	`URL?parameters`: add `?` after the URL and paste the parameters right after

When the source has a dedicated field for parameters, use it first. To include your tool's tracking parameters along with TWR's, add & after the TWR parameters and paste the extra ones in sequence, with no blank spaces.

9. Test the campaign redirect

When you open the index.php URL directly in the browser, TWR detects a suspicious access (outside the ad) and shows the safe page. To check the offer page, use the Test button: it generates a test parameter that you add to the URL. With that parameter, you're redirected to the offer page defined in the campaign. Turn off test mode when you're done.

10. Track the requests and bots chart

In the campaign chart you see, in real time, the total requests coming in and where each one goes: offer page or safe page. Bots that try to access the funnel are all sent to the safe page and counted separately, because they aren't billed.

If you later edit the paths to the safe page or the offer page, TWR generates a new PHP file that you must replace on your hosting. The campaign parameters always stay the same.

Updated on: 20/07/2026

Was this article helpful?

Thank you!