Import linków zbiorczy z CSV

Jeśli masz arkusz kalkulacyjny z docelowymi URL-ami, które chcesz skrócić wszystkie naraz — migrując z innego narzędzia, uruchamiając kampanię lub zasilając nowy workspace — importer zbiorczy to właściwa droga. Wyświetla podgląd błędów przed zatwierdzeniem czegokolwiek, więc możesz naprawić problemy bez częściowych importów.

Format CSV#

Importer oczekuje pliku oddzielanego przecinkami z wierszem nagłówka. Jedyną wymaganą kolumną jest destination. Wszystko inne jest opcjonalne.

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

Zasady kolumn:

• destination (wymagana) — pełny URL wraz z https://. URL-e bez schematu są odrzucane.
• slug (opcjonalny) — niestandardowy krótki slug. Tylko litery, cyfry i myślniki. Jeśli pusty, generujemy losowy 6-znakowy kod.
• title (opcjonalny) — czytelna etykieta widoczna na liście linków.
• tags (opcjonalne) — jeden lub więcej tagów oddzielonych dwukropkami lub średnikami. Tagi są tworzone automatycznie jeśli nie istnieją.

Kolejność kolumn nie ma znaczenia o ile nazwy nagłówków się zgadzają. Dodatkowe kolumny są ignorowane.

Uruchom import#

1. Przejdź do Narzędzia → Import zbiorczy (lub kliknij przycisk importu z Linki).
2. Prześlij plik CSV. Importer analizuje go i pokazuje tabelę podglądu.
3. Przejrzyj podgląd. Wiersze z błędami są wyróżnione — najedź na ikonę błędu, aby zobaczyć co jest nie tak.
4. Kliknij Importuj, aby zapisać prawidłowe wiersze. Wiersze z błędami są pomijane.

Import działa w tle. Dla dużych plików wskaźnik postępu pokazuje ile wierszy zostało przetworzonych. Otrzymasz e-mail ze podsumowaniem gdy się skończy.

Limit 50 000 linków#

Każde uruchomienie importu jest ograniczone do 50 000 wierszy. Jeśli plik jest większy, podziel go na wiele plików i uruchamiaj je sekwencyjnie. Nie ma dziennego limitu uruchomień importu.

Deduplikacja#

Importer sprawdza slugi względem istniejących linków. Jeśli slug wiersza już istnieje w workspace:

• Wiersz jest pomijany z błędem ("slug already taken").
• Istniejący link nie jest modyfikowany.

Jeśli kolumna slug jest pusta, zawsze generujemy nowy unikalny kod, więc wiersze z pustym slugiem nigdy nie powodują konfliktów.

Jeśli reimportujesz plik, który częściowo przetworzyłeś wcześniej, importer jest idempotentny dla wierszy z pustym slugiem (każde uruchomienie tworzy nowe linki z nowymi kodami). Dla jawnych slugów powiedzie się tylko wiersze ze slugami, które jeszcze nie istnieją w workspace.

Częste błędy importu i naprawy#

"Invalid URL" — miejsce docelowe nie zawiera schematu (https://) lub zawiera znaki nieprawidłowe w URL. Napraw komórkę w arkuszu kalkulacyjnym i prześlij ponownie.

"Slug already taken" — link z tym slugiem już istnieje. Usuń slug, aby otrzymać auto-generowany, lub zmień go na coś unikalnego.

"Slug contains invalid characters" — slugi mogą zawierać tylko litery (a-z, A-Z), cyfry (0-9) i myślniki (-). Spacje, podkreślenia i kropki nie są dozwolone.

"File too large" — plik przekracza limit 50 000 wierszy. Podziel go i importuj partiami.

"Destination blocked" — nasz skaner URL oflagował miejsce docelowe jako złośliwe lub w zablokowanej kategorii. Jeśli uważasz, że to fałszywy alarm, skontaktuj się z pomocą techniczną z URL-em.

Rozwiązywanie problemów#

Import zakończony, ale brakuje niektórych wierszy. Pobierz raport importu — link pojawia się w podsumowaniu importu. Raport pokazuje które wiersze zostały pominięte i dlaczego. Większość pominięć to zduplikowane slugi lub nieprawidłowe URL-e.

Importer mówi, że plik jest zniekształcony. Upewnij się, że plik jest faktycznie CSV (nie TSV ani Excel .xlsx). Otwórz go w edytorze tekstu i potwierdź, że przecinki są separatorem i wiersz nagłówka jest obecny.

Import utknął na "processing". Duże importy (dziesiątki tysięcy wierszy) mogą zająć kilka minut. Odśwież stronę, aby sprawdzić bieżący stan. Jeśli nadal utknął po 10 minutach, skontaktuj się z pomocą techniczną z ID importu widocznym w URL.