Pierwsze kroki z Magento 2.x (CE i EE)
Czego się dowiesz?
Dowiedz się, jak zintegrować Klaviyo ze swoim sklepem Magento 2 CE lub EE. Musisz zainstalować rozszerzenie Klaviyo w Magento, skonfigurować rozszerzenie i skonfigurować OAuth, a następnie włączyć integracje w Klaviyo. Ten przewodnik obejmuje wszystkie wymagane kroki integracji, a także opisuje, jak potwierdzić, że synchronizacja twoich danych historycznych przebiegła pomyślnie.
Kilka słów na początek
Pamiętaj, że wersje Magento 2 starsze niż 2.4.0 nie są obsługiwane.
Aby Klaviyo mogło wykonywać niezbędne wywołania API dla integracji, Twój serwer Magento 2 musi mieć publicznie dostępną nazwę hosta. Serwery Magento 2 hostowane lokalnie nie będą mogły zostać w pełni zintegrowane z Klaviyo.
Zdecydowanie zaleca się dodanie adresów IP Klaviyo do białej listy dostawcy zapory sieciowej, aby zminimalizować problemy z uwierzytelnianiem i konfiguracją. Więcej informacji na ten temat znajdziesz w artykule na temat umieszczania adresów IP ruchu integracji Klaviyo na białej liście.
Rozszerzenie Klaviyo do Magento 2 należy zainstalować za pośrednictwem Composera. Pamiętaj, że do instalacji za pośrednictwem Composera potrzebny jest administrator IT z dostępem przez SSH do serwera, na którym hostowane jest Magento 2.
Zainstaluj rozszerzenie Klaviyo w Magento 2
- Zaloguj się na serwer Magento 2 i za pomocą narzędzia do obsługi wiersza poleceń przejdź do katalogu głównego aplikacji Magento. W tym przewodniku przedstawiono przykładowe dane wyjściowe aplikacji Terminal, ale te kroki można zmodyfikować dla dowolnego narzędzia wiersza poleceń.
- Uruchom następujące polecenie, aby uzyskać dostęp do najnowszej wersji rozszerzenia Klaviyo z Packagist. Packagist to repozytorium bibliotek kodu PHP, które pozwala łatwo zainstalować najnowszą wersję rozszerzenia.
composer require klaviyo/magento2-extension - Uruchom następujące polecenie, aby włączyć rozszerzenie Klaviyo, które właśnie pobrano:
php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
- Jak pokazano w przykładowych danych wyjściowych, musisz teraz włączyć wszystkie dodatkowe moduły. Uruchom następujące polecenie, aby je włączyć:
php bin/magento setup:upgrade - Przeskanuj dane wyjściowe pod kątem
Module 'Klaviyo_Reclaim', aby potwierdzić, że moduł Klaviyo jest włączony i działa. - Aby mieć pewność, że CSS i JS w Twoim sklepie Magento 2 nadal będą działać prawidłowo, musisz uruchomić polecenie wdrożenia zawartości statycznej.
php bin/magento setup:static-content:deploy -f
- Możesz teraz wrócić do pulpitu administratora Magento w przeglądarce.
Instalacja za pośrednictwem Composera zakończona! Aby uzyskać instrukcje dotyczące konfiguracji, przejdź do następnej sekcji.
Skonfiguruj rozszerzenie Klaviyo
Wideo instruktażowe
- Na koncie Klaviyo przejdź do karty kluczy API.
- W nowej karcie przejdź do panelu administratora sklepu Magento.
- W sekcji Ustawienia kliknij Sklepy > Konfiguracja.
- W menu rozwijanym Klaviyo kliknij Ogólne.
- Ustaw Włącz rozszerzenie Klaviyo na Tak.
- Skopiuj swój publiczny klucz API Klaviyo (Site ID) z karty Klucze API i wklej go do odpowiedniego pola w Magento.
- Na karcie kluczy API w Klaviyo utwórz nowy prywatny klucz API i skopiuj go do odpowiedniego pola w Magento. Uwierzytelnianie za pomocą Twojego prywatnego klucza API pozwala Ci synchronizować subskrypcje newslettera z Magento do Klaviyo.
W następnej sekcji skonfigurujesz protokół OAuth, który włączy inne aspekty integracji.
Skonfiguruj usługę OAuth
Następnie włączysz uwierzytelnianie OAuth, aby bezpiecznie połączyć swoje konto Klaviyo z rozszerzeniem Magento 2.
- Przejdź do zakładki Konfiguracja OAuth w Magento.
- Nadaj swojej integracji niezapomnianą nazwę, ponieważ będzie trzeba ją później zlokalizować.
- Kliknij Zapisz konfigurację,aby kontynuować.
- W lewym okienku nawigacyjnym znajdź opcję System, a na pasku zadań wybierz opcję integracje.
- Znajdź nazwę integracji i kliknij przycisk Aktywuj. Aktywacja integracji spowoduje otwarcie okna z prośbą o zatwierdzenie dostępu.
- Kliknij Zezwól, aby przejść do Klaviyo, gdzie dokończysz konfigurację integracji.
- Jeśli pojawi się komunikat z odpowiednim komunikatem, zaloguj się do Klaviyo lub potwierdź, że nazwa konta jest poprawna, a następnie kliknij przycisk Integruj. Spowoduje to dodanie integracji z Magento 2 do interfejsu API Klaviyo powiązanego z interfejsem API klucz użytym do konfiguracji. Jeśli logujesz się do wielu kont Klaviyo, a właściwe konto nie jest wyświetlane, wyloguj się z pozostałych sesji.
Jeśli okno zamknie się automatycznie, połączenie powiodło się. Sukces można również potwierdzić, otwierając Klaviyo konto w nowej karcie lub nowym oknie przeglądarki, wybierając zakładkę integracje i wyszukując Magento 2 znajdujące się na liście.
Jeśli widzisz błąd „Konto Klaviyo nie pasuje do identyfikatora firmy”, upewnij się, że klucz API wprowadzony w Magento należy do konta Klaviyo, na które jesteś obecnie zalogowany(-a), a następnie spróbuj ponownie.
Jeśli podczas nawiązywania połączenia między Magento i Klaviyo otrzymasz listę błędów, możesz kliknąć każdy błąd, aby dowiedzieć się więcej na jego temat.
Ustaw listę newslettera
Następnie wybierz listę Klaviyo, z którą chcesz synchronizować subskrybentów newslettera. Możesz także użyć ustawień zgody opt-in Klaviyo lub ustawień zgody opt-in Magento 2 dla wybranej listy.
- W Magento kliknij Newsletter.
- Wybierz z menu rozwijanego listę Klaviyo, z którą chcesz zsynchronizować formularz rejestracyjny Magento.
- Kliknij Zapisz konfigurację.
Włącz wyrażanie zgody na stronie płatności
Możesz zbierać zgodę w kasie na e-mail oraz na kanały mobilne (SMS, WhatsApp lub oba).
Pamiętaj, że jeśli włączysz wyrażanie zgody w kasie, konieczne będzie również włączenie webhooków (poniżej), aby wyrażanie zgody przy przejściu do kasy działało poprawnie.
- Na stronie Konfiguracja w sekcji Klaviyo przejdź do sekcji Zgoda przy kasie.
- Pojawi się sekcja dotycząca pozyskiwania zgody na wysyłkę e-maili i zgody na urządzenia mobilne (SMS/WhatsApp). Oba typy są traktowane oddzielnie, więc możesz zbierać tylko e-maile, same SMS-y/WhatsApp lub oba typy. Jeśli gromadzisz zarówno subskrybentów wiadomości SMS/WhatsApp, jak i subskrybentów e-maili, wybierz inną listę dla wiadomości SMS/WhatsApp niż dla subskrybentów e-maili. Dzięki temu zgoda będzie zawsze poprawnie przypisana do właściwego kanału.
- Zgoda nie będzie synchronizowana (zarówno w przypadku e-maili, jak i SMS-ów/WhatsAppa), dopóki klient nie zakończy składania zamówienia i, jeśli ma to zastosowanie, potwierdzi subskrypcję dzięki funkcji podwójnej zgoda opt-in.
- Pamiętaj, że w przypadku użytkowników, którzy zalogowali się już do Twojego sklepu Magento 2, pole wyboru zgody na wysyłkę e-maili nie pojawi się domyślnie przy kasie.
- W sekcji E-maile wybierz Tak, aby subskrybować kontakty do marketingowych wiadomości e-mail przy kasie.
- Wybierz wiadomość e-mail na liście mailingowej, do której chcesz zsynchronizować subskrybowanych, np. newsletter.
- Wprowadź tekst pola wyboru zgody opt-in na wiadomości e-mail, którego chcesz użyć.
- W sekcji Mobilne wybierz opcję Tak, jeśli chodzi o odbierz wiadomość tekstową i wiadomość tekstową subskrybenta.
- Wybierz listę, z którą mają się synchronizować kontakty SMS/WhatsApp. Aby uzyskać więcej szczegółów dotyczących tych ustawień, zapoznaj się z naszym przewodnikiem na temat zbierania zgody na SMS i/lub WhatsApp podczas realizacji zakupu.
- Kolejność sortowania umożliwia zmianę umieszczenia pól zgody na wysyłkę e-maili i SMS-ów. Domyślnie pola te znajdują się odpowiednio pod pierwszym polem wprowadzania adresu e-mail i numerem telefonu do wysyłki. Jeśli więc nie zmieniono układu strony kasy, nie trzeba zmieniać kolejności sortowania. W przypadku zmiany układu strony odpowiednio dostosuj porządek sortowania.
- Po zakończeniu w prawym górnym rogu kliknij Zapisz konfigurację.
Włącz webhook
Następnie należy włączyć webhook Klaviyo na koncie Magento 2. Pamiętaj, że włączenie webhooków jest wymagane do poprawnego działania zgody na etapie płatności w kasie.
- Z pulpitu administratora przejdź do obszaru Sklepy > Konfiguracja.
- Kliknij Klaviyo i wybierz zakładkę webhook.
- Utwórz klucz tajny webhooka i wprowadź go w odpowiednim polu. Tajny klucz webhooka to klucz, którego Klaviyo będzie używać do walidacji. Tym sekretem może być dowolny wybrany przez Ciebie sekret, ale zalecamy utworzenie bezpiecznego ciągu liter i cyfr. Ze względów bezpieczeństwa Magento ukryje Twój sekret webhook za pomocą gwiazdek, więc pamiętaj o jego poprawnym wprowadzeniu.
Jeśli korzystasz z integracji z wieloma sklepami, sekret webhooka z tego pola należy wpisać w domyślnej konfiguracji. Ten sam sekret będzie używany do weryfikacji dla każdej konfiguracji sklepu. Sekret webhooka należy dodawać tylko do domyślnej konfiguracji, a nie dla każdego sklepu.
- Obok webhooków, które chcesz włączyć, wybierz Tak z menu rozwijanego. Aby dowiedzieć się więcej o webhookach obsługiwanych przez Klaviyo, zapoznaj się z naszym przewodnikiem po webhookach dla Magento 2.
- Kliknij Zapisz konfigurację.
Włącz integracje Magento 2 w Klaviyo
Wideo instruktażowe
- Otwórz Klaviyo, a następnie w menu nawigacyjnym po lewej stronie wybierz integracje. Znajdź na liście Magento 2 i wybierz je.
- Na następnej stronie możesz wybrać dodanie klientów z Magento 2 do listy Klaviyo. Wybierz Dodaj nowych klientów z Magento 2 do listy Klaviyo i wybierz listę z menu rozwijanego. Samo dodanie klienta do listy nie oznacza udzielenia zgody marketingowej. Aby ją uzyskać, użyj ustawień zgody na newsletter i w realizacji zakupu w Magento.
Istniejące profile klientów są uwzględnione w synchronizacji danych historycznych. Aby przesłać istniejących subskrybentów newslettera z pliku CSV, skorzystaj z przewodnika dotyczącego przesyłania istniejących subskrybentów Magento 2 do listy w Klaviyo.
- Następnie wybierz, które widoki sklepu z Magento 2 chcesz zsynchronizować z Klaviyo. Domyślnie wszystkie widoki sklepu są synchronizowane z Klaviyo. To ustawienie pozwala Ci wybrać, z którymi sklepami chcesz się integrować. Jeśli korzystasz z Multi-Source Inventory (MSI) w Magento 2, wybierz Określone widoki sklepu Magento 2 i wybierz sklepy, które chcesz zsynchronizować, aby Twoje stany magazynowe były prawidłowo wyświetlane w Klaviyo.
- W sekcji Advanced skonfiguruj poniższe ustawienia zgodnie z potrzebami:
- Ustawienia cen specjalnych
To ustawienie dotyczy specjalnej ceny promocyjnej produktów, która opcjonalnie może obowiązywać w określonym zakresie dat. Włącz to przed pierwszą synchronizacją katalogu, jeśli planujesz używać cen specjalnych. Jeśli włączysz to później, zsynchronizuj ponownie katalog, aby odświeżyć istniejące produkty. Gdy włączysz Użyj ceny specjalnej dla cen produktów, gdy ma zastosowanie, blok produktu będzie wyświetlać cenę specjalną, gdy ma ona zastosowanie. Podczas korzystania z dynamicznego feedu produktowego cena specjalna zostanie uzupełniona w czasie wysyłki. Gdy ręcznie wybierasz produkty z katalogu, cena specjalna zostanie uzupełniona, gdy tylko wybierzesz produkt(-y). Dla każdego produktu zsynchronizują się cztery pola metadanych:- Price
(Wymagany, liczba zmiennoprzecinkowa) Standardowa cena produktu. - cena_specjalna
(opcjonalnie, zmiennoprzecinkowa) To jest cena promocyjna dla tego produktu. Gdy cena zacznie obowiązywać, obok niej pojawi się ta cena, która zostanie przekreślona. - special_from_date
(opcjonalnie, data) Określa datę rozpoczęcia obowiązywania ceny specjalnej. - special_to_date
(opcjonalnie, data) Określa datę zakończenia obowiązywania ceny specjalnej.
- Price
- Główny adres URL multimediów
Aby zmienić domyślną ścieżkę dla obrazów w Twojej witrynie, wybierz Zmień główny adres URL multimediów i wpisz główny adres URL multimediów. Użyj tego ustawienia, jeśli Twoje obrazy są hostowane pod innym adresem URL niż Twoja witryna. - Ogranicz okresową synchronizację zamówieńdo ostatnich zamówień. Okresowe synchronizacje zamówień identyfikują zamówienia, które zostały zaktualizowane od poprzedniej okresowej synchronizacji, i uwzględniają je podczas następnej synchronizacji.
To ustawienie pozwala określić, które zamówienia kwalifikują się do okresowej synchronizacji zamówień, na podstawie daty utworzenia. Po włączeniu możesz wybrać względny zakres dat, a tylko zaktualizowane zamówienia utworzone w tym czasie zostaną uwzględnione w następnej okresowej synchronizacji zamówień. Pomaga to zapobiegać ponownemu pobieraniu starszych zamówień podczas okresowych synchronizacji, gdy w zamówieniach nastąpią nieistotne aktualizacje.
- Ustawienia cen specjalnych
- Kliknij Dokończ konfigurację.
Twoja integracja Magento 2 jest teraz włączona, a synchronizacja Twoich danych historycznych została rozpoczęta.
Po zakończeniu początkowej synchronizacji danych historycznych integracje Magento 2 będą synchronizowane co 30 minut.
Potwierdź synchronizację danych historycznych
- W Klaviyo wybierz Integracje, a następnie otwórz integrację z Magento 2.
- Wybierz kartę Dane.
- Przejrzyj sekcję dane historyczne. Podczas importowania widać postęp synchronizacji. Gdy import się zakończy, sekcja potwierdzi, że Twoje historyczne zamówienia, klienci i produkty zostały zsynchronizowane, oraz wyświetli datę Ostatnia synchronizacja.
Dane zsynchronizowane z integracjami Magento 2
Integracje Klaviyo z Magento 2 pobiera kluczowe informacje o klientach z Twojej platformy Magento.
Oto niektóre z danych, które synchronizujemy z Magento:
- Informacje o kliencie, w tym imię, nazwisko i lokalizacja.
- Dane dotyczące sprzedaży i zamówień, w tym informacje o zakupach produktów, zdjęcia i kategorie produktów oraz wszelkie zastosowane rabaty.
- Dane dotyczące realizacji, zwrotu środków i anulowanego zamówienia.
- kiedy użytkownicy odwiedzają Twoją stronę i które pozycje przeglądają; Odpowiedzialność za rozszerzenie zajmuje aktywność na stronie.
Aby dowiedzieć się więcej, przejdź do naszego dokumentu referencyjnego danych Magento 2.
Przeliczanie wartości zamówień Magento na pojedynczą walutę
Klaviyo obsługuje konwersję wszystkich walut obcych w Magento na jedną walutę podstawową w Klaviyo. Skontaktuj się z działem wsparcia, aby włączyć tę funkcje. Jest to szczególnie przydatne, jeśli masz wiele sklepów z transakcjami w różnych walutach.
Gdy te funkcje są włączone:
- Konwersja ma miejsce, gdy Magento synchronizuje dane zamówień z Klaviyo.
- Klaviyo sprawdzi, czy order_currency_code jest taki sam jak global_currency_code. Jeśli nie, Klaviyo przeliczy kwotę zamówienia z waluty zamówienia na wskazaną walutę globalną, aby zapewnić dokładność danych analitycznych. Pamiętaj, że pozycje zamówienia pozostaną w kodzie waluty zamówienia i nie będą przeliczane.
Zaktualizuj rozszerzenie
Aby zaktualizować rozszerzenie Klaviyo Magento 2, powtórz kroki z sekcji Zainstaluj rozszerzenie Klaviyo w Magento 2 powyżej, w tym polecenia aktualizacji Magento i wdrożenia zawartości statycznej. Te kroki zastąpią Twoją obecną wersję rozszerzenia. Nie musisz ponownie konfigurować rozszerzenia ani ponownie włączać integracji w Klaviyo.
Ponowna synchronizacja katalogu
W dowolnym momencie możesz uruchomić pełną historyczną ponowną synchronizację katalogu Magento 2. Ponowna synchronizacja katalogu może pomóc Ci skorzystać z aktualizacji Klaviyo dotyczących zapasów i funkcji związanych z wariantami. Ponownie zsynchronizuj katalog po zmianie ustawień synchronizacji katalogu, aby zastosować te zmiany do istniejących produktów.
Aby ponownie zsynchronizować katalog:
- W Klaviyo wybierz kartę Integracje.
- Wybierz z listy integracje Magento 2.
- Kliknij kartę Dane.
- W sekcji Zsynchronizuj dane katalogu kliknij Zsynchronizuj ponownie.
Sprawdź postęp synchronizacji w tej samej sekcji, gdy trwa ponowna synchronizacja. Gdy się zakończy, w sekcji zobaczysz datę Ostatnia synchronizacja.
Dodatkowe źródła
- Magento 2 data reference
Learn what data Klaviyo imports from your Magento 2 store when you integrate the two platforms. Klaviyo's integration with Magento 2 pulls in all of the historical data in your Magento 2 store with the initial historic sync. Once enabled the integration will also begin to sync order and customer data every 30 minutes. Examples of this data include the information associated with past placed orders, fulfilled orders, etc.
- Klaviyo Community: Magento 2 "Ask Me Anything" Question and Answer Video