Import i eksport
Przenieś uczestników z innej aplikacji lojalnościowej za pomocą pliku CSV albo wyeksportuj swoich obecnych uczestników jako kopię zapasową. Oba miejsca znajdziesz w Ustawieniach, w sekcji Import i eksport uczestników.
Import i eksport uczestników
Eksportowanie uczestników
Kliknij Eksportuj uczestników do CSV, aby pobrać każdego zapisanego uczestnika jako plik CSV. Użyj go jako kopii zapasowej, do przeglądu sald w arkuszu kalkulacyjnym albo jako szablonu wyjściowego do importu — kolumny eksportu są nadzbiorem tego, co odczytuje importer, więc wyeksportowany plik można edytować i zaimportować ponownie bez zmian.
Format CSV
Importer potrzebuje tylko trzech kolumn. Wszelkie dodatkowe kolumny z eksportu są ignorowane. Wiersz nagłówka jest wymagany, a nazwy kolumn nie są zależne od wielkości liter.
| Kolumna | Wymagana | Co to jest |
|---|---|---|
email | Tak | E-mail uczestnika. Używany do znalezienia pasującego klienta Shopify. |
points | Tak | Liczba całkowita ≥ 0. Staje się saldem punktów uczestnika (oraz bazą punktów łącznych). |
tier | Nie | Slug poziomu (np. gold). Pozostaw puste, aby o poziomie zdecydowały punkty. |
Wartość tier musi być slugiem poziomu, a nie jego nazwą wyświetlaną — na przykład vip-member, a nie „VIP Member”. Eksport używa już slugów, więc obieg tam i z powrotem jest bezpieczny.
Minimalny plik importu wygląda tak:
email,points,tier
alice@example.com,1200,gold
bob@example.com,350,silver
carol@example.com,0,Co robi import
Dla każdego wiersza, którego e-mail pasuje do istniejącego klienta Shopify, import:
- Zapisuje uczestnika — bez bonusu powitalnego, niezależnie od Twojego ustawienia bonusu za zapisanie się.
- Ustawia jego punkty na wartość z pliku CSV (to ustawienie, a nie dodanie).
- Przypisuje poziom z kolumny
tieralbo wylicza go na podstawie punktów, jeśli kolumna jest pusta. - Datuje punkty na dzień importu — więc jeśli używasz wygasania kroczącego (FIFO), zegar startuje od nowa od dnia importu.
Import to pełne zastąpienie. Dla każdego e-maila pasującego do istniejącego uczestnika import nadpisuje jego obecne saldo i czyści jego dotychczasową historię punktów (zachowaną jedynie jako anulowane wiersze do celów audytu). Już wydane kody rabatowe pozostają nienaruszone. Tej operacji nie można cofnąć — więc przy jednorazowej migracji zaimportuj dane, zanim uczestnicy zaczną zdobywać punkty.
Jak działa dopasowywanie
Uczestnicy są dopasowywani do klientów Shopify po e-mailu. Jeśli dany e-mail nie ma pasującego klienta Shopify, ten wiersz jest pomijany i wymieniany w wynikach — import nigdy nie tworzy nowych klientów Shopify. Pominięte e-maile są pokazywane po zakończeniu importu, więc możesz utworzyć tych klientów w Shopify i uruchomić import ponownie, jeśli zajdzie taka potrzeba.
Poziomy po imporcie
Poziom z pliku CSV jest stosowany natychmiast. Gibbond raz dziennie ponownie sprawdza też poziom każdego uczestnika względem Twoich progów poziomów, więc ostatecznie o poziomie decydują punkty uczestnika. Jeśli zaimportujesz poziom, do którego punkty nie kwalifikują, zostanie on przy następnym dziennym uruchomieniu uzgodniony z poziomem wynikającym z punktów. Aby zaimportowane poziomy były stabilne, upewnij się, że Twoje progi poziomów odpowiadają importowanym punktom.
Uruchamianie importu
Importy działają w tle, więc możesz opuścić stronę, kiedy import trwa. Baner stanu pokazuje postęp na żywo oraz podsumowanie po zakończeniu (zaimportowane, pominięte i ewentualne błędy). Po zapisaniu danych Gibbond automatycznie odświeża saldo punktów i poziom każdego uczestnika w witrynie sklepu.
| Limit | Wartość |
|---|---|
| Maksymalny rozmiar pliku | 5 MB |
| Maksymalna liczba wierszy na import | 10 000 |
| Powtórzone e-maile w pliku | Wygrywa ostatni wiersz dla danego e-maila |
Ponowne uruchomienie tego samego pliku jest bezpieczne: ponieważ każdy import to pełne zastąpienie, ponowny import po prostu ustawia uczestników na wartości z pliku, zamiast sumować punkty.