> ## 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 zasadami przejrzystości i zgody v2.3 (TCF)

> ℹ️ **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.

Integracja Transparency & Consent Framework v2.3 (TCF) pomaga sklepowi w przekazywaniu w standaryzowany sposób sygnałów zgody zarejestrowanym dostawcom IAB.

Kiedy włączone, Hoppy Cookie generuje i zarządza poprawnym łańcuchem zgody TCF (TC String), ujawnia oficjalny `__tcfapi` interfejs i dzieli preferencje zgody odwiedzających z uczestniczącymi sprzedawcami reklam i analityków.

Hoppy Cookie jest już zarejestrowany jako IAB Consent Management Platform (CMP ID: 454), więc nie jest wymagana dodatkowa rejestracja lub konfiguracja zewnętrzna.

---

# **⚠️ Zanim zaczniesz**

Przed włączeniem TCF należy upewnić się, że:

*   Hoppy GDPR EU Cookie Banner jest zainstalowany i aktywny
*   Twój Cookie Banner jest opublikowany
*   Zamontowana aplikacja jest włączona wewnątrz Shopify motyw

💡 Nie są wymagane klucze API, referencje lub konta zewnętrzne.

⚠️ TCF ma zastosowanie wyłącznie do odwiedzających zlokalizowanych w regionach GDPR.

Jeśli planuje się stosowanie leku **Tryb zgody Google V2** W przypadku ruchu GDPR należy najpierw włączyć TCF.

---

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

Wewnątrz Shopify Admin:

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

→ Kliknij **Integracje**

Zlokalizuj:

**Ramy przejrzystości i zgody v2.3 (TCF)**

i otworzyć stronę integracji.

---

# **🚀 Etap 2 - Włącz TCF**

Na górze strony:

→ Kliknij **Włącz**

Po włączeniu:

*   Zmiana statusu integracji **On**
*   Aplikacja ładuje globalną listę dostawców IAB (GVL)
*   Sklepy zaczynają ujawniać `__tcfapi` interfejs
*   Odwiedzający GDPR otrzymują doświadczenie w zakresie zgody zgodnej z TCF-

💡 Baner i preferencje wyświetlane automatycznie dostosowują się do struktury TCF w razie potrzeby.

---

# **🧩 Etap 3 - Wybierz współpracujących dostawców (opcjonalnie)**

Poniżej przełączania integracji znajdziesz:

### **Poszukiwacze**

Pole.

Pozwala to wybrać, którzy sprzedawcy z Global Vendor List IAB mogą otrzymywać sygnały zgody.

### **Jak dodawać instalatorów**

→ Zacznij wpisywać nazwę sprzedawcy

→ Wybierz sprzedawcę z wyników

→ Powtórzyć w razie potrzeby

### **Jak usunąć sprzedawców**

→ Kliknij **×** obok nazwy sprzedawcy

usunąć go z wybranej listy.

---

### **Ważne zachowanie**

Jeżeli nie wybrano dostawców:

→ Domyślnie dopuszcza się wszystkich dostawców z Global Vendor List.

Dla większości kupców, wybór tylko sprzedawców aktywnie używane w sklepie jest zalecane.

Pomaga to utrzymać komunikację zgody bardziej dokładne i łatwiejsze w zarządzaniu.

---

# **💾 Krok 4 - Zapisz zmiany**

Po włączeniu TCF i wybraniu preferowanych dostawców:

→ Kliknij **Zapisz**

Aplikacja będzie:

*   Zapisz konfigurację TCF
*   Aktualizuj ustawienia storefrontu
*   Rozdzielcie niezbędną konfigurację banera

Po zapisaniu, sklep zaczyna korzystać z uaktualnionych ustawień TCF automatycznie.

---

# **🔄 Jak TCF Roboty**

Po aktywacji, przepływ zgody działa automatycznie dla odwiedzających GDPR.

### **Co się dzieje za sceną**

1.  Aplikacja ładuje najnowszą Globalną Listę Sprzedawców IAB
2.  Odwiedzający kontaktują się z banerem zgody zgodnym z TCF-
3.  Wybór zgody jest przekształcany w ciąg TC
4.  TC String jest przechowywany w sklepie
5.  Sygnały zgody są dzielone poprzez `__tcfapi` interfejs
6.  Uczestniczący sprzedawcy dostosować zachowanie na podstawie przyznanych uprawnień

Proces ten odbywa się automatycznie bez konieczności ręcznej interwencji.

---

# **🧪 Krok 5 - Weryfikacja integracji**

Po zapisaniu zaleca się sprawdzenie, czy TCF działa prawidłowo.

---

## **Sprawdź status integracji**

Powrót do:

**Integracje → Transparency & Consent Framework v2.3 (TCF)**

Odznaka statusu powinna wyświetlać:

**On**

---

## **Test z regionu GDPR**

Ponieważ TCF dotyczy wyłącznie odwiedzających GDPR:

→ Badanie przy użyciu lokalizacji VPN UE

lub

→ Dostępne Shopify narzędzia testowe dla regionalnych zachowań sklepowych

Doświadczenia dotyczące zgody TCF powinny pojawić się automatycznie.

---

## **Weryfikacja łańcucha TC**

Po przedłożeniu preferencji zgody:

→ Otwórz narzędzia programisty przeglądarki

→ Sprawdź pliki cookie przeglądarki

Szukaj:

euconsent- v2

Można również znaleźć taką samą wartość przechowywaną w localStorage.

Jego obecność potwierdza, że został wygenerowany i zapisany prawidłowy ciąg TC String.

---

## **Sprawdzić zachowanie operatora**

Jeżeli wybrano konkretnych dostawców:

→ Potwierdź poprawny załadunek skryptów sprzedających

→ Sprawdzić, czy reagują odpowiednio na wybór zgody

W przypadku korzystania z Google Consent Mode V2 obok TCF, testować obie integracje razem, aby zapewnić, że sygnały zgody płyną zgodnie z oczekiwaniami.

---

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

## **TCF Banner nie pojawia się**

Weryfikacja:

*   Gość znajduje się w regionie GDPR
*   Cookie Banner jest opublikowany
*   Zamontowana aplikacja jest włączona

Funkcje TCF aktywują się tylko w przypadku zastosowania wymogów GDPR.

---

## **Lista dostawców nie jest wczytywana**

Global Vendor List jest tymczasowo buforowany dla wydajności.

Jeżeli sprzedawcy nie pojawiają się:

→ Odśwież stronę

→ Poczekaj kilka minut i spróbuj ponownie

→ Weryfikacja sklepu może uzyskać dostęp do serwisu listy sprzedawców

---

## **Sprzedawcy ignorują zgodę**

Weryfikacja:

*   Właściwi sprzedawcy zostali wybrani
*   Sprzedawca wspiera `__tcfapi` interfejs
*   Sprzedawca jest zarejestrowany w ramach IAB

TCF dotyczy wyłącznie dostawców, którzy uczestniczą w ramach.

---

## **Tryb zgody Google V2 nie działa**

TCF jest wymagany dla trybu zgody Google V2 w regionach GDPR, ale nie konfiguruje automatycznie trybu zgody Google.

Po włączeniu TCF:

→ Konfiguracja trybu zgody Google V2 oddzielnie od sekcji Integracje.

---

# **⚠️ Ważne uwagi**

### **Tylko regiony GDPR**

TCF ma zastosowanie wyłącznie do odwiedzających w regionach objętych programem Glasgow.

Goście spoza tych regionów nadal korzystają ze standardowego doświadczenia w zakresie zgody.

---

### **Empty Vendor List umożliwia wszystkich autorów**

Jeżeli żaden sprzedawca nie zostanie wybrany ręcznie:

→ Domyślnie dopuszcza się wszystkich dostawców z Global Vendor List.

---

### **Zgoda jest przechowywana automatycznie**

Wygenerowany TC String jest automatycznie zapisywany i ponownie używany zgodnie z wymogami zgody.

Ręczna konfiguracja plików cookie nie jest konieczna.

---

### **TCF Wymagane dla trybu zgody Google V2**

Dla odwiedzających GDPR tryb zgody Google V2 zależy od aktywności TCF.

TCF należy zawsze skonfigurować przed włączeniem trybu zgody Google V2.

---

# **🎉 Wynik końcowy**

Po skonfigurowaniu:

✅ Odwiedzający GDPR otrzymują doświadczenie w zakresie zgody zgodnej z TCF-

✅ Wybór zgody jest konwertowany na poprawny ciąg TC

✅ W `__tcfapi` interfejs staje się dostępny w sklepie

✅ Producenci zarejestrowani w IAB otrzymują standardowe sygnały zgody

✅ Uprawnienia Vendor mogą być kontrolowane bezpośrednio z aplikacji

✅ Twój sklep jest gotowy do Google Consent Mode V2 i innych usług kompatybilnych z TCF-

Integracja Transparency & Consent Framework v2.3 pomaga zapewnić przekazywanie informacji dotyczących zgody w standardowym formacie, który mogą zrozumieć i szanować główni sprzedawcy reklam i analiz. 🔒

---