Możesz użyć pliku CSV lub XLSX, aby zaimportować wiele produktów do Positive User za jednym razem. To praktyczny sposób na szybsze przeniesienie danych produktowych do platformy i utrzymanie porządku od samego początku. W tym artykule dowiesz się, jak poprawnie sformatować plik i przeprowadzić import bez problemów.
Jeśli chcesz dowiedzieć się więcej o produktach w Positive User, sprawdź ten artykuł.
Zanim zaczniesz, upewnij się, że Twój plik jest poprawnie skonstruowany i że rozumiesz, w jaki sposób dane są przechowywane w Positive User. Platforma korzysta zarówno z atrybutów standardowych (wbudowane pola, takie jak adres e-mail czy numer telefonu), jak i atrybutów niestandardowych (pól tworzonych przez Ciebie).
Dopasuj atrybuty standardowe: Jeśli kolumny w Twoim arkuszu odpowiadają atrybutom standardowym, możesz od razu zaimportować plik.
Utwórz atrybuty niestandardowe: Jeśli chcesz uwzględnić dodatkowe informacje, które nie są obsługiwane domyślnie, najpierw musisz utworzyć odpowiednie atrybuty niestandardowe. Postępuj zgodnie z krokami opisanymi w artykule „Jak utworzyć atrybut niestandardowy”.
Zweryfikuj typy danych: Upewnij się, że każda kolumna ma poprawny typ wartości atrybutu. Na przykład, jeśli chcesz zaimportować „Scoring”, upewnij się, że Twój atrybut jest liczbą całkowitą. Jeśli chcesz zaimportować „Datę”, ustaw atrybut jako datetime. Szczegółowe informacje o konkretnych typach danych znajdziesz w artykule „Czym jest atrybut”.
Przed przesłaniem upewnij się, że plik jest poprawnie sformatowany. Jeśli nie masz pewności, jak Twój plik powinien wyglądać, możesz pobrać gotowy do użycia szablon bezpośrednio z aplikacji, klikając przycisk „xlsx” lub „csv” w sekcji „Dane” → „Import”.
Aby znaleźć więcej wskazówek dotyczących formatowania danych, sprawdź nasz dedykowany artykuł.
Pola wymagane
Musisz posiadać unikalny identyfikator dla każdego produktu. Może to być nazwa lub Custom ID. Możesz mieć kilka produktów o tej samej nazwie, ale z różnymi custom ID.
Pole „custom_id” nigdy nie powinno być zwykłą liczbą całkowitą. Zdecydowanie zalecamy jego zakodowanie.
Nagłówki kolumn
Zawsze umieszczaj nagłówki kolumn w pierwszym wierszu pliku. Postaraj się nadać kolumnom dokładnie takie same nazwy, jakie mają istniejące atrybuty w Positive User. Jeśli nazwa kolumny jest identyczna z nazwą atrybutu, system dopasuje je automatycznie podczas importu.
Kodowanie
Czym jest kodowanie? Kodowanie mówi komputerowi, jak interpretować znaki tekstu w Twoim pliku. Domyślnym i zdecydowanie zalecanym formatem jest UTF-8. Wybór UTF-8 zapewnia poprawne zaimportowanie znaków specjalnych, akcentów i symboli bez zamiany ich na losowe znaki.
Separator
Czym jest separator? W plikach CSV (Comma Separated Values) separator to znak interpunkcyjny używany do dzielenia tekstu na poszczególne kolumny arkusza. Najczęściej spotykane separatory to przecinki (,) lub średniki (;).
Sprawdź, w jaki sposób Twój program arkusza kalkulacyjnego wyeksportował plik i upewnij się, że wiesz, jaki znak rozdziela Twoje dane.
Pola wielowartościowe
Jeśli jedna kolumna zawiera wiele wartości (na przykład „Tagi” lub dowolny atrybut typu wybór stały z dozwolonymi wieloma wartościami), oddziel je znakiem pionowej kreski: „|”
Przykład: tag1|tag2|tag3
Jeśli eksportujesz z Excela, upewnij się, że dla każdej komórki ustawiono poprawne formaty danych.
Przejdź do „Dane” → „Importery” i wybierz „Importuj produkty”.
LUB
Możesz przejść ścieżką „Dane” → „Produkty” → „Dodaj produkty” → „Importuj produkty”.
Prześlij plik lub przeciągnij go metodą drag&drop.
Wybierz kodowanie odpowiednie dla Twojego pliku. (UTF-8 jest domyślne)
Wybierz separator użyty w Twoim pliku.
Dodaj tagi, jeśli chcesz, aby zostały przypisane do produktów.
Ten krok polega na zmapowaniu nagłówków kolumn z Twojego pliku do istniejących atrybutów w Positive User.
Automatyczne dopasowanie: Jeśli nazwa kolumny w Twoim pliku jest dokładnie taka sama jak nazwa atrybutu w systemie, zostaną one dopasowane automatycznie.
Ręczne dopasowanie: W przypadku niedopasowanych kolumn po prostu wybierz odpowiedni istniejący atrybut z menu rozwijanego, aby je połączyć.
Upewnij się, że połączysz wszystkie nagłówki kolumn z atrybutami! Niedopasowane kolumny nie zostaną zaimportowane!
Gdy wszystkie kolumny z Twojego pliku zostaną dopasowane do atrybutów, kliknij „Dalej”. Zostaniesz przekierowany do kroku „Potwierdzenie”.
W kroku „Potwierdzenie” przeglądasz podsumowanie importu i potwierdzasz proces. Po potwierdzeniu system rozpoczyna przetwarzanie Twojego pliku.
Możesz monitorować proces importu i sprawdzić ostateczne wyniki w sekcji „Wyniki importu”, do której zostaniesz automatycznie przekierowany.
Możesz odwiedzić tę sekcję w dowolnym momencie, korzystając ze ścieżki „Dane” → „Importery” → „Wyniki importu”.
Tutaj zobaczysz:
Status importu (Rozpoczęty/Oczekujący/Zakończony/Zarchiwizowany)
Data utworzenia
Zakończono o
Typ (jaki rodzaj danych został zaimportowany)
Utworzone przez (członek zespołu, który przesłał plik)
Nazwa pliku
Całkowita liczba wierszy (z Twojego pliku)
Powiodło się (ostateczna liczba zaimportowanych wierszy)
Nie powiodło się (pokazuje liczbę błędów)
Jeśli podczas importu coś pójdzie nie tak, kliknij nazwę pliku, aby wyświetlić szczegółowy raport błędów.
Aby wyświetlić nowo zaimportowane profile, przejdź do „Dane” → „Produkty”. Możesz filtrować swoją bazę danych według konkretnych atrybutów lub tagu dodanego podczas importu, aby łatwo przejrzeć zaimportowane dane.
Możesz użyć tego samego procesu importu do aktualizacji istniejących produktów. Aby zaktualizować produkt, system musi rozpoznać go po atrybucie „custom_id”.
Pamiętaj, że produkty mogą być również aktualizowane za pomocą zdarzeń produktowych oraz feedu produktowego.
