Pierwsze kroki z Magento 2.x (CE i EE)

Czego się dowiesz

Dowiedz się, jak zintegrować Klaviyo ze sklepem Magento 2 CE lub EE. Musisz zainstalować rozszerzenie Klaviyo w Magento, skonfigurować rozszerzenie i skonfigurować OAuth, a następnie włączyć integrację w Klaviyo. W tym przewodniku omawiamy wszystkie wymagane kroki integracji, a także sposoby potwierdzania, że synchronizacja danych historycznych przebiegła pomyślnie.

Zanim zaczniesz

Pamiętaj, że wersje Magento 2 poniżej 2.4.0 nie są obsługiwane.

Aby zapewnić, że Klaviyo może 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ą w stanie w pełni zintegrować się 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 na liście dozwolonych dla ruchu integracji z Klaviyo.

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

1. Zaloguj się na serwer Magento 2 i przejdź do katalogu głównego aplikacji Magento z narzędzia wiersza poleceń. Ten przewodnik pokazuje przykładowe dane wyjściowe dla Terminala, ale te kroki można zmodyfikować dla dowolnego wybranego narzędzia wiersza poleceń.
2. Uruchom następujące polecenie, aby uzyskać dostęp do najnowszej wersji rozszerzenia Klaviyo z witryny Packagist. Packagist to repozytorium bibliotek kodu PHP, które pozwala łatwo zainstalować najnowszą wersję rozszerzenia. kompozytor wymaga rozszerzenia klaviyo/magento2-
3. Uruchom następujące polecenie, aby włączyć właśnie pobrane rozszerzenie Klaviyo: php bin/magento module:enable Klaviyo_Reclaim --clear-static-content
   
4. Jak pokazano w przykładowych danych wyjściowych, musisz teraz włączyć wszelkie dodatkowe moduły. Aby je włączyć, uruchom następujące polecenie: php bin/magento setup:upgrade
5. Zeskanuj dane wyjściowe modułu „Klaviyo_Reclaim”, aby potwierdzić, że moduł Klaviyo jest włączony i działa.
6. Aby CSS i JS w Twoim sklepie Magento 2 działały poprawnie, musisz uruchomić polecenie wdrażania treści statycznej. php bin/magento setup:static-content:deploy -f
   
7. Możesz teraz powrócić do pulpitu administratora Magento z poziomu przeglądarki.

Instalacja przez Composer została zakończona! Przejdź do następnej sekcji, aby uzyskać instrukcje konfiguracji.

Skonfiguruj rozszerzenie Klaviyo

Film instruktażowy

1. Na koncie Klaviyo przejdź do karty Klucze API.
2. W nowej karcie przejdź do strony administratora Magento sklep.
3. W sekcji Ustawienia kliknij opcję sklep > Konfiguracja.
4. Z listy rozwijanej Klaviyo kliknij Ogólne.
5. Ustaw Włącz Klaviyo Rozszerzenie na Tak.
6. Skopiuj swój sześciocyfrowy klucz publiczny Klaviyo API z zakładki klucz API i wklej go w odpowiednim polu w Magento.
7. W zakładce Klaviyo klucz API wygeneruj nowy klucz prywatny, a następnie wklej go do odpowiedniego pola w Magento. Uwierzytelnienie za pomocą prywatnego klucza API pozwoli Ci zsynchronizować subskrypcje newslettera z Magento do Klaviyo.

W następnej sekcji skonfigurujesz OAuth, który włącza inne aspekty integracji.

Skonfiguruj usługę OAuth

Następnie włączysz uwierzytelnianie OAuth, aby bezpiecznie połączyć swoje konto Klaviyo z rozszerzeniem Magento 2.

1. Przejdź do zakładki Setup OAuth w Magento.
2. Nadaj integracji niezapomnianą nazwę, ponieważ dzięki tej nazwie będzie trzeba ją później zlokalizować.
3. Kliknij Zapisz konfigurację,aby kontynuować.
   
4. W lewym okienku nawigacyjnym znajdź opcję System, a na pasku zadań wybierz opcję Integracje.
5. Znajdź nazwę integracji i kliknij przycisk Aktywuj. Aktywacja integracji spowoduje otwarcie okna z prośbą o zatwierdzenie dostępu.
   
6. Kliknij Zezwól, aby przejść do Klaviyo, gdzie dokończysz konfigurację integracji.
   
7. Jeśli pojawi się odpowiedni komunikat, 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 konta Klaviyo powiązanego z kluczem API użytym do konfiguracji. Jeśli logujesz się na wiele kont Klaviyo i nie wyświetlasz właściwego konta, wyloguj się z innych sesji.

Jeśli okno zamknie się automatycznie, połączenie powiodło się. Sukces możesz również potwierdzić, otwierając konto Klaviyo w nowej karcie przeglądarki lub w nowej karcie przeglądarki, wybierając kartę Integracje i wyszukując Magento 2 na liście.

Jeśli zamiast tego pojawi się poniższy błąd, upewnij się, że klucze API użyte w pierwszym kroku odpowiadają kontu, do którego się obecnie logujesz.

Podczas nawiązywania połączenia między Magento i Klaviyo, jeśli zamiast tego otrzymasz listę błędów, możesz kliknąć każdy błąd, aby dowiedzieć się więcej o jego przyczynie.

Ustaw listę newsletter

Następnie wybierz listę Klaviyo, z którą chcesz zsynchronizować subskrybenta newsletter. Masz również możliwość skorzystania z ustawień Klaviyo opt-in lub Magento 2 opt-in dla wybranej listy.

1. Na stronie Magento kliknij opcję newsletter.
2. Wybierz z listy rozwijanej Klaviyo listę, z którą chcesz zsynchronizować swój Magento formularz rejestracyjny.
3. Kliknij Zapisz konfigurację.

włącz zgodę na stronie płatności kasa

Następnie możesz włączyć zgodę na stronie płatności kasa za wysyłkę e-mail i SMS.

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.

1. Na stronie Konfiguracja w sekcji Klaviyo przejdź do sekcji Zgoda przy kasie.
   
2. Zobaczysz sekcję dotyczącą pozyskiwania zgody na wysyłkę e-maili i SMS-ów. Oba typy są traktowane oddzielnie, więc zarówno e-maile, jak i SMS-y mogą być używane oddzielnie. Jeśli gromadzisz zarówno subskrybentów SMS, jak i e-maili, wybierz inną listę dla wiadomości SMS niż dla e-maili. Dzięki temu zgoda będzie zawsze prawidłowo przypisywana do właściwego kanału.
   
   • Zgoda nie zostanie zsynchronizowana (zarówno w przypadku wysyłki e-mail, jak i SMS), dopóki klient nie zakończy składania zamówienia i, jeśli ma to zastosowanie, nie potwierdzi swojej subskrypcji z powodu podwójnej zgody opt-in.
   • Pamiętaj, że dla użytkowników, którzy już zalogowali się do Twojego Magento 2 sklep, pole wyboru zgody na e-mail nie pojawi się domyślnie na stronie płatności kasa.
3. W sekcji E-maile wybierz opcję Tak dla opcji Subskrybuj kontakty do marketingu e-mailowego podczas finalizacji zamówienia.
4. Wybierz listę e-mailową, z którą chcesz zsynchronizować subskrybenta, np. newsletter.
5. Wprowadź tekst pola wyboru zgody opt-in na wiadomości e-mail, którego chcesz użyć.
   
6. W sekcji SMS-y wybierz Tak dla opcji Subskrybuj kontakty do wysyłki marketingu SMS-owego podczas finalizacji zamówienia.
7. Wybierz listę, z którą chcesz zsynchronizować kontakty SMS. Więcej informacji na temat tych ustawień znajdziesz w naszym przewodniku pozyskiwania zgody na wysyłkę SMS-ów po przejściu do kasy.
   
8. Kolejność sortowania umożliwia zmianę rozmieszczenia pól zgody na wysyłanie wiadomości e-mail i SMS. Domyślnie pola te pojawiają się odpowiednio pod pierwszym wprowadzonym adresem e-mail i polem numeru telefonu do wysyłki. Tak więc, jeśli nie zmieniłeś układu strony płatności kasa, nie musisz zmieniać kolejności sortowania. Jeśli zmieniłeś układ, dostosuj odpowiednio kolejność sortowania.
9. Po zakończeniu w prawym górnym rogu kliknij Zapisz konfigurację.

włącz webhook

Następnie włączysz webhooki Klaviyo na swoim koncie Magento 2. Pamiętaj, że włączenie webhooków jest wymagane do poprawnego działania zgody na etapie płatności w kasie.

1. Z pulpitu administratora przejdź do sklepu > Konfiguracja.
2. Kliknij Klaviyo i wybierz kartę Webhooki.
3. 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 w tym polu należy wprowadzić 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.
   
4. Z listy rozwijanej wybierz opcję Tak obok webhooków, które chcesz włączyć. Więcej na temat webhooków obsługiwanych przez Klaviyo znajdziesz w naszym przewodniku po webhookach dla Magento 2.
5. Kliknij Zapisz konfigurację.

włącz Magento 2 integracje w Klaviyo

Film instruktażowy

1. Otwórz stronę Klaviyo, a następnie wybierz integracje z nawigacji po lewej stronie. Znajdź Magento 2 na liście i wybierz go.
2. Na następnej stronie znajdziesz opcję dodawania nowych klientów Magento 2 do listy Klaviyo. Kliknij pole wyboru Dodaj nowych klientów Magento 2 do listy Klaviyo i wybierz listę z rozwijanego menu. Pamiętaj, że zaznaczenie tego ustawienia spowoduje tylko dodanie klientów do wybranej listy, ale nie zasubskrybuje ich do otrzymywania wiadomości marketingowych. To ustawienie spowoduje synchronizację tylko nowych klientów. należy ręcznie przenieść istniejących klientów z listy Magento do Klaviyo.
   
3. Następnie wybierz widoki sklepu z Magento 2, które chcesz zsynchronizować z Klaviyo. Wszystkie widoki sklepu są domyślnie synchronizowane z Klaviyo. To ustawienie pozwala na wybranie sklepów, z którymi się integrujesz. Jeśli korzystasz z Multi-Source Inventory (MSI) w Magento 2, sprawdź Specyficzne widoki sklepów Magento 2 i wybierz sklepy, które chcesz zsynchronizować, aby zobaczyć swoje zapasy prawidłowo reprezentowane w Klaviyo.
4. W sekcji Zaawansowane włącz odpowiednio następujące ustawienia:
   
   • Specjalne ustawienia cen To ustawienie odnosi się do specjalnej ceny promocyjnej dla produktów, która opcjonalnie może zacząć obowiązywać w określonym zakresie dat. Zdecydowanie zalecamy, by włączyć tę funkcję, jeśli planujesz z nich korzystać, ponieważ później będzie to trudniejsze. Po włączeniu opcji Użyj ceny specjalnej dla cen produktów, gdy będzie to możliwe, w bloku produktu wyświetli się cena promocyjna. W przypadku dynamicznego feedu produktowego cena promocyjna zostanie podana w momencie wysyłki. W przypadku ręcznego wyboru pozycji z katalogu cena promocyjna pojawi się po wybraniu produktów. Dla każdego produktu istnieją 4 pola metadanych, które zostaną zsynchronizowane:
     • 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.
   • Niestandardowy główny adres URL multimediów To ustawienie umożliwia zmianę domyślnej ścieżki dla obrazów na Twojej stronie. Włącz to ustawienie, jeśli hostujesz obrazy produktów pod innym adresem URL niż Twoja strona internetowa.
5. Kliknij Zapisz.

Integracja z Magento 2 została pomyślnie włączona! Za kilka minut rozpocznie się synchronizacja danych z Klaviyo.

Po zakończeniu początkowej synchronizacji dane historyczne Magento 2 integracje synchronizują się co 30 minut.

dane zsynchronizowane z integracją Magento 2

KlaviyoIntegracja Magento 2 pobiera kluczowe informacje o kliencie 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 zakupione artykuły, obrazy artykułów, kategorie artykułów i wszelkie zastosowane rabaty.
• Dane dotyczące realizacji, zwrotu i anulowania zamówienia.
• Kiedy ludzie odwiedzają Twoją witrynę i które elementy przeglądają; śledzenie aktywności na stronie jest obsługiwane przez rozszerzenie.

Aby dowiedzieć się więcej, przejdź do dokumentacji danych z Magento 2.

Konwertuj Magento wartość zamówienia na jedną walutę

Klaviyo obsługuje przeliczanie wszystkich walut obcych w Magento na jedną walutę podstawową w Klaviyo. Skontaktuj się z działem wsparcia, aby włączyć tę funkcję. Jest to szczególnie pomocne w przypadku wielu sklepów, w których transakcje realizowane są w różnych walutach.

Kiedy ta funkcja jest włączana:

• Do konwersji dochodzi, 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.

Uaktualnij swoje rozszerzenie

Chcesz zaktualizować rozszerzenie Klaviyo dla Magento 2? Postępuj zgodnie z instrukcjami zawartymi w sekcji Instalacja powyżej i uruchom polecenie, aby zainstalować najnowszą wersję. Spowoduje to zastąpienie obecnej wersji, a aktualizacja zostanie zakończona. Nie trzeba ponownie konfigurować rozszerzenia ani włączać integracji w Klaviyo.

Ponowna synchronizacja katalogu

W dowolnym momencie możesz poprosić o pełną historyczną ponowną synchronizację katalogu Magento 2. Ponowna synchronizacja katalogu ułatwi Ci korzystanie z aktualizacji Klaviyo stanu magazynowego i funkcji związanych z wariantami.

Aby ponownie zsynchronizować katalog:

1. Wybierz zakładkę Integracje w Klaviyo.
2. Proszę wybrać integrację Magento 2 z listy.
3. Kliknij zakładkę Dane.
4. W sekcji Zsynchronizuj dane katalogu kliknij Zsynchronizuj ponownie.