> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.hoppyapps.com/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# 🔗 Integrat Hoppy Cookie z TikTok Pixel

> ℹ️ **Note:** Ten artykuł został automatycznie przetłumaczony za pomocą AI i może zawierać nieścisłości. Jeśli coś wygląda źle, skontaktuj się z naszym zespołem wsparcia.

Połączenia pikseli TikTok z Hoppy Cookie pozwala TikTok śledzenia przestrzegania preferencji zgody wybranych przez odwiedzających.

Zamiast załadunku natychmiast, gdy gość przybywa na Twój sklep, TikTok Pixel staje się aktywny tylko wtedy, gdy zgoda na dopuszczenie do obrotu jest udzielana. Pomaga to handlowcom w utrzymaniu bardziej przyjaznej dla prywatności konfiguracji śledzenia przy jednoczesnym kontynuowaniu wspierania reklamy TikTok, budowania publiczności, śledzenia konwersji i pomiaru kampanii, gdy odwiedzający chcą.

---

# **⚠️ Zanim zaczniesz**

Przed włączeniem TikTok Pixel, upewnij się, że:

*   Hoppy GDPR EU Cookie Banner jest zainstalowany i aktywny
*   Twój Cookie Banner jest opublikowany
*   Masz dostęp do TikTok Events Manager
*   Masz swój TikTok Pixel Snippet skrypt dostępny

Skrypt można pobrać bezpośrednio z:

**Menedżer imprez TikTok**

⚠️ **Ważne:**

Jeśli TikTok Pixel jest już zainstalowany bezpośrednio wewnątrz Shopify motyw lub za pomocą innej aplikacji, usunąć istniejącą implementację przed włączeniem tej integracji.

Uruchomienie wielu pikseli TikTok może spowodować:

*   Duplikat śledzenia
*   Zdarzenia powtórzone
*   Niedokładne raportowanie

---

# **🛠️ Krok 1 - Otwarcie sekcji Integracji**

Wewnątrz Shopify Admin:

→ Otwórz **Hoppy GDPR EU Cookie Banner**

→ Kliknij **Integracje**

Zlokalizuj:

**TikTok Pixel**

i otworzyć stronę integracji.

Jeśli integracja nie została jeszcze skonfigurowana, stan zostanie wyświetlony:

→ **Wyłącz**

---

# **🔑 Krok 2 - Wklej swój skrypt pikseli TikTok**

Zlokalizuj:

### **TikTok Pixel Script**

Wklej kompletny skrypt TikTok Pixel dostarczany przez TikTok Events Manager.

### **Przykład**

< script >  
...  
< / skrypt >

⚠️ Wklej cały skrypt dokładnie tak, jak jest to przewidziane.

Obejmuje to:

*   Otwarcie `<script>` tagi
*   Konfiguracja śledzenia
*   Zamknięcie `</script>` tagi

Usuwanie lub modyfikowanie fragmentów skryptu może uniemożliwić prawidłowe wczytanie TikTok Pixel.

---

# **⚙️ Krok 3 - Włącz integrację**

Po wklejeniu skryptu:

→ Włączenie / wyłączenie **Integracja z pikselem TikTok** do **On**

Po włączeniu:

*   Stan zmienia się na **On**
*   TikTok Pixel staje się dostępny
*   Zachowanie śledzenia jest kontrolowane przez preferencje zgody gości

Akceptacja marketingowa jest obecnie wykorzystywana do ustalenia, czy śledzenie TikTok może działać.

---

# **💾 Krok 4 - Zapisz zmiany**

Po wprowadzeniu skryptu i włączeniu integracji:

→ Kliknij **Zapisz**

Konfiguracja jest automatycznie synchronizowana z Twoim sklepem.

Nie są wymagane żadne dodatkowe edycje motywów.

---

# **🔄 Jak działa integracja**

Po włączeniu, zachowanie TikTok Pixel automatycznie odpowiada na preferencje zgody gości.

---

## **Kiedy akceptowane jest pozwolenie na dopuszczenie do obrotu**

Jeśli gość akceptuje pliki cookie marketingowe:

✅ Ładunki pikseli TikTok

✅ Śledzenie TikTok staje się aktywne

✅ Pomiar reklamowy może wystąpić

✅ Publiczność budynku i śledzenia konwersji stają się dostępne

Pozwala to na kampanie TikTok zbierać zatwierdzone interakcje gości.

---

## **Kiedy pozwolenie na dopuszczenie do obrotu jest zaprzeczone**

Jeśli odwiedzający traci cookies marketingowe:

❌ TikTok Pixel nie ładuje

❌ Żądania śledzenia są zablokowane

❌ Zapobiega się działalności związanej z monitorowaniem

Pomaga to zapewnić dostosowanie śledzenia do preferencji zgody gości.

---

## **When Consent Preferences Change**

Jeśli odwiedzający zaktualizuje swoje preferencje później:

*   Śledzenie TikTok może być włączone
*   Śledzenie TikTok może być wyłączone

w zależności od zaktualizowanego wyboru pozwolenia na dopuszczenie do obrotu.

Integracja automatycznie dostosowuje zachowanie śledzenia w razie potrzeby.

---

# **🧪 Krok 5 - Weryfikacja integracji**

Po zapisaniu zaleca się sprawdzenie poprawności integracji.

---

## **Test z pozwolenia na dopuszczenie do obrotu Odmowa**

→ Otwórz sklep w oknie przeglądarki Incognito lub Private

→ Odrzucanie plików cookie marketingowych

Następnie:

→ Open Developer Tools

→ Otwórz **Sieć** tab

→ Szukaj:

tiktok

lub

ttq

### **Oczekiwany wynik**

Nie powinny pojawiać się żadne żądania śledzenia TikTok.

Potwierdza to, że integracja prawidłowo blokuje TikTok Pixel.

---

## **Test z akceptacją pozwolenia na dopuszczenie do obrotu**

Powtórzyć test używając świeżego okna Incognito.

Tym razem:

→ Akceptuj pliki cookie marketingowe

→ Odśwież stronę w razie potrzeby

Następnie:

→ Otwórz **Sieć** tab

→ Szukaj:

tiktok

lub

ttq

### **Oczekiwany wynik**

TikTok Pixel powinien ładować z powodzeniem.

Zdarzenie PageView powinno być również automatycznie wywołane.

---

## **Sprawdź konsolę przeglądarki**

Otwórz narzędzia programisty i przełącz na konsolę.

Przegląd wyników dla:

*   Komunikaty inicjalizacji TikTok
*   Błędy śledzenia
*   Zagadnienia wczytywania skryptu

Wszelkie błędy przedstawione tutaj mogą pomóc w identyfikacji problemów z konfiguracją.

---

# **⚠️ Wspólne rozwiązywanie problemów**

## **TikTok Pixel Loads Przed zgodą**

To zazwyczaj wskazuje, że TikTok Pixel jest zainstalowany gdzie indziej.

Sprawdź:

*   Shopify Kod motywu
*   Rozszerzenia aplikacji tematycznych
*   Inne Shopify aplikacje
*   Własne skrypty śledzenia

Usuń duplikat instalacji TikTok i pozwolić Hoppy Cookie bezpośrednio zarządzać pikselem.

---

## **Piksel TikTok nie wczytuje po wyrażeniu zgody**

Weryfikacja:

*   Kompletny skrypt TikTok został wklejony poprawnie
*   Integracja jest włączona
*   Zmiany zostały zapisane
*   Zaakceptowano zgodę na dopuszczenie do obrotu

Brakujące części skryptu mogą zapobiec inicjalizacji TikTok Pixel.

---

## **Duplikowane wydarzenia w TikTok Events Manager**

Duplikaty zdarzeń zwykle występują, gdy TikTok Pixel jest ładowany z wielu miejsc.

Tylko jedna implementacja TikTok powinna pozostać aktywna.

---

## **Brak aktywności TikTok**

Weryfikacja:

*   Użyto poprawnego skryptu TikTok Pixel
*   Wydano zgodę na dopuszczenie do obrotu
*   Żądania śledzenia są widoczne w narzędziach programisty
*   Brak błędów JavaScript zapobiega inicjalizacji

Zaleca się badanie za pomocą okna Incognito.

---

# **⚠️ Ważne uwagi**

### **Kontrola pozwolenia na dopuszczenie do obrotu**

TikTok Pixel odpowiada konkretnie na kategorię Cookies Marketing.

W przypadku odmowy zgody na dopuszczenie do obrotu, śledzenie TikTok pozostaje wyłączone.

---

### **Pełny skrypt jest wymagany**

W przeciwieństwie do niektórych liczb całkowitych, które wymagają tylko ID, TikTok Pixel wymaga pełnego skrótu skryptowego dostarczonego przez TikTok Events Manager.

---

### **Nie wymaga kodowania motywu**

Po skonfigurowaniu, integracja zarządza TikTok Pixel automatycznie.

Nie są konieczne żadne dodatkowe modyfikacje tematu.

---

### **Unikaj powielania instalacji**

Nigdy nie wczytywać Pixel TikTok jednocześnie przez:

*   Hoppy Cookie
*   Kod motywu
*   Kolejna aplikacja
*   Własne skrypty śledzenia

chyba że specjalnie skonfigurowane w celu zapobiegania duplikatom zdarzeń.

---

# **🎉 Wynik końcowy**

Po skonfigurowaniu:

✅ TikTok Pixel ładuje się tylko po uzyskaniu pozwolenia na dopuszczenie do obrotu

✅ Odwiedzający, którzy odmawiają Cookies marketingowe nie są śledzone

✅ Pomiar reklamowy pozostaje dostępny po uzyskaniu zgody

✅ Zgodnie z oczekiwaniami prace związane z budową widowni i monitorowaniem konwersji

✅ Nie jest wymagane ręczne kodowanie motywu

✅ Zachowanie śledzenia pozostaje zgodne z preferencjami Cookie Banner

Integracja pikseli TikTok pomaga handlowcom zrównoważyć wydajność reklamy i prywatność odwiedzających poprzez zapewnienie śledzenia TikTok aktywuje się tylko wtedy, gdy została udzielona odpowiednia zgoda.

---