TikTok
Collegare il pixel TikTok al sito dell'accademia per le campagne TikTok, gli eventi standard che inviamo, come verificarli con Test Events e Pixel Helper e come evitare il doppio conteggio.
08/10/2026
Con il pixel TikTok le campagne TikTok vedono visite, corsi visti, checkout, richieste, registrazioni e acquisti del sito dell'accademia, per ottimizzare e creare pubblici. Aladia carica il codice ufficiale del pixel con il tuo Pixel ID e invia gli eventi standard di TikTok.
TikTok si carica solo dopo il consenso Marketing nel banner dei cookie. Cookie, consenso e pagine in cui parte valgono per tutti gli strumenti: vedi Tracciamento e cookie.
Dove trovare l'ID
- In TikTok Ads Manager apri Strumenti › Events Manager (TikTok: Events Manager).
- Apri il pixel web del sito. Se non c'è: Collega origine dati › Web, e come metodo scegli la configurazione manuale (codice), non un partner (TikTok: configurare e verificare il pixel).
- Il Pixel ID è sotto il nome del pixel: lettere maiuscole e cifre, circa 20 caratteri (es.
C4ABCDEFGH12345678IJ).
Non serve copiare il codice del pixel: lo carica Aladia.
Collegarlo in Aladia
- Impostazioni › Integrazioni, categoria Marketing, card TikTok.
- Nella sezione Collegamento scrivi il Pixel ID e accendi l'interruttore.
- Premi Salva: compare il badge Attivo.
Servono il ruolo Proprietario o Admin. Con un formato sbagliato il campo mostra Formato atteso e non si salva.
Eventi inviati
I nomi sono gli eventi standard di TikTok.
| Evento Aladia | Quando | Evento TikTok | Parametri |
|---|---|---|---|
| Pagina vista | Ogni pagina pubblica, anche navigando senza ricaricare | ttq.page() | — |
| Corso visto | Apertura della pagina di un corso, da chi non è iscritto | ViewContent | contents, value, currency |
| Checkout aperto | Apertura del checkout | InitiateCheckout | contents, value, currency |
| Richiesta inviata | Invio riuscito del modulo di richiesta | SubmitForm | contents |
| Registrazione | Account creato e verificato sul sito | CompleteRegistration | — |
| Acquisto | Pagamento riuscito, una volta per acquisto | CompletePayment | contents, value, currency |
In contents c'è il corso: content_id (id del corso), content_name, content_type (product), quantity e price se pubblico. Ogni evento ha un event_id (per l'acquisto purchase.<id della sessione di pagamento>) per la deduplica con l'Events API lato server (TikTok: deduplica degli eventi). Nessun dato personale: niente email, telefono o nome.
Come verificare
- Accendi TikTok e salva.
- In Events Manager › il tuo pixel › Test Events, apri il sito dal codice QR o dall'indirizzo (TikTok: Test Events).
- Nel sito premi Accetta nel banner dei cookie e naviga: compaiono la pagina vista,
ViewContentsu un corso,SubmitFormdopo una richiesta… - Oppure usa l'estensione TikTok Pixel Helper per Chrome sul sito (TikTok Pixel Helper).
- Da Preferenze cookie nel piè di pagina prova Rifiuta: TikTok non deve ricevere più nulla (Aladia chiama
ttq.revokeConsent()).
Invio dal server
Oltre al pixel, Aladia invia a TikTok InitiateCheckout, SubmitForm, CompleteRegistration e CompletePayment con la Events API, con lo stesso event_id del browser (TikTok: deduplica) e, in hash SHA-256, email e telefono. Cosa inviamo, deduplica e privacy: Invio dal server.
- Apri TikTok Ads Manager › Strumenti › Events Manager › il tuo pixel web › Impostazioni.
- Nella sezione Events API scegli Genera token di accesso e copialo (TikTok: Events API, documentazione per sviluppatori).
- In Aladia, in questa pagina, sezione Invio dal server: incolla il token, Salva, poi accendi l'interruttore.
- Verifica: Events Manager › il tuo pixel › Test Events, copia il codice di test e incollalo in Codice evento di test; gli eventi del server compaiono lì (TikTok: Test Events). Toglilo dopo il collaudo.
Problemi frequenti
- Pixel Helper non trova il pixel. Il visitatore non ha dato il consenso Marketing: senza, TikTok non si carica. Usa una finestra in incognito e premi Accetta.
- "Formato atteso" sotto il campo. Hai copiato l'ID dell'account pubblicitario o un codice con caratteri in più: serve il Pixel ID (lettere maiuscole e cifre).
- Il pixel risulta "Inattivo". Non è ancora arrivato nessun evento dopo il salvataggio: apri il sito, accetta i cookie e naviga.
- Gli acquisti fatti dopo l'accesso non arrivano. Dal browser l'acquisto parte dal checkout senza accesso; gli altri (dopo l'accesso, a rate) li conta l'invio dal server, per chi ha accettato i cookie.
Doppio conteggio
TikTok qui e in Google Tag Manager
Se accendi TikTok qui e Google Tag Manager, e nel contenitore hai anche il tag del pixel TikTok, ogni evento arriva due volte: la pagina lo segnala con un avviso. Tieni il pixel in un solo posto, e non collegarlo anche tramite un partner sullo stesso sito.
Vedi anche: Meta, Google Tag Manager.
Meta (Facebook e Instagram)
Collegare il Dataset Meta (ex pixel) al sito dell'accademia per le campagne Facebook e Instagram, gli eventi standard che inviamo, come verificarli con Eventi di test e come evitare il doppio conteggio.
SSO dei clienti, guida per lo sviluppatore
Come il tuo prodotto fa entrare i suoi utenti nell'accademia Aladia con lo stesso account, firmando un JWT. Flusso, claim, esempi Node.js, Python e PHP (HS256 e RS256/JWKS), deep link, remote login, logout, iscrizioni ai corsi, errori e checklist di sicurezza.