To get started using Cloakbro you will need to have the following ready:

• Hosting — Cloakbro works on all servers (VPS and Dedicated) and on most shared hosting providers (not recommended). We recommend lethost.co (use coupon "CloakBro" for 10% off).
• Domain — You will need a domain that is connected to your hosting. We recommended to always use Cloudflare with proxy mode on.
• White-Page — The page that blocked visitors see.
• Black-Page — The page that allowed visitors see.

Creating a flow can be done from the Flows page in your client area by clicking the Add Flow button in the top right corner.

Here's a detailed explanation of each of the settings.

Hover the Flow that you would like to edit on the Flows page and click on the edit icon () to edit the flow. There is no need to re-install the flow files after making changes.

Hover the Flow that you would like to download on the Flows page and click on the download icon () to download the manual installation files or click on the WordPress icon () to download the WordPress plugin.

After creating a flow you will receive a .zip file with your flow files. If you did not automatically receive them then you can easily download them again from the flows page by hovering your mouse over the flow and clicking the download icon.

Placing the files on your webserver.

Firstly rename the name of your whitepage (safepage) to index-2.html or index-2.php. Now extract the contents of the .zip (that you've downloaded earlier from your flow) and place them in the same directory as your whitepage.

IMPORTANT: Extra step for local blackpages.

If you selected the local blackpage method then you will need to rename the index file of your blackpage to bpage.html or bpage.php.

Example Webserver structure:

|--index.php // (Cloakbro's script)
|--index-2.php // (Your whitepage/safepage - visitors that didn't pass the test will be redirected here)
|--bpage.php // (Your Local blackpage - visitors that did pass the test will be redirected here)
|--assets/
|--|--track.php // (Cloakbro's script)
                                      

We assume that at this point you already have your WordPress installed and running. Now let's add CloakBro to your WordPress website.

• Find your page 'slug' — The slug is the last part of the url you can find this slug easily by going in to your WordPress Dashboard > Pages > Edit Page > URL.
  For example if the url is https://cloakbro.com/my-slug then 'my-slug' is the slug we need.
  
• Download Plugin ZIP — Go to Flows, hover your mouse over the flow that you want to use and click on the icon.
  
  
• Now enter the slug that we got from the first step and click on Download and we will receive the WordPress plugin that we have to install next.
  
  
• Installing the Plugin — To install the plugin simply upload it to your WordPress website.
  Plugins > Add New Plugin
  
  
• Next click on 'Upload Plugin'
  
  
• Next select and upload the plugin that you've downloaded earlier.
  
  
• Test Functionality — Once installed and activated, test if the page is functioning properly and if the clicks are coming through in the Cloakbro Dashboard. Once you've confirmed everything is fine you're ready to start driving traffic to your pages!

To add a local black page extract the contents of the WordPress .zip file that you've downloaded and add a folder called 'template'.

Next add your black page contents inside of this folder and rename your index file to 'bpage.php' or 'bpage.html'.

Now compress the contents back to .ZIP and upload this plugin to your Wordpress website. The plugin should install successfully and you will be all set to start running traffic!

Here are some of the most common errors and how you can solve them. Most errors are caused due to the use of a shared hosting plan with Namecheap or similair providers that have Firewalls.

It's not a good idea to use your Facebook (or any other) pixel directly from your black-page. The best way is to fire pixel events from your white-page domain, here's how:

In this example, I'm going to use two different domains:

• white-page.com is where the cloaker and white-page are installed.
• black-page.com is my black-page where real visitors get redirected to from our white-page. This is also where a purchase/conversion/lead happens.

We're going to add a file to white-page.com called pixel.php and put this code inside of it.

  <?php
  $px_id = $_GET['px_id']; // Variable to hold the Pixel ID
  $px_ev = $_GET['px_ev']; // Variable to hold the event that we want to fire
  ?>

  <img height="1" width="1" style="display:none" src="https://www.facebook.com/tr?id=<?php echo $px_id; ?>&ev=<?php echo $px_ev; ?>"/>

Great! Now all we need to do is add some code to our black-page.com site. Here are some examples:

Example: You want to fire a Page View event.
Simply add this code before the </body> tag of your website:

  function cloakBroPixelEvent(px_id, px_ev) {
      var iframe = document.createElement('iframe');
      iframe.src = 'https://white-page.com/pixel.php?px_id=' + px_id + '&px_ev=' + px_ev;
      iframe.style.display = 'none';
      iframe.referrerPolicy = 'no-referrer';
      document.body.appendChild(iframe);
  }

  // Usage
  var pixelId = '0101010101'; // Replace with your pixel ID
  cloakBroPixelEvent(pixelId, 'PageView'); // PageView is the name of the Pixel event; you can change this to any other

Example: You want to send a conversion event (Purchase, Lead, etc.).

  // Again, our function to fire the pixel
  function cloakBroPixelEvent(px_id, px_ev) {
      var iframe = document.createElement('iframe');
      iframe.src = 'https://white-page.com/pixel.php?px_id=' + px_id + '&px_ev=' + px_ev;
      iframe.style.display = 'none';
      iframe.referrerPolicy = 'no-referrer';
      document.body.appendChild(iframe);
  }

  // Find your function that completes the conversion, for example:
  function registerLead(name, email, phone) {
      fetch('https://your-server.com/register-lead', {
          method: 'POST',
          headers: {
              'Content-Type': 'application/json',
          },
          body: JSON.stringify({ name, email, phone }),
      })
      .then(response => response.json())
      .then(data => {
          var pixelId = '0101010101'; // Replace with your pixel ID
          cloakBroPixelEvent(pixelId, 'Lead'); // Lead is registered successfully, so we fire the Pixel event here
      })
      .catch(error => console.error('Lead registration failed', error));
  }

And that's it! Now our Pixel will receive data and learn from it.

To add CloakBro to Keitaro as an filter you will need to add the following script

Now place this file in the /var/www/keitaro/application/filters directory on your Keitaro server.

Create a new flow in your Keitaro campaign, choose the filter 'cloakbro' and enter your Flow Key.
You can find the Flow Key by hovering your Flow on the Flows page and clicking the copy () button.

If the filter was set to 'IS' the condition is equal to 'IS real visitor' and the opposite goes for 'IS NOT' then the condition is equal to 'IS NOT a real visitor'. Here is a example of how to use the 'IS' condition: