Jak ręcznie zaimportować historyczne dane zdarzeń

Czego się dowiesz?

Dowiedz się, jak ręcznie zaimportować historyczne dane zdarzeń do Klaviyo. Chociaż zalecamy korzystanie z integracji stworzonych przez Klaviyo z platformami takimi jak Shopify, Magento i BigCommerce oraz z naszego API w przypadku integracji niestandardowych, możesz też dodać te dane ręcznie. Typowym przykładem jest dodanie historycznych danych zakupowych z poprzedniej platformy e-commerce, dla której Klaviyo nie ma gotowej integracji.

Pamiętaj, że limit przesyłania plików CSV wynosi 50 MB.

Sformatuj dane

Pierwszym krokiem jest prawidłowe sformatowanie danych w pliku CSV. Poniżej znajduje się przykład danych Placed Order wraz z opisem poniższych pól. Każdy wiersz w pliku CSV powinien reprezentować działanie lub aktywność wykonaną przez daną osobę, np. "Zakupiono produkt" lub "Zapisano się na webinar". Jeśli masz do śledzenia wiele działań, prześlij je jako osobne pliki CSV. Adres e-mail musi być pierwszy podczas przesyłania pliku CSV.

Oto kilka przykładowych plików CSV zdarzeń, do których można się odwołać podczas formatowania danych.

Pola wymagane

2 wymagane pola to znacznik czasu identyfikujący, kiedy wystąpiło zdarzenie, oraz właściwość klienta (adres e-mail lub unikalny identyfikator), która identyfikuje, kto wykonał działanie.

• Znacznik czasu: znacznik czasu pokazujący dzień i godzinę zdarzenia. Format to RRRR-MM-DD GG:MM:SS. Na przykład 13:30 dnia 14 listopada 2012 r. będzie wyglądać tak: 2012-11-14 13:30:00.
  

  Jeśli co najmniej 2 zdarzenia w pliku CSV mają ten sam znacznik czasu, musisz uwzględnić unikalne $event_id, w przeciwnym razie tylko jedno zdarzenie zostanie zaimportowane, a pozostałe zostaną pominięte. Zobacz poniższą sekcję dotyczącą $event_id.

• Osoba//E-mail lub Osoba//ID: Najprawdopodobniej do identyfikowania klientów będzie używany adres e-mail. Niektórzy klienci będą też używać unikalnego identyfikatora. Jeśli chcesz, możesz używać obu.

Pola opcjonalne

Są 2 pola specjalne, na które należy zwrócić uwagę.

• $event_id: To unikalny identyfikator zdarzenia. W praktyce należy wysłać $event_id, jeśli masz unikalny identyfikator dla każdego zdarzenia (np. identyfikator zamówienia). Należy też ustawić $event_id, jeśli oczekujesz, że określone zdarzenia będą występować w tym samym momencie. Może się tak zdarzyć, gdy ktoś wykona jedno działanie, które rozdzielisz na wiele zdarzeń. Na przykład jeśli ktoś kupi wiele produktów, możesz chcieć zarejestrować 1 zdarzenie dla każdego kupionego produktu. W 2 przykładowych zestawach danych poniżej jest 1 zdarzenie złożonego zamówienia oraz 3 zdarzenia zamówionego produktu (1 dla każdego produktu w złożonym zamówieniu). Wszystkie te zdarzenia mają ten sam znacznik czasu, ale wszystkie zostaną zaimportowane, ponieważ każde ma unikalny $event_id. Jeśli $event_id byłyby identyczne lub jeśli by ich brakowało, wtedy tylko jedno ze zdarzeń zostałoby zaimportowane, a pozostałe zostałyby pominięte.
  
• $value: Użyj tego pola, jeśli importowane zdarzenie zawiera wartość. Na przykład jeśli importujesz dane zdarzenia Placed Order, każde zamówienie będzie mieć wartość. Nie musisz poprzedzać wartości znakiem $ ani innym symbolem waluty.
  

  Jeśli masz dodatkowe dane o osobie, która coś zrobiła, powinny one znaleźć się w kolumnie, której etykieta zaczyna się od Person//, a następnie zawiera typ danych, jakie są w tej kolumnie. Na przykład, jeśli masz nazwę firmy lub organizacji, do której należy każda osoba, etykieta tej kolumny powinna brzmieć Person//Organization. Ten specjalny prefiks informuje nas, aby powiązać dane w tej kolumnie z każdą osobą, a nie z aktywnością. Poniżej znajdują się specjalne kolumny, których możesz użyć, aby pomóc sobie w identyfikowaniu osób:

• Osoba//Imię: imię
• Osoba//Nazwisko: nazwisko
• Osoba//Telefon: numer telefonu
• Osoba//Organizacja: organizacja
• Osoba//Stanowisko: stanowisko pracy
  

  Jeśli masz dodatkowe dane o każdym działaniu, możesz dodać je w dodatkowych kolumnach z dowolnymi etykietami. Na przykład jeśli ktoś coś kupi i chcesz uwzględnić informację o tym, jaki produkt kupiono, możesz umieścić te dane w kolumnie o nazwie Zakupiony produkt. Poniżej znajdziesz kilka przykładów.

• Zakupiony produkt
• Kategoria produktu
• Produkt
• Położenie

Jeśli nie masz danych dla konkretnej kolumny, pozostaw ją pustą, a my ją zignorujemy. Na przykład jeśli nie znasz organizacji danej osoby, możesz pozostawić pustą kolumnę Osoba//Organizacja , a my pominiemy śledzenie tej właściwości dla tego wiersza w danych.

Gdy skończysz formatować dane, zapisz je w pliku CSV.

Prześlij plik CSV z danymi

Gdy dane będą prawidłowo sformatowane, przejdź do Klaviyo.

1. W Klaviyo wybierz kartę Integracje.
2. Wybierz Zarządzaj danymi > Importuj przez CSV.
3. Zostanie wyświetlony komunikat z prośbą o przesłanie pliku CSV, a następnie kliknij Dalej.
4. Będzie można nadać nazwę zdarzeniu. Jeśli próbujesz przypisać zaimportowane dane do metryki zdarzenia, która już istnieje na koncie, upewnij się, że wpisujesz nazwę zdarzenia dokładnie tak, jak już się wyświetla.
   
5. Po nadaniu nazwy zdarzeniu można poniżej podejrzeć dane.
6. Gdy wszystko będzie gotowe do zaimportowania danych, kliknij Dalej. Plik zacznie się przetwarzać i można opuścić tę stronę.

Uwaga dla sklepów internetowych wczytujących dane o zakupach

Jeśli przesyłasz dane o zakupach, prześlij 2 pliki: jeden dla całego zamówienia i drugi z danymi o poszczególnych pozycjach.  Na przykład klient może złożyć zamówienie na wiele produktów. W takim przypadku będzie 1 zdarzenie dla Złożonego zamówienia, a następnie osobne zdarzenia dla każdego z Zamówionych produktów. Oto jak zazwyczaj powinny wyglądać nagłówki tych plików:

Złożone zamówienia

Osoba//E-mail	Osoba//Imię	Osoba//Nazwisko	Sygnatura czasowa	$event_id	$value	Ilość	Produkty
[e-mail]	Jan	Smith	2014-03-10 08:55:01	12425	49,00	2	["Zabić drozda", "Pictionary"]

Zamówiono produkt

Osoba//E-mail	Osoba//Imię	Osoba//Nazwisko	Sygnatura czasowa	$event_id	$value	Ilość	Produkt
[e-mail]	Jan	Smith	2014-03-10 08:55:01	12425_TKM	24,00	1	Aby zabić przedrzeźniacza
[e-mail]	Jan	Smith	2014-03-10 08:55:01	12425_P	25.00	1	Pictionary

Nie używamy $ jako prefiksu dla wartości zamówienia. Używaj samych liczb, aby wskazać cenę lub wartość zamówienia. Użycie nagłówka $value spowoduje poprawne wypełnienie danych na Twoim koncie Klaviyo.

Powód uwzględnienia dwóch metryk jest taki, że ułatwia to późniejsze wyzwalanie e-maili zarówno na podstawie całego zamówienia, jak i na podstawie konkretnych kategorii / produktów.

W przypadku zdarzeń Ordered Product element $event_id musi być unikalnym identyfikatorem dla każdej kombinacji zamówienia i zamówionego produktu. Jednym z prostych sposobów utworzenia unikalnego identyfikatora jest połączenie identyfikatora zamówienia i identyfikatora produktu, jak w przykładzie powyżej.

Rozwiązywanie problemów z importem

Poniżej przedstawiono kilka typowych problemów i rozwiązań, które mogą pojawić się podczas ręcznego importowania historycznych danych zdarzeń.

Mój import trwa bardzo długo

Importowanie może zająć od 5 minut do 24 godzin, w zależności od rozmiaru listy. Zdecydowanie zalecamy rozpoczęcie importowania każdej listy co najmniej 24 godziny przed planowanym użyciem jej w danej kampanii, aby mieć pewność, że proces importu nie opóźni wysyłki.

Mój import ciągle się nie udaje

Jeśli import się nie powiedzie, prawdopodobnie wynika to z jednej z następujących przyczyn:

• Czy Twój plik jest plikiem .csv? Twój plik musi mieć format .csv format. Jeśli spróbujesz przesłać plik Excel lub plik .txt, import nie powiedzie się.
• Czy kolumna Timestamp została poprawnie sformatowana? Datę i godzinę należy sformatować jako YYYY-MM-DD HH:MM:SS. Na przykład 1:30pm 14 listopada to: 2012-11-14 13:30:00. Jako dodatkową kontrolę otwórz plik CSV w edytorze tekstu, aby upewnić się, że końcowe zera w znacznikach czasu nie są usuwane podczas zapisywania lub eksportowania plików CSV. Jeśli pracujesz z danymi w arkuszu kalkulacyjnym, upewnij się, że komórki Timestamp są ustawione na prawidłowy format znacznika czasu.
  
• Czy wszystkie wymagane kolumny mają wypełnione dane w każdym wierszu? Musisz mieć kolumnę oznaczoną jako Person//Email lub Person//ID. Jeśli w jednej z tych kolumn znajduje się pusty wiersz, może to spowodować niepowodzenie importu.
• Czy kolumna Person//Email zawiera nieprawidłowe adresy e-mail? Jeśli w polu Person//Email znajdują się wartości, które nie mają prawidłowego formatu adresu e-mail, może to spowodować niepowodzenie importu.
• Czy wszystkie kolumny są prawidłowo opisane? Czy są jakieś spacje? Upewnij się, że wszystkie nagłówki kolumn są zgodne z tym, co opisano w tym przewodniku. Warto też upewnić się, że w nazwach kolumn nie ma spacji.