Integracja Mailchimp: konfiguracja i pomoc

1. Prześlij i zainstaluj ZIP mprmailchimp w Moduły > "Module Manager".
2. Kliknij "Configure", aby otworzyć Ustawienia Mailchimp.
3. Wpisz Klucz API i ID odbiorców/listy dla docelowej grupy odbiorców.
4. Wybierz "Opt-in Mode" i włącz "Sync Opted-in New Customers", jeśli chcesz synchronizować przy tworzeniu konta.
5. Osobno skonfiguruj skrypt połączonej witryny, jeśli chcesz śledzenia w sklepie.
6. Włącz "Enable Mailchimp" i zapisz.
7. Utwórz klienta testowego, który jawnie zaznacza subskrypcję newslettera. Sprawdź odbiorcę w Mailchimp.

Sufiks klucza API wybiera centrum danych Mailchimp, np. -us1. Skopiuj identyfikator grupy odbiorców z ustawień odpowiedniej grupy. Nie wklejaj nazwy grupy do ID odbiorców/listy.

Synchronizacja klientów i skrypt połączonej witryny to osobne funkcje. Aby synchronizować bez śledzenia w sklepie, włącz "Sync Opted-in New Customers" i wyłącz "Enable Connected Site Script".

Moduł nasłuchuje actionCustomerAccountAdd. Przed dopuszczeniem zadania synchronizacji sprawdza flagę newslettera klienta, znaczniki personelu i politykę wysyłania danych. Przełącznik synchronizacji nie stanowi zgody.

Żądanie używa stałego endpointu odbiorcy:

PUT https://us1.api.mailchimp.com/3.0/lists/YOUR_LIST_ID/members/MD5_OF_LOWERCASE_EMAIL

Wysyła email_address, FNAME i LNAME. Dla nowego odbiorcy status_if_new to subscribed w trybie pojedynczej zgody lub pending w trybie podwójnej zgody. PUT nie wymusza ponownego zapisania istniejącego wypisanego odbiorcy.

Moduł kolejkuje synchronizację kontaktów i od razu próbuje wykonać nowe zadanie. Przed wysłaniem ponownie sprawdza aktualny stan klienta, zgodę na newsletter, tożsamość, skonfigurowane miejsce docelowe i zapisany tryb zgody. Zadanie zostaje wstrzymane, gdy brakuje zapisu zgody lub zmieniło się miejsce docelowe.

Dla ponowień moduł deklaruje opcjonalne współdzielone zadanie cron mailchimp_member_sync, nazwane "Retry opted-in Mailchimp audience sync", z harmonogramem every:60. Jest domyślnie wyłączone i wymaga istniejącego mechanizmu uruchamiania cron MPR w sklepie. Moduł nie zawiera tego mechanizmu. Włącz tam zadanie, jeśli potrzebujesz zaplanowanych ponowień. Moduł nie udostępnia własnego publicznego URL ponowień.

Nie importuje hurtowo starych klientów, nie zapisuje osobnych zgłoszeń z bloku newslettera i nie zarządza kampaniami, tagami, segmentami ani ścieżkami Mailchimp.

Skopiuj URL skryptu z fragmentu kodu połączonej witryny Mailchimp do "Connected Site Script URL". Wklej tylko URL. Włącz "Enable Connected Site Script" i zapisz. Dawny ogólny fragment .../users/mc.js nie jest obecną konfiguracją.

Moduł uruchamia się przez displayBeforeBodyClosingTag. Używa bieżących kontroli zgody marketingowej, personelu i wysyłania danych oraz prywatnego endpointu konfiguracji. Publiczny kod HTML strony nie zawiera imion i nazwisk klientów ani ich adresów e-mail.

Testuj w nowej przeglądarce klienta ze zgodą marketingową. Sprawdź żądania sieciowe do dokładnego URL połączonej witryny. Sam moduł nie wysyła danych zdarzeń produktu, koszyka ani zakupu.

Jeśli nadpisujesz szablon, zachowaj jego publiczną konfigurację i skrypty wykonawcze:

themes/your-theme/modules/mprmailchimp/views/templates/hook/tracking.tpl

• Brak nowego odbiorcy: potwierdź "Enable Mailchimp", dane dostępowe, "Sync Opted-in New Customers" i jawne zaznaczenie newslettera przy rejestracji.
• Test podwójnej zgody: sprawdź oczekującego odbiorcę i proces potwierdzenia Mailchimp zamiast oczekiwać natychmiastowej subskrypcji.
• Istniejący wypisany kontakt: moduł nie wymusza ponownej subskrypcji.
• Wstrzymane ponowienie: sprawdź diagnostykę integracji, aktualny stan newslettera, miejsce docelowe i tryb zgody. Potwierdź dostępność współdzielonego magazynu kolejki.
• Brak skryptu: sprawdź dokładny URL witryny, przełącznik skryptu, zgodę marketingową, blokowanie w przeglądarce i znaczniki pracownika.
• Ostrzeżenie instalacji: użyj strony "Integrity" modułu do kontroli wymaganych danych dostępowych i współdzielonych tabel.

Nie zaimplementowano tutaj ekranu zarządzania grupą odbiorców osobno dla każdego klienta. Zarządzaj statusem kontaktów i kampaniami w Mailchimp.

Wyłącz przełącznik synchronizacji, aby zatrzymać nowe synchronizacje kontaktów. Wyłącz przełącznik skryptu, aby zatrzymać ładowanie połączonej witryny w sklepie. Wyłącz "Enable Mailchimp", aby zatrzymać obie funkcje.

Odinstaluj przez "Module Manager", aby usunąć menu i zapisaną konfigurację modułu. Współdzielone dane kolejki i wycofań zgody pozostają po odinstalowaniu. Nie usuwa kontaktów już przechowywanych przez Mailchimp.

Wymaga PrestaShop 1.6 lub nowszego oraz PHP 7.1 lub nowszego.