FAQ — часто задаваемые вопросы

Установка и обновление

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

Читайте на странице Как установить Keitaro.

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

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

Чем отличается базовая от профессиональной редакции?

В Pro версии доступен следующий функционал:

  • Многопользовательность
  • Парковка доменов
  • Мониторинг потоков
  • Подключение своих скриптов действий, редиректов, макросов и фильтров
  • Admin API
  • Click API
  • WordPress Plugin

Чем отличается Бизнес редакция от Профессиональной?

В ней доступен функционал брендирования. На данный момент в неё можно заменять логотип и favicon.

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

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

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

Читайте на странице Установка ionCube.

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

Читайте на странице Требования к серверу

Как переустановить Keitaro без потери данных?

  • Удалите файл var/install.lock;
  • Скачайте инсталлятор https://keitaro.io/getfile/install;
  • Откройте в браузере install.php?step=3;
  • Пройдите до этапа, где будет написано об успешной распаковке файлов;
  • Удалите install.php.

Как настроить несколько серверов с Keitaro и центральной админкой?

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

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

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

Для открытия порта, смотрите как открыть порт на сервере.

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

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

Устанавливая старую версию продукта, вы соглашаетесь:

  1. с наличием ошибок в продукте;
  2. с отсутствием техподдержки;
  3. отсутствию пробного периода, т.к. 7я версия не поддерживает этот тип лицензий;

Способы установки:

  1. Через php-инсталлятор. Скачайте скрипт https://keitaro.io/getfile/install_legacy (поддержка скрипта прекращена 01.02.2017) и переименуйте файл в install.php. Запустите его на хостинге.
  2. Через терминал на VPS: curl -sSL https://keitaro.io/install.sh | bash -s -- -l ru -k 7.

Мы рекомендуем пользоваться только свежими версиями Keitaro, чтобы наслаждаться новейшим функционалом трекера и получать полноценную техподдержку.

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

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

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

Что делать, если не обрабатывается статистика?

Как включить английский интерфейс?

Запустите с ключом -l en:

curl -sSL https://keitaro.io/install.sh | bash -s -- -l en -k 9

Если трекер уже установлен, в правом верхнем углу нажмите на имя пользователя, затем Профиль - Язык

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

Работа Keitaro будет остановлена.

Можно перенести лицензию из одного аккаунта в другой?

Нет. Вы не можете пенеросить лицензии.

Можно ли устанавливать несколько Keitaro с одной лицензий?

Да, если они будут использовать один IP-адрес.

Можно ли менять IP в лицензии?

Вы можете изменить IP в личном кабинете на нашем сайте.

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

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

  1. Регистрируетесь на сайте
  2. Выбирайте «Купить лицензию»
  3. Выбираете срок 1 год (оригиналы предоставляем при оплате на год)
  4. На странице выбора способа платежа, выбираете «Распечатать счет»
  5. Вместо со счетом будет инструкция по получению актов
  6. Распечатываете акт в 2х экземплярам, подписываете оба и отправляете по указанному там адресу
  7. После получения, мы подписываем и отправляем на обратный адрес.

Договор у нас в виде оферты, находится по адресу https://keitaro.io/ru/license-agreement. Вы принимаете его условия, зарегистрировавшись на сайте.

Эксплуатация Keitaro

Как добавить домены к Keitaro?

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

2. Пропишите в DNS у регистратора «A»-запись:

@  A    x.x.x.x

Где «x.x.x.x» это IP вашего сервера.

Читайте подробнее по функционалу на странице Домены

Почему поток не срабатывает или клик уходит не в тот поток?

  1. Зайдите на страницу «Обслуживание > Логи > вкладка Трафик».
  2. Включите логирование.
  3. Сделайте переход или подождите попадание клика, который попал не в тот потока.
  4. Посмотрите в лог трафика. Там вы увидите как отработали фильтры потоков.

Также, посмотрите функцию в меню «Дополнительно > Симуляция трафика». Там вы сможете сымитировать попадание любого пользователя в кампанию.

Как найти причину потерь трафика?

  • Сравнивайте количество «сырых» кликов (хитов), а не уникальных. У Keitaro свои алгоритмы определения уникальности.
  • Сверяйте показатели в одной временной зоне с партнеркой.
  • Если вы используете хостинг или сервер с ISPamanger, то могут влиять лимиты, которые накладываются этими системами. Используйте наше решение для серверов Установка Keitaro.
  • При ботовом трафике, много ботов может застрять на редиректах как «мета-редирект», «двойной мета-редирект». Keitaro их может не выявлять как ботов, но некоторые боты просто не умеют проходить через такие редиректы. Проверяется легко. Сделайте редирект в другую кампанию и посмотрите на разницу «отправлено - получено». Если получено меньше, то вероятнее всего отвалились боты.
  • Пройдите по всем потокам сами. Проверьте, что они все рабочие.
  • Проверьте системный лог на наличие ошибок. Он доступен через меню «Обслуживание > Логи».
  • Если вы используете CloudFlare, переключите настройки Firewall на «essentially off». Отключите компрессию.
  • Проверьте ваш домен через сервисы host-tracker.com, http://urlvoid.com и http://virustotal.com.
  • Если 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, то могут сказываться недостаточная настройка сервера. Обратите внимание, что мы помогаем лишь с серверами, которые настроены нашим скриптом.

Если теряется трафик на FriendHosting с панелью VestaCP (пакет FastTDS)

1. Обновите Redis:

yum update redis-server

2. Обновите Redis расширение:

pecl install redis

3. Замените команду в кроне с curl на php

php /home/admin/www/domain/public_html/cron.php

Как восстановить работу Keitaro если сервер был заражен вирусом?

Первым делом определите каким образом вломали сервер. С этим вам могут помочь в саппорте хостера. Только затем восстанавливайте Keitaro.

  1. Перенестите все файлы Keitaro в папку backup или к себе;
  2. Создайте директорию application/config/;
  3. Скопируйте туда из бекапа файл config.ini.php;
  4. Проверьте, нет ли в конце файла инъекции кода;
  5. Установить инсталлятором новую версию (до шага с настройкой базы);
  6. Откройте админку;
  7. Если авторизация работает, удалите install.php.

Почему нет конверсий или почему не работает постбек?

Как использовать разные домены для Keitaro?

Вариантов несколько:

По какому адресу находится админка?

http://ваш_домен/admin

Как отправлять пользователей с домена на кампанию?

На странице Настройки во вкладке «Другое» найдите опцию «Действие для домена» и выберите пункт «Отправить в компанию».

Как восстановить пароль к Keitaro?

Читайте на странице Как восстановить пароль к Keitaro?

Срок лицензии в Keitaro не изменился после продления

  • Проверьте ключ вашей лицензии и тот, что прописан в файле /var/license/key.lic;
  • Удалите файл /var/license/hash.lic.

Как сменить ключ в Keitaro?

Пропишите новый ключ в /var/license/key.lic и удалите файл /var/license/hash.lic.

Не удаляются и не редактируются файлы Keitaro

Если нужен доступ только к одному файлу, создайте в директории Keitaro скрипт:

chmod('file/path', 0777);

Замените путь до файла и откройте в браузере.

Если нужно изменить права на несколько файлов, воспользуйтесь скриптом http://keitaro.io/getfile/fix_permissions. Измените в нем путь к директории, загрузите в директорию Keitaro и откройте в браузере.

Какие атрибуты должны быть у файлов?

Если PHP работает в режиме CGI или FastCGI, достаточно выставить 755 на директорию var и 655 на все остальные файлы.

cd /keitaro/directory
chmod 755 -R ./var

Убедитесь, что владелец файлов тот же, что и у процессов PHP:

chown -R user ./

В случае с использованием Apache и mod_php, иногда необходимо повышать атрибуты до 777.

В ISPManager атрибуты меняются через страницу «Система > Менеджер Файлов». Выберите директорию и нажмите сверху на кнопку «Атрибуты»:

Почему отличаются показания счетчиков LiveInternet/Метрика/GoogleAnalytics и Keitaro

  • Сравнивайте хиты, уники считаются у каждой системы по своему. В настройках кампании можете переключить уникальность на «IP» вместо «IP+UA».
  • Трафик может быть ботовый. Keitaro посчитает бота, браузерные счетчики нет.
  • Счетчики блокируются Adblock'ом и другими расширениями.

Почему отличаются показатели в Facebook и Keitaro?

Возможные причины:

  • Вашу рекламу дергают сервисы типа AdMobiSpy;
  • Смотрите статистику за разные временные периоды или в разных временных зонах;
  • Facebook не считает повторные клики (смотрите показатель уников);
  • Не отключено игнорирование preferch (отключается на странице Обслуживание > Настройки);
  • Используете старую библиотеку klick_client.php или плагин интеграции WP;

Почему Вебвизор показывает не тот сайт, на который попал пользователь

Если вы используете фильтр по боту, то вебвизир при выгрузке копии вашего сайта попадает под фильтр и получает не то, что обычные пользователи. Поэтому запуская сессию вебвизора вы видите как пользователь совершал действия поверх совсем другого сайта.

Во всех отчетах пишет "Нет данных"

Проверьте настройки работы крона на странице «Состояние» и лог ошибок /var/log/errors.log.

Не передаются рефереры с Google и Яндекс

С 25 сентября 2013 Google включил https на странице поиска: http://www.searchengines.ru/news/archives/google_budet_enscript_searches.html. При переходе с https на http реферер не передается.

С конца 2013 Яндекс начал сокращать передачу рефереров http://habrahabr.ru/company/yandex/blog/204886/.

Почему домен с Keitaro отмечается как "Malicious site"?

Некоторые сервисы выдают статус «Malicious site» за редирект на другой домен.

Зайдите на страницу «Обслуживание > Настройки». Найдите настройку «Действие для домена» и выберите «404 NotFound» или «Отправить в кампанию».

Как подменить или скрыть реферер?

Читайте на странице Скрытие реферера.

Как исправить кодировку ключевиков?

Добавьте параметр &charset=utf-8 к ссылкам на ваших сайтах.

Как ограничить доступ к админке по 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/*

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

4. Можете очистить статистику до определенной даты, но если кликов было много в базе, процесс может занять длительное время. В пункте 5 рассказывается как удалить моментально все клики из базы.

export DB_NAME='keitaro'
export DB_USER='root'
mysql -u $DB_USER  -e 'DELETE FROM keitaro_clicks WHERE datetime < "2018-01-01" ' $DB_NAME 

5. Попробуйте выполнить запросы

optimize table keitaro_clicks;
optimize table keitaro_conversions;
optimize table keitaro_visitors;
optimize table keitaro_ref_ips;
optimize table keitaro_ref_referrers;
optimize table keitaro_ref_user_agents;

Внимание! Эти запросы заблокируют базу на время выполнения и требуют наличие дополнительного свободного места

6. Если больше нечего удалять, можно очистить текущую статистику:

Внимание! Выполнение команды приведет к удалению всей статистики!

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

Как посмотреть историю посещений админки?

Лог обращений к админке логируется в файле /var/log/nginx/admin.access.log. Через терминал можно смотреть так:

less /var/log/nginx/admin.access.log

или запросить последние обращения

tail -n 100 /var/log/nginx/admin.access.log