Массовый импорт ссылок из CSV

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

Формат CSV#

Импортёр ожидает файл с разделителем-запятой и строкой заголовка. Единственный обязательный столбец — destination. Всё остальное опционально.

destination,slug,title,tags
https://acme.com/spring-sale,spring-2026,Spring Sale 2026,campaign:spring
https://acme.com/about,,About Us,
https://acme.com/contact,contact-us,,support:contact

Правила для столбцов:

• destination (обязательный) — полный URL, включая https://. URL без схемы отклоняются.
• slug (опциональный) — кастомный короткий слаг. Только буквы, цифры и дефисы. Если пустой, генерируем случайный 6-символьный код.
• title (опциональный) — читаемая метка, отображаемая в списке ссылок.
• tags (опциональный) — один или несколько тегов, разделённых двоеточием или точкой с запятой. Теги создаются автоматически, если не существуют.

Порядок столбцов не важен, главное чтобы имена заголовков совпадали. Лишние столбцы игнорируются.

Запуск импорта#

1. Перейди в Tools → Bulk import (или нажми кнопку импорта из Links).
2. Загрузи CSV-файл. Импортёр парсит его и показывает таблицу предпросмотра.
3. Проверь предпросмотр. Любая строка с ошибкой выделена — наведи на иконку ошибки, чтобы увидеть что не так.
4. Нажми Import, чтобы записать корректные строки. Строки с ошибками пропускаются.

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

Ограничение в 50 000 ссылок#

Каждый запуск импорта ограничен 50 000 строк. Если файл больше, раздели его на несколько файлов и запускай последовательно. Дневных ограничений на количество запусков импорта нет.

Дедупликация#

Импортёр проверяет слаги на совпадение с существующими ссылками. Если слаг строки уже существует в воркспейсе:

• Строка пропускается с ошибкой («slug already taken»).
• Существующая ссылка не изменяется.

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

При повторном импорте частично обработанного файла импортёр идемпотентен для строк с пустым слагом (каждый запуск создаёт новые ссылки с новыми кодами). Для явных слагов успешными будут только строки со слагами, которых ещё нет в воркспейсе.

Типичные ошибки импорта и их исправление#

«Invalid URL» — у назначения нет схемы (https://) или оно содержит недопустимые символы. Исправь ячейку в таблице и перезагрузи файл.

«Slug already taken» — ссылка с таким слагом уже существует. Либо удали слаг, чтобы получить автоматически сгенерированный, либо измени на уникальный.

«Slug contains invalid characters» — слаги могут содержать только буквы (a-z, A-Z), цифры (0-9) и дефисы (-). Пробелы, подчёркивания и точки не допускаются.

«File too large» — файл превышает лимит в 50 000 строк. Раздели его и импортируй пакетами.

«Destination blocked» — наш URL-сканер пометил назначение как вредоносное или относящееся к заблокированной категории. Если считаешь, что это ложное срабатывание, свяжись с поддержкой с указанием URL.

Устранение неполадок#

Импорт завершился, но некоторые строки отсутствуют. Скачай отчёт об импорте — ссылка появляется в итогах импорта. Отчёт показывает, какие строки были пропущены и почему. Большинство пропусков — это дублирующиеся слаги или недопустимые URL.

Импортёр говорит, что файл повреждён. Убедись, что файл действительно CSV (не TSV или Excel .xlsx). Открой его в текстовом редакторе и убедись, что разделителем являются запятые, а строка заголовка присутствует.

Импорт завис на «processing». Большие импорты (десятки тысяч строк) могут занять несколько минут. Обнови страницу для проверки текущего состояния. Если завис более 10 минут, свяжись с поддержкой, указав ID импорта из URL.