Stores

Basi #

Un Negozio è un’entità separata in Clerk.io che contiene tutti i dati e le impostazioni per un dominio specifico. Questo può essere uno shop online unico, una piattaforma, una versione linguistica o qualsiasi altra cosa che debba funzionare come entità separata.

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

Ogni Negozio ha il proprio set di chiavi API per comunicare tramite le API di Clerk, indipendentemente dal tipo di configurazione utilizzato.

I Negozi possono essere configurati per una qualsiasi delle nostre 54 lingue supportate. Search e l’indicizzazione funzionano su tutte le lingue supportate. Non è necessaria alcuna migrazione; le modifiche sono disponibili immediatamente. Consulta la lista completa delle lingue supportate.

Gestione dei Negozi #

Un’Azienda può avere un numero illimitato di Negozi associati e questi possono essere creati, copiati e eliminati secondo necessità.

Aggiungi nuovo #

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

Compila i dettagli per il tuo negozio e clicca su Add New Store.

La Piattaforma selezionata adatterà le guide di configurazione del Negozio per rispecchiare come Clerk è impostato sulla piattaforma, quindi è importante scegliere quella corretta.

La valuta viene usata solo per riflettere la valuta corretta nelle dashboard del Negozio e non ha influenza sul tracciamento.

Copia da esistente #

Quando crei un nuovo negozio su my.clerk.io, puoi risparmiarti molto lavoro se utilizzi la stessa configurazione di uno esistente semplicemente copiando i contenuti, design e altri aspetti di configurazione che desideri riutilizzare.

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

Sotto Copia contenuti da un Negozio Esistente, scegli il Negozio che vuoi duplicare dal menu a tendina. Puoi scegliere quali elementi specifici copiare:

• Contenuti
• Design
• Synonyms
• Accessori
• Audiences
• Regole
• Merchandising
• Modificatori
• Impostazioni Chat
• Integrazioni AI

A questo punto dovrai solo apportare piccole modifiche ai Design (come cambiare i simboli di valuta e i testi dei pulsanti, ad esempio).

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

Elimina un Negozio #

Quando elimini un Negozio, le sue impostazioni e dati verranno 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 nella richiesta successiva e, dopo questo, il tuo Negozio sarà eliminato.

Chiavi API #

Se hai bisogno delle chiavi del tuo Negozio per qualsiasi scopo dopo l’integrazione iniziale, puoi trovarle sotto Developers > API Keys.

Ogni Negozio ha una Public API key fissa e un numero di Private API keys.

La Public API key viene utilizzata per effettuare chiamate di base a Clerk e può essere condivisa ovunque dato che non dà accesso ai dati sensibili da sola.

Combinata con una Private API key, puoi accedere a dati sensibili come indirizzi email e apportare modifiche ai dati su un Negozio.

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

Rotazione delle Chiavi #

Se il tuo Negozio ha 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 vecchia chiave — qualsiasi integrazione che la utilizzi smetterà immediatamente di funzionare. Assicurati di essere pronto a sostituirla ovunque sia usata prima o immediatamente dopo la rotazione.

Dopo la rotazione, potrebbe essere necessario uscire e rientrare nel backend di Clerk.io, poiché la vecchia chiave può rimanere attiva nella sessione corrente.

Per una configurazione più gestibile, usa invece le Private API Keys standard. Puoi crearne quante preferisci per scopi diversi, e ognuna può essere revocata individualmente senza influenzare le altre.

Statistiche API #

Apri Developers > API Stats per una panoramica delle chiamate API nel periodo selezionato.

Le chiamate senza risultati non sono necessariamente errori HTTP. Ad esempio, una ricerca valida può non restituire prodotti corrispondenti.

Log Sviluppatore #

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

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

Debug API #

Utilizza Debug API per costruire richieste API e ispezionarne i risultati. Apri Developers > API Debug per il negozio su cui stai lavorando. I parametri sono organizzati in gruppi di moduli.

Semplice vs Avanzato #

• Semplice: Ogni parametro API è configurato nel proprio campo. All’inizio vengono mostrati solo i campi obbligatori, puoi espandere Campi aggiuntivi per accedere ai parametri opzionali.
• Avanzato: Crea manualmente una richiesta API completa GET (ad esempio incollando l’URL completo). Utile se hai già una chiamata API dal codice o dalla rete del browser che vuoi riprodurre.

Esegui una richiesta #

1. Scegli un Endpoint (ad esempio Search Products o Complementary Products).
2. Compila i campi obbligatori.
3. Opzionale: espandi Campi aggiuntivi e aggiungi altri parametri che vuoi testare.
4. Clicca su Run Request (o Make full API call in modalità Avanzata).

Output di Debug #

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

• Regole Search personalizzate: configurazione specifica della query che ha influenzato i risultati.
• Merchandising: campagne applicate e le relative modifiche.
• Backfill: prodotti aggiunti ai risultati per raggiungere il limite.
• Metadata: dettagli aggiuntivi calcolati per la chiamata.

Funzionalità #

I Negozi hanno diversi interruttori che possono essere usati per controllare quali funzionalità sono abilitate.

Impostazioni di personalizzazione #

Funzionalità standard che possono essere attivate o disattivate. Principalmente utilizzate per identificare problemi causati da modifiche al comportamento standard di Clerk. Quando una funzionalità è disabilitata, qualsiasi funzionalità all’interno della stessa smetterà di funzionare.

Le funzionalità attualmente attivabili/disattivabili sono:

• Regole
• Redirect
• Synonyms
• Merchandising
• AI Campaigns
• Fullname Categories

Accesso Anticipato #

Queste sono funzionalità ancora in fase di sviluppo attivo. Possono essere abilitate manualmente per testare nuove funzionalità prima che vengano rilasciate ovunque.

La maggior parte può essere abilitata da qualsiasi utente su un Negozio, alcune solo da dipendenti Clerk se sono ancora in Beta, lo stadio precedente alla pubblicazione come Early Access.

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

Search 3.0 Nel Negozio Demo #

L’ultima versione del nostro motore Search può essere attivata specificamente nel Negozio Demo, per verificarne 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 Search.

AI Demo Shop Assistant #

Attiva Chat nel Negozio Demo, così può essere testata. Funziona solo se hai già attivato Search 3.0. Maggiori info nella pagina di introduzione a Chat.

Search 3.0 #

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

Non è necessario reinstallare Search sul sito poiché la modifica avviene a livello di API. Funzionerà con la tua configurazione attuale.

Semantic Fallback (Beta) #

Un modo rivoluzionario di gestire le ricerche per frasi intere.

Se non viene trovato alcun match diretto, Clerk analizzerà la query e comprenderà semanticamente ciò che i visitatori cercano. Es: una ricerca come “qualcosa per raffreddare il mio cibo” restituirà frigoriferi.

Recommendations 3.0 (Beta) #

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

Attualmente funziona per questi logici:

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

Non è necessario reinstallare Recommendations poiché la modifica avviene lato API.

Order Scoring (Legacy) #

Un metodo diverso di valutazione dei prodotti basato sui loro dati d’ordine nei risultati Search delle versioni precedenti. Sta per essere dismesso, poiché Search 3.0 gestisce questo aspetto molto meglio.

Spell Fix (Legacy) #

Un metodo diverso di gestione degli errori ortografici nelle versioni precedenti di Search. Sta per essere dismesso, poiché Search 3.0 lo gestisce molto meglio.

SKU Search Optimization (Legacy) #

Un modo diverso di gestire le ricerche SKU nelle versioni precedenti di Search. Sta per essere dismesso, poiché Search 3.0 lo gestisce molto meglio.

Autocomplete Improvement (Legacy) #

Un modo diverso di autocompletare le ricerche nelle versioni precedenti di Search. Sta per essere dismesso, poiché Search 3.0 lo gestisce molto meglio.

Improved Category Search (Legacy) #

Un modo diverso di ricercare le categorie nelle versioni precedenti di Search. Sta per essere dismesso, poiché Search 3.0 lo gestisce molto meglio.

Schema Colori #

I Negozi erediteranno lo schema colore preferito dal tuo sistema operativo. Sono supportate sia la modalità chiara che la modalità scura.