FAQ

This page collects short answers to the questions that come up most often when you install and work with the tracker. Each answer links to a page with steps and details.

Installation

What server do I need

A clean server with Ubuntu 24.04 (amd64), root access, at least 2 CPUs, 4 GB of RAM and 20 GB of free space. Ports 80 and 443 must be free and open to the internet. The full list is on the Server requirements and preparation page.

Can I install the tracker on a server that already hosts a website

No. The installer is designed for a first installation on a clean server: if a port is taken, it stops with the message “Port 80 is busy.” («Порт 80 занят.») or “Port 443 is busy.” («Порт 443 занят.») The messages are explained on the Installation errors and how to fix them page.

How many domains do I need

Two different ones: a panel domain, for example panel.example.com, and a tracking domain, for example track.example.com. Both have an A record pointing to the server IP. Domains for campaign links are added after installation — see Domains and DNS.

How do I start the installation

With two commands in the server terminal. The installer prepares the server and prints a link to the wizard; the domains and the owner are set in the browser — see Installation.

curl -fsSLo install.sh https://install.micator.com/install.sh
sudo bash install.sh

Where do I get the wizard access code

The installer prints a link with the code at the end of its run. The same link is saved on the server in the /opt/micator/setup-access.txt file, which only root can read. More in Access by IP and the access code.

Domains behind Cloudflare — how do I get through the wizard

For the duration of setup, turn on the “DNS only” mode for both domains. If you need proxying right away, choose the Full (strict) encryption mode and turn off the HTTP to HTTPS redirect until setup is complete. More in Cloudflare.

Can I run the installer again

Yes, with the same install.sh file. If the wizard has not been completed, the same link appears; if the tracker is already set up, the installer responds “The tracker is already set up. The wizard is closed.” («Трекер уже настроен. Повторный мастер закрыт.») and does not change any data — see Running the installer again.

License and payment

How much does a license cost

$119 per month for one installation. When you pay, you can choose 1, 3, 6 or 12 months. It is a one-time payment with no automatic charges. The license does not limit the number of clicks, domains or users — see How the license works.

Is there a trial

Yes, 14 days from the first successful activation of the key on the server. There is one trial license per account, it is issued after you confirm your email, and no payment card is required — see Trial.

What is closed in the trial

Only the spend extension: it works with a paid license. All other panel sections, traffic, conversion intake and outgoing postbacks work — see What is available in the trial.

How do I pay for a license

Payment goes through Heleket: choose the currency and network on the payment page. After the transfer is confirmed, the license is issued or renewed automatically; you do not need to enter a hash. Direct USDT invoices issued earlier keep their payment details. More in Renewal and orders.

What happens when the license expires

The panel and the API close for all users. Traffic keeps flowing, and clicks and incoming conversions are recorded. Outgoing postbacks and Facebook events wait in a queue and are sent automatically after renewal — see License expiry: what is closed and what keeps working.

Can I use one license on two servers

No. The first activation binds the license to the installation and the panel domain, and the key is rejected on another installation. Each installation needs its own license — see One license, one installation.

How do I move a license to another server

Unbind the previous server in your account: Licenses → Manage → Unbind server. Your account gives you a new key, which usually activates within 10 minutes. The license term does not change — see Transferring a license to another server.

Is there autolaunch

Autolaunch is coming later. You cannot buy a license with it yet — see Prices and renewal.

Working with traffic

How do I add a domain for campaign links

Point the domain's A record to the server IP, open Domains («Домены») and click + Domain («+ Домен»). The tracker issues the HTTPS certificate on its own the first time the domain is accessed. The owner and the admin add domains — see Domains.

Where does traffic that did not pass cloaking go

To the top enabled stream of the Final («Замыкающий») type that matches its filters, schedule and click cap. There is no separate “white” choice in the cloaking settings — see Where filtered traffic goes.

Filtered visitors get a 404

The campaign has no enabled final stream, or it does not match its filters, schedule or click cap. Add a stream with the + White («+ Белая») button on the Streams («Потоки») tab — see Cloaking streams: “white” and target.

Real visitors go to the “white”

Open the click in the click log and look at the Reasons («Причины») line. Common reasons: the link has no platform click ID, the country is not in the GEO («Гео») conditions of the target streams, or the visitor uses a VPN — see Cloaking FAQ.

How do I check a stream without sending traffic

Open the campaign and click Check stream («Проверить поток») on the Streams tab. The check applies the same filters, schedule and rotation as a real click, but does not record the click — see Stream selection check.

In what order does the tracker choose a stream

First intercepting streams, then regular ones, then final ones. Among intercepting and final streams, the top matching one is taken; a regular stream is chosen at random, in proportion to its weight — see Streams: types and processing order.

Are bots filtered out without cloaking

No. The click is marked in the statistics and goes through the streams like a regular one, unless the stream has the Bot («Бот») = false condition — see Protecting a stream without cloaking.

Can I upload a landing page to the tracker server

Yes, as a ZIP archive in the page editor. A hosted page opens on the same domain as the campaign link. The owner, the admin, the team lead and the designer can upload archives — see Hosted pages.

Conversions and postbacks

Where do I get the postback URL for an affiliate network

In the Networks («Сети») section, the Conversion postback URL («URL постбэка приёма конверсий») block, the Copy («Копировать») button. Paste the URL into the network settings and replace {click_id}, {status}, {payout} and {txid} with the network's macros — see Incoming postback.

How do I pass the subid to an affiliate network

Add the {subid} macro to the offer link, for example sub1={subid}. The network sets the parameter name and returns this value in the postback — see How the tracker receives conversions.

The conversion did not appear in the tracker

Open Logs → Postbacks («Логи → Postbacks») and find the request by the click subid. If there are no rows, the request did not reach the tracker or it has no click ID. Causes for each message are on the Postback not arriving: what to check page.

Two conversions were recorded for one click

A conversion is identified by the pair of the click subid and txid. A second row appears when the network sent a different txid: to change the status, the network must pass the previous one — see Transaction ID, duplicates and conversion corrections.

How do I send conversions to the traffic source

Paste the postback URL from the ad network account into the source card, in the S2S postback to source («S2S-постбэк в источник») block. Additional URLs are set in the campaign on the S2S postbacks («S2S-постбеки») tab — see S2S postback to the source and Campaign and source S2S postbacks.

The postback to the source was not sent

Open Logs → Event delivery («Логи → Доставка событий») and find the delivery by subid. In the Pending («Ожидает») state, the tracker will retry the delivery on its own; in the Needs review («Нужна проверка») state, automatic attempts are over — see Postback to the source was not sent.

How do I send events to Facebook

Check the Facebook Conversions API checkbox in the source card and fill in the Pixel ID and Access Token. The event is sent for conversions with the lead or sale status — see Facebook Conversions API.

Can I upload conversions from a file

Yes, from a CSV on the Settings → Conversion import («Настройки → Импорт конверсий») tab. The tracker checks all rows first; while the file has at least one error, nothing is recorded — see Conversion import from CSV.

Maintenance

How do I update the tracker

In the panel: Settings → Updates («Настройки → Обновления»), the Install… («Установить…») button. Only the installation owner can update. Before installing, the tracker creates a copy of the data on the server — see Updating the tracker from the panel.

Does traffic stop during an update

Yes. While copying and installation are in progress, campaign links and the postback URL respond with code 503: clicks and postbacks during this time are not recorded. How long the pause lasts depends on the amount of data — see Installing an update.

What happens if an update fails

The tracker restores the previous version and the data from the copy on its own. After the “Done” («Готово») stage, the previous version cannot be restored from the panel — see Automatic rollback.

Where are backups stored

On your storage server, which the tracker connects to over SSH/SFTP. Without a connected storage server, you cannot create a backup. You can connect up to 10 servers — see Backups: getting started.

Can I create a backup without stopping traffic

No. The snapshot is taken while click and postback intake is stopped, and requests during this time get a 503 response. The backup is uploaded to the storage server after the tracker is running again — see Traffic pause.

How do I move the tracker to another server

Create a backup, install the tracker on an empty server and choose Restore from a backup («Восстановить из резервной копии») in the wizard. Domains and the license are set again: the key is issued after the previous server is unbound — see Restoring on a new server.

How long are clicks and conversions stored

18 months; the period is fixed. CSV exports are stored for 24 hours, and the audit log until cleanup deletes the records — see Retention periods.

How do I know the tracker is working correctly

Click Admin panel («Админ-панель») in the top right corner and choose Status («Состояние»). The page shows the databases, background tasks, click intake and event delivery. The owner and the admin can see the section — see System status.