Гайд по установке Keitaro и настройке первой кампании с локальным оффером и постбеком.

Ниже представлено пошаговое руководство по установке Keitaro и настройке первой кампании с локальным оффером и постбеком.

1. Установка Keitaro

Требования:

• Сервер с ОС Ubuntu/Debian (рекомендуется 4+ ядра, 8+ ГБ RAM)
• Домен с SSL-сертификатом (можно использовать Let’s Encrypt)

Установка через скрипт:

# Скачать установочный скрипт
curl -sSL https://keitaro.io/install.sh > install.sh

# Запустить установку
sudo bash install.sh

• Следуйте инструкциям: укажите домен, email для SSL.
• После установки откройте адрес https://ваш-домен и завершите настройку администратора.

2. Создание кампании

1. Добавьте оффер:

• Перейдите в Offers → Create Offer.
• Тип: Local URL (если оффер на вашем сервере) или Direct Link.
• Укажите URL оффера (например, https://ваш-сервер.com/landing).
• Сохраните оффер.

1. Создайте кампанию:

• Перейдите в Campaigns → Create Campaign.
• Тип кампании: Выберите «Direct Link».
• Название: Введите любое имя.
• Трафик: Укажите источник (например, «Test»).
• Geo: Выберите целевую страну.
• Оффер: Выберите созданный оффер.
• Сохраните кампанию.

3. Настройка постбека

1. В Keitaro:

• Перейдите в Offers → выберите ваш оффер → вкладка Postbacks.
• Нажмите Create Postback.
• Укажите URL вашего обработчика постбека (например, https://ваш-сервер.com/postback?click_id={click_id}&status={status}).
• Метод: GET или POST (зависит от вашего обработчика).
• Триггер: Выберите событие (например, «Conversion»).
• Сохраните постбек.

1. На стороне оффера:

• Создайте скрипт-обработчик постбека (пример на PHP): <?php $click_id = $_GET['click_id']; $status = $_GET['status']; // например, "approved" или "rejected" // Запись данных в лог или БД file_put_contents('postback.log', "Click ID: $click_id, Status: $status\n", FILE_APPEND); ?>
• Убедитесь, что URL обработчика совпадает с указанным в Keitaro.

4. Тестирование

1. Проверьте редирект:

• Скопируйте ссылку кампании из Keitaro (в разделе Campaigns → Campaign URL).
• Откройте ссылку в браузере — должен произойти редирект на ваш оффер.

1. Проверьте постбек:

• Сымитируйте конверсию (например, заполните форму на оффере).
• Вручную отправьте POST/GET запрос на постбек:
  bash curl "https://ваш-сервер.com/postback?click_id=123&status=approved"
• Убедитесь, что данные появились в логе или БД.

5. Дополнительные настройки

• Токен безопасности: Добавьте параметр &token=SECRET_KEY в URL постбека для защиты от фрода.
• Макросы: Используйте подстановки Keitaro (например, {sub_id} для идентификатора подписки).
• Фильтры: Настройте правила в разделе Flow для управления трафиком.

Возможные ошибки

1. Постбек не срабатывает:

• Проверьте правильность URL.
• Убедитесь, что обработчик возвращает HTTP-код 200.

1. Редирект не работает:

• Убедитесь, что оффер доступен по указанному URL.
• Проверьте настройки SSL (должен быть HTTPS).

Если возникнут проблемы, проверьте логи Keitaro:

tail -f /var/log/keitaro/nginx-error.log