Rozwiązywanie problemów z importem list

Czego się dowiesz?

Dowiedz się, jak rozwiązywać problemy z błędami, które pojawiają się podczas przesyłania pliku CSV z kontaktami do nowej lub istniejącej listy w Klaviyo. Przesyłasz recenzje? Więcej an ten temat dowiesz się z naszego artykułu o importowaniu recenzji.

Kilka słów na początek

Chcesz mieć pewność, że plik zostanie zaimportowany? Przed zaimportowaniem listy sprawdź poniższą listę wymagań.

• Plik CSV (nie w żadnym innym formacie)
• Rozmiar pliku nie może przekraczać 50 MB
• Pierwszy wiersz to nagłówki
• Każdy wiersz ma przypisany adres e-mail albo numer telefonu
• Nie ma zduplikowanych adresów e-mail ani numerów telefonów

Nasz zespół pomocy technicznej nie może importować plików CSV do Klaviyo w Twoim imieniu. Jeśli potrzebujesz pomocy z importem, zapoznaj się z poniższą sekcją rozwiązywania problemów, aby znaleźć wskazówki, jak skutecznie rozwiązywać problemy z importem list.

Spis treści

• Opóźnienie importu
• Rozwiązywanie problemów z importem
• Wszystkie kolumny zaimportowane jako jedno pole
• Komunikaty o błędach nieprawidłowego formatu
• Nieprawidłowe formatowanie daty lub znacznika czasu
• Komunikaty o błędach dotyczące zduplikowanego lub brakującego unikatowego identyfikatora
• Brakująca wartość w wymaganym polu
• Problemy z formatowaniem numeru telefonu

Opóźnienie importu

Jeśli importujesz duży plik z dużą ilością danych, proces importu może potrwać kilka godzin. Niestety nie ma sposobu, aby przyspieszyć ten proces, gdy już się rozpocznie. Jednym ze sposobów na wcześniejsze usprawnienie procesu importu jest usunięcie wszystkich zduplikowanych adresów e-mail z pliku CSV przed importem. Zdecydowanie zalecamy zaplanowanie importu nowej listy co najmniej dzień wcześniej, zanim zaczniesz wysyłać e-maile do kontaktów z tej listy.

Po rozpoczęciu importu początkowo zobaczysz pasek stanu. Jeśli przejdziesz do innej strony, nadal będzie można śledzić postęp importu, obserwując, jak z czasem rośnie liczba na liście. Wyślemy e-mail, gdy tylko import listy zostanie ukończony.

Rozwiązywanie problemów z importem

Jeśli nie uda się przesłać listy, sprawdź następujące typowe błędy w pliku CSV, które mogą powodować ten problem:

Wszystkie kolumny zaimportowane jako jedno pole

Jeśli używasz wersji programu Excel, w której język angielski nie jest językiem domyślnym, oprogramowanie może używać średników zamiast przecinków jako separatora w pliku. Jeśli tak jest, plik po imporcie może wyglądać tak:

Aby to naprawić, przejdź do ustawienia Format liczb lub Separator listy (lub liczb) na komputerze. To ustawienie prawdopodobnie znajduje się w sekcji Język i region i może być umieszczone w sekcji Ustawienia zaawansowane. Zastąp średnik przecinkiem i zapisz. Teraz, gdy eksportujesz pliki jako CSV, będą one używać formatu z przecinkiem. Pamiętaj, że dokładna lokalizacja tego ustawienia może się różnić w zależności od systemu operacyjnego.

Sprawdź też, czy plik CSV jest zgodny z wymaganiami formatowania Klaviyo. Jeśli jeszcze tego nie zrobiono, przejdź do naszej dokumentacji dotyczącej formatowania danych. Na przykład jednym z wymaganych pól jest pole na adresy e-mail.

Rozwiązywanie problemów z komunikatami o błędach nieprawidłowego formatu

Gdy importujesz listę do Klaviyo, strona mapowania pól umożliwia dopasowanie dowolnych właściwości do odpowiadającego im typu danych w Klaviyo. Na przykład E-mail zawsze ma typ danych Tekst; natomiast jeśli prześlesz właściwość niestandardową dla Urodziny, ustaw typ danych na Data.

Zapoznaj się z poniższymi typami danych, akceptowalnymi formatami i przykładami.

• Tekst
  Dowolny tekst lub dowolna kombinacja tekstu i cyfr. Jeśli nie masz pewności, w jakim formacie są Twoje dane, wybierz tę opcję.
  • Przykłady:
    przyklad@przyklad.com
    Witaj, świecie
    5,00 USD
• Numeryczne
  Wszystkie numery. Nie uwzględniaj symboli walut w polach numerycznych.
  • Przykłady:
    2
    5.0031
    130.0
• Wartość logiczna
  Wartości true lub false.
  • Przykłady:
    prawda
    fałsz
• Data
  Zapoznaj się z naszym przewodnikiem dotyczącym akceptowanych formatów daty i znacznika czasu dla właściwości profilów i zdarzeń, aby dowiedzieć się więcej o akceptowanych formatach dat.
  • Przykład:
    2014-09-01 13:34:08
• Lista
  Dane muszą być sformatowane jako tablica JSON.
  • Przykłady:
    ["jabłka","banany","pomarańcze"]
    ["jabłka"]
• Zgoda
  Zgoda jest sformatowana jako kanał (e-mail, SMS itp.) oraz typ zgody (jeśli w Klaviyo dostępnych jest kilka typów). Jedyną opcją dla e-maila jest Zgoda na marketing e-mailowy; dla SMS będzie to Zgoda na marketing SMS-owy lub SMS Transactional Consent itd. Wartość tego pola musi brzmieć „Subscribe”, „Never Subscribed” lub „Unsubscribed”. 

Aby dowiedzieć się więcej o tym, co obejmują poszczególne typy danych i który wybrać podczas importowania listy, zapoznaj się z naszym przewodnikiem: zrozumienie typów danych.

Aby dowiedzieć się więcej o komunikatach o błędach „Nieprawidłowy format [typ danych]” (np. „Nieprawidłowy format listy”), zajrzyj do naszego przewodnika rozwiązywania problemów z komunikatami o błędach nieprawidłowego formatu.

Nieprawidłowe formatowanie daty lub znacznika czasu

Być może używasz nieprawidłowego formatu dat lub znaczników czasu. Jeśli dodano jedną z tych wartości i nie masz pewności co do akceptowanych przez Klaviyo formatów, przejdź do naszego przewodnika po akceptowanych formatach dat i znaczników czasu dla właściwości profilu i zdarzeń.

Rozwiązywanie problemów z komunikatami o błędach dotyczących zduplikowanego lub brakującego unikatowego identyfikatora

Zduplikowane identyfikatory

Rekordy pominięte z powodu „Duplicate Unique ID” oznaczają, że w pliku powtórzono adres e-mail lub numer telefonu. W takich przypadkach Klaviyo przetworzy dane z pierwszego wiersza zawierającego powtórzony identyfikator i udostępni wszystkie nieprzetworzone rekordy w pliku do pobrania.

Kliknij Pobierz pominięte rekordy, aby zobaczyć kontakty pominięte z powodu zduplikowanych identyfikatorów, i w razie potrzeby ponownie prześlij te pominięte rekordy.

Brak unikalnych identyfikatorów

Rekordy pominięte z powodu „Brakujący unikalny identyfikator” oznaczają, że pominięte wiersze nie zawierały adresu e-mail, numeru telefonu ani innego akceptowanego unikalnego identyfikatora.

Kliknij Pobierz pominięte rekordy, aby zobaczyć kontakty pominięte z powodu braku identyfikatorów, dodaj adres e-mail lub numer telefonu do każdego z nich i prześlij ponownie nowy plik.

Brakująca wartość w wymaganym polu

Sprawdź, czy wszystkie wymagane pola mają przypisane wartości. Na przykład jeśli na liście kontaktów któremuś brakuje adresu e-mail w kolumnie e-mail, podczas przesyłania zobaczysz błąd. Sprawdź, czy każdy kontakt, który chcesz przesłać, ma wartość we wszystkich wymaganych polach. Jeśli są puste, uzupełnij je przed kolejną próbą przesłania.

Nieprawidłowy adres e-mail lub nierozpoznane znaki

Jeśli pojawi się ten komunikat o błędzie, sprawdź adresy e-mail w pliku pod kątem nieprawidłowych znaków. Nieprawidłowe znaki obejmują ( ) , : ; [ / ], a także spacje.

Przenoszenie profili między kontami

Podczas przenoszenia profili z jednego konta na inne istnieją pewne właściwości, których nie można przesłać do innego konta.

Na przykład Profil utworzony dnia nie może zostać przeniesiony, ponieważ jest ustawiony na datę utworzenia profilu na koncie. Innymi przykładami są Pierwszy aktywny i Ostatni aktywny, ponieważ są one ustawiane automatycznie na podstawie aktywności profilu na koncie.

Problemy z formatowaniem numeru telefonu

Numery telefonów muszą zawierać numer kierunkowy kraju lub osobną kolumnę wskazującą kraj oraz muszą być zgodne z akceptowanym formatem numeru telefonu. Dowiedz się, jak prawidłowo sformatować i przesłać numery telefonów.