Import danych historycznych
Gromadzenie wszystkich opinii klientów w jednym miejscu jest kluczowe dla pełnego zrozumienia ich potrzeb i budowania skutecznej strategii Customer Experience. Jeśli dotychczas korzystałeś z innych narzędzi do przeprowadzania ankiet (np. zewnętrznych systemów CRM, formularzy czy dedykowanych platform ankietowych) i chcesz przenieść zebrane już odpowiedzi do Customer Hero, ten dokument jest dla Ciebie.
Poniższa instrukcja krok po kroku wyjaśnia, jak odpowiednio sformatować i przygotować plik z danymi historycznymi. Dzięki prawidłowemu importowi zachowasz ciągłość analityczną, będziesz mógł śledzić trendy w czasie i zyskasz pełny wgląd w satysfakcję swoich klientów – wszystko w jednym, centralnym systemie.
Specyfikacja określa wymagania dotyczące formatu i struktury plików CSV, które mają być importowane do platformy Customer Hero. Poprawne przygotowanie pliku jest kluczowe dla zapewnienia spójności i integralności danych.
Ogólne wymagania dotyczące pliku
- Format pliku: Plik musi być w formacie CSV (Comma-Separated Values).
- Kodowanie: Wymagane kodowanie znaków to UTF-8. Zapewnia to poprawne wyświetlanie polskich znaków i symboli specjalnych.
- Separator: Domyślnym separatorem kolumn jest przecinek (
,). - Struktura:
- Pierwszy wiersz pliku musi zawierać nagłówki kolumn. Nazwy nagłówków muszą być unikalne.
- Każdy kolejny wiersz reprezentuje jedno, kompletne wypełnienie ankiety przez jednego respondenta.
Struktura i nazewnictwo kolumn
Plik importu może zawierać dwa rodzaje danych, które powinny być umieszczone w osobnych kolumnach: Wyniki Pytań oraz Atrybuty Respondenta.
Kolumny z Wynikami Pytań
Nazwy nagłówków dla pytań powinny być tworzone według spójnego schematu, aby system mógł automatycznie rozpoznać typ pytania.
Schemat nazewnictwa: [numer_pytania]-[typ_pytania]
[numer_pytania]: Identyfikator pytania w ankiecie, np.q1,q2. W przypadku pytań macierzowych, należy dodać numer podpytania, np.q5.1,q5.2.[typ_pytania]: Określa rodzaj pytania. Poniżej znajduje się lista obsługiwanych typów:
| Typ Pytania | Identyfikator | Opis i format danych |
|---|---|---|
| Pytanie otwarte | open | Odpowiedź tekstowa respondenta. Np. "Obsługa była bardzo profesjonalna." |
| Pytanie NPS | nps | Odpowiedź numeryczna w skali od 0 do 10. |
| Pytanie jednokrotnego wyboru | single | Numeryczny indeks wybranej odpowiedzi. Kafeteria jest liczona od 1. Np. 1 dla pierwszej opcji, 2 dla drugiej. |
| Pytanie wielokrotnego wyboru | multiple | Numeryczne indeksy wybranych odpowiedzi, oddzielone przecinkiem. Np. 1,3,4. |
| Pytanie macierzowe | matrix | Każda kolumna macierzy (podpytanie) to osobna kolumna w pliku. Format danych zależy od skali (np. numeryczny 1-5). |
| Pytanie typu formularz | form | Każde pole formularza to osobna kolumna, np. q14.1-form, q14.2-form. Zawartość to tekst wpisany przez użytkownika. |
Kolumny z atrybutami respondenta (Etykiety)
Są to dodatkowe informacje o respondencie lub kontekście wypełnienia ankiety, które pozwalają na zaawansowaną segmentację i filtrowanie wyników.
- Nazewnictwo: Nazwy kolumn z atrybutami powinny być zwięzłe i zrozumiałe, np.
email,data_kontaktu,opiekun_klienta,region. - Przykładowe atrybuty:
completion_date: Data wypełnienia ankiety (zalecany format: RRRR-MM-DD).email: Adres e-mail respondenta (jeśli dostępny).customer_id: Unikalny identyfikator klienta w Twoim systemie.oddzial: Nazwa oddziału lub lokalizacji.- Dowolne inne dane biznesowe pozwalające na kategoryzację wyników.
Zasady formatowania danych
- Brak odpowiedzi: Jeśli respondent nie odpowiedział na dane pytanie, komórka w pliku CSV powinna pozostać pusta. Nie należy wpisywać wartości takich jak
NULL,NAczybrak. - Logika warunkowa: Plik powinien odzwierciedlać logikę ankiety. Jeśli pytanie było wyświetlane tylko respondentom, którzy w poprzednim pytaniu udzielili określonej odpowiedzi (np. pytanie otwarte po niskiej ocenie w NPS), dane powinny pojawić się tylko w tych wierszach, które spełniają ten warunek.
- Spójność danych: Zadbaj o to, aby dane w całym wierszu były spójne. Przykładowo, jeśli respondent wystawił ocenę 10 w pytaniu NPS, jego odpowiedź w pytaniu otwartym powinna mieć pozytywny wydźwięk.
Przykładowa struktura pliku CSV
Poniżej znajduje się uproszczony przykład pliku importu dla ankiety satysfakcji.
Struktura ankiety:
q1-nps: Ocena NPS (0-10)q2-open: Uzasadnienie oceny (pytanie otwarte)q3-single: Z jakiego działu uzyskałeś pomoc? (1=Sprzedaż, 2=Wsparcie Techniczne, 3=Księgowość)- Atrybuty:
email,completion_date,opiekun_handlowy
Przykładowy plik import.csv:
q1-nps,q2-open,q3-single,email,completion_date,opiekun_handlowy
10,"Wszystko super, szybka i sprawna pomoc ze strony Pana Jana.",2,anna.kowalska@example.com,2025-10-13,Jan Nowak
8,"Ogólnie jestem zadowolony, ale czas oczekiwania na odpowiedź mógłby być krótszy.",1,tomasz.zalewski@example.com,2025-10-13,Anna Czerwińska
3,"Nikt nie rozwiązał mojego problemu, a sprawa była pilna.",2,katarzyna.lis@example.com,2025-10-12,Jan Nowak
9,"",1,piotr.wójcik@example.com,2025-10-12,Anna Czerwińska