> ## 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).

# 🔗 Integreren Hoppy Cookie met transparantie- en goedkeuringskader v2.3 (TCF)

> ℹ️ **Note:** Dit artikel is automatisch vertaald met behulp van AI en kan onjuistheden bevatten. Als er iets mis is, neem dan contact op met ons ondersteuningsteam.

De integratie van Transparency & Access Framework v2.3 (TCF) helpt uw winkel om toestemmingssignalen op een gestandaardiseerde manier aan IAB-geregistreerde leveranciers te communiceren.

Indien ingeschakeld, Hoppy Cookie genereert en beheert een geldige TCF toestemming string (TC String), stelt de officiële `__tcfapi` interface, en deelt bezoekers toestemming voorkeuren met deelnemende advertenties en analytics leveranciers.

Hoppy Cookie is reeds geregistreerd als een IAB Toestemming Management Platform (CMP ID: 454), dus geen aanvullende registratie of externe installatie is vereist.

---

# **⚠️ Voordat u begint**

Alvorens TCF in te schakelen, moet u:

*   Hoppy GDPR EU Cookie Banner is geïnstalleerd en actief
*   Uw Cookie Banner wordt gepubliceerd
*   De App Embed is ingeschakeld in uw Shopify thema

💡 Er zijn geen API sleutels, referenties of externe accounts vereist.

⚠️ TCF is alleen van toepassing op bezoekers in AVG-regio's.

Als u van plan bent om **Google Toestemmingsmodus V2** voor GDPR-verkeer moet TCF eerst worden ingeschakeld.

---

# **🛠️ Stap 1 Open de sectie Integraties**

In uw Shopify Beheerder:

→ Openen **Hoppy GDPR EU Cookie Banner**

→ Klik **Integraties**

Zoeken:

**Transparantiekader v2.3 (TCF)**

en open de integratie pagina.

---

# **🚀 Stap 2 Inschakelen TCF**

Bovenaan de pagina:

→ Klik **Aanzetten**

Eenmaal ingeschakeld:

*   De integratiestatus verandert in **Aan**
*   De app laadt de IAB Global Leverancierslijst (GVL)
*   Het storefront begint de `__tcfapi` interface
*   GDPR bezoekers ontvangen een TCF-compatibele toestemming ervaring

💡 De banner en voorkeuren popup automatisch aanpassen aan de TCF structuur wanneer nodig.

---

# **🧩 Stap 3**

Hieronder vindt u het volgende:

### **Verkopers zoeken**

veld.

Hiermee kunt u kiezen welke leveranciers uit de IAB Global Leverancierslijst toestemmingssignalen mogen ontvangen.

### **Hoe toe te voegen leveranciers**

→ Start met het typen van een leveranciersnaam

→ Selecteer de verkoper uit de resultaten

→ Herhaal indien nodig

### **Hoe te verwijderen leveranciers**

→ Klik op de **×** naast de verkoopnaam

uit de geselecteerde lijst verwijderen.

---

### **Belangrijk gedrag**

Als er geen leveranciers zijn geselecteerd:

→ Alle leveranciers van de Global Leverancierslijst zijn standaard toegestaan.

Voor de meeste handelaren, het selecteren van alleen de leveranciers actief gebruikt op de storefront wordt aanbevolen.

Dit helpt toestemming communicatie nauwkeuriger en gemakkelijker te beheren.

---

# **💾 Stap 4: Uw wijzigingen opslaan**

Na het inschakelen van TCF en het selecteren van uw voorkeur leveranciers:

→ Klik **Opslaan**

De app zal:

*   Bewaar uw TCF configuratie
*   Opgeslagen instellingen bijwerken
*   De benodigde bannerconfiguratie republiseren

Eenmaal opgeslagen, begint de storefront automatisch met de bijgewerkte TCF-instellingen.

---

# **🔄 Hoe TCF Werken**

Na activering werkt de toestemmingsstroom automatisch voor bezoekers van de AVG.

### **Wat gebeurt er achter de scènes**

1.  De app laadt de nieuwste IAB Global Leverancierslijst
2.  Bezoekers interactie met de TCF-compatibele toestemming banner
3.  Toestemmingskeuzes worden omgezet in een TC String
4.  De TC String wordt opgeslagen op de storefront
5.  Toestemmingssignalen worden gedeeld door de `__tcfapi` interface
6.  Deelnemende leveranciers aanpassen gedrag op basis van de verleende machtigingen

Dit proces gebeurt automatisch zonder enige handmatige interventie.

---

# **🧪 Stap 5: Controleer de integratie**

Na het opslaan wordt aanbevolen om te controleren of TCF correct werkt.

---

## **Controleer de integratiestatus**

Terug naar:

**Integraties → Transparantiekader v2.3 (TCF)**

De status-badge moet worden weergegeven:

**Aan**

---

## **Test uit een AVG-regio**

Omdat TCF alleen van toepassing is op bezoekers van de AVG:

→ Test met behulp van een VPN-locatie in de EU

of

→ Beschikbaar gebruiken Shopify testtools voor regionaal storefrontgedrag

De TCF-toestemmingservaring moet automatisch verschijnen.

---

## **Controleer de TC-tekenreeks**

Na het indienen van toestemming voorkeuren:

→ Ontwikkelhulpmiddelen van uw browser openen

→ Controleer browsercookies

Zoek naar:

euconsent-v2

Mogelijk vindt u ook dezelfde waarde opgeslagen in localStorage.

De aanwezigheid bevestigt dat een geldige TC String is gegenereerd en opgeslagen.

---

## **Verifieer het gedrag van de leverancier**

Indien specifieke leveranciers werden geselecteerd:

→ Bevestig die leverancier scripts correct laden

→ Controleer of ze correct reageren op toestemming selecties

Als u Google Toestemmingsmodus V2 naast TCF gebruikt, test beide integraties samen om ervoor te zorgen dat de toestemmingssignalen stromen zoals verwacht.

---

# **⚠️ Vaak voorkomende problemen oplossen**

## **TCF Banner verschijnt niet**

Verifiëren:

*   De bezoeker is gelegen in een GDPR regio
*   De Cookie Banner wordt gepubliceerd
*   Het insluiten van de App is ingeschakeld

TCF functionaliteit activeert alleen wanneer de AVG vereisten van toepassing zijn.

---

## **Verkoperslijst wordt niet geladen**

De Global Leverancierslijst wordt tijdelijk gecached voor uitvoering.

Indien leveranciers niet verschijnen:

→ Pagina vernieuwen

→ Wacht een paar minuten en probeer het opnieuw

→ Controleer uw storefront kan toegang krijgen tot de leverancierslijst service

---

## **Verkopers negeren toestemming**

Verifiëren:

*   De juiste leveranciers zijn geselecteerd
*   De verkoper ondersteunt de `__tcfapi` interface
*   De verkoper is geregistreerd binnen het IAB kader

TCF heeft alleen invloed op leveranciers die deelnemen aan het kader.

---

## **Google Toestemmingsmodus V2 werkt niet**

TCF is vereist voor Google Toestemming Mode V2 in AVG regio's, maar het configureert Google Toestemming Mode niet automatisch.

Na het inschakelen van TCF:

→ Google Toestemmingsmodus V2 apart van de sectie Integraties instellen.

---

# **⚠️ Belangrijke opmerkingen**

### **Alleen AVG-regio's**

TCF is alleen van toepassing op bezoekers binnen GDPR-gebieden.

Bezoekers buiten die regio's blijven gebruik maken van de standaard toestemmingservaring.

---

### **Lege leverancierslijst staat alle leveranciers toe**

Als er geen leveranciers handmatig zijn geselecteerd:

→ Alle leveranciers van de Global Leverancierslijst zijn standaard toegestaan.

---

### **Toestemming wordt automatisch opgeslagen**

De gegenereerde TC String wordt automatisch opgeslagen en hergebruikt volgens de toestemmingseisen.

Er is geen handmatige cookieconfiguratie nodig.

---

### **TCF Is vereist voor Google-toestemmingsmodus V2**

Voor bezoekers van de AVG hangt Google Toestemmingsmodus V2 af van het feit dat TCF actief is.

TCF moet altijd worden geconfigureerd voordat Google Access Mode V2 wordt ingeschakeld.

---

# **🎉 Eindresultaat**

Eenmaal succesvol geconfigureerd:

✅ GDPR bezoekers ontvangen een TCF-conforme toestemming ervaring

✅ Toestemmingskeuzes worden omgezet in een geldige TC String

✅ De `__tcfapi` interface beschikbaar wordt op de storefront

✅ IAB-geregistreerde leveranciers ontvangen gestandaardiseerde toestemmingssignalen

✅ De machtigingen van de leverancier kunnen direct vanuit de app worden gecontroleerd

✅ Uw winkel is klaar voor Google Toestemming Mode V2 en andere TCF-compatibele diensten

Het Transparency & Access Framework v2.3 integratie helpt ervoor te zorgen dat toestemmingsinformatie wordt gecommuniceerd in een gestandaardiseerd formaat dat belangrijke reclame- en analyseleveranciers kunnen begrijpen en respecteren. 🔒

---