cloakingx@guard:~
man cloaking-x.integrations.keitaroIntegration Guide

Keitaro

A native Keitaro custom filter — no snippet to paste, no server proxy. Keitaro calls this filter directly for every click and routes it to whichever flow you attach the filter to.

Note
Decision-onlyThis integration is decision-only: it never fetches or proxies destination HTML. Keitaro still owns routing — sending traffic to your money-page flow or your safe/bot-page flow — once this filter answers whether a click is a bot.

1. Download the filter file

In your dashboard, go to Integration, select the stream you want to protect, choose the Keitaro tab, and click Download CloakingXFilter.php. Your Stream ID and API URL are baked into the file at download time — one file per stream.

2. Upload it to your Keitaro server's filters directory

The path depends on your Keitaro version:

Keitaro 11
/var/www/keitaro/var/filters
Previous versions
/var/www/keitaro/application/filters

This only needs to be done once per Keitaro server (or again after reinstalling the tracker).

3. Set up the campaign flow

  1. Create a separate flow for your safe/bot page in your Keitaro campaign, and put it above your money page flow.
  2. On that flow's Filters tab, add the "CloakingXFilter" filter and set it to "IS" mode.
  3. Direct traffic to your Keitaro campaign URL — done. All other visitors fall through to your money page flow.
Warning
The saved file name must stay CloakingXFilter.php — Keitaro matches the filter's class name to its file name, and this file's class is CloakingXFilter.
Note
If the Cloaking X API is ever unreachable, times out, or returns something unexpected, the filter fails open — it reports "not a bot" so a temporary outage never black-holes your campaign.