Collegare un Canale Telegram

Questa guida ti mostra come collegare il tuo canale Telegram ad AdTarget affinche le conversioni vengano tracciate automaticamente.

Prerequisiti

Aver creato un bot Telegram
Un canale Telegram (devi essere amministratore)
Token del bot aggiunto ad AdTarget

Passo 1: Aggiungi il Bot al Tuo Canale

Apri le impostazioni del canale

Apri il tuo canale Telegram, tocca il nome del canale in alto, poi tocca Amministratori.

Aggiungi il bot come amministratore

Tocca Aggiungi Amministratore, cerca l’username del tuo bot e selezionalo.

Imposta i permessi

Quando aggiungi il bot come amministratore, assicurati che questo permesso sia abilitato:

Invita utenti tramite link (obbligatorio) — il bot ne ha bisogno per generare link di invito univoci e tracciabili per ogni visitatore

Gli altri permessi possono restare disabilitati.

Tocca Fine per confermare.

Passo 2: Conferma il Rilevamento del Canale in AdTarget

AdTarget rileva automaticamente il tuo canale quando aggiungi il bot come amministratore. Non c’è bisogno di inserire manualmente il nome o l’ID del canale.

Dopo aver aggiunto il bot come amministratore (Passo 1), vai alla tua dashboard AdTarget
Vai nelle Settings del tuo sito e seleziona la scheda Channels — il tuo canale dovrebbe apparire automaticamente entro pochi secondi
Seleziona la casella accanto al canale e clicca Save per assegnarlo al sito

Assegnare il canale a un sito è necessario prima che il tracciamento funzioni. I canali non assegnati non genereranno link di invito né tracceranno conversioni.

Opzionalmente, modifica il tipo di evento di conversione (predefinito: CompleteRegistration)

Il canale non appare? Prova a rimuovere il bot dalla lista degli amministratori del canale e riaggiungerlo. Questo riattiva il webhook Telegram che AdTarget usa per il rilevamento. Vedi la sezione Risoluzione dei Problemi qui sotto per altri suggerimenti.

Passo 3: Verifica la Connessione

Una volta aggiunto il bot come amministratore, il canale appare nella scheda Settings > Channels del tuo sito. Se il bot viene rimosso dal canale, lo stato del canale cambia in removed.

Per testare la connessione:

Entra nel tuo canale da un account diverso
Controlla AdTarget entro 30 secondi
Dovresti vedere l’evento di iscrizione

Più Canali

Puoi collegare più canali allo stesso sito AdTarget:

Aggiungi il tuo bot come amministratore in ogni canale — ognuno viene rilevato automaticamente
Vai nelle Settings del tuo sito e seleziona la scheda Channels, poi seleziona ogni canale che vuoi assegnare
Le conversioni di ogni canale vengono tracciate separatamente

Suggerimento: Usa lo stesso bot per tutti i canali per semplificare la gestione.

Canali Privati vs Pubblici

Consigliamo fortemente di usare canali privati per la migliore accuratezza dell’attribuzione. I canali pubblici hanno una limitazione nota di Telegram che può impedire il funzionamento affidabile del tracciamento delle conversioni — vedi dettagli qui sotto.

Canali Privati (Consigliati)

Gli utenti devono usare un link di invito per entrare — non c’è altro modo
AdTarget genera un link di invito univoco e tracciabile per ogni visitatore
Quando l’utente entra, Telegram include il link di invito nel webhook, permettendo ad AdTarget di associare l’iscrizione al clic originale sull’annuncio
Risultato: accuratezza dell’attribuzione vicina al 100% e eventi CAPI affidabili verso Meta

Canali Pubblici

Gli utenti possono entrare tramite t.me/nomedelcanale, la ricerca di Telegram o messaggi inoltrati — senza usare il tuo link di invito tracciato
AdTarget genera comunque link di invito univoci per ogni visitatore, ma anche quando un utente ne clicca uno, l’app Telegram (specialmente su Android) potrebbe silenziosamente convertirlo in un “ingresso diretto”
Quando questo accade, il webhook di Telegram non include il link di invito, quindi AdTarget non può associare l’iscrizione al clic sull’annuncio
Queste iscrizioni appaiono come organiche nella tua dashboard — nessun evento CAPI viene inviato a Meta

Perché È Importante

Questa è una limitazione nota della Bot API di Telegram : per i canali pubblici, il campo invite_link nel webhook ChatMemberUpdated è spesso assente, anche quando l’utente ha cliccato un link tracciato. Il client Telegram risolve il canale pubblico ed effettua un ingresso diretto invece di un ingresso tramite link di invito.

In pratica, questo significa:

L’attribuzione dei canali pubblici potrebbe essere inaffidabile, specialmente per gli utenti Android
Le iscrizioni che dovrebbero essere attribuite ai tuoi annunci potrebbero apparire come organiche
L’algoritmo di Meta non riceverà questi segnali di conversione, riducendo l’ottimizzazione degli annunci

La Nostra Raccomandazione

Se l’attribuzione accurata e il reporting Meta CAPI sono importanti per le tue campagne (di solito lo sono), usa un canale privato. Puoi sempre condividere link di invito tracciati sulla tua landing page — l’esperienza utente è identica, ma l’attribuzione è garantita.

Impostazioni del Canale

Modifica la Configurazione del Canale

Vai nelle Settings del tuo sito e seleziona la scheda Channels
Clicca il pulsante Setup (o Edit) sulla riga del canale per aprire la finestra di configurazione
Aggiorna le impostazioni secondo necessità
Clicca Save

Rimuovere o Eliminare un Canale

Per rimuovere l’assegnazione di un canale da un sito, deselezionalo nella scheda Channels e clicca Save. Il canale rimane nel tuo account ma smette di tracciare per quel sito.

Per eliminare permanentemente un canale, usa l’opzione di eliminazione sulla riga del canale. Questo cancella a cascata tutti gli inviti, le conversioni e le assegnazioni ai siti associati a quel canale. Questa azione non può essere annullata.

Risoluzione dei Problemi

“Bot is not an administrator”

Aggiungi il bot come amministratore al tuo canale
Assicurati che il permesso “Invita utenti tramite link” sia abilitato
Aspetta 30 secondi e riprova

Il canale non appare nella dashboard?

Rimuovi il bot dalla lista degli amministratori del canale, poi riaggiungerlo
Assicurati che il bot sia stato aggiunto come amministratore, non solo come membro normale
Aspetta fino a 30 secondi per l’arrivo del webhook

Non rileva le iscrizioni?

Verifica che il bot abbia i permessi di amministratore
Testa entrando da un account diverso

Eventi in ritardo?

I webhook di Telegram occasionalmente hanno ritardi
Gli eventi appaiono tipicamente entro 5 secondi
Se il ritardo è costante, contatta il supporto

Buone Pratiche

Usa nomi di canale descrittivi: Dai nomi chiari ai canali in AdTarget così puoi identificarli nei report.

Testa prima di fare pubblicita: Verifica che il tracciamento funzioni entrando da un account di test prima di spendere in annunci.

Monitora lo stato dei canali: Controlla periodicamente la scheda Settings > Channels del tuo sito per assicurarti che i canali restino attivi.

Durata dei link di invito: Ogni link di invito è monouso e valido per 7 giorni dopo la creazione. I link restano aperti durante questa finestra così che gli utenti che cliccano un annuncio ma entrano più tardi vengano comunque attribuiti correttamente. Dopo 7 giorni, Telegram fa scadere automaticamente il link.

Prossimi Passi

Con il tuo canale collegato, configura l’integrazione Meta Pixel per inviare eventi di conversione a Meta.