Blocklist registry (PL) and automatic domain replacement
Checking domains against a connected registry for Poland, blocklist marks and optional automatic replacement of the destination domain in PL streams.
The list of blocked domains is connected on the Settings → PL registry («Настройки → Реестр PL») tab. Automatic replacement requires spare domains in a separate group and a stream for Poland. Owners and admins can see this section.
What the PL registry is for
The section helps you notice that your domain has appeared in a connected blocklist for Poland and find the affected links in the tracker. In alert only («только алерт») mode, it marks domains and writes to the log. With automatic replacement on, it can switch the destination domain of a suitable stream to a prepared reserve domain.
The check works on the contents of the registry you specified. It does not check whether the site is reachable through every Polish ISP, and it does not guarantee that a spare domain is reachable. A domain missing from the list only means that it is not in the latest successfully received version of that list. Check DNS, HTTPS and site errors separately — see Domain check.
For example, the campaign link leads to track.example.com, and the stream for PL sends the visitor to go.example.com/promo. If go.example.com appears in the list and a free reserve domain exists, the tracker replaces it in the stream URL. If track.example.com itself ends up in the registry, this feature does not change the link in the ad and does not restore access to it automatically.
A two-domain scheme
Automatic replacement is designed for a pair of domains:
- The first is the campaign link domain. It is used in the ads, and the tracker does not change it: it only marks it and writes a warning to the system log.
- The second is the domain in the Destination URL («URL назначения») field of a stream with the Direct URL («Прямой URL») action. This is the one the tracker replaces.
The link in the ad account stays the same, and a visitor from Poland goes to the new domain.
Prepare a reserve group and stream
- Add spare domains in the Domains section.
- Create a domain group.
- Assign the spare domains to this group.
- Open the campaign and click + Stream («+ Поток») — see Managing streams.
- In the Action («Действие») field, choose Direct URL.
- Enter the link in the Destination URL field, for example
https://go.example.com/promo?cid={click_id}. - Go to the Filters («Фильтры») tab and click + Condition («+ Условие»).
- Leave the GEO («Гео») field and the in list («в списке») operator, and enter the value
PL— see Stream filters. - Click Save stream («Сохранить поток»).
If the stream has other conditions, leave AND («И») between them and GEO.
The domain in the Destination URL must be added to the Domains («Домены») section or be a subdomain of an added one. On replacement, the whole domain in the link changes to the reserve one, while the scheme, port, path, parameters and macros stay.
Do not choose spare domains in campaigns and do not put them in links of other streams: such domains are not taken for replacement.
Add a registry
For Poland, use the CERT Polska list. Copy the full file address into the List URL («Адрес списка») field:
https://hole.cert.pl/domains/v2/domains.txt- Open Settings → PL registry.
- Click + Registry («+ Реестр»). The “Poland domain registry (PL)” («Реестр доменов Польши (PL)») window opens.
- Paste the CERT Polska list address given above into the List URL field.
- Click Check («Проверить») next to the field.
- Look at the result: “Records parsed: N” («Разобрано записей: N»), the first records of the list and the line “Our domains in the registry (N): …” («Наши домены в реестре (N): …») or “None of our domains are in the registry” («Наших доменов в реестре нет»). The test check changes nothing.
- Choose a group in the Reserve domain group («Резервная группа доменов») field.
- Click Save («Сохранить»).
| Field | What to enter | Default |
|---|---|---|
| Name («Название») | Any registry name. If you leave it empty, the list shows the address | Empty |
| GEO | A two-letter country code | PL |
| List URL | A link to the list, starting with http:// or https://. The format is detected automatically: a list by line, a hosts file, JSON, XML, CSV. Size — up to 64 MiB | — |
| Reserve domain group | The group from which a replacement domain is taken. Next to the name — the number of domains in the group | “— not selected —” («— не выбрана —») |
| Check every, min («Проверять раз в, мин») | The check interval, at least 5 minutes | 30 |
| Check the registry («Проверять реестр») | Scheduled check. A disabled registry has the “off” («выключен») label | On |
| Replace the domain automatically («Менять домен автоматически») | If you turn it off, the tracker only marks domains and writes to the log. Such a registry has the “alert only” label | On |
To change a registry, click its name in the list. The ✕ button deletes the registry after the confirmation “Delete registry “…”?” («Удалить реестр «…»?»). The replacement log and the “in registry” («в реестре») marks set by the registry remain, and other registries do not remove these marks. So change settings in the registry window rather than creating the registry again.
For another country you need a separate compatible list and its own code in the GEO field.
Check
- Click Check in the registry's row.
- Wait for the message “PL registry: N records, checked” («Реестр PL: N записей, проверено»).
Under the registry address, a line like “every 30 min · records N · checked DD.MM, HH:MM” («каждые 30 мин · записей N · проверен ДД.ММ, ЧЧ:ММ») is updated. A manual check, like a scheduled one, marks domains and replaces them in streams. After that, an enabled registry is checked at the interval from the Check every, min field.
- The registry is matched against domains from the Domains section and domains from the Destination URL of streams with the Direct URL action.
- A registry record covers the domain and all its subdomains: the record
example.comalso applies togo.example.com. - Records written in national alphabets are not recognized — only in punycode (
xn--…). - While the license is not active, registries are not checked — see License expiry.
- If the list arrives empty or has shrunk sharply, the tracker does not remove the “in registry” mark from domains.
When a domain is replaced
A replacement in a stream happens if all of the following are true:
- the registry has Replace the domain automatically on and a reserve group selected;
- the stream action is Direct URL, and your domain from the Destination URL is found in the registry;
- the stream has a GEO condition with the in list or = operator and the registry's country;
- the campaign is not archived;
- the reserve group has a free domain.
A stream is not affected if it has no GEO condition, uses the not in list («не в списке»), ≠ or regex operator, or GEO is joined with another condition through OR («ИЛИ»). The tracker does not change offer and landing page links.
If the GEO condition lists other countries besides the registry's country, the domain changes for all traffic of the stream.
Which reserve domain is chosen
The tracker takes the reserve group's domains in the order they were added. It skips domains with the “in registry” mark, domains from the current list, domains selected in any campaign and domains already used in the Destination URL of streams. The DNS and HTTPS check status is not taken into account when choosing — it is visible in the Domains section, see Domain check.
One reserve domain is used per blocked domain, even if the blocked domain is used in several streams. Enabled streams of active campaigns are processed first.
Replacement log and rollback
The Replacement log («Журнал замен») block appears on the tab after the first replacement and shows the 20 latest records: “old domain → new domain”, GEO, stream and time. Earlier records are available through the API.
To return the previous domain:
- Click roll back («откатить») in the record's row.
- Confirm the question “Return domain … to stream “…”?” («Вернуть в поток «…» домен …?»).
The previous domain returns to the stream, its “in registry” mark is removed, and the record gets the “rolled back” («откачено») mark. If the domain is still in the list, the next check marks and replaces it again.
The previous domain returns to the stream only through a rollback. It does not come back on its own even when it disappears from the list: in that case the next check only removes its “in registry” mark. If you enter the previous domain in the Destination URL manually, the reserve domain stays when the stream is saved.
Where you can see that a domain is in the registry
- The Domains section, Status («Статус») column — the “in registry” mark. The hover tooltip shows the registry name and the date the domain first appeared there.
- The Stream settings («Настройки потока») window, under the Destination URL field — the note “Domain … is in the blocked registry … and was replaced automatically. Rollback — in Settings, replacement log.” («Домен … попал в реестр заблокированных … и заменён автоматически. Откат — в Настройках, журнал замен.»)
- Logs → System log («Логи → Системный лог») — messages about domains appearing in the registry, replacements and rollbacks, see System log. Warnings start with the
⚠sign.
Messages in the system log
| Message | What it means |
|---|---|
| “PL registry: N of our domain(s) in the list — …” («Реестр PL: в списке N наш(их) домен(ов) — …») | Domains were found in the list for the first time and marked |
| “Domain … got into the PL registry — in stream “…” (campaign “…”) replaced with …” («Домен … попал в реестр PL — в потоке «…» (кампания «…») заменён на …») | The replacement was done |
| “Campaign link domain … got into the PL registry — traffic from this GEO will not reach the campaign. Automatic replacement is not done: the link in the traffic source must be changed.” («Домен ссылки кампании … попал в реестр PL — трафик из этого гео до кампании не дойдёт. Замена автоматикой не делается: нужно менять ссылку в источнике трафика.») | The domain selected in the campaign is in the registry. The message repeats at every check while the domain is in the list |
| “Domain … in a PL GEO stream got into the registry, but it is not ours — automatic replacement is impossible (we do not have its pages). Change the link manually.” («Домен … в потоке под гео PL попал в реестр, но он не наш — автозамена невозможна (у нас нет его страниц). Смените ссылку вручную.») | The domain in the Destination URL is not added to the Domains section and is not a subdomain of an added domain |
| “Reserve domains exhausted: N stream(s) remained on blocked domains (…). Add domains to the reserve group.” («Резерв доменов исчерпан: N поток(ов) остались на заблокированных доменах (…). Добавьте домены в резервную группу.») | The free domains in the group have run out |
| “Replacement rollback: domain … returned to stream “…”” («Откат замены: в потоке «…» возвращён домен …») | A rollback from the log was done |
If the campaign link domain gets into the registry, traffic from the registry's country does not reach the campaign. Choose another domain in the campaign and replace the link in the traffic source.
If something went wrong
The message of the last check is shown as a red line under the registry. Errors of the Check, Save and roll back buttons are shown above the registry list; an error from the registry window is visible once the window is closed.
| Message | Cause and what to do |
|---|---|
| “an http(s) registry address is required” («нужен http(s)-адрес реестра») | The List URL field is empty or the address does not start with http:// or https:// |
| “the registry responded …” («реестр ответил …») | The list server returned an error instead of the list. After the word “responded” («ответил») comes the response code, for example “404 Not Found”. Check the list address |
| “… non-public address blocked …” («… заблокирован непубличный адрес …») | The list address points to a non-public IP address. The list is downloaded only from public addresses |
| “no domains found in the registry response — the source returned the wrong format or a stub” («в ответе реестра не найдено ни одного домена — источник отдал не тот формат или заглушку») | There is no domain list at the address. Marks and streams are not changed |
| “the snapshot shrank sharply (N instead of M) — accepted as incomplete: new blocks applied, removal skipped” («снимок резко уменьшился (N вместо M) — принят как неполный: новые блокировки применены, снятие пропущено») | The list is much shorter than at the last successful check. While it stays like this, “in registry” marks are not removed |
| “auto-replacement not done: no reserve domain group selected — nothing to replace with” («автозамена не выполнена: не выбрана резервная группа доменов — менять не на что») | No Reserve domain group is selected in the registry. The field is also reset after the selected group is deleted |
| “auto-replacement not done: the reserve group is empty — nothing to substitute” («автозамена не выполнена: резервная группа пуста — подменить нечем») | The group has no free domains. Add new domains to the reserve group |
| “reserve domain group not found” («резервная группа доменов не найдена») | The selected group no longer exists. Reload the page and choose another group |
| “too many requests, try again later” («слишком много запросов, попробуйте позже») | The Check button was clicked too often. Wait a minute |
A rollback is not done in two cases:
- “stream deleted — nothing to roll back” («поток удалён — откатывать нечего») — the stream no longer exists or its campaign is archived;
- “the stream already has another domain — no rollback needed” («в потоке уже другой домен — откат не нужен») — the link in the stream was changed after the replacement, manually or by a new automatic replacement.