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 ustawić OAuth, a następnie włączyć integracje w Klaviyo. Niniejszy przewodnik obejmuje wszystkie wymagane kroki integracji, a także sposób potwierdzenia, że synchronizacja danych historycznych zakończyła się powodzeniem. 

Zanim zaczniesz

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.

Rozszerzenie Klaviyo Magento 2 powinno zostać zainstalowane poprzez Composer. Pamiętaj, że instalacja za pomocą Composera wymaga administratora IT z dostępem 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 poniższe polecenie, aby uzyskać dostęp do najnowszej wersji rozszerzenia Klaviyo z Packagist. Packagist to repozytorium bibliotek kodu PHP, dzięki któremu możesz łatwo zainstalować najnowszą wersję rozszerzenia.
   composer require Klaviyo/magento2-extension
3. Uruchom poniższe polecenie, aby włączyć właśnie pobrane rozszerzenie Klaviyo:
   php bin/Magento module:włącz Klaviyo_Reclaim --clear-static-content
4. Jak pokazano na przykładowym wyjściu, musisz teraz włączyć wszystkie dodatkowe moduły. Uruchom poniższe polecenie, aby je włączyć:
   php bin/Magento setup:upgrade
5. Przeskanuj dane wyjściowe modułu "Klaviyo_Reclaim ", aby potwierdzić, że moduł Klaviyo jest włączony i uruchomiony.
6. Aby upewnić się, że CSS i JS na twoim Magento 2 sklep nadal działają poprawnie, musisz uruchomić polecenie wdrożenia statycznej zawartości.
   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 swoim koncie Klaviyo przejdź do zakładki klucz 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 uwierzytelnienie OAuth, aby bezpiecznie połączyć swoje konto Klaviyo z rozszerzeniem Magento 2. 

1. Przejdź do zakładki Setup OAuth w Magento.
2. Nadaj swoim integracjom łatwą do zapamiętania nazwę, ponieważ będziesz musiał później zlokalizować je według tej nazwy.
3. Kliknij Zapisz konfigurację , aby kontynuować.
   
4. Znajdź System w lewym panelu nawigacyjnym i wybierz Integracje z zasobnika systemowego.
5. Znajdź nazwę swojej integracji i kliknij przycisk Aktywuj. Aktywacja integracji otworzy okno z prośbą o zatwierdzenie dostępu.
   
6. Kliknij Zezwól, aby zostać przekierowanym na stronę Klaviyo, gdzie dokończysz konfigurację integracji.
   
7. Zaloguj się na Klaviyo, jeśli zostaniesz o to poproszony, lub potwierdź, że nazwa Twojego konta jest poprawna i kliknij przycisk Integruj. Spowoduje to dodanie integracji Magento 2 do konta Klaviyo powiązanego z kluczem API, którego użyłeś do konfiguracji. Jeśli jesteś zalogowany na wielu kontach Klaviyo, a prawidłowe konto nie jest wyświetlane, wyloguj się z innych sesji.
   

Jeśli okno zamknie się automatycznie, połączenie powiodło się. Możesz również potwierdzić powodzenie, otwierając konto Klaviyo w nowej karcie lub oknie przeglądarki, wybierając zakładkę integracje i szukając Magento 2 na liście.

Jeśli zamiast tego otrzymasz następujący błąd, upewnij się, że klucz API użyty w pierwszym kroku odpowiada kontu, na które aktualnie się 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 przycisk 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łączasz zgodę na stronie płatności kasa, musisz również włączyć webhook (poniżej), aby zgoda na stronie płatności kasa działała poprawnie. 

1. Na stronie konfiguracji, w sekcji Klaviyoprzejdź do opcji Zgoda na stronie płatności kasa.
   
2. Zobaczysz sekcję dotyczącą zbierania zgody na wysyłkę wiadomości e-mail i zgody na wysyłkę SMS. Oba są traktowane oddzielnie, więc możesz zbierać tylko wiadomości e-mail, tylko SMS-y lub oba. Jeśli gromadzisz zarówno subskrybentów SMS, jak i e-mail, wybierz inną listę dla SMS niż dla e-mail. Dzięki temu masz pewność, że zgoda będzie zawsze prawidłowo przypisana 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-mail wybierz Tak, abysubskrybować kontakt z marketingiem e-mailowym na stronie płatności kasa.
4. Wybierz listę e-mailową, z którą chcesz zsynchronizować subskrybenta, np. newsletter.
5. Wprowadź tekst pola wyboru e-mail, którego chcesz użyć.
   
6. SMSPod, wybierz Tak dla subskrybować kontakt do marketingu SMS-owy na stronie płatności kasa.
7. Wybierz listę, z którą chcesz zsynchronizować kontakt SMS. Aby uzyskać więcej informacji na temat tych ustawień, przejdź na stronę płatności przejdź do kasy naszego przewodnika po zbieraniu zgody na wysyłkę SMS na stronie płatnościkasa.
   
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 kliknij przycisk Zapisz konfigurację w prawym górnym rogu.

włącz webhook

1. Z pulpitu administratora przejdź do sklepu > Konfiguracja.
2. Kliknij przycisk Klaviyo i wybierz zakładkęwebhook. 
3. Utwórz klucz tajny webhook i wprowadź go w odpowiednim polu webhook Secret. Sekret webhook jest kluczem, którego Klaviyo użyje do walidacji. Ten sekret może być dowolny, ale zalecamy utworzenie bezpiecznego ciągu liter i cyfr. Magento ukryje Twój sekret webhook za pomocą gwiazdek dla celów bezpieczeństwa, więc uważaj, aby wprowadzić go poprawnie.
   
   Jeśli korzystasz z integracji wielu sklepów, sekret webhook w tym polu powinien być wprowadzony w domyślnej konfiguracji, a ten sam sekret będzie używany jako walidacja dla każdej konfiguracji sklepu. Sekret webhook powinien być dodany tylko do domyślnej konfiguracji i nie powinien być dodawany dla każdego sklepu.
4. Obok elementu webhook, który chcesz włączyć, wybierz Tak z listy rozwij anej. Aby dowiedzieć się więcej o webhookach obsługiwanych przez Klaviyo, przejdź na stronę płatności przejdź do kasy naszego przewodnika po webhookach dla Magento 2.
5. Kliknij przycisk 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 będziesz mieć możliwość dodania nowego klienta Magento 2 do listy Klaviyo. Kliknij pole wyboru Dodaj nowego Magento 2 klienta do listy Klaviyo i wybierz listę z listy rozwijanej. Zwróć uwagę, że zaznaczenie tego ustawienia spowoduje jedynie dodanie klienta do wybranej listy, ale nie podskrybowanie go do wiadomości marketingowych.
   
   To ustawienie zsynchronizuje tylko nowego klienta; istniejący klient musi zostać ręcznie przeniesiony z Twojej Magento listy Klaviyo na.
3. W sekcji Zaawansowane włącz następujące ustawienia zgodnie z potrzebami :
   • Sklepy
     Wszystkie sklepy Magento 2 są domyślnie zsynchronizowane z Klaviyo. To ustawienie pozwala na wybranie sklepów, z którymi się Państwo integrują. Jeśli korzystają Państwo z Multi-Source Inventory (MSI) w Magento 2, proszę zaznaczyć opcję Tylko zsynchronizuj określone sklepy Magento 2 i wybrać sklepy, które mają zostać zsynchronizowane, aby Państwa zapasy były prawidłowo reprezentowane w Klaviyo.
   • Ustawienia ceny specjalnej
     To ustawienie odnosi się do specjalnej ceny sprzedaży produktów, która może opcjonalnie obowiązywać w określonym zakresie dat. Zdecydowanie zalecamy włączenie tej funkcji, jeśli planujesz z niej korzystać, ponieważ trudniej jest ją później włączyć. Gdy włączysz opcję Użyj ceny specjalnej dla cen produktów, gdy ma to zastosowanie, blok produktu wyświetli cenę specjalną, gdy ma to zastosowanie. W przypadku korzystania z dynamicznego feedu produktowego cena specjalna zostanie wyświetlona w czasie wysyłki. Podczas ręcznego wybierania pozycji z katalogu cena specjalna zostanie wyświetlona po wybraniu produktów. Dla każdego produktu istnieją 4 pola metadanych, które zostaną zsynchronizowane:
     
     • cena
       (Wymagane, zmiennoprzecinkowe) Standardowa cena przedmiotu.
     • special_price
       (Opcjonalnie, zmiennoprzecinkowa) Jest to specjalna cena sprzedaży przedmiotu. Gdy ta cena obowiązuje, zobaczysz tę cenę specjalną obok przekreślenia ceny.
     • special_from_date
       (Opcjonalnie, data) Określa datę rozpoczęcia obowiązywania special_price.
     • special_to_date
       (Opcjonalnie, data) Określa datę końcową obowiązywania ceny specjalnej.
   • Niestandardowy główny adres URL multimediów
     To ustawienie pozwala zmienić domyślną ścieżkę dla obrazów Twojej witryny. Włącz to ustawienie, jeśli hostujesz obrazy produktów pod adresem URL innym niż Twoja witryna. 
4. Kliknij przycisk Zapisz.

Pomyślnie włączyłeś Magento 2 integracje! Twoje dane zaczną synchronizować się z Klaviyo w ciągu kilku minut. 

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, odwiedź naszą stronę Magento 2 dane reference. 

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

Klaviyo pomoc konwersji wszystkich walut obcych w Magento na jedną walutę główną w Klaviyo. Skontaktuj się z nami, aby włączyć tę funkcję. Jest to szczególnie przydatne, jeśli masz wiele sklepów z transakcjami w różnych walutach.

Kiedy ta funkcja jest włączana:

• Konwersja ma miejsce, gdy Magento synchronizuje dane zamówienia z Klaviyo. 
• Klaviyo sprawdzi, czy order_currency_code jest taki sam jak ustawiony global_currency_code. Jeśli nie, Klaviyo przeliczy sumę zamówienia z waluty zamówienia na określoną walutę globalną, aby upewnić się, że Twoje dane analityczne są dokładne. Pamiętaj, że pozycje zamówienia pozostaną w kodzie waluty zamówienia i nie zostaną przeliczone. 

Uaktualnij swoje rozszerzenie

Chcesz zaktualizować rozszerzenie Klaviyo Magento 2? Postępuj zgodnie z instrukcjami opisanymi w sekcji Instalacja powyżej i uruchom polecenie, aby zainstalować najnowszą wersję. Spowoduje to zastąpienie bieżącej wersji i aktualizacja zostanie zakończona - nie ma potrzeby ponownej konfiguracji rozszerzenia ani ponownego włączania integracji w Klaviyo.

Ponowna synchronizacja katalogu

W dowolnym momencie mogą Państwo poprosić o pełną historyczną ponowną synchronizację katalogu Magento 2. Ponowna synchronizacja katalogu może pomóc Państwu skorzystać z aktualizacji Klaviyo w zakresie zapasów 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 Synchronizuj dane katalogu kliknąć przycisk Ponów synchronizację.
   
   

Dodatkowe źródła

• Magento 2 dane referencyjne
• Społeczność Klaviyo: Magento 2 "Zapytaj mnie o cokolwiek" Wideo z pytaniami i odpowiedziami