TikTok Events API v1.3

Tracciamento server-side delle conversioni TikTok

Le sue conversioni partono dal suo server verso l'API Events di TikTok, non dal browser di un visitatore che forse blocca il pixel. L'acquisto è attivato dall'ordine convalidato, non da una pagina di ringraziamento che il cliente potrebbe non caricare mai.

Gli identificativi vengono normalizzati e poi cifrati prima dell'invio: TikTok riceve quanto basta per ricollegare la conversione a una persona, mai l'indirizzo stesso.

Inviato dal suo server Identificativi cifrati prima dell'invio Ospitato nell'UE
Il percorso di un acquisto
Il suo negozio L'ordine è convalidato lato server, non su una pagina di ringraziamento
Dispatcher DataFirefly Consenso verificato, identificativi normalizzati e cifrati
TikTok Events API v1.3 CompletePayment, con il valore e i prodotti
Pageview AddToCart CompletePayment SubmitForm
Il problema

Dove un negozio perde le sue conversioni TikTok

Il pixel TikTok dipende da una catena fragile: il browser carica lo script, lo esegue, e nulla lo blocca lungo la strada.

Il pixel non si carica

Blocchi, browser restrittivi, una connessione mobile che cade a metà navigazione: l'evento non esiste mai, e TikTok ottimizza su ciò che resta.

L'acquisto dipende da una pagina

Il pixel scatta sulla pagina di conferma. Chi chiude la scheda dopo il pagamento ha comprato, e la conversione non è mai partita.

Un abbinamento povero costa ROAS

Senza identificativo utilizzabile, TikTok non collega la conversione a un profilo. La campagna appare peggiore di quanto sia e l'algoritmo impara su dati incompleti.

Installazione

Tre passaggi, e nulla da riscrivere

Il connettore si installa sul suo negozio; il resto si imposta nella console.

1: Installare il connettore

Il modulo PrestaShop, il plugin WooCommerce o l'estensione Shopware, scaricati dalla sua console. Nessun codice da scrivere.

2: Incollare due valori

Il codice del pixel e il token, presi dal suo account TikTok. Sono cifrati a riposo e non ricompaiono mai in una pagina.

3: Verificare in Test Events

I suoi eventi arrivano nella schermata di test di TikTok prima che passi in produzione.

Corrispondenze

Cosa riceve TikTok, evento per evento

Dodici dei nostri eventi hanno un nome ufficiale TikTok. Quelli che non ce l'hanno non vengono inviati a questa destinazione: vanno alle altre, senza errori né perdite.

Il nostro nome Nome presso la piattaforma
page_viewPageview
view_contentViewContent
add_to_cartAddToCart
initiate_checkoutInitiateCheckout
add_payment_infoAddPaymentInfo
purchaseCompletePayment
leadSubmitForm
complete_registrationCompleteRegistration
searchSearch
add_to_wishlistAddToWishlist
contactContact
subscribeSubscribe
I limiti

Cosa TikTok non saprà fare

Ogni destinazione ha un vocabolario chiuso, tranne una. Ecco cosa comporta, detto prima che lo scopra.

Gli eventi senza nome TikTok non partono

TikTok non ha un equivalente ufficiale per un appuntamento, una condivisione o una candidatura. Questi eventi non gli vengono inviati: vanno alle sue altre destinazioni, senza errori. Preferiamo non inviare nulla piuttosto che forzarli in un nome vicino che falserebbe i suoi numeri.

La qualità dell'abbinamento dipende da lei

TikTok collega la conversione a un profilo grazie agli identificativi che il suo negozio ci trasmette. Un ordine senza indirizzo e-mail parte comunque, ma si abbina peggio. La console le mostra questa copertura giorno per giorno.

Verificabile

Cosa le mostrerà la console per questa destinazione

Un argomento che possiamo sostenere perché la pagina esiste: non deve crederci sulla parola, guarda.

Ogni evento, con la risposta della piattaforma

L'Inspector elenca cosa è partito, cosa la destinazione ne ha fatto e il motivo esatto di un rifiuto. Un identificativo non valido o un token scaduto si leggono in chiaro, lo stesso giorno.

La copertura degli identificativi

Quanti dei suoi eventi portavano di che ricollegare la conversione a una persona. È ciò che decide la qualità dell'abbinamento, quindi il ROAS che leggerà presso l'inserzionista.

I periodi in cui non è partito nulla

L'anomalia più costosa e la più discreta: una dashboard vuota si legge come una brutta settimana, mai come un guasto. La console li nomina.

Requisiti

Cosa le serve

Due valori, dal suo account TikTok. Non le chiediamo mai la password.

Il codice del pixel

TikTok Ads Manager → Assets → Events → Web Events → il suo pixel. È l'«Event Source ID».

Un token di accesso

Generato nella configurazione Events API della stessa schermata. Cifrato a riposo e mai visibile in una pagina.

Un codice evento di test (facoltativo)

Per vedere i suoi eventi arrivare in Test Events prima di passare in produzione.

Riservatezza

Ciò che non lascia la nostra infrastruttura

Un prodotto che tratta dati di clienti deve dire dove si ferma.

Gli identificativi sono cifrati prima dell'invio

Normalizzati e poi cifrati da noi: la destinazione riceve un'impronta, mai l'indirizzo e-mail o il numero di telefono.

Il consenso decide, anche lato server

Ogni evento porta lo stato registrato dal suo banner. Un rifiuto resta un rifiuto: passare dal server non aggira nulla.

Ospitato nell'Unione europea

Il dispatcher, il database e la console sono in Germania. I suoi token sono cifrati a riposo e non ricompaiono mai in chiaro in una pagina.

Nessuna sorpresa

Semplice da installare, senza costi aggiuntivi

È una scelta di progetto, non una promessa commerciale: non c'è nulla da ospitare né nulla da sbloccare piano per piano.

Un modulo, come gli altri

Il connettore si installa come qualsiasi altra estensione del suo negozio. Nulla da ospitare: nessun contenitore da affittare, nessun server da mantenere, nessun sottodominio da configurare.

Tutte le destinazioni, in tutti i piani

Anche in quello gratuito. I piani differiscono solo per il numero di siti e di eventi: nessuna destinazione è riservata a un livello, benché sia la prassi.

Iniziare non costa nulla

Il piano gratuito copre un sito e 10 000 eventi al mese, senza carta. Nulla si rompe se supera la soglia.

Ce qu'on nous demande

Questions fréquentes

Il pixel TikTok resta necessario?

Sì, ed è voluto. Il pixel e l'invio dal server portano lo stesso identificativo di evento, quindi TikTok li unisce invece di contare due volte. Il pixel porta il contesto del browser, il server garantisce che l'acquisto arrivi anche se il pixel non ha potuto eseguirsi.

Le mie conversioni verranno contate due volte?

No. La deduplicazione si basa sull'identificativo di evento, che fissiamo dal numero d'ordine. Due invii per lo stesso ordine portano lo stesso identificativo: TikTok ne tiene uno.

Quali dati personali vengono inviati?

Gli identificativi vengono normalizzati e poi cifrati prima di lasciare la nostra infrastruttura: TikTok riceve un'impronta, mai l'indirizzo. Nulla parte senza il consenso registrato dal suo banner.

Cosa succede se TikTok rifiuta un evento?

L'Inspector della sua console mostra il rifiuto con il messaggio esatto di TikTok. Un token scaduto si vede lo stesso giorno, non al bilancio mensile.

Colleghi questa destinazione in pochi minuti

Il piano gratuito include tutte le destinazioni. Senza impegno e senza carta.