Экспорт данных юзеров

❖ Что такое Экспорт Данных

Экспорт Данных - позволяет экспортировать в файл, сохраненные в переменных, данные юзеров вашего бота. Данные экспортируются в текстовый .csv файл, с ";" в качестве разделителя колонок, в формате Unicode UTF8.

Проверить количество доступных Экспортов Данных можно в:
☞ 🔐Админ

Напоминаем, что если вам нужно узнать данные только одного юзера - вам не нужно осуществлять полный экспорт, вы можете использовать команду:
/userinfo user_id/user_code - выводит всю имеющуюся по юзеру информацию. (Команда потребляет 5 Токенов Функций).

ВНИМАНИЕ:
Экспортировать в файл можно данные, ТОЛЬКО тех юзеров которые хоть как-то проявили себя в боте, помимо того что просто посмотрели меню. Для экспорта нужно чтобы у юзера были рефералы, реферальный родитель, баланс либо ещё что-нибудь - бонусы например - сохранены в переменых.

Данные тех кто просто зашёл посмотреть бот и по нажимать кнопки меню - экспортироваться НЕ будут - и узнать их НЕЛЬЗЯ - НИ платно, НИ бесплатно, НИ в виде исключения, НИ потому что это "единственное чего вам не хватало в жизни". Это вопрос ЭТИКИ, а не технических возможностей.

Если вы ОСМЫСЛЕННО не настроили какую-либо функцию на сохранение данных в переменных - не ожидайте что какие-либо данные будут экспортированы.

Если вы не знаете какие функции бота могут сохранять данные в переменных - значит вы ТОЧНО их не настраивали!

Далее... Для тех кто не может вывести логических заключений из выше написанного или предпочитает игнорировать реальность в угоду собственным желаниям:
Если у вас в боте есть юзеры С сохраненными в переменных данными и БЕЗ сохраненных в переменных данных - то экспортированы будут ТОЛЬКО те юзеры у которых ЕСТЬ сохраненные в переменных данные. Остальные в экспорт не попадут - несмотря на то что у них есть Telegtam ID и Name.

И ПОСЛЕДНЕЕ: один экспортированный файл будет содержать ВСЕ доступные данные ВСЕХ доступных пользователей!!!!!!!!!!!!! Не одного юзера за экспорт, не двух, не трех, а ВСЕХ - ВСЕХ ДОСТУПНЫХ! Мы не знаем как доступнее можно объяснить эту концепцию, поэтому НЕ НУЖНО дополнительно прояснять этот момент ни в Суппорте, ни в группах Тех. Поддержки.

Для подключения перейдите в вашем боте:
☞ 🔐Админ | 🧩Расширения | 📂Логи и Данные

❖ Экспортируемые данные

Список экспортируемых данных (типичный):
● ID (user_id)
● UserCode (user_code)
● UserName (username)
● Имя (first_name)
● Фамилия (last_name)
● Удалён - бот заблокирован юзером (bot_blocked)
● Забанен - юзер заблокирован админом (is_banned)
● Переменные - их данные (по имени переменной)
● Количество Рефералов - все уровни (ref1, ref2, ref3, ref4 и т.д.)
● Реферальный Родитель (ref_parent)

Все данные записываются в .csv файл, который присылается ботом в чат с админом. Файлы .csv могут быть открыты как текст, в любом текстовом редакторе, либо в виде таблиц, в любых приложениях поддерживающих или работающих с таблицами (MS Excel, OpenOffice, LibreOffice, FreeOffice).

По умолчанию разделителем колонок является точка с запятой ( ; )

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

❖ Как экспортировать данные

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

ВНИМАНИЕ: один экспортированный файл будет содержать ВСЕ доступные данные ВСЕХ доступных пользователей!!!!!!!!!!!!!

Полный экспорт всех данных

/varexp

В один файл будут экспортированы ВСЕ сохраненные в переменных бота данные, ВСЕХ пользователей у кого они есть.

Для тех альтернативно одарённых, у кого сложности с пониманием с первого раза....
Не нужно приходить в поддержку и спрашивать: "10 экспортов это 10 человек? А если у меня 1000 человек мне нужно 1000 экспортов?".
НЕТ - вам НЕ нужно 1000 экспортов!
Один единственный Экспорт присылает ВСЕ (повторю еще раз: ВСЕ) имеющиеся данные, ВСЕХ (повторю еще раз: ВСЕХ) имеющихся пользователей с сохраненными данными.

Если в вашем Боте большое количество пользователей или у них большое количество данных, размер вашего файла Полного Экспорта может превысить максимальный размер разрешенный командой Telegram для ботов (боты имеют ограничение на размер файла который они могут отправить в чат). В этом случае ваш бот, чисто технически, не будет иметь возможности отправить вам этот файл. Ещё раз подчеркнём это ограничение самого Telegram. В этом случае, чтобы уменьшить его размер, мы можем поместить ваш файл экспорта в ZIP архив. В случае же если бот не будет иметь возможности отправить вам и архивированный файл, то файл вашего экспорта будет загружен на один из наших серверов. В чате же с ботом, вы в свою очередь, получите ссылку на этот файл. Просто перейдите по ссылке чтобы скачать файл с нашего сервера. Файл будет удалён с сервера после скачивания, либо удалён через сутки в случае если он так и не был скачан вами.

Экспорт данных по выбору

/varexp var_name - экспортирует данные одного столбца.
/varexp var_name1 var_name2 var_name3 - экспортирует данные трех столбцов.

Где var_name это имя переменной данные которой нужно экспортировать. В файл попадут ТОЛЬКО данные соответствующие указанной переменной (ВСЕХ юзеров у кого есть данные в указанной переменной).

Столбец user_id (содержащий Telegram ID юзера) - НЕ экспортируется по умолчанию. Указывайте его как один из аргументов если он вам нужен в экспорте.

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

❖ Варианты разделителей колонок

При экспорте данных, в качестве разделителя колонок можно назначить "," (запятую), а не ";" (точку с запятой, использующуюся по умолчанию). Это может помочь нормально открывать .csv файл экспорта в мобильных приложениях и Google документах.

Используйте дополнительный параметр - слово "comma" при экспорте. Например:
/varexp comma

Положение аргумента comma относительно других возможных аргументов команды - не имеет значения.

❖ Типичные ошибки при использовании экспорта

Тут собраны наиболее типичные примеры ошибок встречающиеся при экспорте данных.

Бот не присылает файл с данными (хотя раньше присылал)

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

Иероглифы вместо текста в файле экспорта

Файл открыт в неправильной кодировке. Используйте кодировку Unicode UTF8 - при открытии файле в вашем приложении для работы с таблицами или текстовом редакторе.

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

Попробуйте использовать другой разделитель колонок. Используйте запятую ( , ) вместо точки с запятой ( ; ) используемой по умолчанию и наоборот.