# Частые вопросы (FAQ)

# Общие вопросы

# Для чего нужен трекер

Трекер помогает собрать в одном месте статистику по всем источникам трафика и из всех партнерских сетей. В каждой рекламной сети или партнерке есть своя статистика, однако для того, чтобы видеть полную картину по запущенной кампании, нужно или перемещаться между вкладками браузера, или выгружать всю статистику в один файл. Трекер собирает всю статистику за вас.

Кроме того, Keitaro позволяет анализировать показатели и строить отчеты по различным метрикам, что помогает выявить профитные связки и отказаться от убыточных площадок.

Дополнительная функция нашего трекера – распределение трафика на разные целевые страницы с помощью большого количества фильтров: геолокация, мобильный оператор, браузер, устройство, включение потоков и лендингов в них по определенному расписанию, и многое другое.

# Как установить Keitaro?

Читайте на странице.

# Какие ограничения у пробной версии?

  • 2 кампании
  • 2 потока в каждой кампании
  • 1 фильтр в потоке

# После апгрейда лицензии новый функционал недоступен

Лицензию можно принудительно обновить, нажав "Обновить лицензию" в верхнем правом меню админки Keitaro "admin > Обновить лицензию".

# Какие требования серверу?

Читайте на странице.

# Как подписать акты через diadoc.ru?

Подготовьте акты и через diadoc.ru отправьте на подписание контрагенту ИНН 183104973204.

# Что значат ошибки в логе?

Читайте расшифровки на странице устранение неисправностей.

# Что произойдет, когда закончится срок лицензии?

Работа Keitaro будет полностью остановлена, редиректы и обработка трафика не будет работать.

# Как узнать, что лицензия скоро закончится?

За 7 дней до окончания лицензии внутри трекера появится уведомление, отображающее оставшееся количество активных дней. Также, вы получите уведомление на почту за 2 дня и в последний день срока лицензии.

# Можно ли устанавливать несколько 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?

  1. Приобретите профессиональную редакцию

  2. Пропишите в 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, с которого можно будет зайти в админку.

# Как очистить статистику и освободить место на сервере?

  1. Самый простой и доступный способ очистить статистику - запустить процесс очистки из админ панели Keitaro. В разделе Обслуживание - Очистка статистики вы можете выбрать временной интервал и временную зону для очистки всех кликов.

  2. Для того, чтобы база не разросталась в размерах и клики очищались автоматически, стоит отрегулировать срок хранения статистики в трекере. В раздлеле Обслуживание - Настройки - Системные, вы можете задать Срок хранения статистики и Срок хранения удаленных ресурсов в архиве, после истечения которых трекер будет автоматически подчищать всю статистику старше установленного количества дней.

Если база начала перегружаться и место на диске стремительно заканчиваться, можно попробовать следущие экстренные пути решения проблемы:

  1. Выполнить в терминале чистку дампов Redis'а (это удалит все необработанную статистику!):

rm -r /var/lib/redis/*

  1. Попробовать запустить очистку статистики до определенной даты. Однако, при большом количестве кликов в базе, процесс может занять длительное время.
export DB_NAME='keitaro'
export DB_USER='root'
mysql -u $DB_USER  -e 'DELETE FROM keitaro_clicks WHERE datetime < "2018-01-01" ' $DB_NAME
  1. Если на диске имеется хотя бы 25% свободного места, запустите утилиту оптимизации базы данных.

Проверьте достаточное количество места на диске df -k -h --output=source,avail,pcent.

Выполните

yum install https://repo.percona.com/yum/percona-release-latest.noarch.rpm
yum install percona-toolkit
pt-online-schema-change --alter='ENGINE=TokuDB' D=keitaro,t=keitaro_clicks --execute

Оптимизация может занять несколько часов, но сама база не блокируется на это время.

  1. С помощью следующей команды можно удалить всю имеющуюся статистику и освободить место на диске:

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.

Будет произведена очистка всей статистики.

  1. Если вы делали апгрейд с 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

# Как очистить инноды на сервере?

Если Ваш трекер стал не корректно работать или появилось сообщение о том, что заканчивается свободное место на 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

Подробный список всех директорий можно найти по ссылке

# Когда не следует производить перезагрузку VPS/VDS сервера?

Иногда бывают ситуации (например в следствии большой нагрузки, ошибки сервера, DDoS)когда быстродействие VPS сервера падает, наблюдаются сильные задержки в работе трекера, и тогда кажется что перезагрузить сервер в таком случае - это хорошее решение. Однако если сервер или трекер занят определенной операцией которая работает со статистикой кликов в Вашей БД, то перезагружать VPS/VDS сервер не рекомендуется, так как Вы рискуете проведить базу данных трекера, что приведет к потери данных. Что бы избежать этого - рассмотрим простой список случаев когда не стоит перезагружать сервер:

  • RedisException: OOM command not allowed when used memory > maxmemory - если служба хранения статистики в БД трекер была остановлена ОС сервера, однако необходимо проверить или ключи и данные все еще не висят в службе redis. Перезагрузка сервера может привести к тому, что статистика которая зависла в redis - может так и не попасть в Ваш трекер. В таком случае нужно проверить что бы очередь команд отрабатывала (Обслуживание - Состояние). Если у Вас постоянно растет очередь команд, и не уменьшается - следует незамедлительно написать в нашу тех.поддержку.
  • Выполнение очистки статистики - желательно дать запросу на удаление статистики полноценно отработать, в противном случае выполнение запроса будет прервано и удаление статистики придется запустить заного.
  • Оптимизация базы данных трекера - ни в коем случае мы не рекомендуем Вам выполнять перезагрузку сервера при оптимизации БД - есть большая вероятность уронить таблицу с данными, в которой выполнялась оптимизация на момент перезагрузки. Так же сама БД будет заблокирована на время выполнения оптимизации, а в случае перезагрузки - отката изменений.
  • Неисправность SSD - в данном случае лучше сразу же написать в техническую поддержку Вашего VPS/VDS хостинга, после чего Вам проведут замену.
  • Критические ошибки ядра ОС сервера - необходимо произвести резервное копирование всех Важных файлов (дампов БД, архива с лендингами напр.) Перезагрузка при неисправной ОС может привести к тому что дальнейшее создание дампа БД или архива с лендингами будет невозможно, в ввиду недоступности некоторых служб.
  • Закончилось свободное место на сервере - если на сервере, на SSD где расположен трекер - закончилось свободное место (проверить можно командой df -h), то после перезагрузки сервера, VPS не сможет производить никакие записи в файлы трекера или сервера (из-за недостатка места), что в свою очередь приведет к тому что сервер вообще не включиться. В таком случае лучше написать нам, в техническую поддержку или же в техническую поддержку VPS/VDS после чего мы постараемся найти, что именно у Вас занимает больше всего места на сервере.

# Как открыть порт на сервере?

Откройте /etc/firewall.bash.

Найдите # Open ports и добавьте:

iptables -A INPUT -p tcp -m tcp --dport 3306 -j ACCEPT

После этого перезагрузите firewall

systemctl restart firewall