TikTok Events API, inviata dal tuo server
ROASaurus invia gli eventi di shopping alla Events API 2.0 di TikTok dal server, con gli stessi event id del pixel TikTok. Preleva anche la spesa su TikTok per il ROAS e per i report sulle creatività.
| TikTok in sintesi | |
|---|---|
| Connessione | Events API 2.0 (server) più pixel TikTok (browser), con gli stessi event id |
| Eventi | ViewContent, AddToCart, InitiateCheckout, CompletePayment (nome precedente di Purchase) |
| Dati del cliente | Email e telefono con hash SHA-256, external_id, IP, user agent |
| Click id | ttclid e il cookie _ttp |
| Credenziali | Codice pixel e un token di accesso alla Events API |
| Sincronizzazione della spesa | Sì, con un ID inserzionista e un token della Marketing API |
Cosa invia ROASaurus a TikTok
Alla Events API arrivano quattro eventi: ViewContent, AddToCart, InitiateCheckout e CompletePayment. TikTok ha rinominato CompletePayment in Purchase e accetta ancora il vecchio nome come acquisto. Le visualizzazioni di pagina passano solo dal pixel del browser; il server non invia PageView a TikTok.
Ogni evento porta con sé l’event id, l’URL della pagina, il click id ttclid, il cookie _ttp, l’indirizzo IP e lo user agent. Quando il cliente è noto, aggiunge email e telefono con hash SHA-256 e un customer id o visitor id con hash come external_id. Le proprietà contengono valuta, valore, order id e, per ogni prodotto, ID, nome, quantità e prezzo.
TikTok può rispondere HTTP 200 e rifiutare comunque un evento con un codice di errore nel corpo della risposta. ROASaurus legge quel codice, così un evento rifiutato risulta fallito nell’Event log invece di passare in silenzio.
Come collegarsi
- In ROASaurus, vai su Tracking & platforms e clicca su Add pixel nella scheda TikTok.
- Inserisci il tuo codice pixel e un token di accesso alla Events API.
- Lascia attivo Also load the browser pixel. Gli eventi del browser e del server condividono così gli ID e TikTok li deduplica.
- Facoltativo: incolla un codice evento di test per vedere prima gli eventi in Eventi di test.
- Per la spesa, aggiungi il tuo ID inserzionista e un token della Marketing API.
Report su spesa e creatività
Con la spesa sincronizzata, le campagne TikTok mostrano ROAS e CPA accanto a Meta nell’attribuzione. L’analisi delle creatività aggiunge le statistiche video di TikTok: l’hook rate conta le visualizzazioni di 2 secondi e l’hold rate quelle di 6 secondi. Dai ai tuoi annunci nomi che indichino hook, creator e formato per poterli confrontare.
Limiti
- Se anche l’app del canale di vendita TikTok invia questo pixel, gli acquisti vengono contati due volte. Disconnetti il pixel in quell’app.
- ROASaurus conta solo gli ordini che riesce a collegare a un clic, quindi i suoi totali di solito differiscono da quelli di TikTok Ads Manager.
Correlati
Domande, risposte
Perché un acquisto si chiama CompletePayment?
CompletePayment è il vecchio nome dell’evento di acquisto di TikTok; TikTok ora lo chiama Purchase e accetta ancora il vecchio nome. ROASaurus usa CompletePayment sia nel pixel del browser sia nella Events API, così TikTok può abbinare le due copie tramite event_id.
Mi serve anche l’app TikTok su Shopify?
No. Se la tieni, disconnetti il pixel nell’app TikTok, perché gli eventi che invia usano ID diversi e TikTok conterebbe ogni acquisto due volte.
Posso fare un test prima di andare online?
Sì. Incolla il codice evento di test da TikTok Events Manager nelle impostazioni del pixel. Gli eventi compaiono poi in Eventi di test. Rimuovi il codice quando hai finito.
Ogni vendita, ricondotta all’annuncio che l’ha generata
Tracciamento server-side, profitto e lifetime value in un’unica app. Prova gratuita di 14 giorni, senza carta di credito.
Inizia la prova gratuita →