Plugin znajdziesz na Adobe Commerce Marketplace pod nazwą Ecomail Email Marketing lub klikając tutaj.

Niektóre zaawansowane funkcje e-commerce, na przykład śledzenie zachowań (behavioral tracking), obsługa zamówień oraz porzuconych koszyków, mogą wymagać odpowiedniego taryfy Ecomail.

W zależności od włączonych ustawień plugin może wysyłać do Ecomailu:

Przesyłaj wyłącznie te dane, które są rzeczywiście potrzebne i do których masz odpowiednią podstawę prawną lub zgodę.

Plugin może dodawać następujące tagi:

Podczas standardowej synchronizacji pojedynczego kontaktu plugin najpierw pobiera jego dotychczasowe tagi w Ecomailu, a następnie dodaje do nich nowe tagi. Podczas masowej synchronizacji początkowej przekazywanie tagów jest osobną opcją do wyboru, ponieważ może ono zastąpić dotychczasowe tagi kontaktu w Ecomailu.

Przygotuj:

Instalację na sklepie produkcyjnym zalecamy powierzyć administratorowi Magento lub programiście. Przed instalacją zawsze wykonaj kopię zapasową.

Magento od wersji 2.4 do instalacji rozszerzeń wykorzystuje wiersz poleceń. Po pobraniu bezpłatnego pluginu z Adobe Commerce Marketplace użyj kluczy dostępu Marketplace powiązanych z daną instalacją Magento.

W terminalu przejdź do głównego folderu Magento i uruchom:

Jeśli na Twoim serwerze bin/magento działa jako plik wykonywalny, możesz podać te polecenia również bez php:

Jeśli pojawi się komunikat Permission denied, używaj wariantu zaczynającego się od php bin/magento albo pełnej ścieżki do PHP, którą poda Ci hosting.

Jeśli pakiet instalacyjny otrzymałeś bezpośrednio od wsparcia Ecomailu, wgraj jego zawartość do:

Następnie uruchom polecenia Magento z poprzedniej sekcji, zaczynając od module:enable.

W panelu administracyjnym Magento przejdź do:

Po pomyślnym połączeniu w polu Status pojawi się informacja o aktywnym połączeniu.

Jeśli korzystasz z wielu witryn lub widoków sklepu, sprawdź w przełączniku Store View w lewym górnym rogu, dla którego poziomu zapisujesz konfigurację. Poszczególne sklepy mogą używać innego klucza API, innej listy oraz innych ustawień.

General

Personal Information

Behavior Tracking

Logs

Po zapisaniu konfiguracji plugin reaguje na nowe zdarzenia w sklepie:

Jeśli klient w kasie zaznaczy pole rezygnacji z newslettera, plugin nie utworzy ani nie zaktualizuje na podstawie tego zamówienia kontaktu newsletterowego. Wysyłanie zamówienia jako transakcji podlega osobnemu ustawieniu Send order transactions.

Przy standardowym dodawaniu lub aktualizacji kontaktu plugin zachowuje jego dotychczasowe tagi w Ecomailu i dodaje do nich tagi z Magento.

Synchronizacja początkowa służy do przekazania klientów i zamówień, które istniały w Magento już przed instalacją pluginu.

Przykład: przy 6500 klientach i paczce wielkości 3000 potrzeba co najmniej trzech przebiegów cron dla kontaktów. Zamówienia zaczną być przetwarzane w jednym z kolejnych przebiegów. Jeśli hosting uruchamia cron co pięć minut, każdy kolejny krok będzie następował po około pięciu minutach.

Masowy import transakcji nie uruchamia automatyzacji Ecomailu z triggerem „Provedl nákup / Makes an order”.

Webhook zapewnia zwrotne przekazywanie statusu zapisu z Ecomailu do newslettera Magento. Gdy kontakt wypisze się w Ecomailu, zmiana może zostać przeniesiona również do Magento.

Webhook zmienia status wyłącznie u kontaktu, który już istnieje w newsletterze Magento. Wygenerowanego tokenu nie przesyłaj nikomu ani nie publikuj go.

Po włączeniu Behavior Tracking plugin ładuje skrypt trackingowy Ecomail i wysyła informacje o odwiedzinach stron. Opcja Track product views dodaje zdarzenie wyświetlenia produktu na podstawie jego SKU.

Jeśli korzystasz z natywnego Magento Cookie Restriction Mode, pozostaw Respect Magento cookie consent ustawione na Yes. Skrypty Ecomail zostaną wtedy załadowane dopiero po zapisaniu zgody odwiedzającego.

Jeśli korzystasz z zewnętrznego paska cookies, sprawdź jego powiązanie ze zgodą Magento. Sam plugin śledzi natywną zgodę na cookies user_allowed_save_cookie.

Po skonfigurowaniu zalecamy przeprowadzenie następującego testu:

Plugin wyświetla ostatnie 10 zapytań. Wpisy są przechowywane maksymalnie przez siedem dni, a log w bazie danych jest ograniczony do 10 000 wierszy. Nie są zapisywane pełne payloady ani klucze API.

Jeśli błąd powstanie jeszcze przed wysłaniem zapytania do API, może nie pojawić się w panelu. Administrator sklepu może go odszukać również w standardowych logach Magento w folderze var/log.

Przed aktualizacją wykonaj kopię zapasową plików i bazy danych. W głównym folderze Magento uruchom:

Polecenie module:enable nie jest potrzebne przy zwykłej aktualizacji, jeśli moduł nie był wyłączony.

Po aktualizacji sprawdź konfigurację, status połączenia, jeden testowy kontakt oraz jedno testowe zamówienie.

a) Listy kontaktów się nie ładują

b) Synchronizacja początkowa pozostaje w stanie Pending

Cron Magento nie działa lub uruchamiany jest pod inną wersją PHP niż sklep. Poproś hosting o sprawdzenie, czy php bin/magento cron:run uruchamia się regularnie.

c) Synchronizacja przebiega wolno

Każdy przebieg crona przetwarza jedną paczkę. Szybkość zależy więc od interwału crona Magento oraz ustawionej wielkości paczki. Na stabilnym hostingu używaj domyślnych wartości 3000 kontaktów i 1000 transakcji.

d) Kontakt lub zamówienie nie zostały przekazane

Sprawdź Recent API Requests. Czerwony wpis zawiera status HTTP oraz skróconą wiadomość błędu. W przypadku błędu lokalnego sprawdź również logi Magento.

e) Webhook nie zmienił statusu kontaktu

f) Tracking się nie ładuje

g) Polecenie bin/magento zwraca Permission denied

Użyj polecenia z PHP:

Na niektórych hostingach konieczne jest podanie pełnej ścieżki do PHP, np. /opt/alt/php82/usr/bin/php. Prawidłową ścieżkę poda dostawca hostingu.

h) Kompilacja nie może usunąć generated/code/Magento

Zwykle chodzi o uprawnienia lub własność plików utworzonych przez innego użytkownika lub inną wersję PHP. Nie kontynuuj usuwania na oślep; poproś administratora serwera o poprawienie własności plików i bezpieczne wyczyszczenie folderu generated.