Масовий імпорт посилань з 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 (необов'язково) — власний короткий slug. Тільки літери, цифри та дефіси. Якщо поле порожнє, ми генеруємо випадковий 6-символьний код.
• title (необов'язково) — зрозуміла людині мітка, що відображається у списку посилань.
• tags (необов'язково) — один або кілька тегів, розділених двокрапками або крапками з комою. Теги створюються автоматично, якщо вони не існують.

Порядок стовпців не має значення, якщо назви заголовків збігаються. Додаткові стовпці ігноруються.

Початок імпорту#

1. Перейдіть до Інструменти → Масовий імпорт (або натисніть кнопку імпорту зі Посилання).
2. Завантажте свій CSV файл. Імпортер розбирає його та показує таблицю попереднього перегляду.
3. Перегляньте попередній перегляд. Будь-який рядок з помилкою виділяється — наведіть курсор на іконку помилки, щоб побачити, що не так.
4. Натисніть Імпорт, щоб записати дійсні рядки. Рядки з помилками пропускаються.

Імпорт виконується у фоновому режимі. Для великих файлів індикатор прогресу показує, скільки рядків було оброблено. Ви отримаєте підсумковий лист, коли він буде завершений.

Ліміт у 50 000 посилань#

Кожен запуск імпорту обмежений 50 000 рядками. Якщо ваш файл більший, розділіть його на кілька файлів і запустіть їх послідовно. Щоденного ліміту на кількість запусків імпорту немає.

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

Імпортер перевіряє slugs на відповідність існуючим посиланням. Якщо slug рядка вже існує в робочому просторі:

• Рядок пропускається з помилкою («slug вже зайнято»).
• Існуюче посилання не змінюється.

Якщо стовпець slug порожній, ми завжди генеруємо новий унікальний код, тому рядки з порожнім slug ніколи не конфліктують.

Якщо ви повторно імпортуєте файл, який ви вже частково обробляли раніше, імпортер є ідемпотентним для рядків з порожніми slug (кожен запуск створює нові посилання з новими кодами). Для явних slug, лише рядки з slug, які ще не існують у робочому просторі, будуть успішними.

Поширені помилки імпорту та їх виправлення#

«Недійсний URL» — цільовий URL не містить схеми (https://) або містить символи, які не є дійсними для URL. Виправте клітинку в електронній таблиці та завантажте знову.

«Slug вже зайнято» — посилання з таким slug вже існує. Або видаліть slug, щоб отримати автогенерований, або змініть його на щось унікальне.

«Slug містить неприпустимі символи» — slugs можуть містити лише літери (a-z, A-Z), цифри (0-9) та дефіси (-). Пробіли, підкреслення та крапки не допускаються.

«Файл занадто великий» — файл перевищує ліміт у 50 000 рядків. Розділіть його та імпортуйте партіями.

«Ціль заблокована» — наш сканер URL позначив ціль як шкідливу або таку, що належить до заблокованої категорії. Якщо ви вважаєте, що це помилкове спрацювання, зв'яжіться зі службою підтримки, надавши URL.

Усунення несправностей#

Мій імпорт завершився, але деякі рядки відсутні. Завантажте звіт про імпорт — посилання з'являється у підсумку імпорту. Звіт показує, які рядки були пропущені та чому. Більшість пропусків – це повторювані slugs або недійсні URL-адреси.

Імпортер повідомляє, що файл пошкоджений. Переконайтеся, що файл справді є CSV (а не TSV чи Excel .xlsx). Відкрийте його в текстовому редакторі та переконайтеся, що кома є роздільником і присутній заголовковий рядок.

Імпорт завис на етапі «обробка». Великі імпорти (десятки тисяч рядків) можуть зайняти кілька хвилин. Оновіть сторінку, щоб перевірити поточний статус. Якщо він все ще завис після 10 хвилин, зв'яжіться зі службою підтримки, вказавши ID імпорту, показаний в URL.