Stores

Nozioni di base #
Un Negozio è un’entità separata in Clerk.io che contiene tutti i dati e le impostazioni per un dominio specifico. Questo può essere un webshop unico, una piattaforma, una versione linguistica o qualsiasi altra cosa che debba funzionare come un’entità separata.
Funzionano completamente in modo autonomo e non condividono dati tra loro. L’unica eccezione è che alcune funzionalità come Merchandising e Sinonimi 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 utilizzata.
I Negozi possono essere configurati per ciascuna 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 qualsiasi numero di Negozi associati e questi possono essere creati, copiati o eliminati a seconda delle necessità.
Aggiungi nuovo #
I nuovi Negozi vengono aggiunti su my.clerk.io, facendo clic sul nome del Negozio attuale nell’angolo in alto a sinistra e poi su + Add New Store.
Compila i dettagli del tuo negozio e fai clic su Add New Store.
La Piattaforma selezionata personalizzerà le Guide di configurazione del Negozio per riflettere come Clerk è configurato sulla piattaforma, quindi è importante scegliere quella corretta.
La valuta viene utilizzata solo per mostrare la valuta corretta nelle dashboard del Negozio e non influisce sul tracciamento.
Copia da esistente #
Quando crei un nuovo negozio su my.clerk.io, puoi risparmiarti molto lavoro utilizzando la stessa configurazione di quello esistente semplicemente copiando i contenuti, design ed altri aspetti di configurazione che vuoi 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 Negozio esistente, scegli il Negozio che vuoi duplicare dal menu a tendina. Puoi scegliere quali elementi specifici desideri copiare:
- Contenuti
- Design
- Sinonimi
- Accessori
- Audience
- Regole
- Merchandising
- Modificatori
- Impostazioni Chat
- Integrazioni AI
A questo punto è sufficiente apportare modifiche minori ai Design (come ad esempio modificare i simboli di valuta e i testi dei pulsanti).
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 i suoi dati verranno rimossi per sempre e non potranno essere recuperati.
Puoi eliminarli andando su Settings > Store settings e cliccando poi su Delete Store in fondo alla pagina. Conferma nella successiva finestra di dialogo e, dopo questo, il tuo Negozio sarà eliminato.
Chiavi API #
Se ti servono le chiavi del tuo Negozio per qualsiasi scopo dopo l’integrazione iniziale, puoi trovarle sotto Developers > API Keys.
Ogni Negozio ha una chiave API Pubblica fissa e un certo numero di chiavi API Private.
La chiave API Pubblica viene utilizzata per effettuare chiamate di base a Clerk e può essere condivisa ovunque poiché di per sé non concede accesso a dati sensibili.
In combinazione con una chiave API Privata, puoi accedere a dati sensibili come indirizzi email e apportare modifiche ai dati di un Negozio.
Per sicurezza per Clerk, la chiave API Privata verrà generata al momento della 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 rotate accanto ad essa.
La rotazione invaliderà immediatamente la vecchia chiave — tutte le integrazioni che la utilizzano smetteranno di funzionare subito. Assicurati di essere pronto a sostituirla ovunque venga usata prima o subito dopo la rotazione.
Dopo la rotazione, potresti dover effettuare il logout dal backend di Clerk.io e rientrare, poiché la vecchia chiave potrebbe rimanere attiva nella sessione corrente.
Per una gestione più semplice, usa invece le chiavi API Private standard. Puoi crearne quante ne servono per diversi scopi, e ciascuna può essere revocata individualmente senza influenzare le altre.
Statistiche API #
Apri Developers > API Stats per una panoramica delle chiamate API nel periodo selezionato.
| Metrica | Significato |
|---|---|
| API | L’endpoint chiamato, ad esempio recommendations/popular. |
| Labels | Etichette di tracciamento come Homepage / Popular. Gli endpoint senza un’etichetta avranno la cella Labels vuota. |
| Hits | Chiamate all’endpoint nel periodo selezionato. |
| Results | Chiamate che hanno restituito risultati. |
| Avg. Response Time | Tempo medio in millisecondi per la risposta dell’endpoint. |
| Success Rate | Percentuale di chiamate che hanno restituito risultati. |
Le chiamate senza risultati non sono necessariamente errori HTTP. Ad esempio, una richiesta di ricerca valida può non restituire prodotti corrispondenti.
Log Sviluppatore #
Utilizza Developer Logs per ispezionare richieste, errori e avvisi del tuo Negozio in tempo reale. Vai su Developers > Logs.
Vedi la panoramica completa delle funzionalità qui: /platform/company/developer-logs/.
Debug API #
Usa API Debug 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 viene configurato nel proprio campo. All’inizio vengono mostrati solo i campi obbligatori, e puoi espandere i campi aggiuntivi per accedere ai parametri opzionali.
- Avanzato: Crea manualmente una richiesta API GET completa (ad esempio incollando l’intera URL). È utile quando hai già una chiamata API dal codice o dalla scheda di rete del browser che vuoi riprodurre.
Esegui una richiesta #
- Scegli un Endpoint (ad esempio Search Products o Complementary Products).
- Compila i campi obbligatori.
- Opzionale: Espandi i campi aggiuntivi ed aggiungi i parametri extra che vuoi testare.
- Fai clic 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 le diagnostiche che spiegano cosa li ha influenzati. A seconda dell’endpoint e della configurazione, questo può includere:
- Regole di ricerca personalizzate: configurazione specifica per la query che ha influito sui risultati.
- Merchandising: campagne applicate e cosa hanno modificato.
- Backfill: prodotti aggiunti ai risultati per raggiungere il limite.
- Metadati: dettagli aggiuntivi calcolati della chiamata.
Funzionalità #
I Negozi dispongono di una serie di switch che possono essere utilizzati per controllare quali funzionalità sono attivate.
Impostazioni di personalizzazione #
Funzionalità standard che possono essere attivate o disattivate. Principalmente servono a identificare problemi causati dalla modifica del comportamento standard di Clerk. Quando una funzionalità è disabilitata, le sue funzionalità smettono di funzionare.
Le attuali funzionalità disattivabili sono:
- Regole
- Redirect
- Sinonimi
- Merchandising
- AI Campaigns
- Fullname Categories
Accesso Anticipato #
Queste sono funzionalità ancora in fase di sviluppo. Possono essere attivate manualmente per consentire il test di nuove feature prima che vengano rilasciate ovunque.
La maggior parte può essere abilitata da qualsiasi utente su un Negozio, mentre alcune possono essere attivate solo dai dipendenti Clerk se sono ancora in Beta, che rappresenta la fase prima della pubblicazione in Early Access.
Se alcune delle seguenti non ti sono visibili, è perché sono ancora in Beta. Contatta un dipendente Clerk se sei interessato a testare le funzionalità in Beta.
AI Demo Shop Assistant #
Attiva la Chat nel Demo Store, così può essere testata. Maggiori informazioni nella pagina introduttiva della Chat.
Semantic Fallback (Beta) #
Un modo rivoluzionario per gestire le ricerche di frasi complete.
Se non viene trovato un abbinamento diretto, Clerk analizzerà la query e capirà 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 per Search 3.0.
Attualmente funziona per queste logiche:
- Bestsellers (
recommendations/popular) - Bestsellers in Category (
recommendations/category/popular)
Non è necessario reinstallare Recommendations poiché la modifica avviene a livello API.
Order Scoring (Legacy) #
Un modo diverso di valutare i prodotti basato sui dati degli ordini nei risultati ricerca nelle versioni precedenti di Search. Sta venendo dismesso poiché la nostra ultima versione Search (3.0) gestisce questo in modo molto migliore.
Spell Fix (Legacy) #
Un modo diverso di gestire gli errori ortografici nelle versioni precedenti di Search. Sta venendo dismesso poiché la nostra ultima versione Search (3.0) gestisce questo in modo molto migliore.
SKU Search Optimization (Legacy) #
Un modo diverso di gestire le ricerche SKU nelle versioni precedenti di Search. Sta venendo dismesso poiché la nostra ultima versione Search (3.0) gestisce questo in modo molto migliore.
Autocomplete Improvement (Legacy) #
Un modo diverso di completare automaticamente le ricerche nelle versioni precedenti di Search. Sta venendo dismesso poiché la nostra ultima versione Search (3.0) gestisce questo in modo molto migliore.
Improved Category Search (Legacy) #
Un modo diverso di cercare le categorie nelle versioni precedenti di Search. Sta venendo dismesso poiché la nostra ultima versione Search (3.0) gestisce questo in modo molto migliore.
Schema dei colori #
I Negozi ereditano lo schema colori preferito dal tuo sistema operativo. Sono supportate sia la modalità chiara che la modalità scura.
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.