Wszystkie strony pomocy

Meta Pixel, Google Tag Manager i inne wtyczki

Ta strona opisuje, jak TallyHost współpracuje z innymi narzędziami w sklepie, żeby dostawca nie policzył żadnego zdarzenia dwa razy. Dotyczy wtyczek z Pixelem, Pixela Meta ładowanego przez snippet, Pixeli w Google Tag Manager, tagu Google Analytics 4, tagu konwersji Google Ads i Pixela TikToka.

Inne wtyczki i integracje wysyłające zakupy

Jeśli sklep ma wtyczkę albo integrację, która sama wysyła zakupy do Meta, TikToka, GA4 albo Google Ads, wyłącz w niej zdarzenie zakupu i wysyłkę z serwera (Conversions API w Meta, Events API w TikToku). Inaczej dostawca dostanie zakup dwa razy: raz od tej wtyczki, raz od TallyHost.

Najczęstsze przykłady:

  • „Facebook for WooCommerce”,
  • wtyczki dla wielu platform naraz: „PixelYourSite”, „Pixel Manager for WooCommerce”, „Conversios”. Sprawdź w nich każdą włączoną platformę,
  • wtyczki TikToka, na przykład „TikTok for WooCommerce”,
  • aplikacje w Shoper App Store z Pixelem Meta albo TikToka.

Wtyczka TallyHost dla WooCommerce zgłasza aktywne wtyczki tego typu do panelu. Na innych platformach sprawdź to sam i potwierdź w kroku 5 konfiguracji.

Pixel Meta ładowany przez snippet

Jeśli w kodzie instalacyjnym jest atrybut data-meta-pixel (albo na WooCommerce pole „Meta Pixel ID” w ustawieniach wtyczki), snippet sam ładuje Pixel Meta:

  • tylko po zgodzie klienta na cookies reklamowe, dane do reklam i personalizację reklam;
  • z wyłączoną automatyczną konfiguracją Pixela (autoConfig ustawione na false), więc Pixel nie zbiera sam danych z przycisków i formularzy;
  • z parametrem eventID równym event_id zdarzenia, które TallyHost wysyła do Conversions API. Dzięki temu Meta deduplikuje zdarzenie z Pixela i z serwera.

Nie ładuj wtedy Pixela Meta drugi raz, na przykład przez Google Tag Manager albo inną wtyczkę.

Wyłącz automatyczne zaawansowane dopasowanie

Jeśli Pixel Meta jest w sklepie (ładowany przez snippet albo w inny sposób), wyłącz w Menedżerze zdarzeń „Automatyczne zaawansowane dopasowanie”. TallyHost wysyła dane klienta sam: po zgodzie i zahashowane.

  1. Otwórz Menedżer zdarzeń (Events Manager).
  2. Wybierz „Źródła danych” (Data sources) i swój Pixel.
  3. Otwórz „Ustawienia” (Settings).
  4. Wyłącz „Automatyczne zaawansowane dopasowanie” (Automatic advanced matching).

Pixel Meta w Google Tag Manager (szablon GTM)

Jeśli wolisz zostawić Pixel Meta w Google Tag Manager, Pixel i TallyHost muszą używać tego samego event_id. Wtedy Meta połączy zdarzenie z Pixela ze zdarzeniem z Conversions API i policzy je raz.

Jak to działa: każdy wpis e-commerce w dataLayer ma pole event_id. Snippet TallyHost bierze gotowy event_id z dataLayer, a tag Pixela w GTM wysyła ten sam identyfikator jako eventID.

  • Wtyczka TallyHost dla WooCommerce dodaje event_id do swoich wpisów w dataLayer sama.
  • Na innych platformach programista dodaje event_id do każdego wpisu, na przykład event_id: crypto.randomUUID(). Dla zakupu event_id to hex sha256(site_id + ":" + order_id). Zobacz Inna platforma i integracja dla programistów.

W trybie GTM nie dodawaj do kodu instalacyjnego atrybutu data-meta-pixel, bo Pixel załadowałby się dwa razy.

Krok 1. Zmienna event_id

  1. W GTM otwórz „Zmienne” i utwórz nową zmienną zdefiniowaną przez użytkownika.
  2. Typ: „Zmienna warstwy danych” (Data Layer Variable).
  3. Nazwa zmiennej warstwy danych: event_id.
  4. Nazwa zmiennej w GTM: TH - event_id.

W ten sam sposób możesz utworzyć zmienne dla ecommerce.value i ecommerce.currency, na przykład TH - value i TH - currency.

Krok 2. Reguły

Utwórz regułę typu „Zdarzenie niestandardowe” (Custom Event) dla każdego zdarzenia:

  • view_item
  • add_to_cart
  • begin_checkout
  • add_payment_info
  • purchase

Możesz też utworzyć jedną regułę z nazwą zdarzenia ^(view_item|add_to_cart|begin_checkout|add_payment_info|purchase)$ i zaznaczoną opcją „Użyj dopasowania do wyrażenia regularnego”.

Krok 3. Tagi

Nazwy zdarzeń GA4 odpowiadają tym zdarzeniom standardowym Meta:

  • view_item → ViewContent
  • add_to_cart → AddToCart
  • begin_checkout → InitiateCheckout
  • add_payment_info → AddPaymentInfo
  • purchase → Purchase

Utwórz tag „Niestandardowy kod HTML” (Custom HTML) dla każdego zdarzenia, z regułą z kroku 2. Przykład dla dodania do koszyka:

<script>
  fbq('track', 'AddToCart',
    { value: {{TH - value}}, currency: '{{TH - currency}}' },
    { eventID: '{{TH - event_id}}' });
</script>

Zamiast pięciu tagów możesz utworzyć jeden tag z regułą obejmującą wszystkie zdarzenia i zmienną typu „Tabela przeglądowa” (Lookup Table), która zamienia {{Event}} na nazwę zdarzenia Meta według listy powyżej. Pozostałe parametry zdarzeń ustaw według dokumentacji Pixela Meta. Kod bazowy Pixela (fbq('init', …)) musi załadować się w GTM przed tymi tagami.

Krok 4. Zgoda

Tagi Pixela mogą działać tylko po zgodzie klienta. W ustawieniach zgody każdego tagu (Consent Settings) wybierz „Wymagaj dodatkowej zgody na uruchomienie tagu” i dodaj ad_storage, ad_user_data oraz ad_personalization. Jeśli baner działa na IAB TCF, tag powinien też sprawdzać zgodę na Meta. Zobacz Baner cookies (CMP) i zgody.

Zdarzenia własne a Pixel w GTM

Zdarzenia własne z listy w panelu (np. select_plan) TallyHost wysyła do Meta z serwera. Jeśli Pixel w Google Tag Manager wysyła to samo zdarzenie (fbq('trackCustom', …)), dodaj do wpisu w dataLayer event_id i przekaż go w tagu jako eventID, jak w kroku 1 wyżej. Inaczej Meta policzy zdarzenie dwa razy. Pixel ładowany przez snippet zdarzeń własnych nie wysyła. Szczegóły: Inna platforma i integracja dla programistów.

Tag Google Analytics 4 (gtag) na stronie

TallyHost wysyła do GA4 zdarzenia z serwera sklepu: zakupy, zwroty i leady. Pozostałe zdarzenia GA4 (wyświetlenia stron, produkty, koszyk) zbiera tag Google na stronie, więc go nie usuwaj. Wyjątek to odwiedzający, u których tag jest zablokowany, jeśli włączysz uzupełnianie (niżej).

  • Zakup: GA4 połączy zakup z tagu ze strony z zakupem od TallyHost tylko wtedy, gdy oba mają identyczny transaction_id. Sprawdź w debuggerze TallyHost i w raportach GA4, że to ta sama wartość (na przykład numer zamówienia w obu miejscach). Jeśli wartości się różnią, GA4 policzy zakup dwa razy: wyłącz wtedy zakup w tagu na stronie.
  • Zwrot i lead: GA4 nie deduplikuje zwrotów (refund) ani leadów (generate_lead). Jeśli wysyła je TallyHost, tag na stronie i wtyczki GA4 nie mogą ich wysyłać.

Gdy tag Google jest zablokowany

Bloker reklam często blokuje tag Google. Taki odwiedzający nie istnieje wtedy w GA4, a jego zakup z serwera nie ma do kogo trafić. W destynacji GA4 możesz włączyć „Uzupełniaj GA4, gdy tag Google jest zablokowany”. Wtedy:

  • u odwiedzających, u których tag Google nie zadziałał, a zgoda na analitykę jest, wysyłamy do GA4 odsłony, lejek zakupowy, zdarzenia własne (same nazwy, bez parametrów) i zakupy;
  • u pozostałych tag działa jak dotąd, a my wysyłamy do GA4 tylko zdarzenia z serwera. Lead albo rejestracja wysłane też przez inną wtyczkę GA4 policzą się dwa razy, jak wyżej;
  • kod na stronie dostaje atrybuty data-ga i data-ga-fallback="1" (aplikacja Shoper dodaje je sama, we wtyczce WooCommerce zaznacz „GA4 przy zablokowanym tagu”);
  • dopisz do polityki cookies cookie _sst_ga (analityczne, 400 dni): identyfikator klienta i sesji GA4.

To uzupełnienie, nie zamiennik tagu. Bez tagu GA4 nie ma demografii, Google Signals, modelowania zgód ani zdarzeń automatycznych (przewijanie, kliknięcia wychodzące). Źródło ruchu (UTM, kampanie) dla takich odwiedzających może być nieprzypisane: GA4 nie dokumentuje, że liczy je z Measurement Protocol. Warunki GA zabraniają danych osobowych także w tytułach i adresach stron.

Sklep bez tagu Google

Bez tagu Google przeglądarka nie ma cookie _ga. Zakupy z serwera nie mają wtedy identyfikatora klienta GA4, więc ich do GA4 nie wysyłamy. W debuggerze widać wynik „pominięte” z powodem „brak identyfikatora klienta GA4”. Panel to wykrywa: lista destynacji i kroki 4 i 5 konfiguracji pokazują ostrzeżenie z przyciskiem „Włącz »Uzupełniaj GA4«”. Po włączeniu działa to jak przy zablokowanym tagu (wyżej): identyfikator nadajemy sami w cookie _sst_ga. Dopisz to cookie do polityki cookies i zaktualizuj kod na stronie. We wtyczce WooCommerce wpisz „Identyfikator GA4” (G-…) i zaznacz „GA4 przy zablokowanym tagu”. Możesz też zamiast tego dodać do sklepu tag Google. Bez jednego z tych kroków destynacja GA4 nie dostanie zakupów.

Sklepy i strony SPA

Jeśli strona zmienia adres bez przeładowania (aplikacja w React, Vue, Next.js), dodaj do kodu instalacyjnego data-spa="1". Snippet wyśle wtedy odsłonę po każdej zmianie adresu, do wszystkich destynacji. Pixel Meta ładowany przez snippet nie wysyła wtedy własnych odsłon przy zmianie adresu. Pixel Meta z GTM wysyła je domyślnie: ustaw w nim przed init fbq.disablePushState = true albo nie włączaj data-spa, inaczej Meta policzy odsłonę dwa razy.

Tag konwersji Google Ads

TallyHost wysyła zakup do akcji konwersji zakupu z ustawień destynacji Google Ads. Google połączy zakup z tagu na stronie z zakupem od TallyHost tylko wtedy, gdy oba trafiają do tej samej akcji i mają ten sam `transaction_id`. Taka akcja ma źródło „Witryna” i jest ustawiona ręcznie kodem (tag Google albo GTM). Akcje oparte na adresach URL i importowane z GA4 się do tego nie nadają.

  • Tag Google zostaje na stronie: w destynacji podaj akcję zakupu, której używa tag. Tag musi wysyłać jako transaction_id ten sam numer zamówienia co TallyHost. Numer od TallyHost zobaczysz w debuggerze, a numer z tagu w Google Tag Assistant albo w podglądzie GTM.
  • Destynacja używa akcji importu, a tag osobnej akcji „Witryna”: tylko jedna z nich może być działaniem głównym. Drugą ustaw w Google Ads jako działanie dodatkowe (Cele → Konwersje, ustawienia działania powodującego konwersję) albo wyłącz zakup w tagu. Działanie dodatkowe nie wpływa na stawki.
  • Zakup importowany z GA4: jeśli w Google Ads jest też działanie zakupu z Google Analytics 4, ustaw je jako dodatkowe. Inaczej zakup z GA4 i zakup od TallyHost będą dwiema konwersjami głównymi.

Leady, rejestracje i zdarzenia własne w Google Ads

W destynacji Google Ads możesz podać osobne akcje konwersji dla formularza (generate_lead), rejestracji konta (sign_up) i wybranych zdarzeń własnych (np. start_trial). Akcja zakupu jest wtedy opcjonalna: strona bez sprzedaży (SaaS, usługi) może wysyłać same leady. Zdarzenie bez akcji do Google Ads nie idzie.

  • Osobna akcja: utwórz w Google Ads akcję „Witryna (import z kliknięć)” tylko dla TallyHost. Jeśli tag Google na stronie wysyła ten sam lead do tej samej akcji, Google policzy go dwa razy, chyba że tag i wpis w dataLayer mają ten sam transaction_id. Bez transaction_id wysyłamy identyfikator zdarzenia TallyHost, którego tag nie zna.
  • Enhanced Conversions for Leads: gdy zdarzenie ma zahashowany e-mail albo telefon klienta (np. z serwera, z wtyczki sklepu), dołączamy je do konwersji, ale tylko przy zgodzie ad_user_data. W Google Ads włącz Enhanced Conversions for Leads i zaakceptuj warunki dotyczące danych klientów. Bez tego Google odrzuci konwersję, a destynacja zostanie wstrzymana z powodem w panelu.
  • Wartość: jeśli wpis w dataLayer ma value i currency, wysyłamy je. Bez nich Google użyje wartości domyślnej akcji.
  • Test: przy zapisie destynacji zdarzenie testowe sprawdza w Google wszystkie podane akcje naraz, niczego nie zapisując. Zmiana akcji w istniejącej destynacji to nowa destynacja.

Odbiorców do remarketingu Google Ads zbiera tag Google na stronie. TallyHost ich nie tworzy, więc tagu nie usuwaj, jeśli z nich korzystasz. Tag Google, tak jak tagi Pixeli, działa według zgód z banera cookies (Consent Mode): ad_storage, ad_user_data i ad_personalization, a tag GA4 także analytics_storage. Zobacz Baner cookies (CMP) i zgody.

Pixel TikToka

Snippet TallyHost nie ładuje Pixela TikToka. Jeśli Pixel TikToka jest w sklepie, zdarzenie z Pixela i zdarzenie z TallyHost muszą trafiać do tego samego Pixela (kod Pixela taki jak w destynacji TikTok) i mieć tę samą nazwę oraz ten sam identyfikator zdarzenia (event_id). Inaczej TikTok policzy je dwa razy.

W Google Tag Manager użyj oficjalnego szablonu tagu TikTok Pixel. W polu „Event ID” (sekcja deduplikacji) wybierz zmienną TH - event_id z kroku 1 wyżej, a reguły ustaw jak w kroku 2. Nazwy zdarzeń TikToka są takie same jak nazwy Meta z kroku 3 (ViewContent, AddToCart, InitiateCheckout, AddPaymentInfo, Purchase). Jeśli w destynacji TikTok włączone są „Stare nazwy zdarzeń”, zakup w Pixelu musi nazywać się CompletePayment, a lead SubmitForm. Najpewniej działa oficjalny szablon. Własny kod wstawiaj tylko wtedy, gdy szablonu nie da się użyć; identyfikator idzie w nim w trzecim argumencie:

<script>
  ttq.track('AddToCart',
    { value: {{TH - value}}, currency: '{{TH - currency}}' },
    { event_id: '{{TH - event_id}}' });
</script>

Tagi Pixela TikToka mają te same wymagania zgody co tagi Pixela Meta (krok 4). Jeśli nie możesz przekazać event_id (na przykład wtyczka TikToka go nie obsługuje), wyłącz w Pixelu albo we wtyczce zdarzenia, które wysyła TallyHost.

TallyHost wysyła do TikToka także odsłony (Pageview). Kod bazowy Pixela TikToka wywołuje ttq.page() i wysyła własną odsłonę. Identyfikator odsłony tworzy snippet TallyHost, a w dataLayer go nie ma, więc tych dwóch odsłon TikTok nie połączy i policzy odsłonę dwa razy. Jeśli w sklepie działa Pixel TikToka, wybierz jedno:

  • wyłącz „Wyświetlenie strony” w ustawieniach zdarzeń destynacji TikTok i zostaw odsłony Pixelowi;
  • albo usuń ttq.page() z kodu bazowego Pixela (w szablonie GTM nie twórz tagu odsłony). Odsłony wyśle wtedy tylko TallyHost, także u odwiedzających z blokerem.