Імпорт посилань із CSV #

Переходите з іншого скорочувача посилань або зберігаєте посилання в таблиці? Ви можете перенести їх у Revolink за один раз, завантаживши файл. Revolink прочитає файл, перевірить кожен рядок, покаже вам усі посилання до того, як щось буде створено, а потім імпортує ті, що ви залишили вибраними.

У цьому посібнику: підготовка файлу, майстер імпорту крок за кроком, правила перенаправлення й A/B-тести у файлі, домени та DNS, дублікати та способи виправити кожне повідомлення про помилку, яке може трапитися.

На цій сторінці

• Перш ніж почати
• Підтримувані файли та сервіси
• Варіант 1 — шаблон Revolink · Поля · Правила й A/B-тести · Дати · Теги
• Варіант 2 — експорт з іншого сервісу
• Запуск імпорту крок за кроком
• Одне значення для всіх посилань
• Домени та DNS
• Дублікати та вже зайняті короткі посилання
• Обмеження
• Помилки та як їх виправити
• Підготовка файлу за допомогою AI-асистента

Перш ніж почати #

• Дозвіл. Для імпорту потрібен дозвіл Імпортувати посилання. Власник робочого простору має його завжди; інші учасники отримують його від власника через роль.
• По одному. У робочому просторі одночасно може виконуватися лише один імпорт.
• Обмеження файлу. До 5000 рядків і 20 МБ на файл. Для більшого експорту розділіть його на частини й імпортуйте одну за одною.
• Обов'язкове лише одне: Цільовий URL у кожному рядку. Усе інше необов'язкове.

Підтримувані файли та сервіси #

Типи файлів: .csv, .tsv і .json. Файли Excel (.xls, .xlsx) не підтримуються: в Excel спершу збережіть файл як CSV. Файл .json має бути масивом об'єктів, по одному об'єкту на посилання.

Сервіси, які розпізнає Revolink. Для експорту з цих сервісів стовпці зіставляються автоматично, тож файл можна завантажити як є:

Будь-який інший файл теж підійде: ви самі зіставляєте його стовпці на кроці Стовпці (Revolink пропонує відповідність, і ви можете її виправити).

Варіант 1 — шаблон Revolink #

Якщо ви переходите не з іншого сервісу або складаєте список вручну, почніть із шаблону.

Завантажити CSV-шаблон

Його також можна завантажити на першому кроці імпорту (Переходите не з іншого сервісу? Завантажте CSV-шаблон Revolink). У файлі шаблону є два заповнені приклади рядків: один із правилами перенаправлення, інший з A/B-тестом. Його рядок заголовків:

title,destination_url,short_link,domain,tags,created_at,expiration_date,clicks,rules,ab_test,routing_mode

Рядок без правил чи A/B-тесту виглядає так (останні три клітинки порожні):

Spring campaign,https://acme.inc/spring-sale?utm_source=email&utm_medium=newsletter&utm_campaign=spring,spring-sale,acme.inc,marketing;email;spring,2026-03-01,2026-12-31,1250,,,

Замініть приклади своїми посиланнями, по одному посиланню на рядок, а рядок заголовків залиште точно таким, як він є. Коли заголовки збігаються з шаблоном, Revolink сам зіставляє стовпці, і ви можете одразу пройти крок Стовпці.

Поля #

Це 11 полів, які можна заповнити з вашого файлу. На кроці Стовпці будь-який стовпець файлу може заповнювати будь-яке поле; у шаблоні Revolink стовпці названо так, як у першій колонці нижче.

Правила короткого посилання.

• Дозволено: літери A–Z / a–z, цифри та дефіси. Великі й малі літери різні: Promo і promo це два різні посилання.
• Дефіси мають бути одиничними й стояти між іншими символами: spring-sale підходить; spring--sale, -spring і spring- ні. Підкреслення не дозволені.
• Пробіли в значенні замінюються дефісами.
• Можна вставити повне коротке посилання, наприклад bit.ly/spring чи https://rebrand.ly/promo. Revolink бере останню частину шляху як коротке посилання, а хост як домен.

Правила й A/B-тести #

Посилання, імпортоване без цих стовпців, отримує одне правило за замовчуванням, яке відправляє кожного відвідувача на destination_url. Щоб перенести правила перенаправлення чи A/B-тест, заповніть клітинку Правила перенаправлення (rules) або A/B-тест (ab_test) цього посилання. Обидві необов'язкові; для посилань, яким вони не потрібні, залиште клітинку порожньою.

Кожна з двох клітинок містить текст JSON.

• Коли складаєте файл вручну, візьміть усю клітинку в подвійні лапки, а кожну " усередині неї пишіть двічі (""). Табличні програми роблять це за вас при збереженні в CSV, але JSON, набраний у клітинці, найлегше перевірити в текстовому редакторі.
• Якщо писати JSON не хочеться, AI-асистент може підготувати клітинки з даних вашого старого сервісу.
• Якщо ваші стовпці називаються не rules, ab_test і routing_mode, зіставте їх вручну на кроці Стовпці.

rules — правила перенаправлення #

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

• Не додавайте основне правило. Основне правило (адреса за замовчуванням) створюється з destination_url і використовується для всіх, хто не підійшов під жодне правило. Правило без жодної умови імпортувати не можна.
• Правила перевіряються зверху вниз, і перемагає перше, усі умови якого збігаються. Ставте точніші правила першими.
• Ключі id та isDefault ігноруються.
• У межах одного правила мають збігатися всі умови; у межах однієї умови достатньо збігу будь-якого з перелічених значень. "country":["UA","DE"],"device":["mobile"] означає мобільних відвідувачів з України або Німеччини.

Значення device, os і browser чутливі до регістру: iOS, а не ios; mobile, а не Mobile.

По одному прикладу на кожну умову (JSON таким, яким ви бачили б його в текстовому редакторі, без лапок CSV):

[
  { "name": "Ukraine", "targetUrl": "https://acme.inc/ua", "country": ["UA"] },
  { "name": "DACH", "targetUrl": "https://acme.inc/dach", "country": ["DE", "AT", "CH"] },
  { "name": "California", "targetUrl": "https://acme.inc/us-ca", "country": ["US"], "region": ["California"] },
  { "name": "Kyiv", "targetUrl": "https://acme.inc/kyiv", "country": ["UA"], "city": ["Kyiv"] }
]

[
  { "name": "Phones", "targetUrl": "https://acme.inc/m", "device": ["mobile"] },
  { "name": "Tablets and consoles", "targetUrl": "https://acme.inc/big", "device": ["tablet", "console"] },
  { "name": "Apple mobile", "targetUrl": "https://acme.inc/ios", "os": ["iOS"] },
  { "name": "Desktop Windows or Linux", "targetUrl": "https://acme.inc/pc", "os": ["Windows", "Linux"] },
  { "name": "Safari and Edge", "targetUrl": "https://acme.inc/browsers", "browser": ["Safari", "Edge"] }
]

[
  { "name": "Evenings", "targetUrl": "https://acme.inc/evening", "timeStart": "18:00", "timeEnd": "23:00" },
  { "name": "Weekend", "targetUrl": "https://acme.inc/weekend", "daysOfWeek": [6, 0] },
  { "name": "Friday evenings", "targetUrl": "https://acme.inc/fri", "timeStart": "17:00", "timeEnd": "23:59", "daysOfWeek": [5] }
]

[
  {
    "name": "Germany evenings on Chrome or Safari",
    "targetUrl": "https://acme.inc/de",
    "country": ["DE"],
    "browser": ["Chrome", "Safari"],
    "timeStart": "18:00",
    "timeEnd": "23:00",
    "daysOfWeek": [5, 6, 0]
  },
  { "name": "Ukrainian speakers", "targetUrl": "https://acme.inc/uk", "locale": ["uk"] }
]

Ті самі два правила з першого прикладу, як вони записуються в клітинці CSV:

"[{""name"":""Ukraine mobile"",""targetUrl"":""https://acme.inc/ua-mobile"",""country"":[""UA""],""device"":[""mobile""]},{""name"":""Germany"",""targetUrl"":""https://acme.inc/de"",""country"":[""DE""]}]"

ab_test — спліт-тест #

Список із щонайменше двох варіантів у форматі JSON. Кожен має url (коректна веб-адреса) і weight (додатне число). Ваги мають у сумі давати рівно 100.

[
  { "url": "https://acme.inc/spring-sale-a", "weight": 50 },
  { "url": "https://acme.inc/spring-sale-b", "weight": 50 }
]

Три варіанти й нерівні частки:

[
  { "url": "https://acme.inc/a", "weight": 34 },
  { "url": "https://acme.inc/b", "weight": 33 },
  { "url": "https://acme.inc/c", "weight": 33 }
]

Як клітинка CSV:

"[{""url"":""https://acme.inc/spring-sale-a"",""weight"":50},{""url"":""https://acme.inc/spring-sale-b"",""weight"":50}]"

Тест вмикається автоматично, коли заповнено лише одну з двох клітинок. destination_url також залишайте заповненим: вказуйте адресу вашого основного варіанта.

Повний файл із правилами, A/B-тестом і режимом маршрутизації #

Перше посилання використовує правила, друге A/B-тест, у третього заповнено обидві клітинки й порожній routing_mode (майстер запитає), у четвертого немає жодної:

title,destination_url,short_link,domain,tags,created_at,expiration_date,clicks,rules,ab_test,routing_mode
Spring campaign,https://acme.inc/spring,spring,acme.inc,marketing,2026-03-01,2027-12-31,1250,"[{""name"":""Ukraine"",""targetUrl"":""https://acme.inc/ua"",""country"":[""UA""]}]","[{""url"":""https://acme.inc/spring-a"",""weight"":50},{""url"":""https://acme.inc/spring-b"",""weight"":50}]",rules
Summer webinar,https://acme.inc/webinar,webinar,acme.inc,events,2026-05-15,,480,,"[{""url"":""https://acme.inc/webinar-a"",""weight"":70},{""url"":""https://acme.inc/webinar-b"",""weight"":30}]",
Autumn sale,https://acme.inc/autumn,autumn,acme.inc,marketing,,,0,"[{""name"":""Mobile"",""targetUrl"":""https://acme.inc/m"",""device"":[""mobile""]}]","[{""url"":""https://acme.inc/autumn-a"",""weight"":60},{""url"":""https://acme.inc/autumn-b"",""weight"":40}]",
Winter promo,https://acme.inc/winter,winter,acme.inc,,,,,,,

Правила чи A/B-тест для одного посилання #

Якщо в посилання заповнено обидві клітинки, активною може бути лише одна. Скажіть Revolink, яка саме, у стовпці Режим маршрутизації (routing_mode): rules або ab_test. Регістр, пробіли й дефіси не мають значення (AB-Test працює).

Залиште його порожнім, і Revolink запитає вас сам. На кроці Посилання рядок позначено Оберіть одне і не вибрано (це не помилка). Натисніть Використовувати A/B-тест або Використовувати правила перенаправлення для цього рядка, або скористайтеся кнопками над списком, щоб вирішити всі такі рядки одразу. Можна також змінити вибір, зроблений у файлі (Натомість використовувати A/B-тест / Натомість використовувати правила перенаправлення); ваш вибір у майстрі важливіший за routing_mode. Нічого не вгадується: рядок, щодо якого ніхто не вирішив, не імпортується і з'являється у файлі помилок як «Заповнено і правила, і A/B-тест, але жоден із них не обрано.»

Нічого не втрачається: варіант, який ви не вибрали, зберігається в посиланні, але лишається неактивним. Якщо ви вибрали правила, A/B-варіанти зберігаються з вимкненим тестом, і ви можете ввімкнути його в редакторі посилання, якщо тариф дозволяє A/B-тести. Якщо ви вибрали A/B-тест, правила зберігаються, але не працюють, поки тест увімкнено.

routing_mode має бути rules або ab_test (див. помилку вкажіть «rules» або «ab_test»). Якщо заповнено лише одну з двох клітинок, залиште routing_mode порожнім.

Можна також задати один режим маршрутизації для всього імпорту, див. Одне значення для всіх посилань.

Ліміти тарифу #

Діють ті самі ліміти тарифу, що й під час ручного створення посилання. Правило за замовчуванням входить у ліміт правил на посилання, тож на тарифі Free (2 правила на посилання) можна імпортувати 1 правило маршрутизації на посилання, на Starter (10) до 9, на Pro (50) до 49; Agency та Business обмежень не мають. A/B-тести потребують тарифу Pro або вище.

Якщо ви імпортуєте багато посилань, крок План показує, що потрібно файлу: він рахує найбільшу кількість правил в одному посиланні (з правилом за замовчуванням) і найбільшу кількість A/B-варіантів в одному посиланні, а не загальну суму по файлу.

Дати #

Для created_at і expiration_date працюють ті самі формати:

Найнадійніший формат YYYY-MM-DD. Для значень на кшталт 03/04/2026, які можна прочитати двома способами, Revolink вирішує між «день-місяць» і «місяць-день» за всім файлом і повідомляє, що обрав; якщо це неправильно, скористайтеся Змінити стовпці або перепишіть дати як YYYY-MM-DD.

• Дата створення, яку не вдалося прочитати, ігнорується: посилання все одно імпортується, лише без неї.
• Дата завершення терміну дії, що не є коректною датою, робить рядок недійсним («Дата завершення терміну дії не є коректною датою, тому посилання не можна створити.»).
• Дата завершення терміну дії в минулому також робить рядок недійсним: не можна створити посилання з датою завершення, яка вже минула. Такі рядки не імпортуються як прострочені посилання. Виправте дату або очистьте її й імпортуйте знову.

Теги #

• Усі теги посилання вказуйте в одній клітинці. Роздільники: кома, крапка з комою, | або новий рядок.
• Початковий # відкидається, зайві пробіли згортаються, а повторювані теги (в будь-якому регістрі) враховуються один раз.
• Тег обмежений 50 символами; довший тег обрізається.
• Теги, яких немає в робочому просторі, створюються. У вашого тарифу є ліміт тегів: теги понад нього не створюються, посилання імпортуються без них, а екран результату повідомляє, скільки їх було.

Варіант 2 — експорт з іншого сервісу #

Завантажте експорт зі свого попереднього скорочувача посилань як є, перетворювати його не потрібно. Revolink розпізнає структуру експортів Bitly, Short.io, Rebrandly, Dub, TinyURL і t.ly та автоматично зіставляє їхні стовпці.

Для будь-якого іншого файлу Revolink підбирає відповідність у такому порядку:

1. Відома структура. Назви заголовків збігаються з одним із сервісів вище або з шаблоном Revolink.
2. Запам'ятована відповідність. Якщо ви вже імпортували файл із такими самими заголовками, використовується відповідність, яку ви застосовували.
3. Підказка AI для файлів, яких він не знає.

Що б не було вибрано, ви можете перевірити й змінити це на кроці Стовпці. Домени старого сервісу (bit.ly тощо) не можуть переїхати разом із посиланнями, див. Домени та DNS.

Запуск імпорту крок за кроком #

Відкрийте Налаштування робочого простору → Імпорти і натисніть Новий імпорт. У майстра такі кроки: Файл → Стовпці → Домени → Теги → Посилання → План → DNS → Готово. Стовпці, Посилання і Готово є завжди. Домени, Теги, План і DNS з'являються лише тоді, коли їх потребує ваш файл. Кнопка Назад на будь-якому з наступних кроків повертає до Стовпців.

1. Файл. Перетягніть файл (або шаблон) в область завантаження. Revolink перевірить тип, розмір і кількість рядків та покаже, що знайшов. Проблеми з самим файлом перелічено в розділі Помилки.
2. Стовпці. Перевірте, який стовпець вашого файлу заповнює кожне з 11 полів (див. Поля). У кожного вибору є пошук за назвами ваших стовпців. Обов'язковий лише Цільовий URL; поле зі значенням Не імпортувати пропускається. Для Режиму маршрутизації, Тегів, Домену та Дати завершення терміну дії можна також ввести одне значення для всіх посилань, див. Одне значення для всіх посилань. Коли ви натискаєте Продовжити, Revolink повністю перевіряє кожну непорожню клітинку стовпців Правила перенаправлення, A/B-тест і Режим маршрутизації й показує всі проблеми одразу, по одному сповіщенню на проблему. Виправте їх у файлі (або змініть відповідність) і завантажте знову, або продовжуйте з рядками, що в порядку. Див. Помилки зіставлення.
3. Домени. З'являється, коли файл використовує домени, не налаштовані у вашому робочому просторі. Див. Домени та DNS.
4. Теги. З'являється лише тоді, коли імпорт створить принаймні один тег, якого ще немає у вашому робочому просторі (Як мають виглядати ваші нові теги?). Оберіть колір та іконку для кожного нового тега; у списку видно кожен новий тег і скільки з вибраних посилань його мають. Теги, які вже є, зберігають свій вигляд і в списку не показуються. Вигляд можна змінити пізніше в розділі Теги. Ліміти дивіться в розділі Теги.
5. Посилання. Перегляньте список. Кожен рядок позначено Готово, Коротке посилання зайняте, Уже імпортовано, Оберіть одне або Недійсне (червоним, із причиною), і його можна шукати та фільтрувати. Зніміть позначку з будь-якого посилання, яке не хочете переносити. Скористайтеся Введіть посилання, щоб виправити адресу, яку не вдалося прочитати. Причини пояснено в розділі Помилки рядків.
6. План. З'являється лише тоді, коли вибрані посилання потребують більше, ніж дозволяє ваш поточний тариф (Для вашого імпорту потрібен план …). Одна картка на кожен ліміт: Посилання, Власні домени, Теги, Правил на посилання, Варіанти A/B-тесту. Вона порівнює потрібне з вашим тарифом і позначена Підходить або Не вистачає. Оберіть Отримати …, щоб оновити тариф, або зменште потребу через Назад до вибору посилань, Змінити мій вибір чи Змінити домени. Якщо ви оберете Не зараз, одразу імпортується лише частина посилань; решта чекає кілька годин і імпортується автоматично, якщо ви оновите тариф за цей час, а потім відкидається.
7. DNS. З'являється, коли ви залишаєте власні домени, які ще не підтверджені. Додайте показані там DNS-записи. Див. Домени та DNS.
8. Готово. Натисніть Імпортувати посилань: N (N це кількість вибраних вами), і Revolink створить посилання. Вкладку можна закрити: імпорт триває, а посилання з'являться у вашому списку посилань. Екран результату перелічує рядки, які не були імпортовані; див. Помилки.

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

Одне значення для всіх посилань #

Іноді кожному посиланню файлу потрібне одне й те саме значення, а стовпця для нього немає. Для Режиму маршрутизації, Тегів, Домену та Дати завершення терміну дії це значення можна ввести прямо у вибір на кроці Стовпці:

1. Натисніть на вибір і введіть значення, наприклад go.acme.inc.
2. Оберіть пункт Використовувати «go.acme.inc» для всіх посилань.
3. Під вибором з'явиться жовта примітка: Це значення буде застосовано до всіх посилань в цьому імпорті: N.

Значення обрізається по краях, а потім читається так само, як стовпець:

Якщо значення неправильне, Продовжити покаже Значення «xyz», яке ви ввели для поля «(назва поля)», некоректне: (причина), і далі нічого не відбудеться. Причини: це має бути назва домену, наприклад go.example.com, це має бути дата, наприклад 2027-01-01, це має бути дата в майбутньому, вкажіть «rules» або «ab_test».

Поля, у яких для кожного посилання різне значення: Цільовий URL, Коротке посилання, Назва, Минулі кліки, Дата створення, Правила перенаправлення та A/B-тест, таким способом заповнити не можна.

Домени та DNS #

Стовпець domain (або значення, яке ви ввели для всіх посилань) повідомляє Revolink, на якому домені має жити кожне коротке посилання.

• Порожній домен: посилання створюється на rvlnk.link.
• Домен, який у вас уже є в робочому просторі й підтверджений: посилання створюється на цьому домені.
• Домен, що ще не налаштований: за замовчуванням посилання переходять на rvlnk.link. На кроці Домени можна натомість залишити домен або замінити його іншим, що вам належить. Якщо залишити, крок DNS покаже запис, який треба додати у вашого DNS-провайдера, щоб Revolink міг підтвердити домен. Посилання на домені, що ще підтверджується, імпортуються автоматично, щойно підтвердження завершиться.
• Власний домен попереднього сервісу (наприклад, bit.ly, rebrand.ly, tinyurl.com) переїхати з вами не може, тому такі посилання потрапляють на rvlnk.link або на домен, що вам належить.

Екран результату показує, скільки посилань було розміщено на rvlnk.link, бо їхній початковий домен не налаштований. Власні домени враховуються в ліміті доменів вашого тарифу; крок План його показує.

Дублікати та вже зайняті короткі посилання #

• Уже імпортовано. Revolink пам'ятає, які посилання прийшли з імпорту. Рядок, ідентифікатор якого (домен + коротке посилання, або цільовий URL, коли короткого посилання немає) уже є в робочому просторі з того самого сервісу, оновлює наявне посилання, а не створює другу копію. Перезаписуються лише його назва та адреса основного правила; правила й A/B-тести лишаються як є. Зніміть позначку з таких рядків, якщо хочете залишити посилання без змін.
• Коротке посилання зайняте. Якщо коротке посилання, яке ви просили, уже використовує інше посилання на цьому домені, рядок позначається Коротке посилання зайняте й не вибирається. Залиште його невибраним, щоб пропустити, або виберіть навмисно: тоді посилання створюється зі згенерованим коротким посиланням, а оригінал зберігається в даних імпорту посилання.
• Два рядки з однаковим коротким посиланням в одному файлі вважаються одним посиланням. Якщо вам потрібно кілька посилань на одну сторінку, дайте кожному різне коротке посилання.

Обмеження #

Помилки та як їх виправити #

Проблеми виявляються в трьох місцях: коли ви перетягуєте файл, коли натискаєте Продовжити на кроці Стовпці, і на кроці Посилання, де проблемний рядок червоний із причиною. Те, що в кінці все ще не імпортовано, перелічено на екрані результату в розділі Рядки, які не було імпортовано. Натисніть Завантажити помилки (CSV), щоб зберегти список. У файлі два стовпці:

Виправте ці рядки у файлі й імпортуйте його знову. Посилання, що вже існують, оновлюються, а не дублюються, тож цілий файл можна безпечно завантажувати повторно. Повідомлення показуються мовою вашого інтерфейсу; нижче вони наведені українською, так, як їх показує застосунок.

Помилки файлу #

Помилки зіставлення #

Показуються на кроці Стовпці після Продовжити, по одному сповіщенню на проблему, усі одразу. Їхній вигляд:

Стовпець «X» не можна використати для поля «Правила перенаправлення / A/B-тест / Режим маршрутизації» (рядок N): причина

Сповіщення для Правил перенаправлення та A/B-тесту завершуються посиланням Дивіться посібник з імпорту, що веде до розділу Правила й A/B-тести. Номер рядка це рядок у вашому файлі, де перший рядок даних має номер 1.

Причини для будь-якого з двох стовпців (Правила перенаправлення, A/B-тест):

Режим маршрутизації:

A/B-тест:

Правила перенаправлення (правило N це позиція в списку, починаючи з 1):

Інші сповіщення на кроці «Стовпці»:

Помилки рядків #

На кроці Посилання проблемний рядок червоний (Недійсне) з однією з цих причин, і той самий текст потрапляє у файл помилок.

Інші причини, через які посилання може не створитися: досягнуто ліміту посилань тарифу (решта посилань чекає обмежений час: оновіть тариф у цьому вікні, і вони імпортуються автоматично), або правило чи A/B-тест виходить за межі того, що дозволяє ваш тариф.

Підготовка файлу за допомогою AI-асистента #

Якщо ваш експорт має незвичну структуру, AI-асистент може перетворити його на шаблон за вас. Дайте йому інструкції з import-csv-agent-instructions.md (англійською) разом зі своїм експортом, а потім завантажте файл, який він створить.