Jak zarządzać tłumaczeniami zbiorczo za pomocą pliku CSV
Aby korzystać z tej funkcji, musisz mieć płatne konto Klaviyo i włączone Inteligentne tłumaczenie.
Zarządzaj tłumaczeniami poza Klaviyo, eksportując i edytując plik CSV, a następnie importując go ponownie, aby zbiorczo zaktualizować tłumaczenia lub współpracować z innymi.
Wyeksportuj plik CSV z tłumaczeniami
Wykonaj te kroki, aby wyeksportować bieżące tłumaczenia dla jednej wiadomości:
- Otwórz wiadomość, którą chcesz zaktualizować (e-mail kampanii, e-mail w sekwencji, SMS, wiadomość WhatsApp itp.).
- Kliknij ikonę lub przycisk Tłumacz w wiadomości albo przycisk pokazujący liczbę tłumaczeń, aby otworzyć edytor tłumaczeń. Jeśli wiadomość nie została jeszcze przetłumaczona, najpierw dokończ konfigurację języka.
- W edytorze tłumaczeń otwórz menu działań z trzema kropkami i kliknij Eksportuj.
- W sekcji Wybierz format eksportu wybierz CSV. Pozostaw zaznaczoną opcję Zgodny z Smartling, jeśli wyślesz plik do Smartling, lub odznacz ją, aby edytować standardowy plik CSV w arkuszu kalkulacyjnym.
- W sekcji Języki do wyeksportowania wybierz Zaznacz wszystko, aby uwzględnić wszystkie istniejące języki tłumaczeń, lub Wybór niestandardowy, aby wybrać konkretne języki. Aby wyeksportować dla tłumacza tylko tekst źródłowy, wybierz opcję tylko dla języka źródłowego. Język źródłowy jest uwzględniany w każdym eksporcie.
- Kliknij Eksportuj, aby pobrać plik CSV.
Smartling CSV
Plik CSV kompatybilny ze Smartling zawiera:
Dyrektywy Smartling na początku pliku, w tym:
# smartling.first_row_header=TRUE
# smartling.paths=2
# smartling.source_key_paths=1
# smartling.translations_in_columns=TRUE
- block_id – unikalny identyfikator dla każdego tłumaczalnego ciągu znaków w tej wiadomości.
- Kod języka źródłowego (np. en) – oryginalny tekst źródłowy dla tego ciągu.
- Kolumny językowe dla wybranych przez Ciebie języków tłumaczenia, jeśli takie są.
Możesz użyć tego pliku w obecnej postaci, aby zaimportować swoje ciągi do Smartling. Smartling automatycznie analizuje plik CSV, wyodrębnia ciągi i umożliwia uruchamianie zadań tłumaczeniowych.
Po zakończeniu zadania pobierz przetłumaczony plik CSV. Przed zaimportowaniem go do Klaviyo usuń wszystkie początkowe wiersze dyrektyw # smartling., aby pierwszy wiersz zawierał nagłówki kolumn. Zachowaj kolumnę block_id, kolumnę języka źródłowego oraz co najmniej 1 obsługiwaną kolumnę języka tłumaczenia. Następnie postępuj zgodnie z instrukcją Importowanie pliku CSV poniżej.
Standard CSV
Standardowy plik CSV zawiera:
- block_id – unikalny identyfikator dla każdego tłumaczalnego ciągu znaków w tej wiadomości.
- source – oryginalny tekst źródłowy dla tego ciągu.
- Kolumny językowe: 1 kolumna na każdy wybrany język tłumaczenia, nazwana jego kodem języka (na przykład en, fr, es-MX). Eksport tylko ze źródłem nie zawiera kolumn języków tłumaczenia.
Możesz teraz otworzyć ten plik w programie Excel, w Arkuszach Google lub w innym edytorze arkuszy kalkulacyjnych.
Zaktualizuj plik CSV
Podczas edytowania pliku CSV wystarczy pracować w kolumnach językowych.
Nie edytuj, nie dodawaj ani nie usuwaj żadnych wartości w kolumnie block_id. Jeśli wiersz ma nieprawidłowy lub brakujący block_id, ten wiersz jest ignorowany podczas importu, a jego tłumaczenia nie są aktualizowane.
Co możesz bezpiecznie zmienić
W pliku CSV:
- Zaktualizuj istniejące tłumaczenia, edytując odpowiednią kolumnę językową.
- Dodaj brakujące tłumaczenia, wypełniając puste komórki w kolumnie języka.
- Pozostaw wartości danego języka bez zmian, jeśli nie chcesz aktualizować tego języka.
- Dodaj jedną lub więcej nowych kolumn językowych:
- Użyj prawidłowego kodu języka BCP-47 (na przykład fr-CA, de, ca).
- Podczas importu obsługiwane języki z nowymi wartościami tłumaczeń są dodawane do edytora tłumaczeń dla tej wiadomości.
Czego nie należy zmieniać
Unikaj poniższych elementów:
- Nie edytuj ani nie usuwaj wartości block_id.
- Nie dodawaj wierszy. Każdy wiersz musi nadal odpowiadać istniejącemu tłumaczalnemu ciągowi znaków w wiadomości.
- Nie zmieniaj wartości źródłowych w pliku CSV:
- Aby zmienić treści źródłowe, edytuj wiadomość bezpośrednio w edytorze Klaviyo, a następnie wyeksportuj nowy plik CSV.
- Pozostaw nagłówki kolumn
block_idi source bez zmian. W pliku Smartling CSV zachowaj nagłówek kolumny w języku źródłowym zamiast source. Pozostaw każdą kolumnę w języku tłumaczenia oznaczoną obsługiwanym kodem języka. - Nie zmieniaj formatu pliku:
- Zapisz plik jako .csv CSV.
- Zapisz z kodowaniem UTF‐8.
Pozostaw znaczniki szablonu i znaczniki szablonu, takie jak {{ first_name }} i {% if ... %}, bez zmian w każdym tłumaczeniu. Jeśli te symbole zastępcze różnią się od wiadomości źródłowej, walidacja zablokuje import.
Obsługa pustych komórek
Jeśli usuniesz tłumaczenie z komórki w pliku CSV i pozostawisz ją pustą:
- Import traktuje ten pusty ciąg znaków jako wartość.
- Istniejące tłumaczenie w tej komórce zostaje zastąpione pustą wartością. Może to skutecznie usunąć tłumaczenie.
Jeśli wyczyszczenie komórki usuwa też placeholdery obecne w tekście źródłowym, walidacja blokuje import. Przywróć placeholdery lub usuń tę kolumnę językową przed importem.
Jeśli chcesz uniknąć zmiany tłumaczenia, pozostaw jego dotychczasową wartość w pliku CSV lub usuń całą kolumnę tego języka przed importem.
Gdy skończysz edytować, zapisz plik jako plik .csv zakodowany w UTF-8.
Importuj plik CSV
Po zaktualizowaniu i zapisaniu pliku CSV:
- Wróć do edytora tłumaczeń dla tej samej wiadomości.
- Otwórz 3‑kropkowe menu działań i kliknij Importuj CSV.
- W modalu importu wykonaj jedną z tych czynności:
- Kliknij Wybierz plik i wybierz plik CSV lub
- Przeciągnij i upuść plik CSV w obszarze przesyłania.
- Kliknij Dalej, aby zweryfikować plik i wyświetlić podgląd zmian.
Klaviyo przeprowadza "na sucho" weryfikację i wyświetla:
- Podsumowanie tego, ile wierszy zostanie zaktualizowanych, pozostanie bez zmian lub zostanie pominiętych
- Wszelkie ostrzeżenia lub błędy, które wykryto
- Dokładnie przejrzyj podsumowanie i ostrzeżenia.
- Jeśli wszystko wygląda poprawnie, kliknij Importuj, aby zastosować zmiany.
Gdy import zakończy się powodzeniem, okno modalne się zamknie, a Twoje tłumaczenia zostaną zaktualizowane w edytorze tłumaczeń. Sprawdź zaimportowane tłumaczenia.
Podczas walidacji Klaviyo sprawdza też:
- Typ pliku i kodowanie: użyj pliku CSV zakodowanego w UTF-8.
- Kolumny CSV: zachowaj
block_id, kolumnę źródłową (lub kolumnę w języku źródłowym w przypadku Smartling) oraz co najmniej jedną obsługiwaną kolumnę w języku tłumaczenia. - Kody języka, które nie są rozpoznawane lub nie są obsługiwane przez kanał.
- Puste wartości tłumaczenia i inne potencjalne problemy.
- Zmienne znaczniki szablonu i znaczniki szablonu, które różnią się od wiadomości źródłowej.
Jeśli walidacja się nie powiedzie, zobaczysz komunikat o błędzie. Po poprawieniu pliku CSV kliknij Wybierz nowy plik, aby spróbować ponownie; walidacja nie zmienia Twoich tłumaczeń.
Poznaj wyniki importu
Po walidacji podsumowanie importu pokazuje, co się stanie, jeśli przejdziesz dalej.
Liczby podsumowania
Podsumowanie może zawierać liczby, takie jak:
- Zaktualizowano: liczba wierszy, w których zmieni się co najmniej 1 wartość tłumaczenia.
- Pominięto (bez zmian): wiersze w pliku CSV, w których wszystkie uwzględnione wartości tłumaczenia są zgodne z tymi, które są już zapisane.
- Pominięte: wiersze, które nie zostaną zaimportowane, takie jak zduplikowane wiersze po pierwszym wystąpieniu lub wiersze, których
block_idnie istnieje w tej wiadomości.
Liczby są obliczane dla każdego wiersza, a nie dla każdego języka. Na przykład jeśli plik CSV ma 2 wiersze i 2 kolumny językowe:
- Jeśli zaktualizuje się 1 wiersz w 1 języku, liczba Zaktualizowane wynosi 1.
- Jeśli jeden wiersz zostanie zaktualizowany w obu językach, liczba Zaktualizowano nadal wynosi 1.
- Jeśli oba wiersze zaktualizują się w 1 języku lub we wszystkich językach, liczba Zaktualizowano wynosi 2.
Najlepsze praktyki
Aby dane tłumaczeń były dokładne i łatwe w zarządzaniu:
- Zacznij od najnowszego eksportu. Unikaj ponownego używania starszych plików CSV, zwłaszcza po zmianie treści lub języka w wiadomości.
- Zachowaj kopię zapasową każdego eksportu. Zapisz kopię pliku CSV przed wprowadzeniem zmian, aby w razie potrzeby móc przywrócić poprzednią wersję.
- Skoordynuj działania z tłumaczami. Wyjaśnij, które kolumny mogą edytować (tylko kolumny językowe), a których nie mogą zmieniać (block_id, source).
- W razie potrzeby pracuj w mniejszych partiach. Jeśli plik jest bardzo duży, rozważ podzielenie pracy na kilka wiadomości lub przeprowadzenie kilku mniejszych importów.
- Używaj obsługiwanych kodów języków. Podczas dodawania nowych kolumn językowych używaj obsługiwanych kodów BCP-47 z artykułu Inteligentnego tłumaczenia, aby uniknąć języków „nieprzetwarzalnych”.
Rozwiąż ostrzeżenia dotyczące walidacji i błędy importu
Jeśli podczas walidacji importu pojawią się ostrzeżenia lub błędy, przejrzyj sekcje poniżej, aby zrozumieć, co oznaczają i jak je naprawić.
"Brakuje wymaganych kolumn."
Co to oznacza: Brakuje kolumny block_id lub została zmieniona jej nazwa, albo plik CSV zaczyna się od wierszy z dyrektywami zamiast od nagłówków kolumn.
Co zrobić: Zacznij od nagłówków kolumn z oryginalnego eksportu i pozostaw block_id bez zmian. Przed importem usuń wszystkie wiersze dyrektyw Smartling znajdujące się na początku pliku. Zachowaj źródło (lub kolumnę Smartling dla języka źródłowego), aby zaimportowane tłumaczenia pozostały powiązane z właściwą treścią źródłową.
"Masz puste wartości tłumaczeń. Puste ciągi znaków będą traktowane jako wartości."
Co to oznacza: Plik CSV zawiera puste wartości tłumaczenia, a puste ciągi znaków będą traktowane jako wartości.
Co zrobić: Jeśli kontynuujesz, te puste komórki zastąpią wszelkie istniejące tłumaczenia dla tego klucza i języka. Jeśli chcesz pozostawić te tłumaczenia bez zmian, przywróć poprzednie wartości lub usuń tę kolumnę języka i ponownie zaimportuj plik.
"Klucz(e) <count> nie istnieje(-ją) w projekcie i nie zostanie(-ną) uwzględniony(-e) w imporcie."
Co to oznacza: Niektóre wartości block_id w pliku CSV nie istnieją dla tego szablonu (na przykład jeśli wartości block_id zostały edytowane ręcznie).
Co zrobić: Te wiersze są ignorowane, a tłumaczenia dla tych kluczy się nie zmieniają. Aby to rozwiązać, usuń te wiersze z pliku CSV lub w razie potrzeby wyeksportuj nowy plik.
"Twój plik zawiera zduplikowane klucze ze sprzecznymi wartościami. Pierwsza wartość zostanie użyta."
Co to oznacza: Co najmniej dwa wiersze w pliku CSV mają te same wartości block_id (na przykład, jeśli wiersze zostały przypadkowo zduplikowane).
Co zrobić: Wykorzystywane są wartości z pierwszego wiersza, a pozostałe zduplikowane wiersze są ignorowane. Aby to rozwiązać, usuń zduplikowane wiersze z pliku CSV lub w razie potrzeby wyeksportuj nowy plik.
"Wiele kolumn odpowiada temu samemu językowi. Użyta zostanie tylko ostatnia kolumna, a pozostałe zostaną zignorowane."
Co to oznacza: Dwie lub więcej kolumn w pliku CSV ma ten sam kod języka lub mapuje się na ten sam język (na przykład, jeśli kolumna językowa została przypadkowo zduplikowana).
Co zrobić: Używane są wartości z ostatniej zduplikowanej kolumny, a pozostałe zduplikowane kolumny są ignorowane. Aby rozwiązać ten problem, usuń zduplikowane kolumny z pliku CSV lub w razie potrzeby wyeksportuj nowy plik.
"Twój plik zawiera kolumny z kodami języków, które nie są obsługiwane przez ten kanał: <nieprawidłowy kod<invalid language code> języka>. Zostaną one zignorowane, a zaimportowane zostaną prawidłowe ustawienia regionalne."
Co to oznacza: Nagłówek kolumny w pliku CSV używa kodu języka, który nie jest obsługiwany ani rozpoznawany.
Co zrobić: Aby dodać nowy język, użyj jednego z obsługiwanych kodów BCP-47 z dokumentacji Inteligentne tłumaczenie. Kolumny z nieobsługiwanymi kodami są ignorowane.
"Masz w pliku języki, których nie ma w projekcie. Następujące języki zostaną dodane do edytora tłumaczeń: <language detected>."
Co to oznacza: Twój plik CSV zawiera kolumny językowe, które nie są obecnie częścią tego szablonu.
Co zrobić:
- Aby dodać te języki, dodaj nową wartość tłumaczenia w każdej kolumnie języka, przejrzyj listę i kliknij Importuj, aby dodać je do edytora tłumaczeń.
- Jeśli nie chcesz ich dodawać, usuń te kolumny i ponownie zaimportuj plik.
"Nie znaleziono kolumn ustawień lokalnych."
Co to oznacza: Plik CSV zawiera kolumny block_id i source, ale nie wykryto żadnego innego nagłówka kolumny.
Co zrobić: Dodaj co najmniej jedną obsługiwaną kolumnę języka i spróbuj ponownie.
„Nie znaleziono prawidłowych kolumn ustawień lokalnych.”
Co to oznacza: Plik CSV zawiera kolumny block_id i source, ale nie zawiera żadnych prawidłowych kolumn językowych.
Co zrobić: Dodaj co najmniej jedną obsługiwaną kolumnę języka i spróbuj ponownie.
"Niektóre tłumaczenia zawierają niedopasowane symbole zastępcze. Upewnij się, że wszystkie symbole zastępcze w tekście źródłowym zostały zachowane w tłumaczeniach."
Co to oznacza: w tłumaczeniu brakuje znaczników szablonu, znaczniki szablonu zostały zmienione lub są dodatkowe w porównaniu z wiadomością źródłową.
Co zrobić: przywróć symbole zastępcze z wiadomości źródłowej w dotkniętych tłumaczeniach, a następnie zapisz plik CSV i wybierz poprawiony plik. Nie można kontynuować importu, dopóki symbole zastępcze nie będą pasować.
Jeśli widzisz tylko ostrzeżenia i rozumiesz ich wpływ, możesz kontynuować import. Jeśli widzisz błąd, musisz poprawić plik CSV i przesłać go ponownie przed kontynuowaniem. Jeśli nadal widzisz błędy, wyeksportuj nowy plik CSV z edytora tłumaczeń, wprowadź minimalne zmiany i spróbuj zaimportować ponownie, aby wyizolować problem.
Dodatkowe źródła
- Jak włączyć Inteligentne tłumaczenie
Dowiedz się, jak włączyć Inteligentne tłumaczenie dla wiadomości, aby wysyłać kampanie i sekwencje w wielu językach na podstawie preferencji językowych odbiorców. Klaviyo może tłumaczyć treści e-mail na ponad 60 języków.
- Jak stworzyć wielojęzyczną kampanię e-mailową przy użyciu funkcji Smart Translations?
Dowiedz się, jak utworzyć i wysłać kampanię e-mail w wielu językach, w zależności od preferencji językowych odbiorców. Klaviyo może przetłumaczyć treść kampanii na ponad 60 języków.
- Jak utworzyć wielojęzyczną kampanię SMS przy użyciu funkcji Inteligentne tłumaczenie
Dowiedz się, jak tworzyć i wysyłać kampanię SMS w wielu językach, w zależności od preferencji językowych odbiorców. Klaviyo może przetłumaczyć treść kampanii na ponad 60 języków.
- Jak dostosować zawartość na podstawie języka
Dowiedz się, jak zbierać informacje o preferowanym języku danej osoby, a następnie kierować do niej komunikację w tym języku.