# Частые вопросы (FAQ)
- Общие вопросы
- Для чего нужен трекер
- Как установить Keitaro?
- Какие ограничения у пробной версии?
- После апгрейда лицензии новый функционал недоступен
- Какие требования серверу?
- Как подписать акты через diadoc.ru?
- Что значат ошибки в логе?
- Что произойдет, когда закончится срок лицензии?
- Можно ли устанавливать несколько Keitaro с одной лицензий?
- Можно ли менять IP в лицензии?
- Срок лицензии в Keitaro не изменился после продления
- Какие есть методы оплаты?
- Как оплатить безналичным расчетом юридическому лицу?
- Эксплуатация Keitaro
- Как добавить домены к Keitaro?
- Как перенести Keitaro на другой сервер без потери данных?
- Почему поток не срабатывает или клик уходит не в тот поток?
- Как найти причину потерь трафика?
- Как восстановить пароль к Keitaro?
- Как сменить ключ в Keitaro?
- Почему отличаются показания счетчиков LiveInternet/Метрика/GoogleAnalytics и Keitaro
- Почему отличаются показатели в Facebook и Keitaro?
- Как ограничить доступ к админке по IP?
- Как освободить место на сервере?
- Как очистить инноды на сервере?
- Как посмотреть историю посещений админки?
- Почему VPS стал работать очень медленно?
- Сколько хранится и где редактируется срок хранения лога полученных постбеков?
- Какие изменения можно вносить в конфигурацию сервера
- Можно ли использовать master-slave репликацию базы данных?
- Как открыть порт на сервере?
# Общие вопросы
# Для чего нужен трекер
Трекер помогает собрать в одном месте статистику по всем источникам трафика и из всех партнерских сетей. В каждой рекламной сети или партнерке есть своя статистика, однако для того, чтобы видеть полную картину по запущенной кампании, нужно или перемещаться между вкладками браузера, или выгружать всю статистику в один файл. Трекер собирает всю статистику за вас.
Кроме того, Keitaro позволяет анализировать показатели и строить отчеты по различным метрикам, что помогает выявить профитные связки и отказаться от убыточных площадок.
Дополнительная функция нашего трекера – распределение трафика на разные целевые страницы с помощью большого количества фильтров: геолокация, мобильный оператор, браузер, устройство, включение потоков и лендингов в них по определенному расписанию, и многое другое.
# Как установить Keitaro?
Читайте на странице.
# Какие ограничения у пробной версии?
- 2 кампании
- 2 потока в каждой кампании
- 1 фильтр в потоке
# После апгрейда лицензии новый функционал недоступен
Лицензию можно принудительно обновить, нажав "Обновить лицензию" в верхнем правом меню админки Keitaro "admin > Обновить лицензию".
# Какие требования серверу?
Читайте на странице.
# Как подписать акты через diadoc.ru?
Подготовьте акты и через diadoc.ru отправьте на подписание контрагенту ИНН 183104973204.
# Что значат ошибки в логе?
Читайте расшифровки на странице устранение неисправностей.
# Что произойдет, когда закончится срок лицензии?
Работа Keitaro будет полностью остановлена, редиректы и обработка трафика не будет работать.
# Можно ли устанавливать несколько Keitaro с одной лицензий?
Только при условии использования одного IP-адреса.
# Можно ли менять IP в лицензии?
Вы можете изменить IP в личном кабинете на нашем сайте.
# Срок лицензии в Keitaro не изменился после продления
- Проверьте ключ вашей лицензии и тот, что прописан в файле
/var/license/key.lic
. - Удалите файл
/var/license/hash.lic
.
# Какие есть методы оплаты?
- Банковские карты, Apple Pay, Google Pay.
Мы принимаем все карты международных платежных систем - Visa, MasterCard, AmericanExpress. Чтобы оплатить Apple Pay - используйте браузер Safari на своем устройстве. Для оплаты Google Pay используйте Chrome. Если во время оплаты добавляется дополнительный налог VAT, а вы не явлеетесь налогоплательщиком Евросоюза, отключите все vpn и прокси, зайдите в личный кабинет со своего гео и создайте новый счет на оплату.
- Яндекс.Деньги
Доступны для оплаты, если в личном кабинете у нас на сайте выбран русский язык в настройках аккаунта.
- WMR
Возможна оплата WMZ, конвертация будет производиться внутри вашего WebMoney keeper'а.
- Безналичная оплата для юридических лиц
Подробную инструкцию по оплате читайте здесь.
- Оплата со счета
Кнопка "Оплатить со счета" появляется в момент выбора способа оплаты, если на вашем реферальном счету достаточно баланса, чтобы оплатить ту лицензию, которую вы сейчас заказали.
# Как оплатить безналичным расчетом юридическому лицу?
Процедура следующая:
- Регистрируетесь на сайте
- Выбирайте "Купить лицензию"
- Выбираете срок 1 год (оригиналы предоставляем при оплате на год)
- На странице выбора способа платежа, выбираете "Распечатать счет"
- Вместо со счетом будет инструкция по получению актов
- Распечатываете акт в 2х экземплярам, подписываете оба и отправляете по указанному адресу
- После получения мы подписываем оригиналы документов и отправляем их на обратный адрес.
Договор у нас в виде оферты. Вы принимаете его условия, зарегистрировавшись на сайте.
# Эксплуатация Keitaro
# Как добавить домены к Keitaro?
Приобретите профессиональную редакцию
Пропишите в DNS у регистратора "A"-запись:
@ A x.x.x.x
Где "x.x.x.x" это IP вашего сервера.
Читайте подробнее по функционалу на странице Домены.
# Как перенести Keitaro на другой сервер без потери данных?
Читайте нашу статью про перенос трекера.
# Почему поток не срабатывает или клик уходит не в тот поток?
- Зайдите на страницу "Обслуживание > Логи > Трафик".
- Включите логирование.
- Сделайте переход или подождите попадания клика, который попал не в тот потока.
- Посмотрите в лог трафика. Там вы увидите, как отработали фильтры потоков.
Также посмотрите функцию в меню "Дополнительно > Симуляция трафика". Там вы сможете сымитировать попадание любого пользователя в кампанию.
# Как найти причину потерь трафика?
- Сравнивайте количество "сырых" кликов (хитов), а не уникальных. У Keitaro свои алгоритмы определения уникальности.
- Сверяйте показатели в одной временной зоне с партнеркой.
- Проверьте, что у домена рабочий SSL-сертификат.
- (Только для трекеров, установленных через терминал) Зайдите в через меню Обслуживание > Состояние. Посмотрите строку
max children reached
. Если там значение больше 10, напишите нам в поддержку, чтобы мы помогли настроить PHP-FPM. - Если вы используете хостинг или сервер с ISPamanger, то могут влиять лимиты, которые накладываются этими системами. Используйте наше решение для серверов.
- Проверьте работу ваших скриптов в AdBlock.
- При ботовом трафике, много ботов может застрять на редиректах как "мета-редирект", "двойной мета-редирект". Keitaro их может не выявлять как ботов, но некоторые боты просто не умеют проходить через такие редиректы. Проверяется легко. Сделайте редирект в другую кампанию и посмотрите на разницу "отправлено - получено". Если получено меньше, то вероятнее всего отвалились боты.
- Пройдите по всем потокам сами. Проверьте, что они все рабочие.
- Проверьте системный лог на наличие ошибок. Он доступен через меню "Обслуживание > Логи".
- Если вы используете CloudFlare, переключите настройки Firewall на
essentially off
. Отключите компрессию. - Проверьте ваш домен через сервисы Host Tracker, Urlvoid и Virustotal.
- Если Keitaro подключен через Script или Iframe, потеря трафика возможна от посещений страниц ботами или браузерами с повышенными настройками безопасности.
- Найдите или запросите в саппорте хостера лог-файл
access.log
отnginx
, где содержится список запросов к серверу. Посмотрите наличие ошибок 500 и 502. Пример такой записи:84.154.60.91 - - [16/Nov/2017:03:36:01 +0200] "GET /cmp HTTP/1.1" 502 1243 "http://test.com
. 502 говорит о том, что сервер не справляется, 500 о каких-то сбоях в работе трекера (смотрите Обслуживание > Логи). - Если на сервере стоит ISPManager или Vesta, то могут сказываться недостаточная настройка сервера. Обратите внимание, что мы помогаем лишь с серверами, которые настроены нашим скриптом автоустановки.
# Как восстановить пароль к Keitaro?
Читайте на странице Сброс пароля.
# Как сменить ключ в Keitaro?
Пропишите новый ключ в /var/license/key.lic
и удалите файл /var/license/hash.lic
.
# Почему отличаются показания счетчиков LiveInternet/Метрика/GoogleAnalytics и Keitaro
- Сравнивайте хиты, уники считаются у каждой системы по своему. В настройках кампании можете переключить уникальность на "IP" вместо "IP+UA".
- Трафик может быть ботовый. Keitaro посчитает бота, браузерные счетчики нет.
- Счетчики блокируются Adblock'ом и другими расширениями.
# Почему отличаются показатели в Facebook и Keitaro?
Возможные причины:
- Вашу рекламу дергают сервисы типа AdMobiSpy;
- Смотрите статистику за разные временные периоды или в разных временных зонах;
- Facebook не считает повторные клики (смотрите показатель уников);
- Не отключено игнорирование preferch (отключается на странице Обслуживание > Настройки);
- Используете старую библиотеку
klick_client.php
или плагин интеграции WP;
# Как ограничить доступ к админке по IP?
Нужно внести правки в файл admin.inc, который находится в /etc/nginx/conf.d/local/keitaro/admin.inc При подключении к серверу через терминал, используйте команду
echo 'allow 1.2.3.4; deny all;' > /etc/nginx/conf.d/local/keitaro/admin.inc
Где "1.2.3.4" - ip, с которого можно будет зайти в админку.
# Как освободить место на сервере?
Выставите в настройках, во вкладке Статистика ограничение на количество дней хранения статистики.
Выполните в терминали чистку дампов Redis'а (это удалит еще необработанную статистику):
rm -r /var/lib/redis/*
- Если вы делали апгрейд с 7й версии, можно удалить старые таблицы через терминал:
export DB_NAME='keitaro'
export DB_USER='root'
mysql -u $DB_USER -e 'show tables' $DB_NAME | grep -e 'keitaro_archive\|keitaro_index' | xargs -I "@@" mysql -u $DB_USER -e "TRUNCATE table \`@@\`" $DB_NAME
- Можете очистить статистику до определенной даты, но если кликов было много в базе, процесс может занять длительное время.
export DB_NAME='keitaro'
export DB_USER='root'
mysql -u $DB_USER -e 'DELETE FROM keitaro_clicks WHERE datetime < "2018-01-01" ' $DB_NAME
- Эти команды помогут оптимизировать имеющиеся клики и освободить дополнительное место. Внимание! Эти запросы заблокируют базу на время выполнения и требуют наличие дополнительного свободного места.
cd /var/www/keitaro && sudo -u keitaro php bin/cli.php system:optimize_db
- С помощью этих команд можно очистить полностью всю текущую статистику:
export DB_NAME='keitaro'
export DB_USER='root'
mysql -u $DB_USER -e 'truncate keitaro_ip_sessions' $DB_NAME
mysql -u $DB_USER -e 'truncate keitaro_clicks' $DB_NAME
mysql -u $DB_USER -e 'truncate keitaro_visitors' $DB_NAME
- С помощью следующей команды можно удалить статистику и освободить место на диске:
cd /var/www/keitaro && sudo -u keitaro php bin/cli.php system:delete_all_stats
Удаляет статистику и очищает места на диске.
После запуска команды вы получите предупреждение о том, что произойдет и какая информация очистится:
[WARNING] Important! The following will happen:
- old versions tables removal,
- clicks stats to the exact date removal (if specified in parameters),
- optimization of the clicks in the stats,
- cleaning all the current stats completely (if specified in parameters).
These inquiries will block the database
during the implementation and require additional free space on a disk.
Далее подтвердите выполнение команды yes/no
.
Будет произведена очистка статистики.
# Как очистить инноды на сервере?
Если Ваш трекер стал не корректно работать или появилось сообщение о том, что заканчивается свободное место на SSD (при этом проверка свободного места на сервере через df -h показывает что места достаточно для работы трекера) - в таком случае у Вас может заканчивается общее колличество иннод. Иноды (inodes) - это файловые дескрипторы в Linux, которые отвечают за метаинформацию о стандартных файлах, директориях или других объектах файловой системы, кроме непосредственно данных и имени. Иногда число файловых дескрипторов близиться к нулю - это значит что в ОС недостаточно описаний для определения местонахождения этих файлов. В таком случае - эти файлы должны быть удалены или очищенны. Для поиска, Вам необходимо выполнить:
df -i
В результате Вы получите структуру Вашей файловой системы со списком и колличеством иннодов которые занимает та или инная папка. Соответственно Вам нужно идти по пути этой папки, и при каждом вхождении проверять колличество иннодов командой df -i В конечном итоге Вы найдете папку с файлами которую нужно будет удалить командой
rm -rf deletedfolder/
Где deletedfolder/ имя папки которую необходимо будет удалить. ВНИМАНИЕ Обязательно сверьтесь с папкой которую собираетесь удалить - Ваша цель удалить папку на сервере с переполненным колличеством файловых дескрипторов, но не системные файлы сервера и её ОС. Если Вы не уверены в своих действиях - лучше напишите в нашу техническую поддержку и мы поможем Вам очистить innode. В противном случае, Вы рискуете привести ОС сервера в неработоспособное состояние, восстановление которого - не входит в нашу техническую поддержку. Пожалуйста будьте внимательны!
# Как посмотреть историю посещений админки?
Лог обращений к админке логируется в файле /var/log/nginx/admin.access.log
. Через терминал можно смотреть так:
less /var/log/nginx/admin.access.log
или запросить последние обращения
tail -n 100 /var/log/nginx/admin.access.log
# Почему VPS стал работать очень медленно?
Это могло произойти по причине недостаточного выделения CPU ресурсов на ваш виртуальный сервер. Запустите на сервере команду
vmstat 1 5
В результате вы увидите таблицу подобную этой
procs -----------memory---------- ---swap-- -----io---- -system-- ------cpu-----
r b swpd free buff cache si so bi bo in cs us sy id wa st
111 0 0 3438984 20280 603200 0 0 11 20 38 85 10 2 32 0 56
139 0 0 3435676 20280 603220 0 0 0 0 936 318 15 3 0 0 82
126 0 0 3434312 20280 603212 0 0 0 0 903 198 14 4 0 0 82
92 0 0 3450964 20280 603868 0 0 0 0 885 198 13 3 0 0 83
145 1 0 3452128 20280 604412 0 0 448 0 993 254 14 2 0 0 84
Обратите внимание на значения в последнем столбце st. Если у вас значения значительно больше 0 (как в примере), значит CPU ресурсов выделено недостаточно. В данном случае рекомендуем поменять дата центр или хостинг провайдера.
# Сколько хранится и где редактируется срок хранения лога полученных постбеков?
Лимит на размер лога прописан в файле application/config/config.ini.php
# Какие изменения можно вносить в конфигурацию сервера
Если Вы обладаете навыками программирования, то для локальной настройки конфигурации nginx можно пользовать файлы в /etc/nginx/conf.d/local
После установки трекера в этой директории будет создана поддиректория keitaro с файлами:
server.inc
- здесь можно вносить изменения на уровне всего сервераadmin.inc
- можно использовать для внесения блокировок или дополнительный настроек админки (например, можно ограничить вход только с определённых ip)tracker.inc
- здесь можно настроить дополнительное поведение для файлов/скриптов, относящихся к трекеру (например настроить кеширование для статических сайтов)nontracker.inc
- здесь можно настроить дополнительное поведение для файлов/скриптов, не относящихся к трекеру (например настроить кеширование для статических сайтов)realip.inc
- в случае, если сервер находится за прокси (типа CloudFlare) и нужно, чтобы ip посетителей определялись и писались в логи nginx корректно, в этот файл стоит добавить директивы вида ''set_real_ip_from a.b.c.d/x;'', где ''a.b.c.d/x'' - IP сеть прокси- для каждого отдельного домена, создаётся также
/etc/nginx/conf.d/local/domain.com.inc
, где можно настроить поведение на уровне домена
Т. о. если например нужно ограничить доступ ботам на уровне всех сайтов и трекера, проще всего это сделать в файле /etc/nginx/conf.d/local/keitaro/server.inc
, в конфигах доменов этого делать не нужно.
Важно! После каждого внесенного изменения нужно проверять конфиг командой:
nginx -t
и только потом делать перезагрузку nginx:
systemctl reload nginx
Подробный список всех директорий можно найти по ссылке
# Можно ли использовать master-slave репликацию базы данных?
Да, вы можете переключить построение отчетов по slave базе.
- Откройте файл
/var/www/keitaro/application/config/config.ini.php
; - Найдите секцию
[db_slave]
; - Пропишите параметры slave-базы;
- Сохраните файл.
- Для открытия порта, смотрите ниже Как открыть порт на сервере.
Настройка репликации остается за пределами этой инструкции.
# Как открыть порт на сервере?
Откройте /etc/firewall.bash
.
Найдите # Open ports
и добавьте:
iptables -A INPUT -p tcp -m tcp --dport 3306 -j ACCEPT
После этого перезагрузите firewall
systemctl restart firewall