> ## 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). # 🔗 Integrazione Hoppy Cookie con Transparency & Consent Framework v2.3 (TCF) > ℹ️ **Note:** Questo articolo è stato tradotto automaticamente utilizzando AI e può contenere imprecisioni. Se qualcosa sembra sbagliato, si prega di contattare il nostro team di supporto. L'integrazione Transparency & Consent Framework v2.3 (TCF) aiuta il tuo negozio a comunicare i segnali di consenso ai fornitori registrati IAB in modo standardizzato. Quando abilitato, Hoppy Cookie genera e gestisce una stringa di consenso TCF valida (TC String), espone il funzionario `__tcfapi` interfaccia e condivide le preferenze di consenso dei visitatori con i fornitori di pubblicità e analisi partecipanti. Hoppy Cookie è già registrato come piattaforma di gestione del Consenso IAB (CMP ID: 454), quindi non è richiesta alcuna registrazione aggiuntiva o configurazione esterna. --- # **⚠️ Prima di iniziare** Prima di attivare TCF, assicurarsi: * Hoppy GDPR EU Cookie Banner è installato e attivo * Il tuo banner sui cookie è pubblicato * L'App Embed è abilitato all'interno del tuo Shopify tema 💡 Non sono richieste chiavi API, credenziali o account esterni. ⚠️ TCF si applica solo ai visitatori situati nelle regioni del GDPR. Se hai intenzione di usare **Google Consent Mode V2** per il traffico GDPR, TCF dovrebbe essere abilitato prima. --- # **🛠️ Fase 1 — Aprire la sezione Integrazioni** dentro il Shopify Admin: → Aperto **Hoppy GDPR EU Cookie Banner** → Cliccare **Integrazioni** Ricerca: **Transparency & Consent Framework v2.3 (TCF)** e aprire la pagina di integrazione. --- # **🚀 Fase 2 — Abilita TCF** Nella parte superiore della pagina: → Cliccare **Girare** Una volta abilitato: * Lo stato di integrazione cambia a **Su** * L'applicazione carica l'IAB Global Vendor List (GVL) * Il negozio inizia a esporre `__tcfapi` interfaccia * I visitatori del GDPR ricevono un'esperienza di consenso compatibile con TCF 💡 Il banner e le preferenze si adattano automaticamente alla struttura TCF quando necessario. --- # **🧩 Fase 3 — Selezionare i fornitori di collaborazione (opzionale)** Sotto il controllo di integrazione, troverete il: ### **Cerca fornitori** campo. Questo consente di scegliere quali fornitori della IAB Global Vendor List sono autorizzati a ricevere segnali di consenso. ### **Come Aggiuntare i Venditori** → Inizia a digitare un nome del fornitore → Selezionare il fornitore dai risultati → Ripetere come necessario ### **Come rimuovere i venditori** → Fare clic su **×** accanto al nome del fornitore per rimuoverlo dall'elenco selezionato. --- ### **Comportamento importante** Se non vengono selezionati fornitori: → Tutti i fornitori della Lista Global Vendor sono autorizzati per impostazione predefinita. Per la maggior parte dei commercianti, selezionando solo i venditori attivamente utilizzati sul negozio è raccomandato. Questo aiuta a mantenere la comunicazione di consenso più accurata e più facile da gestire. --- # **💾 Passo 4 — Salva le tue modifiche** Dopo aver abilitato TCF e selezionando i vostri fornitori preferiti: → Cliccare **Salva** L'app sarà: * Conserva la configurazione TCF * Aggiornare le impostazioni di storefront * Rimozione della configurazione del banner necessaria Una volta salvato, il negozio inizia a utilizzare automaticamente le impostazioni TCF aggiornate. --- # **🔄 Come funziona TCF Lavori** Dopo l'attivazione, il flusso di consenso funziona automaticamente per i visitatori del GDPR. ### **Cosa succede dietro le quinte** 1. L'applicazione carica l'ultima IAB Global Vendor List 2. I visitatori interagiscono con il banner di consenso compatibile con TCF 3. Le scelte consenti vengono convertite in uno String TC 4. Il TC String viene memorizzato sul negozio 5. I segnali di consenso sono condivisi attraverso il `__tcfapi` interfaccia 6. I fornitori partecipanti regolano il comportamento in base alle autorizzazioni concesse Questo processo avviene automaticamente senza richiedere alcun intervento manuale. --- # **🧪 Passo 5 — Verificare l'integrazione** Dopo aver salvato, si consiglia di verificare che TCF stia funzionando correttamente. --- ## **Controlla lo stato di integrazione** Torna a: **Integrazioni → Transparency & Consent Framework v2.3 (TCF)** Il badge di stato dovrebbe visualizzare: **Su** --- ## **Test di una regione del GDPR** Perché TCF si applica solo ai visitatori del GDPR: → Test utilizzando una posizione VPN UE o → Usa disponibile Shopify strumenti di prova per il comportamento del negozio regionale L'esperienza di consenso TCF dovrebbe apparire automaticamente. --- ## **Verifica lo String TC** Dopo aver presentato le preferenze di consenso: → Apri gli Strumenti di sviluppo del tuo browser → Controlla i cookie del browser Cerca: euconsent-v2 Puoi anche trovare lo stesso valore memorizzato in localStorage. La sua presenza conferma che un valido TC String è stato generato e memorizzato. --- ## **Verificare il comportamento del venditore** Se sono stati selezionati fornitori specifici: → Confermare che gli script del fornitore caricano correttamente → Verificare che rispondano adeguatamente alle selezioni di consenso Se si utilizza Google Consent Mode V2 accanto a TCF, testare entrambe le integrazioni insieme per garantire che i segnali di consenso stiano scorrendo come previsto. --- # **⚠️ Risoluzione dei problemi comuni** ## **TCF Banner non appare** Verifica: * Il visitatore si trova in una regione del GDPR * The Cookie Banner è pubblicato * L'App Embed è abilitato La funzionalità TCF si attiva solo quando si applicano i requisiti GDPR. --- ## **Elenco dei fornitori Non Caricamento** Il Global Vendor List viene memorizzato temporaneamente per le prestazioni. Se i fornitori non appaiono: → Aggiornare la pagina → Attendere qualche minuto e riprovare → Verifica il tuo negozio può accedere al servizio lista dei fornitori --- ## **I fornitori stanno ignorando il consenso** Verifica: * I fornitori corretti sono stati selezionati * Il fornitore supporta il `__tcfapi` interfaccia * Il venditore è registrato nel quadro IAB TCF colpisce solo i fornitori che partecipano al quadro. --- ## **Google Consent Mode V2 non funziona** TCF è necessario per Google Consent Mode V2 nelle regioni del GDPR, ma non configura automaticamente la modalità Consent di Google. Dopo aver abilitato TCF: → Configurare Google Consent Mode V2 separatamente dalla sezione Integrazioni. --- # **⚠️ Note importanti** ### **Regioni del PIL** TCF si applica solo ai visitatori situati all'interno delle regioni coperte dal GDPR. I visitatori al di fuori di queste regioni continuano ad utilizzare l'esperienza di consenso standard. --- ### **Elenco fornitori vuoti consente tutti i fornitori** Se nessun fornitore viene selezionato manualmente: → Tutti i fornitori della Lista Global Vendor sono autorizzati per impostazione predefinita. --- ### **Consent è memorizzato automaticamente** Il TC String generato viene memorizzato automaticamente e riutilizzato in base ai requisiti di consenso. Non è necessaria alcuna configurazione manuale dei cookie. --- ### **TABELLA È richiesto per Google Consent Mode V2** Per i visitatori del GDPR, Google Consent Mode V2 dipende dal fatto che TCF è attivo. TCF dovrebbe essere sempre configurato prima di abilitare Google Consent Mode V2. --- # **🎉 Risultato finale** Una volta configurato con successo: ✅ I visitatori del GDPR ricevono un'esperienza di consenso conforme al TCF ✅ Le scelte consenti vengono convertite in un valido TC String ✅ The `__tcfapi` l'interfaccia diventa disponibile sul negozio ✅ I fornitori registrati da IAB ricevono segnali di consenso standardizzati ✅ Le autorizzazioni del venditore possono essere controllate direttamente dall'app ✅ Il tuo negozio è pronto per Google Consent Mode V2 e altri servizi compatibili con TCF L'integrazione di Transparency & Consent Framework v2.3 aiuta a garantire che le informazioni sul consenso siano comunicate in un formato standardizzato che i principali fornitori di pubblicità e analisi possono comprendere e rispettare. 🔒 ---