Riferimento API
Puoi personalizzare e configurare i comportamenti dello script Metricalp fornendo alcuni attributi di dati. Se stai utilizzando librerie di integrazione come per React e NextJS, puoi fornire queste impostazioni nel modo specifico della piattaforma (come props del componente per React), quindi controlla la documentazione di integrazione specifica della tua piattaforma. Tutte le configurazioni corrisponderanno 1 a 1, quindi puoi controllare questa documentazione per spiegazioni. Se stai utilizzando l'incorporamento del puro script, puoi fornire le seguenti impostazioni con attributi di dati. Tutti gli attributi di dati sono opzionali tranne data-tid.
data-tid
Questo è il tuo tid, noto anche come tracker id. Puoi ottenere informazioni su come ottenerlo da Impostazioni Tracker / Incorporare & Condividere. Devi fornire questo attributo per far funzionare Metricalp.
data-allow-localhost
Se stai integrando Metricalp nel tuo localhost a scopo di test, puoi impostare questo attributo su "true". Altrimenti Metricalp non raccoglierà eventi in localhost per salvaguardare la tua quota di utilizzo. Consulta questa documentazione per informazioni dettagliate Se stai consentendo hostnames specifici nelle impostazioni del tuo tracker, aggiungi anche localhost agli hostnames consentiti.
data-custom-event-endpoint
Se hai proxyato l'endpoint degli eventi di Metricalp per evitare adblockers, usa questo attributo per fornire l'endpoint proxyato. Consulta questa documentazione per informazioni dettagliate.
data-disable-auto-route-catch
Di default, Metricalp ascolta gli eventi window.history per catturare i cambi di rotta nelle applicazioni JS. Puoi disabilitare questa funzione impostando questo attributo su true, e quindi potrai tracciare manualmente le rotte.
data-hash-routing
Se la tua applicazione utilizza l'hash routing (example.com/#about, example.com/#homepage), puoi impostare questo attributo su true. In questo caso, Metricalp ascolterà i cambi di rotta hash.
data-disable-custom-elm-events
Metricalp supporta di default il tracciamento degli eventi personalizzati basati sugli attributi HTML. Ad esempio, <button data-metricalp-event="follow click" data-metricalp-user="John">Click</button>, il clic su questo pulsante creerà un evento personalizzato con il nome "follow click" e una prop personalizzata "user" con valore "John". Puoi disabilitare questa funzione impostando questo attributo su true. Consulta questa documentazione per informazioni dettagliate