Jak ręcznie zaimportować zaimportować dane zdarzenia historycznego

Czego się dowiesz

Dowiedz się, jak ręcznie zaimportować dane zdarzenia historycznego do Klaviyo. Podczas gdy zalecamy korzystanie z Klaviyo- wbudowanych integracji z platformami takimi jak Shopify, Magento, i BigCommerce, oraz naszego API dla niestandardowych integracji, możliwe jest również ręczne dodanie tych danych. Typowym tego przykładem jest dodawanie historycznych danych zakupowych z poprzedniej platformy e-commerce, dla której Klaviyo nie ma wbudowanej integracji.

Pamiętaj, że istnieje limit 50 MB dla przesyłanych plików CSV. 

Sformatuj swoje dane

Pierwszym krokiem jest prawidłowe sformatowanie danych w pliku CSV. Poniżej znajduje się przykład danych złożonego zamówienia wraz z opisem poniższych pól. Każdy wiersz w twoim pliku CSV powinien reprezentować akcję lub aktywność, którą ktoś wykonał, np. "Zakupiony produkt" lub "Zapisano się na webinar." Jeśli masz wiele działań do śledzenia, powinieneś przesłać je jako osobne pliki CSV. Adres e-mail musi być na pierwszym miejscu, gdy przesyłasz plik CSV.

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

Pola wymagane

2 wymagane pola to znacznik czasu identyfikujący czas wystąpienia zdarzenia oraz właściwość klienta (e-mail lub unikalny identyfikator) identyfikująca, kto wykonał akcję.

• Znacznik czasu: Znacznik czasu pokazujący dzień i godzinę zdarzenia. Format to YYYY-rynek przedsiębiorstw średniej wielkości-DD HH:rynek przedsiębiorstw średniej wielkości:SS. Na przykład, godzina 13:30 14 listopada 2012 roku to: 2012-11-14 13:30:00.

  Jeśli dwa lub więcej zdarzeń w pliku CSV ma ten sam znacznik czasu, musisz podać unikalny identyfikator $event_id, w przeciwnym razie tylko jedno ze zdarzeń zostanie zaimportowane, a pozostałe zostaną pominięte. Zobacz sekcję dotyczącą $event_id poniżej.

• Person//e-mail lub Person//ID: Najprawdopodobniej użyjesz adresu e-mail do identyfikacji swojego klienta. Niektórzy klienci będą również używać unikalnego ID. Jeśli chcesz, możesz użyć obu.

Pola opcjonalne

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

• $event_id: Jest to unikalny identyfikator zdarzenia. W praktyce powinieneś wysłać $event_id, jeśli masz unikalny identyfikator dla każdego zdarzenia (np. identyfikator zamówienia). Powinieneś także ustawić $event_id, jeśli spodziewasz się, że niektóre zdarzenia wystąpią w tym samym momencie. Może się to zdarzyć, gdy ktoś podejmie jedną akcję, którą podzielisz na wiele zdarzeń. Na przykład, jeśli ktoś kupuje wiele przedmiotów, możesz chcieć zarejestrować 1 zdarzenie dla każdego zakupionego przedmiotu.
  
  W 2 przykładowych zestawach danych poniżej występuje 1 zdarzenie złożonego zamówienia wraz z 3 zdarzeniami zamówionych produktów (po 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 z nich ma unikalny identyfikator $event_id. Jeśli $event_ids były identyczne lub jeśli ich nie było, to tylko jedno ze zdarzeń zostanie zaimportowane, a pozostałe zostaną pominięte.
  
• $value: Użyj tego pola, jeśli importowane zdarzenie zawiera wartość. Na przykład, jeśli importujesz dane zdarzenia złożonego zamówienia, każde zamówienie będzie miało wartość. Nie musisz poprzedzać wartości znakiem $ lub innym symbolem waluty.

Jeśli masz dodatkowe dane o osobie, która coś zrobiła, powinny one trafić do kolumny, której etykieta zaczyna się od Person//, a następnie typu danych, które zawiera kolumna. Na przykład, jeśli masz firmę lub organizację, do której należy każda osoba, chcesz oznaczyć tę kolumnę jako Osoba/Organizacja. Specjalny przedrostek pozwala nam 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ć do identyfikacji osób:

• Osoba/Imię: imię
• Osoba/Nazwisko: nazwisko
• Osoba/telefon: numer telefonu
• Osoba/Organizacja: organizacja
• Osoba/tytuł: stanowisko

Jeśli posiadasz dodatkowe dane na temat każdej akcji, możesz umieścić je w dodatkowych kolumnach z dowolnymi etykietami. Na przykład, jeśli ktoś coś kupi i chcesz uwzględnić, jaki przedmiot kupił, możesz umieścić te dane w kolumnie oznaczonej jako Zakupiony przedmiot. Poniżej znajdziesz kilka przykładów.

• Zakupiony przedmiot
• Kategoria przedmiotu
• 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 czyjejś organizacji, możesz pozostawić kolumnę Osoba/Organizacja pustą, a my pominiemy śledzenie tej właściwości dla tego wiersza w danych.

Po zakończeniu formatowania danych zapisz je w pliku CSV.

Prześlij plik CSV z danymi

Po prawidłowym sformatowaniu danych przejdź na stronę Klaviyo. 

1. Wybierz zakładkę Integracje w Klaviyo.
2. Proszę wybrać opcję Zarządzaj danymi > Importuj przez CSV.
3. Zostaniesz poproszony o przesłanie pliku CSV, a następnie kliknij Dalej.
4. Będziesz mieć możliwość nazwania wydarzenia. Jeśli próbujesz zmapować zaimportowane dane do metryki wydarzenia, która już istnieje na Twoim koncie, upewnij się, że wpisujesz nazwę wydarzenia dokładnie tak, jak już się pojawia.
5. Po nazwaniu wydarzenia możesz wyświetlić jego podgląd poniżej.
6. Gdy będziesz gotowy, aby zaimportować zaimportuj swoje dane, kliknij Dalej. Twój plik zacznie się przetwarzać i możesz opuścić stronę. 

Uwaga dla sklepu internetowego ładującego dane

Jeśli przesyłasz dane zakupu, będziesz chciał przesłać dwa pliki: jeden dla całego zamówienia, a drugi zawierający dane poszczególnych pozycji.  Przykładowo, klient może złożyć zamówienie na wiele produktów. W tym przypadku będzie 1 zdarzenie dla złożonego zamówienia, a następnie oddzielne zdarzenia dla każdego z zamówionych produktów. Oto jak powinny wyglądać nagłówki tych plików:

Złożone zamówienie

Zamówiony produkt

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

Powodem dołączenia dwóch metryk jest to, że ułatwia to późniejsze wyzwalanie wiadomości e-mail zarówno z ogólnego zamówienia, jak i z określonych kategorii / przedmiotów.

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

importować importowanie rozwiązywanie problemów

Poniżej znajdują się niektóre typowe problemy i rozwiązania, które możesz napotkać podczas ręcznego importowania danych zdarzeń historycznych.

Mój importuj import trwa długo

importuj import może zająć od 5 minut do 24 godzin, w zależności od wielkości Twojej listy. Zdecydowanie zalecamy rozpoczęcie importowania dowolnej listy z co najmniej 24-godzinnym wyprzedzeniem, aby upewnić się, że proces importowania nie wstrzyma Twojej wysyłki.

Moje importowanie ciągle kończy się niepowodzeniem

Jeśli importowanie nie powiedzie się, prawdopodobnie jest to spowodowane jedną z następujących przyczyn:

• Czy twój plik jest plikiem .csv? Twój plik musi być w formacie .csv format. Jeśli spróbujesz przesłać plik Excel lub .txt importowanie nie powiedzie się.
• Czy poprawnie sformatowałeś kolumnę Timestamp? Powinieneś sformatować datę i godzinę jako YYYY-rynek przedsiębiorstw średniej wielkości-DD HH:rynek przedsiębiorstw średniej wielkości:SS. Na przykład, godzina 13:30 14 listopada to: 2012-11-14 13:30:00. Jako drugie sprawdzenie, otwórz plik CSV w edytorze tekstu, aby upewnić się, że końcowe 0 w znacznikach czasu nie są usuwane podczas zapisywania lub eksportowania plików CSV. Jeśli pracujesz z dane 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 dla każdego wiersza? Musisz mieć kolumnę oznaczoną Person//e-mail lub Person//ID .Jeśli którakolwiek z tych kolumn ma pusty wiersz, może to spowodować, że importowanie nie powiedzie się.
• Czy Twoja kolumna Person//e-mail zawiera nieprawidłowe adresy e-mail? Jeśli masz wartości w Person//e-mail, które nie mają prawidłowego formatu adresu e-mail, może to spowodować niepowodzenie importowania .
• Czy wszystkie kolumny są poprawnie oznaczone? Czy są jakieś spacje? Upewnij się, że wszystkie nagłówki kolumn są zgodne z tym, co opisano w tym przewodniku. Upewnij się również, że w nazwach kolumn nie ma spacji.

Dodatkowe źródła

• Dopuszczalne formaty daty i znacznika czasu dla właściwości profilu i zdarzenia
• Formatowanie dat dla plików CSV
• Przeprowadź migrację do Klaviyo