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

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

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

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

Кроме того, 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.

# Как оплатить безналичным расчетом юридическому лицу?

Процедура следующая:

  • Регистрируетесь на сайте
  • Выбирайте "Купить лицензию"
  • Выбираете срок 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?

Apache

Создайте файл /admin/.htaccess с содержимым:

<Files index.php>
order Deny,Allow
Deny from all
Allow from 1.2.3.4
</Files>

Nginx.

В секцию хоста /etc/nginx/nginx.conf добавьте: location /admin/ { allow 1.2.3.4; deny all; }

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

  1. Выставите в настройках, во вкладке Статистика ограничение на количество дней хранения статистики.

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

rm -r /var/lib/redis/*

  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
  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. Эти команды помогут оптимизировать имеющиеся клики и освободить дополнительное место. Внимание! Эти запросы заблокируют базу на время выполнения и требуют наличие дополнительного свободного места.

cd /var/www/keitaro && sudo -u keitaro php bin.cli.php system:optimize_db

  1. С помощью этих команд можно очистить полностью всю текущую статистику:
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
  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.

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

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

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

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

# Можно ли использовать master-slave репликацию базы данных?

Да, вы можете переключить построение отчетов по slave базе.

  1. Откройте файл /var/www/keitaro/application/config/config.ini.php;
  2. Найдите секцию [db_slave];
  3. Пропишите параметры slave-базы;
  4. Сохраните файл.
  5. Для открытия порта, смотрите ниже Как открыть порт на сервере.

Настройка репликации остается за пределами этой инструкции.

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

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

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

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

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

systemctl restart firewall