To configure filtering on a virtual server or shared hosting, you need:
- VDS/VPS virtual server or shared hosting.
- Domains (for JavaScript integration, you can use domains of site builder platforms like Tilda, Blogspot, Wix and others).
- Safe pages (websites) for bots and moderators (white page).
¶ Virtual Server
¶ Optimal Configuration
Since JS Fingerprinting is mandatory for cloaking in Google Ads and Bing Ads, we recommend using a VPS with at least 2 CPU cores, 2 GB of RAM, and an NVMe or SSD drive. This helps minimize the time required to redirect visitors to the black page.
We recommend choosing a server location as close as possible to your target audience. Less powerful servers and shared hosting can also be used, but this may increase redirect time and result in higher traffic loss.
¶ Acceptable Configuration
For cloaking in Facebook, TikTok, and native advertising networks, enabling JS Fingerprinting for flows is not recommended, as it may lead to the loss of a significant share of traffic. Shared hosting can be used in these cases. However, allocating fewer server resources may increase redirect time to the black page during sudden traffic spikes.
¶ Requirements
To set up filtering on a VPS or shared hosting, the server must meet the following requirements:
- PHP 7.3 - 8.5
- The cURL library and the php-curl extension
- A valid SSL certificate, with the white page accessible via HTTPS
- The OpenSSL PHP extension, which is installed by default in most VPS control panel setups
To prevent integration issues:
- Add the integration files to the exclusion list of your antivirus software and other automated scanning systems if they mistakenly block, modify, or delete these files
- Disable automatic PHP updates or lock the PHP version to the supported range
We do not recommend hosting white pages on the servers of the following hosting providers: Namecheap, Aeza, AlexHost, Beget, SiteGround
¶ Domains
Any domain registrars are acceptable. Here are some of them:
¶ White Page
A white page is a website that does not contain content prohibited by advertising networks. It is scanned by bots and reviewed by advertising network moderators. The integration script for our service is placed in the root directory of this website.
The white page must include basic HTML5 markup with opening <body> and closing </body> tags.
We recommend using lightweight white pages optimized for fast loading. Avoid heavy images, videos, animations, and an excessive number of scripts or tracking tags. This reduces the time required to redirect users to the black page and helps minimize traffic loss, especially when JS Fingerprinting is enabled.
You can check your white page’s loading speed and file sizes using your browser’s developer tools:
- Firefox: right-click the page → Inspect → Network → refresh the page (F5).
- Chrome: right-click the page → Inspect → Network → refresh the page (F5).
Our test white page is available at https://white.hoax.tech. It runs on a VPS with 1 CPU core, 1 GB of RAM, and an NVMe drive.
The black page can be accessed using a regular browser, residential proxies, or a home IP address.
You can review our recommendations for creating white pages here.