Создавать короткие ссылки по одной становится невозможно, когда в таблице кампании или каталоге товаров сотни строк. Массовый импорт Posty5 принимает один CSV-файл, проверяет каждую строку до создания чего-либо, создаёт ссылки в фоне и выдаёт файл с результатами, где каждый короткий адрес стоит рядом с исходной строкой.
- Откройте Bulk import — Откройте URL Shortener в панели Posty5 и выберите Bulk import.
- Заполните шаблон — Скачайте CSV-шаблон и заполните по строке на каждый URL назначения; обязательна только колонка url.
- Загрузите и проверьте — Загрузите файл, выберите значения по умолчанию для пустых колонок и проверьте его. Posty5 перечислит все ошибочные строки до создания чего-либо.
- Запустите импорт — Запустите импорт и следите за ходом выполнения или закройте страницу и дождитесь уведомления.
- Скачайте результаты — Скачайте файл с результатами и короткими адресами, а также файл с ошибками, если какие-то строки не прошли.
Перед началом
Нужен аккаунт Posty5, в который выполнен вход. Откройте URL Shortener в панели и выберите Bulk import. Массовое создание зависит от вашего тарифа: если тариф его не включает, страница показывает его как заблокированное.
Начните с CSV-шаблона, который предлагает страница. В нём уже есть правильная строка заголовков и одна строка-пример, так что остаётся заменить пример своими данными.
Подготовьте CSV-файл
Обязательна только колонка url. Регистр в названиях колонок не важен, а колонка, которую Posty5 не знает, игнорируется и указывается на шаге проверки.
url | Адрес назначения. Обязательно. baseUrl принимается как другое название этой колонки. |
name | Название для вашего собственного списка. Если оставить пустым, Posty5 заполнит его в фоне по странице назначения. |
customId | Ваше собственное окончание короткой ссылки, если тариф разрешает свои окончания. Оно не должно быть занято, в том числе более ранней строкой того же файла. |
tag | Тег, чтобы потом группировать и фильтровать ссылки. |
refId | Ваш собственный идентификатор, например код товара из вашей системы. |
templateId | Шаблон QR-кода для этой строки. Он заменяет значение по умолчанию, выбранное на шаге загрузки. |
Сохраните файл как CSV в кодировке UTF-8, с запятыми в качестве разделителя и строкой заголовков. Значения с запятыми заключаются в двойные кавычки — табличные программы делают это сами при экспорте в CSV.
Начать массовый импортЗагрузите и проверьте файл
После загрузки выберите значения по умолчанию для строк с пустой колонкой (шаблон, тег и ref ID), затем проверьте файл. Posty5 читает каждую строку, ничего не создавая, и перечисляет все ошибочные строки с их номерами, считая с первой строки под заголовком. Строка не проходит, если:
- URL отсутствует, не является корректным веб-адресом или длиннее 2 048 символов
- URL заблокирован как небезопасный — так же, как и для отдельной ссылки
- название, тег или идентификатор длиннее 255 символов
- собственное окончание не разрешено вашим тарифом, некорректно или уже занято
- шаблон не существует или принадлежит не вам
Запустите импорт
Запустите импорт, когда проверка вас устроит. Он работает в фоне: страница показывает, сколько строк обработано, создано и завершилось ошибкой, и её можно закрыть — уведомление сообщит, когда импорт завершится.
Запущенный импорт можно отменить. Ссылки, созданные до отмены, остаются в вашем аккаунте.
Заголовки страниц и диплинки приложений загружаются после создания каждой ссылки, поэтому новая ссылка может недолго показывать имя хоста в качестве названия.
- Один файл — до 5 000 строк и 2 MB.
- Массово можно создать до 20 000 строк на аккаунт в сутки (UTC), с учётом всех импортов и вызовов API вместе.
- Одновременно выполняется один импорт, и ещё до трёх могут ждать в очереди.
- Если во время импорта на аккаунте закончатся кредиты, эта строка и все последующие завершатся ошибкой, а уже созданные ссылки останутся.
Скачайте результаты
Когда импорт завершится, скачайте файл с результатами. В нём по одной записи на каждую строку вашего файла: номер строки, её статус (создана, ошибка, пропущена или не обработана, если импорт остановился раньше), ID и короткий адрес новой ссылки, а также причина, если строка не прошла.
Второй файл содержит только ошибочные строки с исходными значениями, чтобы вы могли их исправить и загрузить этот файл снова.
Прошлые импорты отображаются со статусом и счётчиками, так что любой можно открыть позже и снова скачать его файлы. Загруженные файлы и файлы результатов хранятся 7 дней, а запись об импорте — 30 дней; скачайте всё нужное заранее. Сами ссылки никогда не удаляются.
Экспорт ссылок позже
- В списке коротких ссылок выберите Export CSV или Export JSON, чтобы скачать ссылки вместе со счётчиками посещений.
- Экспорт учитывает фильтры, применённые к списку, поэтому сначала отфильтруйте по тегу, чтобы выгрузить одну кампанию.
- Один экспорт — до 50 000 строк, начиная с самых новых; более длинный список обрезается на этой границе, и в файле это указано.
- Ячейка CSV, которая начинается с =, +, - или @, получает в начале апостроф, чтобы табличная программа показала её как текст, а не выполнила как формулу.
Через код
Разработчики могут сделать то же самое через API Posty5 с ключом API: POST /api/short-link/bulk создаёт до 100 строк за один запрос и возвращает по результату на каждую строку, а POST /api/link-bulk-jobs отправляет целый файл как задание, статус которого можно опрашивать. Оба способа используют те же проверки и лимиты, что и панель. Маршруты описаны в справочнике API.
Частые вопросы
Сколько URL можно импортировать за раз?
Один файл — до 5 000 строк и 2 MB, а массово можно создать до 20 000 строк на аккаунт в сутки.
Что будет со строкой с неверным URL?
Шаг проверки покажет её с номером строки и причиной ещё до создания чего-либо. Во время импорта ошибочная строка никогда не останавливает остальные.
Можно ли задать свои окончания коротких ссылок?
Да, в колонке customId, если тариф разрешает свои окончания. Каждое окончание должно быть свободным, в том числе от более ранних строк того же файла.
Как долго можно скачивать результаты?
Загруженные файлы и файлы результатов хранятся 7 дней. Сами ссылки остаются в вашем аккаунте.
Можно ли экспортировать короткие ссылки?
Да. Список коротких ссылок экспортируется в CSV или JSON со счётчиками посещений каждой ссылки, с учётом фильтров списка, до 50 000 строк в файле.
