Twój sklep nie mówi add_to_cart

Dostajesz sklep, słyszysz, że dataLayer jest gotowy, i masz podpiąć GA4. Otwierasz listę zdarzeń, dodajesz coś do koszyka, a push, który przychodzi, nazywa się productDetail. Albo dl_add_to_cart. Albo gtm4wp.addProductToCartEEC. Żadna z tych nazw nie jest tą z dokumentacji, którą właśnie czytałeś.

To nie jest błąd konfiguracji. Każda platforma handlowa, która kiedykolwiek wydała integrację z GTM, wymyśliła własne słownictwo na te same pięć kroków, a większość jest starsza niż GA4.

Ten sam lejek na sześć sposobów

To, co GA4 nazywa add_to_cart, zapisuje się — zależnie od tego, gdzie stoisz:

• dl_add_to_cart — Shopify z Elevarem, którego całe słownictwo ma prefiks: dl_view_item, dl_begin_checkout, dl_purchase.
• addToCart — aplikacja GTM od VTEX, obok productDetail, productClick i orderPlaced.
• Znowu addToCart — client data layer Adobe Commerce, który daje też productPageView, initiateCheckout i placeOrder.
• gtm4wp.addProductToCartEEC — WooCommerce w starym trybie Enhanced Ecommerce GTM4WP. Aktualny GTM4WP pushuje już nazwy GA4, więc ta nazwa mówi, że wtyczka jest stara.
• cart_add — ustandaryzowany zestaw Tealium.
• ee-productView i krewni — prefiks ee- to konwencja nałożona na stare słownictwo Universal Analytics, a nie osobne słownictwo.

Do tego wielkość liter. AddToCart, ADD_TO_CART i add-to-cart to dla człowieka to samo słowo, a dla GTM trzy różne zdarzenia.

Co to psuje, w kolejności kosztów

1. Reguły, które nigdy nie działają. Reguła Custom Event skopiowana z tutoriala pasuje do add_to_cart, a strona pushuje dl_add_to_cart. Preview Mode pokazuje, że tag się nie uruchomił, i nie podaje powodu — bo po stronie GTM nic nie jest nie tak: takie zdarzenie nie wystąpiło.
2. Audyty zaliczone przez milczenie. Każde sprawdzenie „czy warstwa e-commerce jest poprawna" oparte na nazwach GA4 zwraca czysty wynik na sklepie, którego nigdy nie zrozumiało.
3. Wdrożenia w połowie zmigrowane. Motyw pushujący stare słownictwo i wtyczka pushująca nazwy GA4, obie na produkcji — tak to samo dodanie do koszyka liczone jest dwa razy pod dwiema nazwami.

Przeczytaj nazwę, potem ją zmapuj

Pewny ruch to przestać zakładać i przeczytać. Zrób jedną rzecz na stronie i spójrz na nazwę zdarzenia, które przyszło — złapanie pusha wywołanego jedną interakcją jest dokładnie tym i podaje nazwę w pisowni strony, razem z wartościami pod spodem.

Potem mapuj, nie przemianowuj. Reguła na własnej pisowni strony; nazwa GA4 wysyłana z taga. Tłumaczenie mieszka w jednym miejscu, które kontrolujesz, a nie w forku aplikacji platformy, który zaktualizuje się pod Tobą. Jeśli budujesz konfigurację z kilku pushy w checkoucie, ta sama kolekcja może zostać wyeksportowana jako plik kontenera z prawdziwymi nazwami już w środku.

Dwie rzeczy do sprawdzenia, zanim zaufasz liście

Po pierwsze, wielkość liter, za każdym razem. Skopiuj nazwę z pusha, zamiast ją przepisywać.

Po drugie, czy w ogóle widzisz całą warstwę. Na Shopify interesujące zdarzenia mogą działać w piaskownicy, do której inspektor nie sięga — i wtedy pytanie o słownictwo jest bezprzedmiotowe, dopóki nie przejdziesz do sieci. Dialekt, którego nie widać, nie jest problemem dialektu.

Pytania

Dlaczego mój sklep pushuje dl_add_to_cart zamiast add_to_cart?

Bo dl_ to słownictwo Elevara dla Shopify, nie GA4. Zdarzenie znaczy add_to_cart; różni się tylko pisownia. Tag, który go słucha, musi słuchać nazwy, którą strona naprawdę pushuje.

Czy reguła Custom Event w GTM rozróżnia wielkość liter?

Tak. addToCart, AddToCart i add_to_cart to dla GTM trzy różne zdarzenia, a reguła pasująca do jednego nigdy nie zadziała na pozostałych. To najczęstszy powód, dla którego poprawnie wyglądająca reguła nigdy się nie uruchamia.

Czy powinienem przemianować zdarzenia na nazwy GA4?

Zwykle nie. Platforma pushuje to, co pushuje, a zmiana nazwy u źródła oznacza utrzymywanie forka cudzej aplikacji. Zamiast tego mapuj: reguła na pisowni strony, nazwa GA4 wysyłana z taga. Jedno miejsce do zmiany, gdy platforma się zmieni.

Jak sprawdzić, którego dialektu używa strona?

Zrób jedną rzecz na stronie — dodaj produkt, zacznij checkout — i przeczytaj nazwę zdarzenia, które przyszło. To jedyna pewna odpowiedź, bo ta sama platforma wysyła różne słownictwa w różnych wersjach aplikacji i motywach.

Jak to zrobić w panelu →

Reszta tej grupy: Sklepy i ich warstwy danych

• Sklep, którego dataLayer jest pusty

Cała grupa Sklepy i ich warstwy danych