AladiaDocs
Integrazioni

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

  1. In TikTok Ads Manager apri Strumenti › Events Manager (TikTok: Events Manager).
  2. 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).
  3. 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

  1. Impostazioni › Integrazioni, categoria Marketing, card TikTok.
  2. Nella sezione Collegamento scrivi il Pixel ID e accendi l'interruttore.
  3. 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 AladiaQuandoEvento TikTokParametri
Pagina vistaOgni pagina pubblica, anche navigando senza ricaricarettq.page()—
Corso vistoApertura della pagina di un corso, da chi non è iscrittoViewContentcontents, value, currency
Checkout apertoApertura del checkoutInitiateCheckoutcontents, value, currency
Richiesta inviataInvio riuscito del modulo di richiestaSubmitFormcontents
RegistrazioneAccount creato e verificato sul sitoCompleteRegistration—
AcquistoPagamento riuscito, una volta per acquistoCompletePaymentcontents, 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

  1. Accendi TikTok e salva.
  2. In Events Manager › il tuo pixel › Test Events, apri il sito dal codice QR o dall'indirizzo (TikTok: Test Events).
  3. Nel sito premi Accetta nel banner dei cookie e naviga: compaiono la pagina vista, ViewContent su un corso, SubmitForm dopo una richiesta…
  4. Oppure usa l'estensione TikTok Pixel Helper per Chrome sul sito (TikTok Pixel Helper).
  5. 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.

  1. Apri TikTok Ads Manager › Strumenti › Events Manager › il tuo pixel web › Impostazioni.
  2. Nella sezione Events API scegli Genera token di accesso e copialo (TikTok: Events API, documentazione per sviluppatori).
  3. In Aladia, in questa pagina, sezione Invio dal server: incolla il token, Salva, poi accendi l'interruttore.
  4. 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.

In questa pagina