Magento – konfiguracja wtyczki

Wtyczka ExpertSender CDP domyślnie synchronizuje zamówienia i umożliwia bezpośrednie zbieranie zgód klienta z poziomu sklepu opartego na Magento i przesyłanie ich do ECDP.

Jeśli wolisz zbierać informacje o klientach za pomocą wtyczki niż API, postępuj zgodnie z instrukcją poniżej.

Synchronizacja zamówień

Informacje o zamówieniach są automatycznie wysyłane do ECDP. Nie jest wymagana dodatkowa konfiguracja.

Jeśli chcesz mieć pewność, że statusy zamówień synchronizują się prawidłowo, zapoznaj się z sekcją Mapowanie statusów zamówień.

Zbieranie i przesyłanie zgód do ECDP

1. Skonfiguruj ustawienia ogólne wtyczki

Przejdź do zakładki Ustawienia ogólne i wypełnij niezbędne pola:

• Klucz API
• Kod śledzenia
• ID strony www (sklepu)

2. Stwórz zgody w Magento

Jeśli chcesz zbierać zgody marketingowe (np. podczas rejestracji, edycji profilu lub składania zamówień):

• Przejdź do zakładki Zgody.
• Utwórz zgodę w Magento i mapuj ją (przypisz) do odpowiedniej zgody marketingowej w ECDP.

3. Stwórz formularze zgód

W zakładce Elementy formularza zgody:

• Utwórz formularze odpowiedzialne za zbieranie zgód (np. „Zgoda podczas dokonywania płatności”).
• Wybierz, gdzie ma być wyświetlana zgoda (np. rejestracja, płatność, edycja profilu).
• Wskaż, która zgoda będzie zbierana po wysłaniu formularza.

4. Skonfiguruj tryb opt-in

Przejdź do Ustawienia > Ustawienia formularza i zdecyduj, czy zgody będą zbierane w trybie single opt-in (bez potwierdzenia) czy double opt-in (z potwierdzeniem).

W przypadku wyboru double opt-in musisz podać ID wiadomości potwierdzającej z ECDP. Znajdziesz ją w Ustawienia > Zgody > Potwierdzenia.

5. Opcjonalnie: mapowanie niestandardowych danych

Jeśli zbierasz dane wykraczające poza standardowe pola (np. dane zamówienia, produktu lub użytkownika), skonfiguruj ich przesyłanie w zakładce Mapowanie pól niestandardowych.

Instalacja i konfiguracja wtyczki

1. Instalacja wtyczki

Możesz zainstalować rozszerzenie ExpertSender CDP używając Composera lub ręcznie, za pomocą FTP:

Z użyciem Composera:

Uruchom następujące polecenie w głównym katalogu Magento:

composer require expertsender/ecdp

Ręcznie przez FTP:

Pobierz wtyczkę z GitHub.

Prześlij pliki rozszerzenia na serwer Magento do katalogu: app/code/ExpertSender/Ecdp/

2. Uruchomienie poleceń Magento

Po instalacji rozszerzenia dowolną metodą uruchom następujące polecenia w głównym katalogu Magento, aby włączyć i skompilować wtyczkę:

php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento cache:flush

Sekcje wtyczki

Ustawienia ogólne

1. Przejdź do panelu administracyjnego Magento.
2. Przejdź do ECDP > Ustawienia ogólne.
3. Skonfiguruj następujące pola:
   • Klucz API: Wprowadź klucz API ExpertSender do uwierzytelnienia.
   • Kod śledzenia: Dodaj kod śledzenia do monitorowania aktywności użytkowników na stronie.
   • ID strony: Wprowadź ID strony dla ExpertSender CDP.
   • Włącz logi API: Wszystkie żądania i odpowiedzi API ECDP będą rejestrowane w pliku /var/log/expertsender/api.log do celów dis-agnostycznych.

Ustawienia danych klienta

Aby skonfigurować sposób wysyłania danych klienta do ECDP:

1. Przejdź do ECDP > Dane klienta w panelu administracyjnym Magento.
2. Możesz skonfigurować źródło numeru telefonu klienta wysyłanego do ECDP:
   • Adres rozliczeniowy (ustawiony domyślnie).
   • Adres wysyłkowy.
3. Dodatkowo możesz zdecydować, czy wysyłać numer telefonu klienta do ECDP.
   • Jeśli wybierzesz Tak, upewnij się, że wszystkie numery telefonów przechowywane w Magento są w formacie międzynarodowym (z prefiksem kraju), ponieważ brak tego może powodować problemy podczas transmisji danych.

Ustawienia formularza

Aby skonfigurować formularze w ExpertSender CDP:

1. Przejdź do Panel administracyjny > ECDP > Ustawienia formularza.
2. W sSekcji Ogólne uzupełniej następujące pola:
   • Tekst wyświetlany przed zgodami w formularzach: Tekst, który pojawi się nad listą pól wyboru, np. „Wyrażam zgodę na:”. Uwaga: Ten tekst nie wyświetla się w formularzach biuletynu lub edycji profilu.
   • Użyj formularza ExpertSender CDP: Ustaw, czy wtyczka powinna zastąpić domyślny formularz biuletynu formularzem zawierającym zgody.
3. Sekcja Single opt-in / Double opt-in obejmuje opcje dla różnych formularzy:
   • Typ formularza: Wybierz między Jednoetapowym a Dwuetapowym dla każdego formularza.
   • Identyfikator wiadomości potwierdzającej: Jeśli wybrano Dwuetapowy, pojawi się dodatkowe pole do wprowadzenia identyfikatora wiadomości potwierdzającej.

Zgody klienta#

Dla prawidłowej synchronizacji danych, zgody w Magento muszą być zmapowane do zgód w ExpertSender CDP:

1. Przejdź do ECDP > Zgody > Dodaj nową.
2. Nadaj nazwę: Będzie to nazwa, której będziesz używać w Magento.
3. Wybierz zgodę z ECDP: Wybierz odpowiednią zgodę utworzoną w platformie ExpertSender CDP.

Utworzone zgody można stosować w formularzach rejestracji, płatności lub zapisu do newslettera.

Elementy formularza zgody

Po utworzeniu zgody musisz określić, gdzie i jak będzie wyświetlana:

1. Przejdź do ECDP > Elementy formularza zgody > Dodaj nowy.
2. Dodaj nazwę: Na przykład „Zgoda na newsletter”.
3. Wybierz formularz: Zdecyduj, gdzie pojawi się pole do wyrażenia zgody.
4. Wybierz zgodę: Wybierz wcześniej utworzoną zgodę.
5. Wybierz sklep: Określ, w których widokach sklepu będzie wyświetlane pole.
6. Włącz lub wyłącz pole wyrażania zgody.
7. Ustaw kolejność sortowania: Możesz zdefiniować priorytet wyświetlania.

Mapowanie pól niestandardowych

Mapowanie pól niestandardowych pozwala łączyć niestandardowe pola z Magento z odpowiednimi polami w ECDP:

• Zamówienie
• Produkt
• Użytkownik

Aby zmapować pola niestandardowe:

1. Przejdź do ECDP > Mapowanie pól niestandardowych.
2. Kliknij Utwórz, aby zdefiniować nowe mapowania:
   • Pole Magento: Wybierz atrybut produktu/użytkownika.
   • Zmapowany zasób: Wybierz Użytkownik, Produkt lub Zamówienie.
   • Pole ExpertSender: Wybierz odpowiednie pole.

Mapowanie statusów zamówień

Pozwala synchronizować statusy zamówień Magento z odpowiednimi statusami w ECDP:

1. Przejdź do ECDP > Mapowanie statusów zamówień.
2. Utwórz mapowania między statusami Magento a ECDP.

Domyślne mapowanie: