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

Гайд по установке 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. Добавьте оффер:
  • Перейдите в OffersCreate Offer.
  • Тип: Local URL (если оффер на вашем сервере) или Direct Link.
  • Укажите URL оффера (например, https://ваш-сервер.com/landing).
  • Сохраните оффер.
  1. Создайте кампанию:
  • Перейдите в CampaignsCreate 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 (в разделе CampaignsCampaign 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

Оставить комментарий

Что будем искать? Например,Как настроить Postback?

Мы в социальных сетях