Marketing Revolution: konfiguracja i pomoc

Prześlij ZIP wydania przez Moduły > "Module Manager" > "Upload a module", a następnie go zainstaluj. Otwórz "Marketing > Panel". W "Marketing > Platformy" skonfiguruj cele, a w "Marketing > Ustawienia" wspólne ustawienia.

Wymaga PrestaShop 1.6 lub nowszego i PHP 7.1 lub nowszego.

Zacznij od jednego celu. Zdecyduj, czy GA4 ma działać bezpośrednio, czy przez kontener GTM. Jeśli obie ścieżki wysyłają do tej samej usługi, skonfiguruj je starannie, aby uniknąć powielania zdarzeń. Sprawdź też pozostałe zainstalowane moduły śledzenia i tagi.

Nadaj pracownikom odpowiednie uprawnienia do wyświetlania i edycji kontrolerów modułu. Zapisywanie platform i wykonywanie akcji wymaga uprawnienia do edycji oraz poprawnego tokena administratora.

"Ogólny"

Używaj tego samego identyfikatora w pliku produktowym i zdarzeniach. Wspólne pobieranie danych obejmuje dostępną nazwę pozycji, markę, hierarchię kategorii, opis kombinacji, cenę i ilość. Dane zamówienia zawierają dodatkowo walutę, podatek, wysyłkę, kupony i identyfikatory zamówienia.

"Śledzenie"

Dziennik pokazuje zakupy zapisane przez sklep. Które konwersje platforma przyjęła, sprawdzisz w jej własnych raportach.

"Zgoda"

Skonfiguruj obsługiwanego dostawcę zgód zbierającego wybór odwiedzającego. Moduł współpracuje z MPR Cookies Revolution oraz obsługiwanymi integracjami Cookiebot, OneTrust i TCF. Domyślne wartości Consent Mode nie zbierają zgody. Każda platforma stosuje też własne wymagania dotyczące zgód.

"Automatyzacja"

W sekcji "Automatyzacja" nie ma edytowalnych ustawień. "Wyślij ponownie pominięte zakupy", "Okres ponownej wysyłki" i "Data Language" są niedostępne. Odzyskiwanie i dostarczanie przez serwer skonfiguruj w opisanych poniżej formularzach platform.

Otwórz "Marketing > Platformy", wybierz platformę i otwórz jej konfigurację. Większość formularzy platform ma przełącznik "Włączony", początkowo wyłączony. Zapisz identyfikator celu, zanim go włączysz.

Google Tag Manager

Wpisz "GTM Container ID", na przykład GTM-XXXXXXX. Początkowo identyfikator jest pusty. Moduł wysyła dane ecommerce do dataLayer; tagi i reguły nadal musisz skonfigurować i opublikować w kontenerze.

"Track Contact Signals" i "Track Product Engagement" są początkowo wyłączone. "Exclude Employee Browsers" również jest początkowo wyłączone w tym pakiecie. Włącz je, jeśli wizyty pracowników mają być wykluczane.

W przypadku kontaktów i zaangażowania w produkt przetestuj odpowiednie ustawienia przed ich szerszym włączeniem. Kontener GTM może generować własne wyświetlenie strony. Moduł nie wysyła do GTM osobnego ogólnego zdarzenia page_view dla każdej strony.

Google Analytics GA4

Aby włączyć odzyskiwanie, zapisz sekret API i włącz "Recover Missing GA4 Purchases". Wymagana jest integracja zgód MPR Cookies Revolution. Odzyskiwanie obejmuje zakupy zapisane po włączeniu funkcji, gdy klient nie dotarł do strony potwierdzenia zamówienia. Zamówienia sprzed aktywacji są wykluczone. Brak tożsamości kupującego, zgody lub zgodnego celu wstrzymuje dostarczenie.

Ustawienia Google dotyczące zaangażowania w produkt

GTM i GA4 udostępniają te ustawienia w swoich formularzach:

Przetestuj selektory w rzeczywistym motywie. Te ustawienia rejestrują zaobserwowane interakcje; nie potwierdzają zakupu ani nie wymagają etykiety konwersji reklamowej.

Wpisz "Google Ads Conversion ID", na przykład AW-123456789, i włącz platformę. Wszystkie etykiety są początkowo puste. Wypełnij tylko żądane działania powodujące konwersję:

Pusta etykieta wyłącza daną konwersję. Platforma ma również "Track Contact Signals" i "Exclude Employee Browsers", obie opcje początkowo wyłączone. Konwersje kontaktowe używają "Phone Click Conversion Label", "Chat Start Conversion Label" i "Confirmed Contact Form Conversion Label", każda początkowo pusta. Użyj etykiety właściwego działania.

Opcjonalne korekty zwrotów

"Correct Refunded Google Ads Conversions" jest początkowo wyłączone. Przed włączeniem skonfiguruj te pola:

Plik OAuth musi zawierać identyfikator klienta, sekret klienta i token odświeżania. Zapisz pola i sprawdź gotowość przed włączeniem korekt. Korygowane są tylko zakupy wysłane z przeglądarki po konfiguracji; starsze konwersje pozostają bez zmian. Zadanie korekt działa tylko wtedy, gdy uruchamia je Twój harmonogram cron.

Otwórz "Meta Pixel" i wpisz "Pixel ID", początkowo puste. "Enable Facebook Pixel" jest początkowo wyłączone. Domyślna wartość "Exclude employees" w pakiecie to wyłączone. "Respect cookie consent" jest początkowo włączone. "Persist marketing consent withdrawals" jest początkowo wyłączone.

Standardowe przełączniki "Track ViewContent", "Track AddToCart", "Track InitiateCheckout", "Track Purchase", "Track Search", "Track AddToWishlist" i "Track CompleteRegistration" są początkowo włączone. Wyłącz zdarzenia nieużywane w Twojej konfiguracji. Zdarzenia listy życzeń i rejestracji wymagają obsługiwanej udanej akcji.

"Track custom events" jest początkowo wyłączone. "Custom event rules" jest początkowo puste i przyjmuje udokumentowane reguły wyzwalania JSON. Skonfiguruj i przetestuj regułę przed jej włączeniem.

"Enable Conversions API purchase events" jest początkowo wyłączone w nowej instalacji. Dodaj "Conversions API access token" przed włączeniem. Pole tokena zachowuje zapisany token, gdy pozostawisz je puste. "Kod zdarzenia testowego" jest początkowo puste. "Graph API version" zaczyna od v25.0.

Jest to dostarczanie zakupów przez serwer obok Pixela przeglądarkowego, ze wspólną tożsamością zdarzenia do deduplikacji. Nie ogranicza się do cogodzinnego ponawiania pominiętych zakupów. Sprawdź panel połączenia, kolejkę dostawcy i diagnostykę Meta. Przed użyciem produkcyjnym usuń tymczasowy kod testowy.

Moduł obsługuje też poniższe cele. Ich dane dostępowe są początkowo puste, a główne przełączniki wyłączone. Używaj formularza sieci, z której faktycznie korzystasz.

Zdarzenia, prywatność i własne reguły

Każdy dostawca mapuje wspólne zdarzenia na obsługiwane API. Sprawdź jego przełączniki zdarzeń osobno. Każda platforma reklamowa otrzymuje tylko obsługiwane przez nią zdarzenia.

Tam, gdzie są dostępne, "Track phone-link clicks", "Track actual chat starts", "Track successful contact forms" i "Track product engagement" są początkowo wyłączone. Odpowiednie pola "Phone target", "Chat target", "Form target" lub "Engagement target" są początkowo puste. Wpisz dokładny cel przydzielony na koncie, gdy formularz go wymaga. Cele nie są tworzone na podstawie Pixel ID.

"Send confirmed forms through the server API" jest początkowo wyłączone tam, gdzie jest obsługiwane. Formularz liczy się dopiero, gdy serwer zgłosi udaną wysyłkę; kliknięcie "Submit" nie wystarcza. Kliknięcia telefonu i rzeczywiste rozpoczęcia czatu to osobne sygnały. "Product engagement thresholds" używa wspólnych wartości domyślnych: 3 wyświetleń galerii, 1 zmiany kombinacji, 1 kliknięcia szczegółów, 45 sekund i 1500 milisekund. Zmieniaj jego JSON tylko w celu dopasowania progów i selektorów motywu do zamierzeń.

"Custom event rules" jest początkowo puste, a własne śledzenie, jeśli występuje, jest wyłączone. Reguły mogą wybierać obsługiwane kliknięcia, adresy URL, kontrolery lub zdarzenia DOM. Nadal obowiązują ograniczenia dostawców. Na przykład Criteo mapuje zdarzenia na obsługiwane słownictwo OneTag zamiast przyjmować dowolne nowe nazwy zdarzeń.

Sprawdź wykluczanie pracowników osobno na każdej platformie. Nie jest to jeden uniwersalny przełącznik domyślnie włączony. Pakiet zachowuje domyślnie wyłączone wykluczanie pracowników dla Google, Meta, TikTok, Snapchat, Reddit i AdRoll. Niezależnie nadal obowiązują kontrole zgód, hostów wyjściowych i odpowiedzialności za obsługę.

Opcjonalne dostarczanie przez serwer

Wysyłkę przez serwer konfiguruje się dla każdej platformy osobno i dla poniższych opcjonalnych ścieżek jest początkowo wyłączona. Wpisz wymagane dane dostępowe i sprawdź ustawienia zgód platformy przed włączeniem.

Dla Pinterest "Include tax in purchase value", "Include shipping in purchase value" i "Subtract discounts from purchase value" są początkowo wyłączone. Sprawdź te wartości właściwe dla dostawcy zamiast zakładać, że ogólne ustawienie ceny decyduje o wartości całego zakupu.

Przyciski testowe dostawców działają różnie. Przycisk o nazwie "Check test availability" lub "Check test requirements" może zwrócić wskazówki bez wysyłania zdarzenia. Użyj udokumentowanej ścieżki testowej dostawcy i wymaganych identyfikatorów testowych. Akcja ponowienia przywraca kwalifikujące się nieudane wiersze do przetwarzania; nie naprawia brakujących danych dostępowych ani brakującej pierwotnej zgody.

Otwórz "ChatGPT Ads (OpenAI)". Zarówno globalny przełącznik "Włącz śledzenie", jak i "Tracking enabled" w tym formularzu muszą być włączone dla tego celu.

Uzyskaj Pixel ID i klucz Conversions API dla właściwego źródła danych. Klucz API jest odrębny od klucza Advertiser API. Przy wymaganej zgodzie dostarczanie przez serwer wymaga odpowiedniej zgody na przechowywanie reklamowe; przeglądarka wymaga też sygnału danych użytkownika. Wycofanie zgody blokuje zdarzenia w kolejce, które nadal oczekują.

Przeglądarka i serwer używają wspólnej tożsamości zakupu na potrzeby deduplikacji na platformie docelowej. Platforma docelowa odpowiada za raportowanie i przypisywanie zakupów. Nieudane oczekujące zdarzenia wygasają po 6 dniach i 22 godzinach w dołączonej kolejce.

"Check test-mode availability" nie wysyła zdarzenia ani nie weryfikuje przykładowego zakupu. "Retry failed events" ponownie umieszcza kwalifikujące się nieudane zdarzenia w kolejce dla wybranego sklepu i Pixel ID.

Wyłączenie "Pixel w przeglądarce" pozostawia osobne sterowanie dostarczaniem przez serwer. Aby skonfigurować wyłącznie zakupy, pozostaw włączone "Purchases" i wyłącz pozostałe zdarzenia handlowe. Identyfikatory produktu i kombinacji mają wartości takie jak 42-7; produkty bez kombinacji zachowują identyfikator produktu.

Opisane wyżej opcjonalne przełączniki kontaktu i zaangażowania również są tu początkowo wyłączone. Jeśli samodzielny moduł Pixel for ChatGPT Ads używa tego samego celu, skoordynowana odpowiedzialność określa, który moduł emituje zdarzenia i przetwarza wspólną kolejkę. Sprawdź status odpowiedzialności przed diagnozowaniem duplikatów.

Otwórz formularz platformy i ustaw:

Przetestuj plakietkę i wyrażanie zgody na ankietę na kwalifikującym się potwierdzeniu zamówienia. Konto Merchant Center musi obsługiwać Opinie konsumenckie Google; decyduje o tym Google, a nie ustawienia modułu.

Te ustawienia obsługują dziedziczenie globalne, grupy sklepów i sklepu. "Use inherited settings" usuwa lokalne nadpisania dla tej platformy. Większość pozostałych ustawień modułu jest wspólna dla sklepów. Samo wybranie sklepu nie tworzy niezależnych danych dostępowych GA4, Meta czy OpenAI.

Połącz zainstalowaną infrastrukturę cron z regularnym uruchamianiem zewnętrznym. Moduł rejestruje te identyfikatory zadań:

Użyj uwierzytelnionego mechanizmu uruchamiania lub polecenia z harmonogramu zainstalowanego dla tego sklepu. Nie wystawiaj nieuwierzytelnionego punktu zapisu. Główne procesy serwerowe nie uruchamiają się z ruchu odwiedzających. Zadanie działa tylko wtedy, gdy hosting faktycznie wywołuje harmonogram, więc to sprawdź.

Sklep otrzymuje skrypty śledzące zamiast nowego widocznego widżetu, z wyjątkiem opcjonalnej plakietki opinii i ankiety. Standardowa integracja używa displayHeader, displayBeforeBodyClosingTag, displayOrderConfirmation, displayAfterBodyOpeningTag i hooków multimediów oraz akcji koszyka/konta/zamówienia i starszej ścieżki stopki.

Wspólne zbieranie obejmuje wyświetlenia stron i produktów, obsługiwane listy i wyszukiwania, wyświetlenia koszyka, rozpoczęcia zamówienia, rejestracje i logowania. Śledzenie w przeglądarce dostarcza potwierdzone dodania do koszyka i obsługiwane udane dodania do listy życzeń. Sygnały kroków zamówienia i inne interakcje sprawdzaj osobno; nie zakładaj, że są zbierane automatycznie. Każdy dostawca stosuje własne obsługiwane mapowania i warunki.

1. Skonfiguruj jedną platformę, pozostawiając globalny przełącznik wyłączony.
2. Sprawdź wymagane dane dostępowe i integrację zgód.
3. Włącz platformę oraz "Włącz śledzenie", a następnie przeglądaj sklep jako klient.
4. Zweryfikuj identyfikatory produktów, ceny, walutę i dane kategorii w żądaniach przeglądarki lub podglądzie GTM.
5. Dodaj i usuń produkt. Sprawdź potwierdzone zdarzenie i jego ilość.
6. Dokończ zamówienie i sprawdź cel zakupu, wartość, walutę, pozycje oraz identyfikator transakcji.
7. Osobno sprawdź "Dziennik śledzenia", status/kolejki dostawcy i diagnostykę zdalną.
8. Przetestuj odmowę, wycofanie zgody i zaplanowaną ścieżkę serwerową, jeśli jest włączona. Następnie wyłącz "Tryb debugowania".

Brak śledzenia: sprawdź oba przełączniki, wymagane dane dostępowe, zgodę, status pracownika/ruchu wewnętrznego, reguły hostów wyjściowych i komunikaty o odpowiedzialności. Śledzenie jest wstrzymywane na nieobsługiwanych ścieżkach środowiska testowego/klonu.

Brakujące zakupy: dla dostarczania przez przeglądarkę sprawdź, czy proces zamówienia wyświetla standardową stronę potwierdzenia, która uruchamia hook potwierdzenia zamówienia. Dla włączonej ścieżki API sprawdź kolejkę serwerową i status harmonogramu. Blokady przeglądarki, odmowa zgody i awarie platform nadal mogą uniemożliwić śledzenie.

Powielone zdarzenia: sprawdź skoordynowanego właściciela obsługi, starsze niezależne moduły, tagi wpisane w motyw i tagi opublikowane w GTM. Natywne integracje ps_facebook lub ps_googleanalytics z tym samym celem nadal mogą emitować powielone tagi i mają wyraźne ostrzeżenia.

Dziennik zakupu wskazuje obserwację: zapisuje to obserwację potwierdzenia zamówienia i listę aktywnych platform. Nie jest to potwierdzenie odbioru od platformy zewnętrznej.

Nieoczekiwane dane wyszukiwania lub klienta: moduł oczyszcza frazy zawierające dane e-mail lub telefonu i stosuje kontrole zgody na dopasowywanie. Sprawdzaj rzeczywiste przesyłane dane w swojej konfiguracji zamiast zakładać, że wszystkie dane są uwzględniane.

W niestandardowych kartach produktów zachowaj tożsamość produktu dostępną dla obsługiwanego mechanizmu śledzenia. Oryginalny wzorzec:

<article class="product-miniature" data-id-product="123" data-list-name="Category page">
  <h3 class="product-title"><a href="/example-product">Example product</a></h3>
  <span class="price" content="49.99">49.99</span>
</article>

Po zmianie kodu HTML przetestuj kliknięcia i prawdziwe dodanie do koszyka: zdarzenie koszyka jest wysyłane dopiero, gdy produkt faktycznie trafi do koszyka, więc samo dopasowanie selektora nie wystarczy.

Dane zakupów GTM używają obiektu ecommerce. Przykładowo skonfigurowany kontener może otrzymać:

dataLayer.push({ ecommerce: null });
dataLayer.push({
  event: 'purchase',
  ecommerce: {
    transaction_id: '123',
    value: 99.99,
    tax: 16.67,
    shipping: 4.99,
    currency: 'EUR',
    items: [{
      item_id: 'SKU-001', item_name: 'Example product',
      item_brand: 'Example brand', item_category: 'Category',
      item_category2: 'Subcategory', price: 99.99, quantity: 1
    }]
  }
});

Przykład pokazuje strukturę danych. Nie wklejaj do motywu drugiego mechanizmu wysyłania zakupów. Skonfiguruj kontener tak, aby korzystał z istniejącego wyjścia modułu.

Wyłącz "Włącz śledzenie", aby zatrzymać śledzenie. Zdarzenia już w kolejce i wycofania zgody są przetwarzane według własnego harmonogramu. Przed odinstalowaniem wykonaj kopię potrzebnych dzienników lub konfiguracji.

Odinstaluj przez "Module Manager". Moduł usuwa swoje menu, zarejestrowane zadania, własne tabele bazy danych, konfigurację oraz odpowiedzialność za kolejki/atrybucję przez wspólne pakiety. Wspólne tabele podlegają regułom czyszczenia ich pakietów. Odinstalowanie modułu nie usuwa zdarzeń wcześniej zgłoszonych zdalnie.