STM - Tag Manager Wymagane zdarzenia szablonu

Rodzaje Eventów w SEIGI Tag Manager

Wprowadzenie

W SEIGI Tag Manager rozróżniamy dwa rodzaje eventów: statyczne i dynamiczne. Zrozumienie różnic między nimi oraz ich działania jest kluczowe dla poprawnej konfiguracji i efektywnego wykorzystania modułu.

Statyczne Eventy

Opis
Statyczne eventy to te, które są wysyłane zawsze po załadowaniu strony. Przykładem takiego eventu jest view_item.

Potencjalne problemy
O ile statyczne eventy działają w większości przypadków poprawnie, mogą one napotkać problemy, jeśli wprowadzone zostały zmiany w Core sklepu (takie jak modyfikacje hooków czy kontrolerów). W takich sytuacjach, statyczne eventy mogą przestać działać.

Dynamiczne Eventy

Opis
Dynamiczne eventy są wywoływane za pomocą JavaScript. Przykładem dynamicznego eventu w naszym systemie jest add_to_cart.

Potencjalne problemy
Szablony zazwyczaj nie modyfikują natywnego systemu dodawania do koszyka ani systemu zdarzeń, co oznacza, że dynamiczne eventy działają bez problemów. Jednakże, w niektórych szablonach mogą występować zmiany, które wpływają na działanie tych eventów.

W takich przypadkach, event może nie być odpalany poprawnie. Dlatego, jeśli zauważysz, że dynamiczny event nie działa na Twoim szablonie, konieczne może być ręczne podłączenie naszego systemu zarządzania eventami do zdarzenia dodania do koszyka.

Instrukcja podłączenia eventów

Aby podłączyć nasz system zarządzania eventami do customowego zdarzenia dodania do koszyka, wstaw poniższy kod w odpowiednie miejsce w Twoim szablonie:

// Od wersji 2.0
seigitagmanager.execute('add_to_cart', {
    // Należy wstawić odpowiednie wartośći
    id_product: 1,
    quantity: 1,
    price: 'Cena produktu z podatkiem',
    category: 'Kategoria produktu',
    name: 'Nazwa produktu',
    // Content category oznacza kontekst z którego zostało wywołane dodanie do koszyka. Przykładowe wartości to 'index', 'category' lub 'product'
    content_category: 'category|index|product',
    
    // Poniższych nie należy zmieniać:
    currency: stm_currency,
    event_id: stm_gid+'-'+resp.id_product.toString(),
    event_name: 'AddToCart'
});

Ważna uwaga dla klientów

Proszę zwrócić uwagę, że nie jesteśmy w stanie przewidzieć wszystkich możliwych modyfikacji szablonów. W związku z tym, nasz moduł może nie działać na niektórych z nich bez dodatkowej konfiguracji. Jeśli napotkasz problemy z działaniem eventów, konieczne może być ręczne podpięcie naszego EventManagera do customowego szablonu.

W razie jakichkolwiek pytań lub wątpliwości, prosimy o kontakt z naszym zespołem wsparcia.

Sprawdzanie poprawności implementacji natywnego zdarzenia AddToCart w szablonie

Wprowadzenie

Jeśli podejrzewasz, że Twoje szablony mogą nie poprawnie wywoływać zdarzenia AddToCart, możesz to łatwo sprawdzić za pomocą prostego testu w konsoli przeglądarki. Poniżej znajduje się instrukcja, jak to zrobić.

Kroki do sprawdzenia poprawności

  1. Otwórz przeglądarkę i przejdź na stronę swojego sklepu, gdzie chcesz przetestować działanie zdarzenia AddToCart.

  2. Otwórz narzędzia deweloperskie:

    • W przeglądarce Google Chrome: kliknij prawym przyciskiem myszy na stronę i wybierz “Zbadaj” lub naciśnij Ctrl + Shift + I (Windows) lub Cmd + Option + I (Mac).
    • W przeglądarce Firefox: kliknij prawym przyciskiem myszy na stronę i wybierz “Zbadaj element” lub naciśnij Ctrl + Shift + I (Windows) lub Cmd + Option + I (Mac).

  3. Przejdź do zakładki “Console” w narzędziach deweloperskich.

  4. Wklej poniższy kod do konsoli i naciśnij Enter:

    prestashop.on('updateCart', function (param) {
    console.log('SEIGI: Add to cart fired!');
});

  5. Dodaj produkt do koszyka na swojej stronie.

  6. Sprawdź konsolę: Jeśli wszystko działa poprawnie, w konsoli przeglądarki powinien pojawić się komunikat SEIGI: Add to cart fired!. Oznacza to, że zdarzenie AddToCart zostało poprawnie wywołane.

Co zrobić, jeśli zdarzenie nie jest wywoływane?

Jeżeli komunikat nie pojawia się w konsoli, oznacza to, że Twój szablon może nie wywoływać zdarzenia AddToCart poprawnie. W takim przypadku należy:

  1. Sprawdzić modyfikacje w szablonie: Upewnij się, że w szablonie nie zostały wprowadzone zmiany, które mogą wpływać na natywny system dodawania do koszyka.

  2. Ręcznie podłączyć nasz system zarządzania eventami: Jeśli modyfikacje są niezbędne, możesz ręcznie podłączyć nasz EventManager do customowego zdarzenia dodania do koszyka.

Podsumowanie

Sprawdzenie poprawności implementacji zdarzenia AddToCart jest kluczowe dla poprawnego działania dynamicznych eventów w SEIGI Tag Manager. Użyj powyższego kodu, aby upewnić się, że Twój szablon wywołuje zdarzenia poprawnie. W razie problemów skontaktuj się z naszym zespołem wsparcia lub dostosuj konfigurację swojego szablonu.pamiętaj o wyłączeniu trybu debugowania, zmieniając wartość z powrotem na false w pliku defines.inc.php. Jest to ważne, aby przypadkowo nie ujawnić wrażliwych informacji o Twoim sklepie klientom lub odwiedzającym.