🔗 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
__tcfapiinterfaccia - 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
- L'applicazione carica l'ultima IAB Global Vendor List
- I visitatori interagiscono con il banner di consenso compatibile con TCF
- Le scelte consenti vengono convertite in uno String TC
- Il TC String viene memorizzato sul negozio
- I segnali di consenso sono condivisi attraverso il
__tcfapiinterfaccia - 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
__tcfapiinterfaccia - 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. 🔒
Aggiornato il: 10/09/2026
Grazie!