Mailchimp dla TYPO3

Rozszerzenie mailchimp przekazuje zapisy wraz z grupami zainteresowań bezpośrednio do list Mailchimp

Podobnie jak koning_mailchimp_signup, rozszerzenie mailchimp jest formularzem zapisu: odwiedzający zapisują się na stronie na określoną listę Mailchimp. Sięga jednak dalej niż starsze rozszerzenie, które kończy się na TYPO3 8: redaktorzy wybierają w elemencie treści listę i opcjonalnie grupę zainteresowań, formularz jest szablonem Fluid, który można dowolnie dostosować, a od wersji 3.0.0 jedna instalacja TYPO3 obsługuje kilka kont Mailchimp. Synchronizacji całych list, danych kampanii w backendzie ani szablonów newsletterowych z treści TYPO3 rozszerzenie nie oferuje; każdy zapis trafia bezpośrednio do API Mailchimp, zadania synchronizacji nie są do tego potrzebne.

Aspekt RODO pozostaje mimo to kluczowy: z każdym zapisem do Mailchimpa trafiają adres e-mail, imię i nazwisko, wybrane grupy zainteresowań i opcjonalnie do dziesięciu dodatkowych pól. Bez umowy powierzenia z Mailchimpem i udokumentowanego mechanizmu transferu do USA nie jest to dopuszczalne z punktu widzenia ochrony danych.

Typowe scenariusze to zapis na newsletter, wybór tematów i kilka marek

Głównym scenariuszem jest zapis na newsletter na stronie. Odwiedzający wpisują adres e-mail oraz imię i nazwisko, rozszerzenie dodaje ich do wybranej listy ze statusem “pending”, a Mailchimp wysyła mail potwierdzający Double-Opt-In. Dopiero po kliknięciu linku potwierdzającego adres jest aktywny. Listą, wypisaniami i bounces zarządza Mailchimp; rozszerzenie nie zakłada w TYPO3 własnych tabel.

Drugi scenariusz: wybór tematów przez grupy zainteresowań. Kto oferuje kilka newsletterów lub tematów, zakłada w Mailchimpie grupę zainteresowań, a formularz pokazuje tematy jako pola wyboru, przyciski opcji lub listę rozwijaną, zależnie od typu grupy. Zapis trafia na listę razem z wybranymi tematami, dzięki czemu marketing może w Mailchimpie wysyłać wiadomości do poszczególnych grup.

Trzeci scenariusz: kilka marek lub krajów w jednej instalacji TYPO3. Od wersji 3.0.0 można zapisać kilka kluczy API z nazwami, a redaktorzy wybierają w elemencie treści, do którego konta Mailchimp i na którą listę trafia formularz. W module strony w backendzie rozszerzenie pokazuje przy każdym formularzu konto, listę, grupę zainteresowań i aktualną liczbę subskrybentów. Wskaźniki otwarć i kliknięć widzi natomiast tylko ten, kto ma dostęp do dashboardu Mailchimp.

Architektura techniczna wywołuje API Mailchimp v3 bezpośrednio przy wysłaniu formularza

Rozszerzenie komunikuje się przez Mailchimp Marketing API v3, korzystając z dołączonej biblioteki PHP. Uwierzytelnianie odbywa się przez klucz API, który jest zapisany w Extension Manager TYPO3. Zadania Scheduler nie ma: każdy zapis trafia do Mailchimpa bezpośrednio przy wysłaniu formularza.

Przy wysłaniu formularza rozszerzenie dodaje członka do wybranej listy: przy Double-Opt-In ze statusem “pending”, w przeciwnym razie od razu jako “subscribed”. Jeśli adres jest już na liście, ale nie ma statusu “subscribed”, rozszerzenie aktualizuje wpis; identyfikatorem członka jest przy tym hash MD5 adresu e-mail. Jeśli adres jest już zapisany, formularz wyświetla odpowiedni komunikat.

Formularz jest szablonem Fluid, który można nadpisać we własnym Site-Package. Z rozszerzeniem typoscript_rendering wysyła dane przez Ajax, bez przeładowania strony. Adres e-mail można wstępnie wypełnić parametrem GET lub POST, na przykład gdy inny formularz odsyła do zapisu.

Dodatkowe pola programista podłącza przez hook: formularz obsługuje do dziesięciu dodatkowych pól, a hook określa, którym polom w Mailchimpie odpowiadają. Własnego modułu backendowego ani wskaźników kampanii rozszerzenie nie ma.

Częste problemy to pola obowiązkowe, istniejące adresy i wyłączone Double-Opt-In

Problem pierwszy: pola obowiązkowe. Jeśli w Mailchimpie oznaczy się pola jako obowiązkowe, rozszerzenie według dokumentacji nie może tego sprawdzić po stronie serwera; gdy takiego pola brakuje, formularz zgłasza tylko ogólny błąd. Rozwiązanie: oznaczyć te same pola w szablonie Fluid jako obowiązkowe i sprawdzać je przed wysłaniem.

Problem drugi: adresy, które już są na liście. Jeśli adres jest już zapisany, Mailchimp odrzuca drugi zapis, a formularz informuje, że adres jest już zarejestrowany. Adresy wcześniej wypisane rozszerzenie zapisuje natomiast ponownie. Rozwiązanie: sformułować ten komunikat w pliku językowym zrozumiale, aby nikt nie sądził, że zapis się nie powiódł.

Problem trzeci: wyłączenie Double-Opt-In. Rozszerzenie domyślnie wymaga potwierdzenia e-mailem. Ustawieniem skipDoubleOptIn wyłącza je w rozszerzeniu tylko ten, kto wyłączył Double-Opt-In również w Mailchimpie; dokumentacja zaleca, by zawsze z niego korzystać. W UE jest to ponadto przyjęty sposób wykazania zgody zgodnie z art. 7 ust. 1 RODO.

Czwarty problem dotyczy serwerów za proxy. Rozszerzenie dociera do API Mailchimp tylko wtedy, gdy w jego konfiguracji wpisano proxy i port; jest też opcja wymuszająca połączenie przez IPv4. Bez tych ustawień żaden zapis nie trafia do Mailchimpa, a TYPO3 nie przechowuje też adresów u siebie.

Rozszerzenie kończy się na TYPO3 v10, dla aktualnych wersji zaleca się bezpośrednią integrację z API

Rozszerzenie mailchimp w TER ukazało się ostatnio w styczniu 2021 (wersja 3.2.0) i obsługuje TYPO3 v9 i v10; dla nowszych wersji TYPO3 nie ma wydania. Ponieważ API Mailchimp v3 jest stabilne i dobrze udokumentowane, Gosign zaleca dla aktualnych projektów TYPO3 bezpośrednią integrację z API bez zależności od rozszerzenia. Klasa własnego serwisu we własnym pakiecie TYPO3, która bezpośrednio komunikuje się z API Mailchimp, jest bardziej przyjazna dla utrzymania niż rozszerzenie społecznościowe i daje się dokładnie dopasować do wymagań projektu. Jeśli treści newslettera mają pochodzić z TYPO3, to również należy do tej integracji; Gosign utrzymuje do tego zestaw szablonów e-mail, który renderuje najczęstsze elementy treści w sposób kompatybilny z e-mailem.

Firmy, które chcą pozostać długoterminowo przy Mailchimpie, powinny dodatkowo rozważyć funkcję Mailchimp Webhook: zamiast regularnie odpytywać o dane, Mailchimp aktywnie wysyła zdarzenia (zapis, wypis, bounce) do endpointu TYPO3. Redukuje to opóźnienie synchronizacji z minut do sekund i eliminuje obciążenie cyklicznymi zapytaniami API.