Реализация кастомного домена трекера Affilka

Входные данные: 2025-12-10-affilka-proxy (тз для аффилки)

Реализация

Для работы с Affilka используется базовый Cloudflare Worker. Он реализует логику проксирования запросов, содержит встроенное логирование и переиспользуется между различными продуктами.

Для каждого конкретного продукта создается отдельный экземпляр воркера с соответствующими настройками (пример конфигурации).

Конфигурация (wrangler.toml)

Основные параметры конфигурации:

account_id: ID аккаунта Cloudflare, в который будет развернут воркер.
name: Имя воркера в Cloudflare.
AFFILKA_DOMAIN: Базовый домен трекера Affilka, на который необходимо перенаправлять запросы.
PRODUCT: Идентификатор продукта, к которому относится трекер.
ADC_ENCODED: Ключ для записи данных в BigQuery.
BIGQUERY_DATASET_NAME: Имя датасета в BigQuery.
BIGQUERY_TABLE_NAME: Имя таблицы в BigQuery.

Диаграмма последовательности (Sequence Diagram)

Архитектурные особенности

Важно понимать, что данное решение является оберткой (wrapper) над оригинальным трекером Affilka. Это означает прямую зависимость: если оригинальный трекер Affilka недоступен, наш сервис также не будет работать.

Решаемые задачи

Наш трекер решает две основные проблемы (подробнее в оригинальном документе):

BYIP (Bring Your Own IP): Позволяет использовать трекер с нашими собственными IP-адресами, что улучшает доставляемость и контроль репутации.
Embedded Mode (Встраиваемый режим): Позволяет встраивать трекер непосредственно в структуру продукта (на том же домене). Пример: https://ganamax.mx/aff/s085cda74. Либо внутрь лендинга или к примеру редиректора (или к примеру возможность делать отложенной инициализации).
Analytics: у нас появляется дополнительный датасет с информацией обо всех кликах (ранее мы выгружали эту информацию из аффилки, в реализации с прокси мы можем напрямую собирать эту информацию на уровне прокси)

Минусы подхода

дополнительные задержки, при использовании трекера напрямую нет возникает задержки от враппера.