TikTok Events API

Questa guida spiega come configurare gli eventi dell’Events API che AdTarget invia a TikTok quando gli utenti si uniscono al tuo canale Telegram.

Quando vengono inviati gli eventi?

AdTarget invia un evento a TikTok solo per le adesioni attribuite — ovvero le adesioni in cui AdTarget riesce a collegare l’adesione Telegram a un clic specifico su un’inserzione nella tua landing page. Questo richiede che l’invite_link sia presente nel webhook di Telegram.

Gli eventi vengono inviati quando un utente clicca sul tuo link di invito tracciato e Telegram lo segnala nel webhook (affidabile per i canali privati).

Gli eventi NON vengono inviati per le adesioni organiche — utenti che trovano il tuo canale tramite ricerca, link diretti o messaggi inoltrati. Queste adesioni appaiono comunque nella tua dashboard AdTarget ma sono contrassegnate come “organiche”.

Tipi di eventi disponibili

AdTarget mappa i suoi tipi di eventi sugli eventi standard di TikTok:

Scegliere l’evento giusto

Stai facendo lead generation? Usa Lead (mappato su SubmitForm di TikTok) — Questo dice a TikTok “questa persona ha inviato un modulo / è diventata un lead”.

Vendi un prodotto o servizio? Usa Purchase — Ideale quando vuoi che TikTok ottimizzi per gli acquirenti. Abbinalo a value e currency nella configurazione di conversione del tuo canale per un’ottimizzazione basata sul valore.

Stai lanciando campagne di registrazione? Usa CompleteRegistration — Segnala un’azione di registrazione completata.

Stai promuovendo un abbonamento al canale? Usa Subscribe — Corrisponde all’azione dell’utente (unirsi = abbonarsi).

Hai bisogno di un evento non standard? Usa Custom — Ti permette di definire il tuo nome evento per scenari di tracciamento specializzati.

Consiglio: Fai corrispondere il tipo di evento all’obiettivo della tua campagna in TikTok Ads Manager per risultati migliori.

Configurazione degli eventi

I tipi di evento sono configurati per canale. Ogni canale ha come predefinito CompleteRegistration quando viene rilevato per la prima volta.

Per cambiare il tipo di evento di un canale:

1. Vai alle Settings del tuo sito → scheda Channels
2. Clicca su Setup (o Edit) nella riga del canale
3. Seleziona il tuo tipo di evento nel dialogo
4. Clicca su Save

Parametri degli eventi

Ogni evento che AdTarget invia a TikTok include questi parametri:

Parametri obbligatori

Parametri di attribuzione

Dati utente

L’external_id (ID utente Telegram) viene hashato con SHA-256 prima dell’invio, come richiesto da TikTok. Indirizzo IP e user agent vengono inviati così come sono secondo le specifiche dell’Events API di TikTok.

Proprietà dell’evento

Deduplicazione degli eventi

AdTarget include un event_id univoco con ogni evento per prevenire duplicati:

event_id: "adtarget_{conversion_id}"

Questo garantisce che la stessa conversione non venga contata due volte, anche in caso di nuovo tentativo.

Test degli eventi

Test in produzione

Il modo più affidabile per testare end-to-end:

1. Clicca sulla tua inserzione TikTok (o usa un’inserzione di test)
2. Visita la tua landing page
3. Unisciti al tuo canale Telegram tramite il link di invito tracciato
4. Controlla il TikTok Events Manager entro 5-10 minuti

Verificare in TikTok Ads Manager

1. Vai in Assets → Events → Web Events → Manage
2. Controlla la scheda Events
3. Cerca il tuo tipo di evento con timestamp recenti
4. Verifica che l’evento mostri come “Received”

Corrispondenza degli eventi

TikTok abbina i tuoi eventi agli utenti per l’attribuzione. Una maggiore qualità di corrispondenza significa una migliore ottimizzazione.

Fattori di qualità della corrispondenza

Migliorare la qualità della corrispondenza

1. Cattura il ttclid: Assicurati che l’URL della tua landing page preservi il parametro ttclid
2. Invia eventi tempestivamente: Meno tempo tra clic e conversione migliora la corrispondenza
3. Percorso utente coerente: Mantieni gli utenti sul tuo dominio prima di reindirizzarli a Telegram

Configurazioni comuni degli eventi

Generazione lead

AdTarget Event: Lead → TikTok Event: SubmitForm
When: User joins channel
Use Case: "Get subscribers" campaigns

Tracciamento acquisti

AdTarget Event: Purchase → TikTok Event: Purchase
When: User joins channel
Use Case: "Buy now" campaigns with value-based optimization

Abbonamento ai contenuti

AdTarget Event: Subscribe → TikTok Event: Subscribe
When: User joins channel
Use Case: "Subscribe to channel" campaigns

Risoluzione dei problemi

Gli eventi non corrispondono?

• Verifica che il ttclid sia nell’URL della landing page
• Verifica che il TikTok Pixel sia anche sulla landing page
• Assicurati che i cookie non siano bloccati

Basso tasso di corrispondenza degli eventi?

• Riduci il tempo tra clic e conversione
• Verifica che il ttclid venga catturato dall’URL
• Assicurati che IP e user agent siano disponibili

Eventi duplicati?

• AdTarget gestisce la deduplicazione automaticamente tramite event_id
• Se vedi duplicati, contatta il supporto

Best practice

1. Fai corrispondere il tipo di evento all’obiettivo della campagna per una migliore ottimizzazione
2. Usa lo stesso tipo di evento in modo coerente all’interno di una campagna
3. Monitora la consegna degli eventi nel TikTok Events Manager regolarmente
4. Testa prima di scalare la spesa pubblicitaria

Prossimi passi

La tua integrazione TikTok è completa! Inizia a pubblicare inserzioni e guarda le tue conversioni arrivare in TikTok.

Hai bisogno di aiuto per ottimizzare? Contatta il nostro team di supporto.