Snapchat Conversions API

Questa guida spiega come configurare gli eventi della Conversions API che AdTarget invia a Snapchat quando gli utenti si uniscono al tuo canale Telegram.

Quando vengono inviati gli eventi?

AdTarget invia un evento a Snapchat 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 Snapchat:

Scegliere l’evento giusto

Stai facendo lead generation? Usa Lead (mappato su SIGN_UP di Snapchat) — Questo dice a Snapchat “questa persona si è registrata / è diventata un lead”.

Vendi un prodotto o servizio? Usa Purchase (mappato su PURCHASE) — Ideale quando vuoi che Snapchat 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 (mappato su SIGN_UP) — Segnala un’azione di registrazione completata.

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

Hai bisogno di un evento non standard? Usa Custom (mappato su CUSTOM_EVENT_1) — Per scenari di tracciamento specializzati che non rientrano nei tipi standard.

Consiglio: Fai corrispondere il tipo di evento all’obiettivo della tua campagna in Snapchat 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 Snapchat 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 Snapchat. Indirizzo IP e user agent vengono inviati così come sono secondo le specifiche della Conversions API di Snapchat.

Campi personalizzati

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 Snapchat (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 lo Snapchat Events Manager entro 5-10 minuti

Verificare in Snapchat Ads Manager

1. Vai in Events Manager
2. Seleziona il tuo pixel
3. Cerca il tuo tipo di evento con timestamp recenti
4. Verifica che l’evento mostri come “Received”

Corrispondenza degli eventi

Snapchat 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 ScCid: Assicurati che l’URL della tua landing page preservi il parametro ScCid
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 → Snapchat Event: SIGN_UP
When: User joins channel
Use Case: "Get subscribers" campaigns

Tracciamento acquisti

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

Abbonamento ai contenuti

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

Risoluzione dei problemi

Gli eventi non corrispondono?

• Verifica che il ScCid sia nell’URL della landing page
• Verifica che lo Snapchat 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 ScCid 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 nello Snapchat Events Manager regolarmente
4. Testa prima di scalare la spesa pubblicitaria

Prossimi passi

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

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