Unpack method: install the campaign on your hosting
The White Rabbit (TWR) Unpack method filters visits through a PHP file installed on your hosting, with no redirect. You enter the Safe Page and Offer Page URLs, download the file TWR generates, and install it on a site dedicated to it. That site's address is what goes in your ad.
Before you start
- A domain connected to TWR, which generates the campaign's PHP file. See how to connect your domain.
- Hosting that runs PHP, with a site to receive the campaign file.
- Your Safe Page and Offer Page published, each with its own URL. To build the Safe Page, see how to create and publish your Safe Page with AI.
The two Unpack domains
Domain | Role | What it needs |
|---|---|---|
Domain in TWR | Generates the PHP file. Never shows in the ad. | Subdomain and |
Hosting domain | Receives the | A site on your hosting that runs PHP |
Step by step
1. Open Campaigns and click New campaign
In the side menu, click Campaigns and then New campaign.
2. Name the campaign and choose the domain
In Campaign name, use any name you like. In Domain, select the domain connected to TWR. It's only used to generate the PHP file.
3. Choose the traffic source
In Traffic source, select the platform where you'll advertise. The available sources depend on your subscription plan. The setup is the same for all of them.
4. Select your ad's countries and devices
Select the countries and devices that match your ad targeting. If you advertise worldwide and on all devices, select them all.
5. Select the Unpack delivery method
In the Safe Page and Offer Page blocks, select Unpack under Delivery method. Unlike the other methods, Unpack doesn't generate a campaign URL: it generates a PHP file for you to install on your hosting. See TWR's delivery methods.
6. Enter the Safe Page URL
In the Safe Page block, under Safe Page URL or file, paste the URL of the page shown to unwanted visits, such as bots and spy tools. It must cover the same subject as your offer and follow the ad platforms' policies.
7. Enter the Offer Page URL
In the Offer Page block, keep Offer type on Single Offer and, under Offer Page URL or file, paste the URL of the page shown to qualified traffic. If you use a tracking tool, paste its redirect URL here. To split traffic across several Offer Pages, switch to A/B Storm: see how to A/B test offer pages.
The page opens on the ad address, with no redirect, the same way as with TWR Mirror. If it relies on features locked to its original address, such as a checkout, a video player, or a domain-restricted script, check the result in the step 12 test before launching your ad.
8. Turn on the Unique Token (optional)
Click Show advanced options, turn on the Unique Token, and confirm. It adds a random password to the campaign parameters, an extra layer of protection that needs no additional setup.
9. Save the campaign and download the PHP file
Click Save. TWR shows the campaign parameters, which go in your ad together with the site URL (step 11). Click Download PHP.
10. Upload the file as index.php to your hosting
On your hosting, open the file manager of the site that will receive the campaign and upload the PHP file to the public folder (usually public_html). This site holds only the campaign file.
index.php. If you downloaded it more than once and your computer added a number to the name, rename it.11. Add the URL and parameters to your ad
The ad URL is the address of the site where you installed index.php, always with https://. Paste it into your traffic source together with the parameters TWR generated:
- Most sources have one field for the destination URL and another for the URL parameters. Use each one in its own field.
- If the source has no field for parameters, append them to the URL with
?(e.g.https://www.yourdomain.com/?parameters). Both ways work, but prefer the dedicated field when there is one. - If you use your own tracking parameters, join them to TWR's with
&, no spaces and no second?.
12. Test the campaign
If you open the site URL directly in your browser, TWR treats it as a visit from outside the ad and shows the Safe Page. To see the Offer Page, open the campaign, click Test Offer, copy the test parameter, and add it to the URL after ?. The Offer Page opens on the same address, with no redirect.
When you're done, turn test mode off. It only enables the test parameter and doesn't affect the campaign, so you can test even with your ad running. More details in how to test if your campaign is set up correctly.
When to update the PHP file
Download the PHP again and replace index.php on your hosting when you:
- change the campaign domain;
- change the Safe Page URL in the campaign.
You don't need to update it when you:
- change the Offer Page URL or link an A/B test;
- edit the content of your pages without changing their URL.
Your ad parameters only change if you turn the Unique Token on or off. In that case, copy the new parameters and update them in your ad.
To run this same campaign in other ad accounts, see how to scale the same offer across multiple ad accounts.
Install the PHP alongside your pages (optional)
If you have access to the Safe Page or Offer Page files, you can install index.php in the same folder as them and enter the file path instead of the URL. With everything on the same hosting, this is the most compatible way to use Unpack. See Unpack method: install the PHP alongside your pages.
Updated on: 27/09/2026
Thank you!