Ниже представлено пошаговое руководство по установке 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. Создание кампании
- Добавьте оффер:
- Перейдите в Offers → Create Offer.
- Тип: Local URL (если оффер на вашем сервере) или Direct Link.
- Укажите URL оффера (например,
https://ваш-сервер.com/landing
). - Сохраните оффер.
- Создайте кампанию:
- Перейдите в Campaigns → Create Campaign.
- Тип кампании: Выберите «Direct Link».
- Название: Введите любое имя.
- Трафик: Укажите источник (например, «Test»).
- Geo: Выберите целевую страну.
- Оффер: Выберите созданный оффер.
- Сохраните кампанию.
3. Настройка постбека
- В Keitaro:
- Перейдите в Offers → выберите ваш оффер → вкладка Postbacks.
- Нажмите Create Postback.
- Укажите URL вашего обработчика постбека (например,
https://ваш-сервер.com/postback?click_id={click_id}&status={status}
). - Метод: GET или POST (зависит от вашего обработчика).
- Триггер: Выберите событие (например, «Conversion»).
- Сохраните постбек.
- На стороне оффера:
- Создайте скрипт-обработчик постбека (пример на 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. Тестирование
- Проверьте редирект:
- Скопируйте ссылку кампании из Keitaro (в разделе Campaigns → Campaign URL).
- Откройте ссылку в браузере — должен произойти редирект на ваш оффер.
- Проверьте постбек:
- Сымитируйте конверсию (например, заполните форму на оффере).
- Вручную отправьте POST/GET запрос на постбек:
bash curl "https://ваш-сервер.com/postback?click_id=123&status=approved"
- Убедитесь, что данные появились в логе или БД.
5. Дополнительные настройки
- Токен безопасности: Добавьте параметр
&token=SECRET_KEY
в URL постбека для защиты от фрода. - Макросы: Используйте подстановки Keitaro (например,
{sub_id}
для идентификатора подписки). - Фильтры: Настройте правила в разделе Flow для управления трафиком.
Возможные ошибки
- Постбек не срабатывает:
- Проверьте правильность URL.
- Убедитесь, что обработчик возвращает HTTP-код 200.
- Редирект не работает:
- Убедитесь, что оффер доступен по указанному URL.
- Проверьте настройки SSL (должен быть HTTPS).
Если возникнут проблемы, проверьте логи Keitaro:
tail -f /var/log/keitaro/nginx-error.log