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

Аккаунты в TwiFarm v3

В TwiFarm есть понятие Аккаунт и Пользователь. Путать эти понятия не нужно.

Аккаунт - это твиттер аккаунт, к которому у вас есть доступ, т.е. пара логин-пароль или email-пароль.

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

Внимание! Мы настоятельно не рекомендуем вам переносить работающие аккаунты, на другой домен со скриптом TwiFarm, это может привести к полной или частичной блокировке переносимых аккаунтов. Например после переноса аккаунтов на новый домен, работающий под управлением новых API ключей, вас попросят во всех аккаунтах подтвердить email.

Были прецеденты во время тестирований и во время подобных действий пользователей на предыдущей версии скрипта.

Следуйте золотому правилу: работает - не трогай!

Рассмотрим элементы страницы по группам и более подробно.

Внимание! Подробные сведения о таблицах, работе с ними, сведения о добавлении данных в таблицы, модулях Импорта/Экспорта, об отдельных настройках для Аккаунтов и всех типов контента, о том как все это устроено читайте в статье Общие принципы работы с TFv3

Данные в таблице

Информация по твитам, ретвитам, читаемым, читателям - берется напрямую из статистики аккаунта в Твиттер. Это не статистика произведенных фермой действий!

Как происходит сбор этой статистики:

Данные статистики обновляются при авторизации аккаунта в приложении или же при выполении действий. Статистика обновляется при успешных действиях.

Статистика ретвитов обновляется самостоятельно при выполнении такого типа действий, так как такого параметра Twitter не возвращает. Действия реплаинга это теже твиты и по этому обновляется эта колонка.
Действия реплаинга, твиттинга, ретвитинга обновляют поля - tweets, friends, followers. При ретвитинга так же поле retweets. Действия фолловинга обновляют поле friends.
Действия анфолловинга обновляют поле followers.

Кнопка Сброс, обнуляет статистику. Статистика не имеет такой ценности, как например токены аккаунта, на случай переноса данных.

В таблице представлены следующие данные

  • Добавлено [1] - отображается дата и время добавления аккаунта
  • Аккаунт [2] - отображается логин аккаунта в виде ссылки, по клику можно попасть на страницу Отчеты - Действия, которая будет предварительно отфильтрована по логину аккаунта. Рядом с логином выводится значок, который обозначает был ли аккаунт уже авторизован через API приложения или пока нет и действий с ним никаких не производилось.
  • Твитов [3] - отображается статистика по твитам аккаунта.
  • Ретвитов [4] - отображается статистика по ретвитам аккаунта.
  • Читаемых [5] - отображается статистика читаемых аккаунтом (те, кого мы зафоловили).
  • Читателей [6] - отображается статистика по читателям аккаунта (те, кто нас зафоловил).
  • Ошибок [7] - отображается статистика по ошибкам аккаунта. Для просмотра ошибок можно перейти в соответствующий раздел Отчеты - Ошибки и применив фильтры отсортировать ошибки логину, дате и времени, типу ошибки и т.д.
  • Статус [8] - отображается статус аккаунта на текущий момент.

Вы можете осуществить поиск в таблице по названию аккаунта [14].

Проверка индексации Yandex/Google [2.1]

Твифарм умеет проверять аккаунты на проиндексированность в Яндекс и Google.

  • Для Яндекса необходимо указать Yandex XML.
  • Для Google необходимо указать Google API

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

Проверка индекса выполняется только по крону, для каждой ПС есть своя крон ссылка.

Процесс проверки Google индекса:

- Выполняем проверку настройки, если она включена или же был передан force параметр продолжаем выполнение. - Выполняем проверку настройки Google API ключа, если он указан продолжаем выполнении, если нет процес останавливается и формируется информационная ошибка. - Выбираем 10 случайныйх активных аккаунтов, если такие есть продолжаем выполнеии. если нет, процес останавливается и формируется ифнормационная ошибка. - Проходимся по каждому из выбранных аккаунтов для выполнения запроса проверки. - Если результаты запроса были успешными данные заносятся в поле google текущего аккаунта, если нет формируется ошибка Google API.

Аналогичная логика для Yandex, которая отличается лишь проверкой на наличие Yandex XML пользователя и Yandex XML ключа.

Таблица - название поля в БД ** Название в TFv3

Все выводимые в интерфейсе, в виде таблицы данные, это данные, которые хранятся в соответствующей таблице MySQL.

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

Поле в БДНазвание в TF
idID - айди поля в таблице
tokenТокен - токен полученный аккаунтом при работе
secretСекрет - сикрет полученный аккаунтом при работе
uidUID - юзер айди аккаунта в твиттере
accountАккаунт - логин аккаунта
passwordПароль - пароль аккаунта
googleGoogle - количество проиндексированных страниц в Google
yandexYandex - количество проиндексированных страниц в Яндекс
tweetsТвиты - количество твитов
retweetsРетвиты - количество ретвитов
friendsЧитаемые - количество читаемых (тех, кого зафоловили)
followersЧитатели - количество читателей (тех, кто нас зафоловил)
errorsОшибки - количество ошибок
statusСтатус - статус аккаунта
created_atДата и Время - дата и время добавления аккаунта в систему

Мы еще раз вернемся к этой таблице чуть ниже, когда будем рассматривать Импорт и Экспорт этих данных.

Действия с аккаунтами

Какие действия нам доступны?

Редактирование аккаунта [9]

Вы можете отредактировать любой выбранный вами аккаунт, нажав рядом с чекбоксом, маленький синий квадратик с карандашом [9].

После нажатия на эту кнопку, вам откроется такая страница:

На этой странице мы можем отредактировать сдедующие данные аккаунта:

  • Токен [1] - здесь мы видим token, полученный при первой авторизации через API приложения. Если поле пустое, это может означать либо то, что аккаунт еще не авторизовывался в Твиттере через API приложения по каким-либо причинам (с ним не выполнялись еще действия или он не прошел авторизацию по каким-либо причинам и не смог получить ключи), либо то, что этому аккаунту был выполнен Сброс (будет описано ниже)
  • Секрет [2] - здесь мы видим secret, полученный при первой авторизации через API приложения. Если поле пустое см. пункт Токен [1].
  • Аккаунт [3] - логин аккаунта
  • Пароль [4] - пароль аккаунта
  • Ошибки [5] - количество ошибок аккаунта

На практике, нам может пригодиться только удаление данных из полей токен и секрет, а также смена пароля аккаунта и уменьшение количества ошибок у него.

Вопрос: Значит ли это, что я могу изменив пароль в поле Пароль [4], изменить пароль аккаунта в Твиттере?

Ответ: нет, на данный момент, никакого взаимодействия в этом плане, с Твиттером, нет. Меняя пароль, вы просто меняете его в БД TwiFarm. Это может понадобиться в том случае, если вы сменили пароли у аккаунтов и необходимо сменить их в Ферме, чтобы аккаунты продолжали нормально авторизовываться. В версии TFv2 это было невозможно, аккаунт приходилось удалять и заново добавлять.

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

Мы уже неоднократно замечали, что любые массовые, однотипные изменения, например переполучение token и secret множеством аккаунтов, работающих на одной Ферме, а соответственно и на одном API, приводили к массовому бану этих аккаунтов. Один из примеров произошел прямо во время тестирований TFv3.

Таким образом, не весь функционал такой полезный, каким он кажется изначально :)

Включение/Выключение/Сброс/Удаление [10],[11],[12],[13]

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

  • Включить [10] - вы можете включить выбранные чекбоксами аккаунты в работу. Также есть возможность Включить все сразу, нажатием одной кнопки.
  • Выключить [11] - вы можете вылючить выбранные чекбоксами аккаунты в работу. Также есть возможность Выключить все сразу, нажатием одной кнопки.
  • Сбросить [12] - вы можете "сбросить" выбранные чекбоксами аккаунты. Также есть возможность Сбросить все сразу, нажатием одной кнопки. Сброс подразумевает под собой удаление данных из полей token и secret для выбранных аккаунтов, которые аккаунты получили при работе через API под которым работает данная Ферма.
  • Удалить [13] - вы можете включить выбранные чекбоксами аккаунты в работу или выключить. Также есть возможность Включить все сразу, нажатием одной кнопки.

Добавление аккаунтов/Импорт-Экспорт/Настройки

Мы рассмотрели данные представленные в таблице, теперь нам нужно рассмотреть действия, которые мы можем выполнять на этой странице.

В верхнем правом углу рабочей области сгруппированы ссылки на эти действия

Первое, что необходимо рассмотреть, это то, как вообще аккаунты попадают в Твифарм.

Добавление аккаунтов [15]

Для добавления аккаунтов, вам необходимо нажать кнопку Добавить [15], после чего вы попадете на страницу добавления аккаунтов

Пользователю предоставляется, на выбор, две возможности для добавления аккаунтов в ТвиФарм:

  1. Импорт из файла [1]. Формат файла - *.txt. Нажимаем кнопку Обзор → находим файл с аккаунтами у себя на компьютере → нажимаем Загрузить. Если хотим выбрать другой файл, нажимаем кнопку Сбросить
  2. Добавление построчно, списком, через textarea [2]. Вводим построчно пары логин/мейл-пароль → нажимаем Добавить. Если хотим очистить полностью textarea от данных, нажимаем кнопку Сбросить

Обратите внимание на информационные сообщения [1.1] и [2.1].

Эти сообщения говорят вам, какой максимальный размер файла (для Импорта из файла) или размер POST запроса (для добавления через textarea) вам доступен, согласно настройкам вашего сервера.

Эти же данные вы видели при установке TFv3 в checker.php. В руководстве данные на картинках отличаются, потому что скриншоты установки снимались на другом сервере (шаред хостинг).

Аккаунты, в обоих случаях, добавляются в формате: логин или [email protected] [пробел] пароль.

Пример:

[email protected] password1
[email protected] password2
login1 pass1
login2 pass2
[email protected] password3

1 строка = 1 аккаунт

После первой авторизации в Твиттере (например произвели действие с аккаунтом), email1 будет заменен на логин и в последующем, в TF вы будете видеть только логин!

Внимание! Были случаи обращения в техподдержку, когда неправильно добавлялись аккаунты, например на каком-то аккаунте обрывалось добавление. Проблема заключалась в том, что между строками не было переноса на следующую строку, хотя визуально, при просмотре через блокнот, строки шли одна под другой. Просим вас, при возникновении похожих проблем, сразу проверить это предположение, а не писать в саппорт :)

В общем-то больше нечего сказать про добавление аккаунтов. Следуйте инструкциям и все будет ОК :)

Импорт табличных данных [16]

Импорт данных - добавление данных в таблицу.

Какие данные вы можете Импортировать?

Поле в БДНазвание в TF
idID - айди поля в таблице
tokenТокен - токен полученный аккаунтом при работе
secretСекрет - сикрет полученный аккаунтом при работе
uidUID - юзер айди аккаунта в твиттере
accountАккаунт - логин аккаунта
passwordПароль - пароль аккаунта
googleGoogle - количество проиндексированных страниц в Google
yandexYandex - количество проиндексированных страниц в Яндекс
tweetsТвиты - количество твитов
retweetsРетвиты - количество ретвитов
friendsЧитаемые - количество читаемых (тех, кого зафоловили)
followersЧитатели - количество читателей (тех, кто нас зафоловил)
errorsОшибки - количество ошибок
statusСтатус - статус аккаунта
created_atДата и Время - дата и время добавления аккаунта в систему

Важно! Для того, чтобы понять какой на данный момент формат импорта, нужно просто экспортировать [17] данные в файл и посмотреть!:)

Для того, чтобы импортировать какие-то данные в нашу Твифарм, нажимаем на кнопку Импорт [16] и попадаем на такую страницу:

Сразу же обращаем внимание на информационное окошко [1.1] (его кстати можно закрыть нажав на крестик в его правом верхнем углу), которое сообщает нам о максимально допустимом размере загружаемого файла, согласно настройкам вашего сервера.

Порядок действий при импорте:

  1. Нажимаем кнопку Обзор и выбираем файл с данными (он обязательно должен быть в CSV формате) на своем компьютере [1]
  2. Указываем Разделитель поля [2] (символ, которым разделены столбцы данных в файле) и Ограничитель поля [3] (необязательный символ, который ограничивает данные в столбце).
    Пример строки с разделителем (,) и ограничителем ("): "data1","data2","data3"
    Пример строки только с разделителем (,): data1,data2,data3
  3. Теперь нажимаем кнопку Загрузить, если хотим загрузить CSV файл на наш сервер для дальнейшего добавления данных из него или кнопку Сбросить, в этом случае поле Обзор, очистится.

После нажатия кнопки Загрузить, файл загружается. Это не значит что данные импортированы/добавлены в базу.

Снизу появляется еще одна область, те, кто работал с импортом товаров в различных CMS интернет-магазинов, прекрасно знакомы с принципом этого этапа, кто не работал, мы расскажем:

Это промежуточный этап между загрузкой файла на сервер и импортом данных из него. На этом этапе вам дается возможность выбрать какие данные из вашего файла в какое поле БД добавить или вообще не добавлять никуда.

Разберем пример:

Ключ [1], [4], [7] и Значение [3], [6], [9] - эти данные относятся к нашему загруженному файлу. Эти поля невозможно отредактировать, это поля из загруженного файла.

  • Ключ - название этого параметра берется из первой строки нашего CSV файла, потому как предполагается что в первой строке идут заголовки столбцов.
  • Значение - вторая строка нашего файла, предполагается что со второй строки начинаются интересующие нас данные, которые мы хотим импортировать.

Поле [2], [5], [8]- это параметр, который можно изменять. Его название соответствует типу данных в нашей БД.

Вот так выглядит загруженный CSV файл, который мы рассматриваем, в текстовом редакторе Notepad++

Сейчас мы рассматриваем как раз вторую строку, аккаунт relymypujuzi

Если вы хотите, чтобы значение 2277 [3], было пропущено и не записывалось в нашу базу данных, вы просто в параметре Поле выбираете пустую строку. Если вы хотите добавить токен ставите соответствие в Поле - token [5] и при экспорте этот токен будет добавлен в базу, для аккаунта relymypujuzi [9]. Если вы хотите чтобы логин аккаунта также был добавлен в базу, выставляете в Поле accoount [5] и тогда relymypujuzi [9], будет записан в БД фермы.

Вопрос: Я Экспортировал (скачал) файл, отредактировал кое-какие параметры у аккаунтов, что будет если я его Импортирую (загружу)?

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

И вот когда вы настроили соответствия, если конечно что-то нужно настраивать, вы можете нажимать кнопку Импорт и скрипт прочтет CSV файл построчно и добавит данные согласно вашему заданию!

Теперь наши данные загружены и вы можете увидеть их в таблице.

Или вы можете нажать кнопку Сброс, в этом случае данные в таблице примут первоначальный вид.

Немного отойдя от темы - в Твифарм v3 импортируется и экспортируется практически все что только может импортироваться и экспортироваться - аккаунты, все типы контента и даже настройки!

Экспорт табличных данных [17]

Какие данные вы можете Экспортировать?

Поле в БДНазвание в TF
idID - айди поля в таблице
tokenТокен - токен полученный аккаунтом при работе
secretСекрет - сикрет полученный аккаунтом при работе
uidUID - юзер айди аккаунта в твиттере
accountАккаунт - логин аккаунта
passwordПароль - пароль аккаунта
googleGoogle - количество проиндексированных страниц в Google
yandexYandex - количество проиндексированных страниц в Яндекс
tweetsТвиты - количество твитов
retweetsРетвиты - количество ретвитов
friendsЧитаемые - количество читаемых (тех, кого зафоловили)
followersЧитатели - количество читателей (тех, кто нас зафоловил)
errorsОшибки - количество ошибок
statusСтатус - статус аккаунта
created_atДата и Время - дата и время добавления аккаунта в систему

А теперь мы познакомимся с экспортом данных таблицы из Фермы.

Как уже было написано выше, чтобы понять какой формат Импорта необходимо использовать, можно сначала выполнить Экспорт :)

Для экспорта выполняем следующие действия:

  • Выбираем нужные нам Поля [1]
  • Задаем настройки результирующего CSV файла ([2], [3], [4], [5])
  • Нажимаем кнопку Экспорт, если хотим скачать CSV или Сбросить, если хотим вернуть все в исходный вид.

После нажатия на кнопку Экспорт, нам предложит скачать CSV файлик. Который вы можете сохранить, например в целях бекапа.

Настройки использования при действиях [18]

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

Эти настройки связаны с использованием этого контента/аккаунта при выполнении с ним действия.

Перейдем в Настроки аккаунтов

Отключать аккаунт после N ошибок:

дает возможность отключать аккаунт, после того как он набрал определенное количество ошибок [1]. Увеличиваем или уменьшаем число и нажимаем Сохранить. При нажатии Сбросить, значение вернется к своему дефолту - 3.

Актуальность полученных твитов

  • Данная настройка ограничивает количество получаемых твитов которые учавствуют в действиях для выполнения которых нужен "номер" (TID).
  • Если в найденных твитах будут те которые созданы раньше указанного значения, тогда они будут исключаться.
  • Значение по умолчанию 604800 секунд, от есть одна неделя.

Количество получаемых твитов:

  • Данная настройка ограничивает количество получаемых твитов [3] которые учавствуют в действиях для выполнения которых нужен "номер" (TID).
  • Значение должно быть больше нуля.
  • По умолчанию 50.
  • Максимальное значение 100, которое ограничено в Twitter API.
Печать/экспорт
QR Code
QR Code Аккаунты в TwiFarm v3 (generated for current page)