Odnośnik do wymagań systemowych integracji z Magento

Czego się dowiesz?

Dowiedz się więcej o wymaganiach systemowych dotyczących optymalnej synchronizacji z Magento 1 lub 2. Administrator Twojego sklepu Magento odpowiada za specyfikację systemu i konfigurację. Upewnienie się, że system jest skonfigurowany do współpracy z Klaviyo, zapewni płynne integracje.

Wersje Magento 2 poniżej 2.4.0 nie są obsługiwane.

Skonfiguruj uprawnienia API

W przypadku istniejącej integracji Magento 1 użytkownik SOAP API musi mieć pełny dostęp do zasobów. Upewnij się, że opcja Dostęp do zasobów jest ustawiona na Wszystkie.

W Magento 2 zainstaluj i skonfiguruj rozszerzenie Klaviyo, a następnie skonfiguruj OAuth i zatwierdź wymagane uprawnienia API. Postępuj zgodnie z przewodnikiem po integracji Magento 2, aby dokończyć konfigurację w Magento i włączyć integrację w Klaviyo.

Bez wymaganych uprawnień API Klaviyo nie będzie w stanie prawidłowo współdziałać z API Twojego sklepu Magento, co uniemożliwi integracji pobieranie danych z Twojego sklepu.

Włącz dostęp do wymaganych punktów końcowych API

Klaviyo wysyła żądania danych do określonych punktów końcowych. Konfiguracje systemu muszą umożliwiać dostęp do tych punktów końcowych; weź pod uwagę wpływ mechanizmów kontroli zabezpieczeń lub logiki przekierowań URL na dostępność tych punktów końcowych dla Klaviyo. Jeśli Klaviyo nie ma dostępu do oczekiwanych punktów końcowych API, synchronizacja części lub wszystkich danych Magento nie będzie możliwa i w aplikacji pojawi się raportowanie błędów.

W przypadku Magento 2 Twój sklep musi mieć publicznie dostępny hostname. Zezwól Klaviyo na łączenie się z /oauth/token/request i /oauth/token/access na potrzeby uwierzytelniania OAuth oraz z interfejsem REST API pod adresem /index.php/rest. Jeśli uwierzytelnianie się nie powiedzie, skorzystaj z przewodnika rozwiązywania problemów z Magento 2.

Cały ruch wychodzący z integracji Klaviyo jest obsługiwany przez zestaw przewidywalnych, statycznych adresów IP, dzięki czemu możesz mieć wysoki poziom pewności, że ten ruch pochodzi z Klaviyo; zalecamy dodanie tych adresów do listy dozwolonych.

Pojemność systemu dla żądań API synchronizacji danych historycznych

Po aktywowaniu integracje Klaviyo automatycznie kolejkowuje żądania API, aby zsynchronizować dane historyczne, w tym rekordy klientów, rekordy zamówień i katalog produktów. Staramy się zrobić to szybko, aby marketerzy mogli jak najszybciej wykorzystać te dane na swoich kontach. Staramy się też robić to w sposób odpowiedzialny, ograniczając współbieżność i płynnie obsługując ponowne próby. Jeśli sklep ma dużą liczbę danych historycznych, ograniczoną przepustowość zasobów lub inne aplikacje, które wykonują znaczną liczbę żądań API, zalecamy konsultację z administratorem Magento, aby upewnić się, że infrastruktura jest przygotowana do obsługi synchronizacji danych historycznych. Administrator może rozważyć tymczasowe zwiększenie zasobów lub zastosowanie automatycznego skalowania.

Zweryfikuj ważność certyfikatu SSL

Certyfikat SSL cyfrowo uwierzytelnia tożsamość witryny i umożliwia szyfrowane połączenie między przeglądarką internetową a serwerem WWW. Certyfikat SSL Twojej strony internetowej jest hostowany przez serwer źródłowy witryny. Ważny certyfikat SSL ma kluczowe znaczenie dla bezpiecznego przyjmowania płatności, ochrony logowań hasłem i zabezpieczania formularzy internetowych. Test serwera SSL może posłużyć do weryfikacji certyfikatu SSL witryny.

Integracje Magento mogą zostać wyłączone, jeśli wygaśnie certyfikat SSL Twojej witryny. W takim przypadku certyfikaty domeny i certyfikaty pośrednie muszą zostać zaktualizowane u dostawcy hostingu. Jeśli nie masz pewności, gdzie znajdują się Twoje certyfikaty, skontaktuj się z dostawcą hostingu, aby uzyskać pomoc.

Wystarczający przydział pamięci serwera

Miejsce na dysku na produkty, zdjęcia produktów, zapisane wiadomości e-mail i statyczne strony z treścią jest niezależne od pamięci PHP. Wystarczająca ilość miejsca na dysku nie oznacza, że PHP ma wystarczająco dużo pamięci, aby przetwarzać żądania API Klaviyo.

Zalecamy przydzielenie ponad 1 gigabajta pamięci do integracje Klaviyo, ale wymagane minimum to 512 megabajtów. Jeśli serwer nie może przydzielić wystarczających zasobów, aby odpowiadać na żądania Klaviyo, wystąpią błędy integracje. Integracje Klaviyo-Magento rozpoczyna się od synchronizacji danych historycznych, dlatego przed aktywacją integracje zaleca się sprawdzenie ustawień pamięci w Magento i na serwerze.

Sprawdź ustawienie PHP memory_limit używane przez serwer WWW Magento. Domyślna wartość PHP to 128 megabajtów, ale konfiguracja hostingu może ją zastąpić. Administrator Magento może zaktualizować to ustawienie w php.ini. W przypadku Magento 2 postępuj też zgodnie z wytycznymi Adobe dotyczącymi ustawień PHP.

Używaj znaczników czasu UTC do synchronizacji

Klaviyo używa uniwersalnego czasu koordynowanego (UTC), aby pobierać najnowsze dane z Magento i interpretować znaczniki czasu zwracane przez API. Nieprawidłowe znaczniki czasu mogą spowodować, że niektóre rekordy zostaną pominięte podczas synchronizacji lub będą wyświetlać się w Klaviyo w niewłaściwym czasie.

Poproś administratora Magento, aby sprawdził, czy znaczniki czasu zwracane przez API twojego sklepu są w UTC. Jeśli brakuje ostatnich rekordów lub pokazują nieprawidłowe godziny, sprawdź te znaczniki czasu i konfigurację serwera, zanim zmienisz ustawienia strefy czasowej sklepu.

Dodatkowe źródła