Stores

Nozioni di base #

Uno Store è un’entità separata in Clerk.io che contiene tutti i dati e le impostazioni per un dominio specifico. Può trattarsi di un webshop unico, una piattaforma, una versione linguistica o qualsiasi altra cosa che debba funzionare come entità separata.

Gli Store funzionano in modo completamente indipendente e non condividono dati tra di loro. L’unica eccezione è che alcune funzionalità come Merchandising e Synonyms possono essere aggiunte a più Store contemporaneamente quando necessario.

Ogni Store ha il proprio set di API key per comunicare tramite l’API di Clerk, indipendentemente dal tipo di configurazione utilizzata.

Gli Store possono essere configurati per una qualsiasi delle nostre 54 lingue supportate. Search e indicizzazione funzionano su tutte le lingue supportate. Non è necessaria alcuna migrazione; le modifiche sono disponibili immediatamente. Consulta l’ elenco completo delle lingue supportate.

Gestione degli Store #

Un’Azienda può avere qualsiasi numero di Store associati e possono essere creati, copiati e eliminati secondo necessità.

Aggiungi nuovo #

Nuovi Store vengono aggiunti in my.clerk.io, cliccando sul nome attuale dello Store nell’angolo in alto a sinistra e poi su + Add New Store.

Compila i dettagli del tuo store e clicca su Add New Store.

La Piattaforma selezionata adatterà le Guide di Installazione dello Store in base a come Clerk viene configurato sulla piattaforma, quindi è importante scegliere quella giusta.

La valuta viene utilizzata solo per riflettere la valuta corretta nelle dashboard dello Store e non influisce sul tracking.

Copia da esistente #

Quando crei un nuovo store in my.clerk.io, puoi risparmiarti molto lavoro se utilizzi la stessa configurazione del tuo store esistente semplicemente copiando contenuto, design e altri aspetti della configurazione che desideri riutilizzare.

Questo è molto utile se stai creando un nuovo Store per una lingua diversa o per un nuovo dominio del tuo Store originale.

Sotto Copy Content From Existing Store, scegli lo Store da duplicare dal menu a tendina. Puoi scegliere quali elementi specifici copiare:

• Contenuto
• Design
• Synonyms
• Accessori
• Audience
• Rules
• Merchandising
• Modifiers
• Impostazioni Chat
• Integrazioni AI

Dovrai solo apportare piccole modifiche nei Design (ad esempio cambiando i simboli di valuta e i testi dei pulsanti).

Il nuovo Store dovrà comunque essere sincronizzato con il tuo catalogo e avrà il proprio set di API key.

Eliminare uno Store #

Quando elimini uno Store, le sue impostazioni e i suoi dati saranno rimossi per sempre e non potranno essere recuperati.

Puoi eliminarlo andando su Settings > Store settings e poi cliccando su Delete Store in fondo alla pagina. Conferma nel prompt successivo, e dopo questo il tuo Store sarà eliminato.

API Keys #

Se hai bisogno delle chiavi del tuo Store per qualsiasi motivo dopo l’integrazione iniziale, possono essere trovate in Developers > API Keys.

Ogni Store ha una Public API key fissa e un certo numero di Private API key.

La Public API key viene usata per le chiamate di base a Clerk e può essere condivisa ovunque poiché di per sé non dà accesso a dati sensibili.

Combinata con una Private API key, è possibile accedere a dati sensibili come gli indirizzi email e apportare modifiche ai dati dello Store.

Per motivi di sicurezza per Clerk, la Private API Key verrà generata alla creazione dello store e sarà inviata al proprietario dell’account MyClerk.

Rotazione delle chiavi #

Se il tuo Store possiede una Legacy Private Key, può essere ruotata direttamente da Developers > API Keys cliccando il pulsante di rotazione accanto ad essa.

La rotazione invalida immediatamente la chiave precedente: ogni integrazione che la utilizza smetterà di funzionare subito. Assicurati di essere pronto a sostituirla ovunque venga usata prima o subito dopo la rotazione.

Dopo la rotazione, potrebbe essere necessario anche disconnettersi e riconnettersi al backend di Clerk.io, poiché la chiave vecchia può restare attiva nella sessione attuale.

Per una gestione più semplice, utilizza invece le normali Private API Keys. Puoi crearne quante ne servono per scopi diversi, e ognuna può essere revocata individualmente senza influenzare le altre.

Stato delle API #

Questa sezione contiene una panoramica di tutte le chiamate API effettuate in un periodo di tempo definito. Include diversi punti informativi:

API: L’endpoint API che viene chiamato. Es: recommendations/popular

Labels: Identificazione usata da Clerk per tracciare i risultati. Es: Homepage / Popular

Hits: Il numero totale di risultati trovati dall’endpoint.

Results: Il numero totale di risultati effettivamente mostrati ai clienti. Questo può differire dagli hit se si utilizzano filtri o limiti inferiori nella visualizzazione dei risultati.

Avg. Response Time: Tempo medio in millisecondi impiegato dall’endpoint API per rispondere.

Success Rate: Percentuale delle chiamate API che hanno effettivamente restituito risultati.

Developer Logs #

Utilizza i Developer Logs per ispezionare in tempo reale richieste, errori e avvisi per il tuo Store. Vai su Developers > Logs.

Consulta la panoramica completa delle funzionalità qui: /platform/company/developer-logs/.

Debug Dashboard #

Usa Debug per costruire richieste API e analizzare il motivo per cui viene restituito uno specifico set di risultati.

Lo trovi in Developers > Debug per lo Store su cui stai lavorando.

Semplice vs Avanzato #

• Simple: Ogni parametro API viene configurato nel suo campo. All’inizio vengono mostrati solo i campi obbligatori e puoi espandere Additional fields per accedere ai parametri opzionali.
• Advanced: Crea manualmente una richiesta GET API completa (ad esempio incollando l’URL completo). Utile quando hai già una chiamata API dal codice o dal browser che vuoi riprodurre.

Esegui una richiesta #

1. Scegli un Endpoint (per esempio Search Products o Complementary Products).
2. Compila i campi richiesti.
3. Facoltativo: Espandi Additional fields e aggiungi eventuali parametri extra che vuoi testare.
4. Clicca su Run Request (o Make full API call in modalità Avanzata).

Debug Output #

Dopo aver eseguito una richiesta, la pagina mostra sia i risultati sia le diagnostiche che spiegano cosa li ha influenzati. A seconda dell’endpoint e della configurazione, questo può includere:

• Customized search rules: Configurazione specifica per le query che ha influenzato i risultati.
• Merchandising: Campagne applicate e relative modifiche apportate.
• Backfill: Prodotti aggiunti ai risultati per raggiungere il limite.
• Metadata: Ulteriori dettagli calcolati per la chiamata.

Funzionalità #

Gli Store dispongono di diversi switch che possono essere utilizzati per controllare quali funzionalità sono abilitate.

Impostazioni di personalizzazione #

Funzionalità standard attivabili o disattivabili. Principalmente utilizzate per identificare problemi causati da modifiche al comportamento standard di Clerk. Quando una funzione è disabilitata, qualsiasi funzionalità interna a quella funzione smetterà di funzionare.

Le funzionalità attualmente attivabili sono:

• Rules
• Redirects
• Synonyms
• Merchandising
• AI Campaigns
• Fullname Categories

Early Access #

Queste sono funzionalità ancora in fase di sviluppo attivo. Possono essere attivate manualmente per consentire il test di nuove funzionalità prima che vengano rilasciate a tutti.

La maggior parte può essere attivata da qualsiasi utente su uno Store, alcune solo da dipendenti Clerk se sono ancora in Beta, ovvero lo stadio precedente l’Early Access pubblica.

Se alcune delle funzionalità sotto non sono visibili, è perché sono ancora in Beta. Contatta un dipendente Clerk se sei interessato a testare le funzionalità Beta.

Search 3.0 Nel Demo Store #

L’ultima versione del nostro motore di Search può essere attivata nello Demo Store per verificare la differenza rispetto al sito live.

Search 3.0 rappresenta un grande miglioramento nella comprensione di qualsiasi tipo di query e nell’ordinamento dei risultati.

AI Demo Shop Assistant #

Attiva la Chat nello Demo Store, così può essere testata. Funziona solo se hai anche attivato Search 3.0. Maggiori info nella pagina introduttiva della Chat.

Search 3.0 #

Attiva l’ultima versione del nostro motore di Search sul tuo sito live. Search 3.0 rappresenta un grande miglioramento nella comprensione di qualsiasi tipo di query e nell’ordinamento dei risultati.

Non è necessario reinstallare Search sul tuo sito perché la modifica avviene a livello di API. Funzionerà con la configurazione già esistente.

Semantic Fallback (Beta) #

Un metodo rivoluzionario per gestire le ricerche di frasi complete.

Se non viene trovato un match diretto, Clerk analizzerà la query e comprenderà semanticamente cosa cercano i visitatori. Ad esempio, una ricerca per “qualcosa per raffreddare i miei cibi” restituirà frigoriferi.

Recommendations 3.0 (Beta) #

Un modo molto più veloce di mostrare i risultati Recommendations, basato sullo stesso framework utilizzato in Search 3.0.

Attualmente è operativo nelle seguenti logiche:

• Bestsellers (recommendations/popular)
• Bestsellers in Category (recommendations/category/popular)

Non è necessario reinstallare Recommendations perché la modifica avviene a livello di API.

Order Scoring (Legacy) #

Un modo diverso di classificare i prodotti sulla base dei dati degli ordini nei risultati di ricerca delle versioni precedenti di Search. Verrà dismesso, in quanto l’ultima versione di Search (3.0) gestisce questo aspetto in modo molto migliore.

Spell Fix (Legacy) #

Un modo diverso di gestire gli errori di ortografia nelle versioni precedenti di Search. Verrà dismesso, in quanto l’ultima versione di Search (3.0) gestisce questo aspetto in modo molto migliore.

SKU Search Optimization (Legacy) #

Un modo diverso di gestire le ricerche SKU nelle versioni precedenti di Search. Verrà dismesso, in quanto l’ultima versione di Search (3.0) gestisce questo aspetto in modo molto migliore.

Autocomplete Improvement (Legacy) #

Un modo diverso di completare automaticamente le ricerche nelle versioni precedenti di Search. Verrà dismesso, in quanto l’ultima versione di Search (3.0) gestisce questo aspetto in modo molto migliore.

Improved Category Search (Legacy) #

Un modo diverso di cercare le categorie nelle versioni precedenti di Search. Verrà dismesso, in quanto l’ultima versione di Search (3.0) gestisce questo aspetto in modo molto migliore.

Schema colore #

Gli Store adotteranno lo schema colore preferito dal tuo sistema operativo. Supporta sia la modalità chiara che quella scura.