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

RichiestoTipo: stringValore predefinito: -

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

OpzionaleTipo: "true" o "false" stringhe perché gli attributi HTML accettano solo valori di tipo stringaValore predefinito: "false"

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

OpzionaleTipo: stringValore predefinito: "https://event.metricalp.com"

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

OpzionaleTipo: "true" o "false" stringhe perché gli attributi HTML accettano solo valori di tipo stringaValore predefinito: "false"

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

OpzionaleTipo: "true" o "false" stringhe perché gli attributi HTML accettano solo valori di tipo stringaValore predefinito: "false"

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

OpzionaleTipo: "true" o "false" stringhe perché gli attributi HTML accettano solo valori di tipo stringaValore predefinito: "false"

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