Guida alla configurazione e al tracciamento dell'API Conversione di TikTok
Scopri come funziona la TikTok Conversion API, come configurare l'API Eventi con il Pixel, evitare eventi duplicati, migliorare l'abbinamento e testare il monitoraggio delle conversioni.

Di
Kinnari Ashar
Tempo di lettura: 15 min

La tua campagna TikTok potrebbe sembrare redditizia in superficie, mentre alcune delle sue conversioni di maggior valore non appaiono mai nel report. Un cliente può visualizzare un prodotto, aggiungerlo al carrello, completare il checkout o inviare un modulo per i contatti, ma il percorso dietro tale azione potrebbe rimanere incompleto.
Questi dati mancanti influiscono su qualcosa di più della semplice reportistica. Possono influenzare quali annunci TikTok mette in evidenza, dove allochi il budget e con quanta sicurezza valuti il rendimento della campagna.
La Conversion API di TikTok, ufficialmente nota come Events API, è progettata per rendere questo quadro più chiaro. Tuttavia, ottenere dati utili da essa dipende da come viene configurata, da come viene connessa con il Pixel di TikTok e da come gestisci gli eventi sovrapposti.
Le sezioni seguenti analizzano gli aspetti fondamentali, senza trasformare il processo in un labirinto tecnico.
Che cos'è la Conversion API di TikTok?
La Conversion API di TikTok, ufficialmente chiamata TikTok Events API, è una connessione server-to-server che invia eventi di marketing e di conversione dal tuo sito web, piattaforma di e-commerce, app, CRM, server o sistema offline direttamente a TikTok.
A seconda della tua attività e configurazione, puoi segnalare azioni come:
Visualizzazioni di prodotti e ricerche
Aggiunte al carrello e inizi di checkout
Acquisti e vendite offline
Registrazioni e invii di moduli
Abbonamenti e lead qualificati
TikTok può utilizzare i dati degli eventi idonei per misurare le conversioni, attribuire i risultati agli annunci, ottimizzare la pubblicazione, creare segmenti di pubblico e supportare il retargeting. La qualità di tali risultati dipende dall'accuratezza, dalla completezza, dai dettagli di corrispondenza e dallo stato del consenso delle informazioni fornite.
L'Events API ha uno scopo più circoscritto rispetto agli altri prodotti per sviluppatori di TikTok. La Marketing API gestisce le funzioni pubblicitarie, le TikTok Shop API supportano le operazioni di commercio e la Research API fornisce ai ricercatori approvati l'accesso a dati pubblici selezionati della piattaforma. L'Events API si concentra sull'invio di eventi di marketing.
Come funziona la Conversion API di TikTok?
La Conversion API di TikTok trasmette un'azione registrata del cliente dai tuoi sistemi aziendali a TikTok, dove può essere associata a un'interazione pubblicitaria idonea e utilizzata per la misurazione.
Il processo segue solitamente questa sequenza:
Un cliente visualizza o fa clic sul tuo annuncio TikTok e visita il tuo sito web o negozio.
Completa un'azione, come visualizzare un prodotto, aggiungere un articolo al carrello, inviare un modulo o effettuare un ordine.
Il tuo sito web, piattaforma di e-commerce, sistema di pagamento o CRM registra l'azione.
Il tuo server o integrazione crea un evento contenente dettagli quali il nome dell'evento, l'orario, il valore dell'ordine, le informazioni sul prodotto e i dati di corrispondenza disponibili.
L'evento viene inviato all'Events API di TikTok.
TikTok utilizza identificatori quali dati sui clic, dettagli di contatto, informazioni sul browser o altri campi di corrispondenza idonei per collegare l'azione con un utente di TikTok o con un'interazione pubblicitaria.
Gli eventi associati possono contribuire alla reportistica, all'attribuzione, all'ottimizzazione della campagna, al retargeting e alla creazione di segmenti di pubblico.
Per il tracciamento web, la stessa azione può raggiungere TikTok anche tramite il Pixel:
Annuncio TikTok → Visita al sito web → Azione del cliente → Evento Pixel ed evento server → Deduplicazione → TikTok Ads Manager
L'evento server può comunque segnalare un risultato confermato quando la richiesta del browser fallisce perché il Pixel è stato bloccato, la pagina di conferma non è stata caricata, il checkout è avvenuto altrove o la connessione si è interrotta troppo rapidamente.
Tuttavia, la ricezione dell'evento non garantisce l'attribuzione su TikTok. TikTok ha comunque bisogno di dati di corrispondenza e attribuzione validi e sufficienti per collegare tale conversione a un'interazione pubblicitaria idonea.
TikTok Pixel vs TikTok Conversion API
Il TikTok Pixel e l'Events API raccolgono i dati di conversione attraverso percorsi diversi. Il Pixel registra l'attività nel browser del cliente, mentre l'Events API invia eventi dal tuo server o da un altro sistema connesso.
TikTok consiglia di utilizzare entrambi per il tracciamento delle conversioni web, quando possibile.
Funzionalità | TikTok Pixel | TikTok Conversion API |
Origine dati | Browser del cliente | Server, piattaforma, app, CRM o sistema offline |
Metodo di tracciamento | Basato su browser | Server-to-server |
Installazione | Codice del sito web, Event Builder o tag manager | Integrazione partner, Events API Gateway, server container o API diretta |
Restrizioni del browser | Più soggetto a restrizioni | Meno dipendente dall'esecuzione del browser |
Ideale per | Visualizzazioni di pagina e azioni onsite | Risultati confermati da sito web, backend, CRM e offline |
Eventi CRM e offline | Limitati | Supportati |
Difficoltà tecnica | Generalmente inferiore | Varia da moderata ad avanzata |
Deduplicazione | Non richiesta se utilizzato da solo | Richiesta quando il Pixel invia lo stesso evento |
Il Pixel è più adatto per il comportamento immediato onsite, mentre l'Events API può confermare risultati registrati dopo l'interazione del browser, come pagamenti approvati o lead qualificati nel CRM.
Quando entrambi segnalano una conversione, TikTok richiede la deduplicazione affinché Ads Manager la conteggi una sola volta.
Quali eventi e dati puoi inviare tramite l'Events API di TikTok?
1. Eventi di conversione standard
TikTok fornisce nomi di eventi standard per le azioni comuni di e-commerce e generazione di lead. Questi eventi predefiniti possono supportare la reportistica, l'ottimizzazione delle conversioni e la creazione di segmenti di pubblico.
Gli eventi comuni includono:
ViewContent: Un visitatore apre una pagina prodotto o un'altra pagina importante.
Search: Qualcuno cerca un prodotto, una categoria o un termine sul tuo sito web.
AddToWishlist: Un acquirente salva un articolo per dopo.
AddToCart: Un prodotto viene aggiunto con successo al carrello.
InitiateCheckout: Il cliente inizia la procedura di checkout.
AddPaymentInfo: I dettagli di pagamento vengono inseriti durante il checkout.
Purchase: Viene registrato un acquisto completato.
SubmitForm: Un visitatore invia con successo un modulo per contatti o richieste.
CompleteRegistration: Un utente completa la creazione di un account o la registrazione.
Subscribe: Un cliente completa un'azione di abbonamento.
StartTrial: Un utente inizia un periodo di prova.
Il nome dell'evento da solo non è sufficiente. Devi anche decidere esattamente quando si attiva ciascun evento.
Ad esempio, Purchase può riferirsi alla creazione di un ordine, all'autorizzazione del pagamento, all'acquisizione del pagamento o all'evasione dell'ordine. Scegli un solo trigger e applicalo uniformemente su sito web, backend e sistemi di reportistica.
I parametri aggiungono quindi contesto all'evento. A seconda dell'azione, questi possono includere valore, valuta, quantità, ID dei contenuti e informazioni sul prodotto. TikTok contrassegna alcuni parametri come obbligatori e ne consiglia altri perché possono migliorare la qualità degli eventi e le prestazioni della campagna.
Inviare lo stesso evento in fasi diverse può sovrastimare le conversioni e le entrate. Standardizza il trigger e i parametri prima del lancio, in modo che Ads Manager riceva una versione coerente di ogni azione del cliente.
2. Parametri dell'evento
Una volta chiaro il trigger dell'evento, i parametri descrivono cosa è accaduto e forniscono a TikTok le informazioni necessarie per interpretarlo correttamente.
Un evento può includere:
Nome evento: L'azione segnalata, come
AddToCartoPurchase.Ora evento: L'orario in cui si è verificata l'azione.
ID evento: Un identificatore univoco utilizzato per riconoscere lo stesso evento tra Pixel ed Events API.
URL di origine evento: La pagina in cui ha avuto luogo l'azione.
Valuta: La valuta utilizzata per la transazione.
Valore di conversione: Il valore monetario totale associato all'evento.
ID prodotto o contenuto: Gli identificatori dei prodotti coinvolti.
Tipo di contenuto: La categoria di contenuto segnalata.
Quantità: Il numero di unità incluse nell'azione.
Dettagli ordine: Informazioni di acquisto supportate, come i dati di contenuto a livello di singolo articolo.
Gli identificatori dei prodotti devono seguire lo stesso formato utilizzato nel catalogo TikTok collegato. Verifica se il catalogo memorizza ID prodotto, ID variante, SKU o un altro identificatore specifico della piattaforma prima di mappare gli eventi.
Anche la valuta e il valore necessitano di una formattazione coerente. Valori mancanti, statici o mappati in modo errato possono lasciare gli eventi di acquisto privi di dati utilizzabili sulle entrate e indebolire i report sul ritorno sulla spesa pubblicitaria (ROAS).
3. Informazioni di corrispondenza del cliente
Dopo che TikTok ha ricevuto un evento, necessita di informazioni sufficienti per collegare tale azione a un cliente o a un'interazione pubblicitaria idonea.
I comuni identificatori di corrispondenza includono:
ID clic di TikTok: Il valore
ttclidassociato al clic su un annuncio TikTok.Indirizzo email con hash: Un indirizzo email normalizzato e convertito tramite SHA-256.
Numero di telefono con hash: Un numero di telefono formattato in modo coerente e convertito tramite SHA-256.
ID cliente esterno con hash: Il tuo identificatore cliente interno, preparato secondo le specifiche di TikTok.
Indirizzo IP del cliente: L'indirizzo IP registrato quando si verifica l'azione sul sito web.
User agent del browser: Informazioni sul browser e sul dispositivo del cliente.
Identificatore proprietario di TikTok: Il valore del cookie supportato
_ttp, se disponibile.
Un evento può essere accettato dall'Events API e produrre comunque una corrispondenza debole se questi campi sono assenti, non validi o formattati in modo errato. Una corrispondenza più efficace dipende dall'invio degli identificatori che puoi raccogliere legalmente, non semplicemente dall'invio di un payload più grande.
Gli indirizzi email, i numeri di telefono e gli ID esterni devono essere normalizzati e sottoposti a hash esattamente come richiesto da TikTok. ID clic, indirizzi IP, user agent e identificatori di cookie supportati seguono le proprie regole di formattazione.
La tua configurazione deve inoltre rispettare le scelte di consenso, le informative sulla privacy e i requisiti di protezione dei dati applicabili in ciascun mercato.
Come funzionano la corrispondenza e la deduplicazione degli eventi su TikTok
Corrispondenza degli eventi
TikTok utilizza chiavi di corrispondenza per collegare una conversione segnalata a una persona che ha interagito in precedenza con un annuncio. Una chiave utile è l'ID clic di TikTok, o ttclid, che può essere aggiunto all'URL della landing page dopo un clic sull'annuncio.
Il tuo sito web dovrebbe conservare questo valore man mano che il visitatore avanza nel percorso d'acquisto. Salvarlo insieme all'ordine finale o al lead offre a TikTok maggiori possibilità di ricollegare il risultato all'interazione originale.
L'ID clic potrebbe andare perso quando:
Un reindirizzamento rimuove i parametri URL
Il checkout si sposta su un altro dominio
Un fornitore di servizi di pagamento avvia una sessione separata
I valori di tracciamento vengono ripuliti dall'URL
La sessione originale scade
Anche i dettagli di contatto e gli ID cliente esterni possono supportare la corrispondenza, ma devono essere normalizzati prima dell'hashing. Utilizza inoltre l'indirizzo IP effettivo del cliente e lo user agent del suo browser.
Inviare dati segnaposto, l'IP di un server o uno user agent di backend fornisce a TikTok informazioni sul tuo sistema anziché sull'acquirente.
Deduplicazione degli eventi
Quando il Pixel e l'Events API inviano entrambi la stessa conversione, TikTok deve riconoscere che i due record descrivono un'unica azione del cliente. La deduplicazione impedisce che un acquisto, un lead o una registrazione vengano conteggiati due volte.
Entrambe le copie devono utilizzare lo stesso nome evento e lo stesso ID evento univoco.
Ad esempio:
Pixel
Purchase:order_84739Server
Purchase:order_84739
TikTok confronta questi campi per identificare gli eventi sovrapposti. Anche il valore, la valuta e i dettagli del prodotto dovrebbero corrispondere, in modo che la reportistica rimanga coerente.
Un ID ordine, un ID transazione, un ID di completamento del checkout o un UUID stabile generato dal server possono funzionare bene perché ciascuno fa riferimento a una sola conversione.
Evita ID prodotto, ID cliente, ID sessione riutilizzati o ID casuali distinti generati separatamente dal browser e dal server.
I tentativi successivi dell'API (retry) devono riutilizzare l'ID evento originale. Un nuovo ID può far sembrare il nuovo tentativo come un'ulteriore conversione.
Come configurare la Conversion API di TikTok
Passaggio 1. Scegli un metodo di integrazione
La prima decisione riguarda il modo in cui i dati degli eventi viaggeranno dai tuoi sistemi aziendali a TikTok. Il percorso migliore dipende dalla tua piattaforma esistente, dal supporto tecnico disponibile e dal grado di controllo di cui hai bisogno sulla mappatura degli eventi e sulla qualità dei dati.
Ciascun metodo gestisce un livello di complessità diverso, quindi confronta le opzioni con il modo in cui il tuo negozio registra già le conversioni.
Integrazione tramite piattaforma e-commerce: Di solito è il percorso più semplice per i negozi Shopify o WooCommerce supportati. La piattaforma gestisce gran parte della connessione, della mappatura degli eventi e della configurazione del catalogo.
Partner di dati o tracciamento: Adatto se utilizzi già una piattaforma di dati dei clienti (CDP), un CRM, un tag manager o un fornitore di tracciamento lato server. Verifica quali eventi, identificatori e controlli del consenso supporta il partner.
Integrazione API diretta: Ideale per siti web personalizzati, checkout proprietari, marketplace, piattaforme in abbonamento o logiche di conversione complesse. Offre un maggiore controllo, ma richiede sviluppo, test, monitoraggio e manutenzione.
Google Tag Manager lato server: Un'opzione pratica per i team che gestiscono già un server container e hanno familiarità con tag, attivatori, variabili, GA4 e hosting cloud. TikTok fornisce anche un flusso di configurazione interattivo per questo metodo.
Prima di impegnarti, valuta gli eventi necessari, le risorse tecniche, la struttura del catalogo, l'accesso ai log degli eventi, il numero di negozi, la configurazione del consenso e chi manterrà la connessione dopo il lancio.
Passaggio 2. Crea un piano di tracciamento degli eventi
Prima di configurare l'integrazione, crea un piano di tracciamento che assegni a ciascuna azione del cliente una definizione condivisa e approvata. Questo garantisce che sviluppatori, marketer e team di analisi lavorino secondo le stesse regole.
Registra quanto segue per ciascun evento:
Nome evento TikTok
Cosa significa l'azione per la tua attività
L'esatta condizione che lo attiva
Se proviene dal browser, dal server o da entrambi
Campi dati che devono accompagnarlo
Informazioni di corrispondenza disponibili
Origine dell'ID evento univoco
Condizioni di consenso applicabili
Prendi Purchase come esempio. Decidi se deve attivarsi quando il negozio crea un ordine o solo dopo che il pagamento è andato a buon fine. Per la maggior parte dei negozi, il pagamento confermato offre una panoramica più affidabile delle entrate effettive, poiché gli ordini non pagati o falliti rimangono esclusi.
Inserisci questa regola nel piano, quindi applicala alla configurazione del checkout, del backend, del Pixel e dell'Events API. TikTok supporta gli eventi standard su entrambi i percorsi di tracciamento, quindi una definizione condivisa previene report contrastanti in seguito.
Passaggio 3. Connetti la corretta origine dati di TikTok
Quindi, apri Events Manager dall'account inserzionista che gestirà le campagne.
Vai su Strumenti, seleziona Events Manager, scegli Connetti origine dati e seleziona Web. Crea una nuova connessione dati per il sito web o apri quella esistente associata al sito corretto.
Prima di completare la configurazione, conferma l'URL del sito web, il codice Pixel, l'account inserzionista e le autorizzazioni utente. Questa verifica diventa particolarmente importante quando più negozi o account cliente risiedono nello stesso Business Center.
Quando Pixel ed Events API segnalano attività dallo stesso sito web, connettili entrambi alla connessione dati del sito prevista. Utilizzare la destinazione errata può inviare eventi validi a un account non correlato, privando le campagne effettive dei dati di cui hanno bisogno.
Passaggio 4. Genera e proteggi il token di accesso
Se stai creando un'integrazione diretta con l'Events API, genera il token di accesso utilizzato per autenticare le richieste. Le integrazioni partner possono gestire l'autenticazione tramite il loro processo di connessione.
Conserva il token in un ambiente server protetto, in un gestore dei segreti o in un file di configurazione crittografato. Solo i sistemi e le persone responsabili dell'integrazione dovrebbero avervi accesso.
Non esporre mai il token in:
Codice sorgente del sito web
Script del browser
Repository pubblici
Screenshot condivisi
Log non protetti
Un token inserito nel codice lato client può essere visualizzato tramite gli strumenti del browser. Se diventa pubblico, sostituiscilo tempestivamente e controlla l'attività dei tuoi eventi per rilevare eventuali richieste impreviste.
Documenta la procedura per ruotare le credenziali senza interrompere l'invio degli eventi.
Passaggio 5. Raccogli e prepara i dati degli eventi
Una volta stabilita la connessione, prepara le informazioni che TikTok riceverà con ogni evento.
Conserva il ttclid dalla landing page e portalo avanti attraverso i reindirizzamenti, il checkout e i passaggi di pagamento. Salvalo con l'ordine o il lead finale quando possibile.
Successivamente, raccogli solo gli identificatori cliente consentiti dalla tua configurazione del consenso. Normalizza gli indirizzi email e i numeri di telefono prima di applicare il metodo di hashing richiesto, anziché eseguire l'hash su valori grezzi non standardizzati.
L'evento dovrebbe inoltre contenere l'effettivo indirizzo IP e lo user agent del browser del cliente, ove consentito. Non sostituirli con i dati del server di hosting o del sistema di backend.
Infine, genera un ID evento stabile per ciascuna azione. Utilizza lo stesso valore nella copia del Pixel e in quella del server, in modo che TikTok possa riconoscerle come un'unica conversione.
Passaggio 6. Invia eventi Pixel ed eventi server
Una volta preparati i dati dell'evento, invia le copie del browser e del server utilizzando lo stesso nome evento TikTok e lo stesso ID evento. Questa identità condivisa consente a TikTok di riconoscere i record sovrapposti e di conteggiare l'azione una sola volta.
Utilizza i dati di backend per il valore dell'acquisto finale, la valuta, l'ID ordine e i dettagli del prodotto, poiché il tuo negozio o sistema di pagamento detiene la registrazione confermata della transazione.
L'evento Purchase dovrebbe attivarsi solo nel momento stabilito nel piano di tracciamento. Ad esempio, invialo dopo che il pagamento è andato a buon fine o quando un ordine valido è confermato, non quando l'acquirente accede semplicemente al checkout o si trova in una pagina di pagamento intermedia.
Prima del lancio, confronta entrambe le copie dell'evento e verifica che i nomi, gli ID, i valori e le informazioni sull'ordine coincidano.
Passaggio 7. Testa gli eventi in TikTok Events Manager
Prima di lanciare le campagne, apri gli strumenti di test in Events Manager ed esegui le azioni elencate nel tuo piano di tracciamento.
Esegui una visualizzazione prodotto, un'aggiunta al carrello, un checkout e un acquisto di prova. Quindi verifica che:
Gli eventi del browser e del server raggiungano la connessione dati del sito web prevista
I nomi degli eventi e i timestamp corrispondano alle azioni eseguite
Il valore dell'acquisto e la valuta riflettano l'ordine di prova
Gli ID prodotto rispettino il formato del catalogo collegato
Gli identificatori di corrispondenza disponibili compaiano correttamente
Gli eventi sovrapposti abbiano lo stesso nome evento e lo stesso ID evento
Le impostazioni di test temporanee vengano rimosse prima del lancio
Esamina anche la sezione Diagnostica. Un evento può arrivare con successo pur presentando informazioni mancanti, non valide o formattate in modo errato.
Dopo il test, controlla i dettagli della deduplicazione per i record del browser e del server corrispondenti. I report di Events Manager potrebbero non aggiornarsi immediatamente al di fuori della visualizzazione di test in tempo reale, quindi attendi i tempi di elaborazione prima di considerare un evento mancante come una richiesta fallita.
Problemi comuni della Conversion API di TikTok e relative soluzioni
Un evento ricevuto può comunque contenere valori errati, informazioni di corrispondenza deboli o record duplicati. Utilizza i seguenti controlli per individuare la causa prima di modificare l'intera integrazione.
Problema | Causa probabile | Cosa verificare |
Gli acquisti compaiono due volte | Gli eventi del browser e del server utilizzano ID diversi | Confronta il nome evento e l'ID evento in entrambe le copie |
Gli eventi server non compaiono | Origine dati, token, account inserzionista o ambiente errati | Verifica l'origine dati collegata, il token di accesso, l'account e la configurazione di produzione |
TikTok trova poche corrispondenze negli eventi | L'ID clic o gli identificatori cliente sono mancanti | Verifica quali chiavi di corrispondenza vengono acquisite e inviate |
Tutti gli eventi mostrano lo stesso indirizzo IP | Viene inoltrato l'IP del server di hosting | Invia l'IP originale del visitatore, ove consentito |
Lo user agent è mancante | Le informazioni sul browser non sono state conservate | Acquisisci lo user agent del visitatore durante la sessione |
Il valore delle entrate d'acquisto è zero | Il valore o la valuta sono mancanti o formattati in modo errato | Ispeziona i parametri di valore e valuta |
I prodotti non corrispondono al catalogo | Gli ID contenuto utilizzano un formato di identificatore differente | Confronta gli ID evento con il formato di prodotto, variante o SKU presente nel catalogo |
Gli ordini vengono inviati prima del pagamento | Il trigger Purchase si attiva troppo presto | Controlla lo stato del pagamento o dell'ordine che attiva l'evento |
I tentativi di invio (retry) creano acquisti extra | Ogni tentativo riceve un nuovo ID evento | Riutilizza l'ID evento originale per ogni nuovo tentativo |
Gli eventi arrivano in ritardo | Una coda, un invio in batch o un partner ritardano la consegna | Invia l'ora originale dell'azione anziché l'ora di elaborazione successiva |
Un conteggio di acquisti inferiore in TikTok non indica automaticamente un errore. Il tuo negozio registra ogni singolo ordine, mentre Ads Manager riporta gli acquisti attribuiti in base alle impostazioni selezionate su TikTok.
Confronta gli acquisti di backend, gli eventi Pixel, gli eventi server, i record deduplicati e gli acquisti attribuiti per individuare la discrepanza.
Rendi più consapevole ogni test su TikTok
La Conversion API di TikTok, ufficialmente nota come TikTok Events API, può offrirti una visione più chiara di ciò che i clienti fanno dopo aver interagito con i tuoi annunci. Per le campagne sul sito web, TikTok consiglia di utilizzarla insieme al Pixel, in modo che gli eventi del browser e del server possano supportare la medesima infrastruttura di misurazione.
Una reportistica utile dipende comunque dalla qualità degli eventi inviati. I trigger di acquisto devono riflettere ordini reali, i valori delle entrate devono essere precisi, gli ID del catalogo devono corrispondere e gli eventi duplicati di browser e server necessitano di ID coerenti.
Questi controlli ti dicono come hanno performato le tue campagne. WinningHunter ti aiuta nelle decisioni che precedono il lancio. Puoi esaminare gli annunci TikTok attivi, le mosse della concorrenza, i segnali sui prodotti, i formati creativi e i dati dei negozi per decidere quali idee meritano di essere testate.
Utilizzati insieme, la ricerca ti aiuta a selezionare test migliori, mentre dati di conversione accurati mostrano quali di questi test hanno prodotto risultati reali.
Domande frequenti (FAQ)
La TikTok Conversion API è la stessa cosa dell'Events API?
Sì. Events API è il nome ufficiale del prodotto di TikTok. Gli inserzionisti e i fornitori di tracciamento la chiamano spesso TikTok Conversion API, Conversions API o TikTok CAPI. Questi termini non ufficiali si riferiscono generalmente alla stessa connessione server utilizzata per inviare eventi di marketing da sito web, app, CRM e offline direttamente a TikTok.
Ho ancora bisogno del TikTok Pixel se utilizzo l'Events API?
TikTok consiglia di utilizzare Pixel ed Events API insieme per il tracciamento delle conversioni web. Il Pixel invia l'attività dal browser, mentre l'Events API trasmette i record da un server o da una piattaforma connessa. Quando entrambe le connessioni segnalano la stessa azione del cliente, devono condividere lo stesso nome evento e lo stesso ID evento, affinché TikTok possa rimuovere i duplicati.
Che cos'è la deduplicazione degli eventi su TikTok?
La deduplicazione degli eventi impedisce che una conversione venga conteggiata due volte quando viene segnalata sia dal Pixel sia dall'Events API. TikTok confronta il nome dell'evento e l'ID dell'evento in ciascuna copia. Quando questi campi corrispondono, TikTok è in grado di riconoscere che entrambi i record descrivono lo stesso acquisto, registrazione, lead o altra azione del cliente.
Cosa dovrei utilizzare come ID evento di TikTok?
Utilizza un identificatore associato a una specifica conversione, ad esempio un ID ordine, un ID transazione, un ID di completamento del checkout stabile o un UUID generato dal server. Il Pixel e l'Events API devono ricevere lo stesso valore per gli eventi sovrapposti. Qualsiasi nuovo tentativo (retry) della richiesta del server dovrebbe inoltre riutilizzare l'ID originale anziché crearne uno nuovo.
Posso configurare l'Events API di TikTok su Shopify?
Sì. I commercianti Shopify possono connettersi a TikTok tramite l'integrazione per e-commerce supportata o un altro fornitore di tracciamento compatibile. La disponibilità e le funzionalità possono variare in base al mercato e alla configurazione. Prima di affidarti a un'integrazione, verifica quali eventi, identificatori cliente, segnali di consenso, campi relativi alle entrate e ID prodotto invia a TikTok dal tuo negozio.
Perché TikTok registra meno acquisti rispetto a Shopify?
Shopify registra gli ordini effettuati da tutte le origini di acquisizione, mentre TikTok riporta solo gli acquisti attribuiti alla pubblicità su TikTok in base alle impostazioni di attribuzione selezionate. Le differenze possono anche derivare dalle finestre di attribuzione, da chiavi di corrispondenza mancanti, dalle scelte di consenso, da errori nell'invio degli eventi, da ritardi nell'elaborazione o dalla deduplicazione. Confronta gli eventi ricevuti prima di presumere che la connessione sia interrotta.
L'Events API di TikTok aggira gli ad blocker?
L'Events API dipende meno dagli script del browser poiché l'evento viene inviato da un server o da una piattaforma connessa. Tuttavia, non dovrebbe essere considerata del tutto immune da ad blocker, controlli del browser, scelte di consenso o restrizioni sulla privacy. È comunque necessario raccogliere e trasmettere i dati dei clienti in conformità con la legge e seguire i requisiti di TikTok.
Come posso verificare se l'Events API di TikTok funziona?
Apri TikTok Events Manager ed esamina gli eventi server ricevuti, i parametri, le informazioni di corrispondenza, la diagnostica e i dettagli sulla deduplicazione. Esegui test su azioni importanti come gli acquisti e confronta il valore, la valuta, gli ID prodotto e gli ID evento segnalati con i registri del tuo negozio e dei pagamenti. Tieni conto dei tempi di elaborazione prima di considerare un evento in ritardo come una richiesta non riuscita.











