Черновик 0.1 · для обсуждения

Структура файла Affiliate.txt

Спецификация намеренно короткая. Её можно прочитать глазами, создать без специального ПО и автоматически проверить.

Где искать файл

Основной адрес — https://example.org/.well-known/affiliate.txt. Размещение на домене рекламодателя подтверждает источник правил и не зависит от кабинета конкретной CPA-сети.

Сервер должен отдавать текст в UTF-8 с кодом 200. Редирект на канонический домен допустим, но цепочка должна быть короткой и публично доступной.

Формат

Черновик использует простой формат «ключ: значение» и именованные секции в квадратных скобках. Комментарии начинаются с символа #.

Минимальный файл
version: 0.1
program: Example Store
website: https://example.org
contact: [email protected]
updated: 2026-09-17

[offer default]
status: active
landing: https://example.org
allowed: content
forbidden: cookie-stuffing

Порядок полей не важен. Неизвестные поля должны игнорироваться, чтобы формат можно было расширять без поломки старых интеграций.

Основные поля

ПолеОбязательноеНазначение
versionДаВерсия синтаксиса, по которой читается файл.
programДаПубличное название партнёрской программы.
websiteДаКанонический домен рекламодателя.
contactДаРабочий адрес команды, которая отвечает за программу.
updatedДаДата последнего содержательного изменения в ISO-формате.
policyНетСсылка на полные юридические условия программы.
disputesНетКонтакт или URL процедуры оспаривания.

Офферы

Каждый оффер — отдельная секция [offer идентификатор]. Идентификатор стабилен и не должен меняться при обычном обновлении условий.

ПолеПримерСмысл
statusactive / paused / closedМожно ли сейчас направлять новый трафик.
landingURLОсновная посадочная страница.
payout7% confirmed orderКороткое публичное описание вознаграждения.
cookie30dОкно атрибуции.
allowedcontent, cashbackРазрешённые типы продвижения.
forbiddenbrand-biddingЯвно запрещённые способы продвижения.
assetsURLАктуальные баннеры, фиды или описание API.

Изменения и споры

Критичное изменение — новый запрет, изменение атрибуции, ставки или статуса — должно сопровождаться новой датой updated. Рекомендуется хранить предыдущие версии и публиковать ссылку changelog.

Запись о нарушении имеет смысл только вместе с источником правила, версией файла, временем события и процедурой ответа. Стандарт не определяет виновность и не заменяет проверку доказательств.

Безопасность данных

В файл не должны попадать персональные телефоны, приватные ключи, токены, закрытые ставки, списки клиентов и другие данные, не предназначенные для публичного доступа.

Статус документа

Это первая гипотеза формата, а не финальная спецификация. Названия полей и синтаксис будут меняться после проверки на реальных офферах.

Проверить на практике

Проверьте формат на своём примере

Найдите ситуацию, которую формат описывает неоднозначно или не описывает совсем.

Открыть примеры