Formatters
Clerk.js consente di scrivere funzioni Javascript personalizzate che aggiungono nuove funzionalità ai disegni.
I formattatori possono essere aggiunti in due modi:
- Attraverso my.clerk.io > Impostazioni > Formatters, dove ogni Formatter può essere creato come voce separata.
- Come configurazione per Clerk.js, nel tracking-script inserito in tutte le pagine, dove si possono aggiungere più formattatori contemporaneamente.
Un esempio può essere visto qui sotto. Si noti che questo è per Clerk V2 (ultima versione):
Clerk('config', {
key: 'O7UITkJIXqXibeQF9ONobiGGKYYKtbvh',
formatters: {
log_price: function(price) {
console.log(price);
}
});
È possibile scrivere un numero qualsiasi di Formatter, separati da una virgola:
...Filters
Interfaccia dei filtri #
I filtri possono essere utilizzati per ciascun Contenuto per restringere i risultati in base agli attributi del prodotto.
Troverai questa opzione in ogni Contenuto che crei per Recommendations, Search o Email, sotto Content type > Product filters.
Ogni parte del filtro è composta da quanto segue:
- Un attributo su cui filtrare
- Un confronto che decide come l’attributo deve essere confrontato con il valore
- Un valore che decide con cosa deve essere confrontato l’attributo
Puoi creare filtri basati su qualsiasi attributo dei prodotti che invii a Clerk. Gli operatori di confronto disponibili dipendono dal tipo di attributo su cui filtri.
...Come scrivere ottimi articoli
È nostro sacro dovere (coro angelico in lontananza) mantenerlo facile da navigare e rendere ogni articolo estremamente ben descritto, affinché rimanga uno strumento essenziale per colmare il divario tra Product e il resto dell’azienda.
...DanDomain
DanDomain Classic
Glossario
Clerk.io ha molte componenti in movimento. Questo glossario copre i concetti chiave della piattaforma — dagli oggetti dati ai template di design fino alle meccaniche di tracciamento — così saprai sempre cosa stai utilizzando.
I termini sono ordinati alfabeticamente. Ogni voce collega all’articolo completo dove puoi approfondire.
| Term | Description | Learn more |
|---|---|---|
| Accessori | Una funzione per dichiarare quali articoli appartengono insieme, utilizzata per indirizzare l’AI verso specifici abbinamenti complementari. | Recommendations |
| Ricerche Azionabili | Una sezione Search Analytics che evidenzia query Non Convertite e Senza Risultati, suggerendo soluzioni come aggiungere sinonimi o fissare prodotti. | Search Analytics |
| AI Chat | L’assistente conversazionale di Clerk.io che risponde alle domande dei clienti usando i dati del tuo negozio online, il catalogo prodotti e i contenuti. | Chat |
| Livello AI | Il secondo dei quattro livelli di elaborazione, dove l’AI di Clerk.io utilizza connessioni tra i dati sincronizzati per prevedere il ranking dei risultati per ciascun endpoint. | Data Foundation |
| AI Modifier | Un Modifier creato descrivendo la trasformazione dati desiderata in linguaggio naturale; Clerk.io genera una regola Python di sola lettura dalla descrizione. | Modifiers |
| Sessione anonima | Un identificatore visitatore a breve termine derivato da una combinazione hashata di indirizzo IP, user agent e un sale rotante dello store — senza necessità di cookie. | Cookieless Solution |
| Ask Clerk.io | Un agente AI in-dashboard che legge la configurazione del tuo store e può proporre modifiche che tu puoi rivedere e approvare prima che vengano applicate. | Ask Clerk.io |
| Rilevanza Attributi Ricerca | Una sezione Search Configuration che definisce quali attributi prodotto sono inclusi nell’indice di ricerca e quanto ogni attributo pesa nel ranking. | Search Configuration |
| Audience | Il prodotto di segmentazione clienti di Clerk.io che prevede l’intento di acquisto, la fase nel ciclo di vita e il valore dai dati di ordini e comportamento. | Audience |
| Prodotti Alternativi Migliori | Logica di Recommendation che propone i prodotti sostitutivi più simili all’articolo attualmente visualizzato dal visitatore. | Product Logics |
| Prodotti Migliori Cross-Sell | Logica di Recommendation che suggerisce articoli complementari basandosi sullo storico di acquisti combinati di altri clienti. | Product Logics |
| Best Sellers | Logica di Recommendation che classifica i prodotti in base al volume totale di ordini nel tempo. | Product Logics |
| Categories Search | L’endpoint search/categories che restituisce corrispondenze di categoria ordinate per popolarità, usato nei risultati di Instant Search e Omnisearch. | Search Logics |
| Categoria | Oggetto dati che raggruppa prodotti. Le categorie sono richieste dalle logiche Alternatives e da tutte le strategie di Recommendation basate su categoria. | Data Foundation |
| Ordine influenzato da Clerk | Un ordine in cui almeno un prodotto acquistato è stato cliccato tramite un elemento Clerk.io durante la stessa sessione. Usato per misurare l’attribuzione. | Measuring Impact |
| Clerk.js | La libreria JavaScript frontend di Clerk.io che visualizza elementi, traccia i visitatori e fornisce la UI kit per search e recommendations. | Clerk.js |
| Code Design | Un Design modificato direttamente come HTML, CSS e Liquid invece che solo tramite il Design Editor visuale. | Designs |
| Componente | Un sotto-design riutilizzabile referenziato all’interno di un Design principale. I componenti non possono essere selezionati direttamente come design di un Element. | Designs |
| Content Recommendations | Logiche di Recommendation che mostrano prodotti correlati a una pagina blog o articolo, e pagine contenuto correlate a un prodotto o categoria. | Content Recommendations |
| Modalità senza cookie | L’approccio di privacy predefinito di Clerk.io, che identifica i visitatori tramite sessioni anonimizzate hashate invece dei cookie del browser. | Cookieless Solution |
| CRUD API | Endpoint stile REST per creare, leggere, aggiornare ed eliminare oggetti sincronizzati come prodotti, ordini e clienti su richiesta. | API |
| Dizionario personalizzato | Un elenco di termini — come acronimi di brand o nomi prodotto stilizzati — che Clerk.io considera come token singoli invece di separarli durante l’indicizzazione. | Search Configuration |
| Cliente | Un oggetto dati opzionale (id o email più attributi) che abilita la segmentazione Audience e funzionalità stile CDP. | Data Foundation |
| Impostazioni di personalizzazione | Interruttori di funzionalità per store in my.clerk.io per attivare/disattivare funzionalità come Rules, Synonyms, Redirects e Merchandising. | Stores |
| Feed dati | Un URL catalogo JSON che l’importatore Clerk.io può acquisire insieme o in sostituzione alle chiamate live CRUD API. | API |
| Data Health | Una dashboard di indicatori verdi, gialli e rossi che evidenziano problemi di qualità dati che possono influire sulle performance di search e recommendations. | Data Health |
| Data layer | Il primo dei quattro livelli di elaborazione, che contiene gli attributi grezzi di prodotto, ordine e cliente prima di qualsiasi elaborazione AI o merchandising. | Data Foundation |
| Sincronizzazione dati | Un’importazione programmata o manuale di prodotti, categorie, ordini, clienti e pagine dal webshop o da un feed esterno. | Data Sync |
| Debug Dashboard | Strumento Developers > Debug per costruire e testare richieste API su dati live e ispezionare le diagnostiche dei risultati. | Stores |
| Demo Data | Metodo di sync che carica un dataset predefinito di Clerk.io per testare la dashboard senza collegare un webshop live. | Data Sync |
| Design | Un template (HTML, CSS e Liquid o visuale) che controlla come Clerk.io mostra Search, Recommendations, Email o risultati Omnisearch. | Designs |
| Design Editor | Lo strumento visuale in my.clerk.io per creare e modificare Designs senza scrivere codice. | Designs |
| Developer Logs | Vista Developers > Logs che mostra in tempo reale richieste API, errori e avvisi di uno store. | Stores |
| Filtri dinamici | Filtri a livello di embed code che vengono risolti in tempo reale usando variabili dal contesto dello store attuale. | Recommendations |
| Early Access | Programma su invito per provare funzionalità beta prima del rilascio generale. | Stores |
| Element | Un blocco configurabile che combina una Product Logic, un Design e un embed code o una regola di iniezione per mostrare contenuti Clerk.io su una pagina. | Website Elements |
| Email Embeds | Snippet HTML che inseriscono una Product Logic di Clerk.io nelle newsletter di ESP terze parti per raccomandazioni di prodotto personalizzate. | |
| Email Triggers | Email automatiche inviate in risposta a eventi comportamentali come sessione abbandonata, carrello abbandonato o ordine completato. | Email Campaigns |
| Embed code | Uno snippet <span class="clerk"> con attributi data-* da inserire nell’HTML del negozio che Clerk.js rileva e visualizza. | Clerk.js |
| Empty State Logic | L’impostazione Omnisearch che definisce quali prodotti o contenuti appaiono prima che il visitatore digiti una query. | Omnisearch |
| Comportamento di Corrispondenza Esatta | Un’opzione Search Configuration che controlla come attributi stile SKU o EAN vengono abbinati — ad esempio, match esatto a valore singolo con autocorrezione disattivata. | Search Configuration |
| Ricavo Addizionale Atteso | Un blocco dashboard che stima i ricavi extra attribuibili a Clerk.io in base al volume di ordini influenzati e all’aumento medio del valore ordine. | Measuring Impact |
| Exporters | Integrazioni che esportano Audience segment su piattaforme esterne come Klaviyo, Meta o Google Ads per campagne a pagamento. | Ask Clerk.io |
| Facets | Filtri basati su attributi — come fascia di prezzo, brand o misura — che permettono ai visitatori di affinare risultati di ricerca o categoria. | Search Facets |
| Attributi filtrabili | Attributi prodotto configurati nelle Search Settings per apparire come opzioni filtro facet nei risultati di search e categoria. | Search Configuration |
| Diritto all’oblio (GDPR) | Il processo di rimozione dei dati personali da un profilo cliente, mentre si anonimizzano ordini conservati, per soddisfare richieste GDPR di cancellazione dati. | GDPR |
| Growth Advisor | Una sessione con esperto prenotabile tramite la dashboard quando le prestazioni dello store sono sotto i benchmark mostrati in Performance Comparison. | Measuring Impact |
| Prodotti Hot | Logica di Recommendation che mostra prodotti con un recente aumento di acquisti, spesso etichettati come articoli trend. | Product Logics |
| Importance | Un punteggio Audience automatico che colloca ogni cliente su un asse di valore in base al comportamento rispetto a clienti simili nello store. | Audience |
| Injection | Una funzione di Clerk.js che inserisce un Element nel DOM usando selettori CSS, senza bisogno di aggiungere uno snippet nel template dello store. | Website Elements |
| Instant Search | Un menu a tendina live che appare mentre il visitatore digita, combinando prodotti, categorie e pagine in un’unica lista di risultati in tempo reale. | Search |
| Filtraggio Intelligente | Funzione Merchandising che usa keyword o filtri attributo per includere dinamicamente solo i prodotti corrispondenti in una campagna. | Merchandising |
| Knowledge Graph | La struttura dati interna di Clerk.io che collega prodotti, categorie, ordini e opzionalmente clienti, per alimentare le previsioni AI. | Cookieless Solution |
| Labels | Stringhe associate a chiamate API o embed code, per identificare quale area ha attivato la richiesta, usate per analytics e attribuzione vendite. | Sales Tracking |
| Life Cycle | Un punteggio Audience automatico che colloca ogni cliente su un asse ciclo di vita — da attivo a in abbandono fino a perso — in base al comportamento d’acquisto. | Audience |
| Live-Search | L’endpoint search/predictive che alimenta l’auto-completamento, classificando i suggerimenti in base alla probabilità di conversione prevista. | Search Logics |
| log/click | Endpoint API che registra un clic su un prodotto servito da Clerk.io, usato per costruire la catena di attribuzione fino alla vendita. | Sales Tracking |
| log/sale | Endpoint API che registra un ordine completato e lo collega a un Visitor ID e ai click precedenti per l’attribuzione di ricavi. | Sales Tracking |
| Merchandising | Set di strumenti trasversali per influenzare il ranking dei risultati tramite campagne, trigger e regole di posizione. | Merchandising |
| Campagna di Merchandising | Una configurazione nominata che combina un calendario, uno o più trigger, una selezione prodotti e regole di ordinamento o fissaggio posizione. | Campaigns |
| Merchandising layer | Il terzo dei quattro livelli di elaborazione, dove le campagne attive possono potenziare, sotterrare o fissare i prodotti prima che i risultati vengano restituiti. | Data Foundation |
| Modifiers | Regole post-sync che trasformano attributi prodotto all’interno di Clerk.io senza alterare il feed dati o i dati dello shop originari. | Modifiers |
| Most Sold With | Logica di Recommendation basata su coppie di acquisto dirette, senza la previsione più ampia della logica cross-sell. | Product Logics |
| Prodotti Più Recenti | Logica di Recommendation ordinata per la data created_at dei prodotti, mostrando gli articoli aggiunti più di recente al catalogo. | Product Logics |
| Newsletters | Email marketing programmate o invii singoli creati, inviati e tracciati tramite Clerk.io Email. | Email Campaigns |
| Omnisearch | Una ricerca a schermo intero che combina risultati digitati live, facets, categorie, pagine e suggerimenti in un’unica esperienza. | Omnisearch |
| Ordine | Oggetto dati che registra un acquisto con id, products e time. Gli ordini sono il principale input per ranking AI, attribuzione e previsioni Audience. | Data Foundation |
| Pagina | Un’entità contenuto opzionale — come un post blog o articolo — che può apparire nei risultati di ricerca o nelle content recommendations. | Data Foundation |
| Page Context | Una chiamata Clerk.js che passa l’ID del prodotto, categoria o pagina attualmente visualizzato per migliorare la personalizzazione degli elementi su quella pagina. | Clerk.js |
| Pacco | Un’entità di tracciamento spedizione associata a un Ordine, contenente codice tracking, stato del corriere, dettagli stato e link di tracking. | Data Foundation |
| Performance Comparison | Tabella dashboard che compara tasso di conversione, valore medio ordine e dimensione carrello rispetto ad altri clienti Clerk.io. | Measuring Impact |
| Powerstep | Il passaggio intermedio mostrato dopo che un cliente aggiunge un articolo al carrello — tipicamente pop-up, side cart o pagina interstiziale — dove sono inserite le raccomandazioni cross-sell. | Recommendations Best Practices |
| Preview mode | Un flag URL (clerk_content_mode=preview) che rende visibili gli Element solo-previsione sullo store, senza impattare i visitatori veri. | Omnisearch |
| Privacy mode: Custom | Un’impostazione di privacy dove fornisci la tua stringa Visitor ID, per l’integrazione con tool di identità first-party o gestione consenso. | Cookieless Solution |
| Privacy mode: Default | La modalità cookieless standard di Clerk.js, che usa sessioni anonime hashate per il tracciamento senza memorizzare identificativi persistenti. | Cookieless Solution |
| Privacy mode: Persistent | Una modalità privacy che salva uno stabile clerk-visitor-id in localStorage dopo il consenso, abilitando finestre di attribuzione più lunghe. | Cookieless Solution |
| Privacy mode: Private | Una modalità privacy che non raccoglie dati dei visitatori, disabilitando tutte le funzioni dipendenti e l’attribuzione dei ricavi Clerk.io. | Cookieless Solution |
| Prodotto | L’entità principale del catalogo, con campi obbligatori tra cui id, name, price, categories, created_at, image e url. | Data Foundation |
| Product layer | Il quarto e ultimo livello di elaborazione, dove l’API di Clerk.io compila la lista di risultati restituita all’acquirente. | Data Foundation |
| Product Logics | Strategie di recommendation o ricerca denominate — come Best Sellers o Visitor Recommendations — che alimentano ogni Element di Clerk.io. | Product Logics |
| Public / Private API key | Una coppia di credenziali dove la public key è usata per richieste frontend di risultati e la private key per operazioni di gestione dati. | API |
| Aggiornamenti in tempo reale | Sincronizzazioni incrementali applicate via CRUD API o integrazioni, così i piccoli cambiamenti di catalogo si riflettono senza attendere un sync completo. | Data Sync |
| Recommendations | Suggerimenti prodotto sul sito alimentati dall’AI di Clerk.io, mostrati in slider, griglie di pagina categoria o banner di contenuto. | Recommendations |
| Redirects | Regole che mappano query corrispondenti esattamente o tramite pattern a un URL di destinazione, restituito dalla search API invece dei risultati. | Redirects |
| Sales tracking | Il setup completo che collega Labels, eventi click (log/click) ed eventi ordine (log/sale) così Clerk.io può attribuire ricavi a elementi specifici. | Sales Tracking |
| Scopes | Impostazione di Merchandising Campaign che definisce se una campagna funziona su un singolo store, un gruppo selezionato o su tutto l’account. | Merchandising |
| Search | La funzionalità di ricerca del sito alimentata da AI di Clerk.io, che include i menu a tendina instant, le pagine search complete e l’overlay Omnisearch. | Search |
| Search Insights | Dashboard Search Analytics per monitorare comportamento di ricerca, query top, tasso di no-result e opportunità di miglioramento. | Search Analytics |
| Search Page | Una pagina di risultati search completa con faceting avanzato, controlli di ordinamento e capacità di browsing oltre il menu instant. | Search |
| Search Rules | Override specifici per query che fissano, includono o escludono particolari tipi di risultato — prodotti, categorie, pagine o suggerimenti — per query scelte. | Search Rules |
| Semantic Search | Una fallback in linguaggio naturale che interpreta l’intento del cliente e restituisce risultati pertinenti anche se la query non corrisponde esattamente. | Search |
| Sender Domain | Record DNS configurati in Clerk.io Email così le campagne vengano inviate dal dominio del merchant e non da un indirizzo condiviso Clerk.io. | Email Campaigns |
| Sessione | Una singola visita continua a uno store, usata per raggruppare i clic e la navigazione di un visitatore sotto un unico Visitor ID. | Cookieless Solution |
| Sliders | Caroselli di recommendation inseriti in pagine prodotto, pagine categoria, homepage o altre posizioni dello store. | Recommendations |
| Smart Campaigns | Campagne merchandising che combinano pianificazione, trigger e regole per funzionare automaticamente — nessun intervento manuale necessario dopo la configurazione. | Merchandising |
| Snippet | Un elemento <span class="clerk"> con attributi data-* che Clerk.js rileva a caricamento pagina e trasforma in chiamate API. | Clerk.js |
| Store | Un tenant isolato di Clerk.io — tipicamente uno per dominio — accessibile con le proprie API keys e con dati, impostazioni e elementi separati. | API |
| Sub-Processor | Un servizio terzo usato da Clerk.io che archivia o elabora dati del merchant. I sub-processori attivi sono elencati per funzionalità nella Dashboard GDPR. | GDPR |
| Subscriber | Un record contatto con subscribed: true che può ricevere campagne email di Clerk.io. | Email Subscribers |
| Subscriber List | Una lista nominata di opt-in usata per segmentare subscriber per campagne email mirate in Clerk.io Email. | Email Subscribers |
| Synonyms | Regole che trattano parole diverse come equivalenti così restituiscono gli stessi risultati di ricerca senza impattare il ranking. | Synonyms |
| Ordini Tracciati vs Sincronizzati | La distinzione fra ordini registrati in tempo reale tramite log/sale sulla vetrina e ordini importati solo via data sync. | Measuring Impact |
| Trust Center | La risorsa pubblica Clerk.io a trust.clerk.io che copre policy privacy, sotto-processori e pratiche di gestione dati. | GDPR |
| Visitor / Visitor ID | L’identificatore anonimo che collega la sessione di navigazione di un cliente alla sua cronologia di clic e all’eventuale acquisto per fini attributivi. | Visitor Log |
| Visitor Log | L’interfaccia Data > Visitors che mostra ogni chiamata API effettuata sotto un Visitor ID con input, output, labels e metadati. | Visitor Log |
| Visitor Recommendations | Suggerimenti prodotto personalizzati basati sulla cronologia recente di navigazione e clic del visitatore corrente in Clerk.io. | Product Logics |
| Website Elements | La sezione di my.clerk.io per configurare e gestire tutti gli Elementi Search e Recommendation che appaiono sullo store. | Website Elements |
Instructions
Istruzioni per ClerkGPT
Istruzioni per LLM #
Il tuo ruolo #
Sei un esperto di Clerk.io.
- Se la domanda riguarda come usare Clerk.io, agisci come esperto supporter.
- Se l’utente ti chiede di generare codice, agisci come esperto sviluppatore.
Importante: Quando si fa riferimento a noi, tu, clerk, ecc., il riferimento è sempre a “Clerk.io”.
Durante il Debug o la Revisione di Problemi su Siti Web #
Compito Principale #
- Il tuo compito principale è aiutare l’utente a capire cosa e perché succede qualcosa in base a ciò che viene richiesto
- Salvo diversa indicazione, stai eseguendo il debug di problemi relativi alle configurazioni di Clerk.io.
Contesto Utente #
- Presumi che l’utente sia uno Supporter di Clerk.io o uno Specialista per le Implementazioni che sta cercando di far funzionare qualcosa per un cliente.
- Se la soluzione a un problema può essere gestita utilizzando gli strumenti integrati di Clerk.io senza ulteriore codice, presumi che l’utente debba risolverlo così.
- Non appena sono necessarie soluzioni con codice personalizzato, presumi che l’utente debba spiegare al developer del cliente come fare, ma fornisci comunque la soluzione. Sii chiaro su questo nelle tue risposte.
Politica di Generazione del Codice #
- Non generare mai nuovo codice nel workspace se non esplicitamente richiesto.
- Puoi mostrare esempi di codice nella conversazione quando necessario.
Risorse Clerk.io #
Per la conoscenza relativa a Clerk.io, utilizza solo le risorse seguenti. Controlla e verifica sempre che la tua risposta sia corretta prima di rispondere:
...Istruzioni per Cursor
Istruzioni per LLM #
Il tuo ruolo #
Sei un esperto di Clerk.io.
- Se la domanda riguarda come utilizzare Clerk.io, agisci come supporto esperto.
- Se la domanda riguarda l’uso commerciale di Clerk.io, agisci come esperto commerciale.
- Se l’utente ti chiede di generare codice, agisci come sviluppatore esperto.
Importante: Quando ti riferisci a noi, te, clerk, ecc., il riferimento è sempre a “Clerk.io”.
Durante il Debugging o la Revisione dei Problemi sui Siti Web #
Compito Principale #
- Il tuo compito principale è aiutare l’utente a capire cosa e perché accade a seconda di cosa sta chiedendo
- Salvo diversa indicazione, stai eseguendo il debug di problemi relativi alle configurazioni Clerk.io.
Contesto dell’Utente #
- Presumi che l’utente sia un Supporter di Clerk.io o uno Specialist Implementations che sta cercando di far funzionare qualcosa per un cliente.
- Se la soluzione a un problema può essere gestita utilizzando gli strumenti integrati di Clerk.io senza ulteriore programmazione, presumi che l’utente debba risolverlo da sé.
- Non appena sono necessarie soluzioni di programmazione personalizzate, presumi che l’utente debba spiegare al developer del cliente come farlo, ma fornisci comunque la soluzione. Rendilo chiaro nelle tue risposte.
Politica di Generazione del Codice #
- Non generi mai nuovo codice nello spazio di lavoro se non esplicitamente richiesto.
- Puoi mostrare esempi di codice nella conversazione quando necessario.
Risorse Clerk.io #
Per la conoscenza relativa a Clerk.io, utilizza solo le informazioni dalle seguenti risorse. Controlla sempre e verifica che la tua risposta sia corretta prima di rispondere:
...Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.