Configurazione del TikTok Pixel

Questa guida ti mostra come collegare il tuo TikTok Pixel Code ad AdTarget per il tracciamento delle conversioni.

Prerequisiti

• Un account TikTok Ads Manager
• Un TikTok Pixel Code (ti mostriamo come crearne uno se necessario)
• Accesso al TikTok Events Manager

Passaggio 1: Trova il tuo Pixel Code

Se hai un Pixel esistente

1. Vai su TikTok Ads Manager 
2. Naviga in Assets → Events → Web Events
3. Clicca su Manage sul tuo pixel esistente
4. Il tuo Pixel Code è mostrato in cima alla pagina

Se devi creare un Pixel

1. Vai su TikTok Ads Manager 
2. Naviga in Assets → Events → Web Events
3. Clicca su Set Up Web Events
4. Scegli TikTok Pixel
5. Seleziona Events API come metodo di connessione
6. Inserisci un nome per il tuo pixel (es. “AdTarget Telegram Tracking”)
7. Clicca su Complete Setup
8. Copia il Pixel Code

Passaggio 2: Genera un Access Token

Per inviare eventi lato server, hai bisogno di un Access Token per l’Events API.

Generare il Token

1. Vai su TikTok Ads Manager 
2. Naviga in Assets → Events → Web Events
3. Clicca su Manage sul tuo pixel
4. Vai alla scheda Settings
5. Scorri fino alla sezione Events API
6. Clicca su Generate Access Token
7. Copia il token immediatamente (non potrai vederlo di nuovo)

Passaggio 3: Aggiungi il Pixel ad AdTarget

Ora che hai il tuo Pixel Code e Access Token, collegali in AdTarget:

1. Vai alla tua dashboard AdTarget 
2. Seleziona il tuo sito, poi apri le sue Settings
3. Clicca sulla scheda Pixels nella barra laterale
4. Clicca su + Add pixel per aprire il dialogo di configurazione
5. Seleziona TikTok come piattaforma
6. Inserisci un Nome per il pixel (es. “TikTok Main Pixel”) — compilalo per primo, perché il pixel non può essere salvato automaticamente senza un nome
7. Incolla il tuo Pixel Code
8. Incolla il tuo Access Token

La validazione si attiva automaticamente una volta inserite credenziali valide. Vedrai un indicatore “Verifying credentials…” mentre AdTarget verifica le tue credenziali con l’API di TikTok.

Dopo la verifica riuscita e la comparsa di “Credentials verified!”, il pixel viene salvato automaticamente solo quando tutti e tre i campi sono validi: Nome, Pixel Code e Access Token.

In caso di successo:

• Appare una conferma “Credentials verified!”
• Il pixel viene salvato automaticamente ed è pronto all’uso
• Il dialogo si chiude e il tuo nuovo pixel appare nella lista

Verifica la tua configurazione

Dopo aver collegato il tuo pixel:

1. Controlla la scheda Pixels — il tuo pixel dovrebbe apparire nella lista
2. Vai su TikTok Events Manager  → Assets → Events → Web Events → Manage
3. Controlla la scheda Events per gli eventi di test in arrivo

Indicatori di successo:

• Il tuo pixel è elencato nella scheda Pixels
• Evento di test visibile nel TikTok Events Manager
• Lo stato dell’evento mostra come ricevuto

Gestione dei Pixel

Selezionare un Pixel predefinito

Se hai più pixel TikTok, clicca su qualsiasi pixel nella lista per impostarlo come predefinito per il tuo sito. Il pixel predefinito viene usato per tutti gli eventi di conversione TikTok.

Eliminare un Pixel

Clicca sull’icona del cestino accanto a un pixel per rimuoverlo.

Risoluzione dei problemi

“Invalid Pixel Code”

• Assicurati di aver copiato il Pixel Code completo da TikTok Ads Manager
• Il Pixel Code si trova in Assets → Events → Web Events → Manage

“Access token appears to be incomplete”

• Gli Access Token di TikTok sono stringhe lunghe
• Assicurati di aver copiato l’intero token

“Invalid or expired access token”

• I token possono essere visualizzati solo una volta al momento della creazione
• Se perso, genera un nuovo token da TikTok Ads Manager
• Assicurati che il token appartenga al pixel corretto

Gli eventi non appaiono nel TikTok Events Manager?

• Attendi 5-10 minuti per l’elaborazione degli eventi
• Controlla la scheda Events nella pagina di gestione del tuo pixel
• Verifica che il pixel sia attivo e non in pausa

Prossimi passi

Ora che il tuo pixel è collegato, configura quali eventi dell’Events API inviare.