Stores

Nozioni di base #

Uno Store è 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 dovrebbe funzionare come entità separata.

Funzionano completamente in modo 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 chiavi API per comunicare attraverso l’API di Clerk, indipendentemente dal tipo di configurazione che si utilizza.

Gli Store 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 l’elenco completo delle lingue supportate.

Gestione degli Store #

Una Company può avere un numero qualsiasi di Store associati e questi possono essere creati, copiati ed eliminati secondo necessità.

Aggiungi nuovo #

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

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

La Platform che selezioni adatterà le Guide di Configurazione dello Store per abbinare come Clerk è installato sulla piattaforma, quindi è importante scegliere quella giusta.

La valuta viene utilizzata solo per mostrare la valuta corretta nelle dashboard dello Store e non influenza il tracciamento.

Copia da esistente #

Quando crei un nuovo store su my.clerk.io, puoi risparmiarti molto lavoro utilizzando la stessa configurazione del tuo store esistente semplicemente copiando i contenuti, design e altri aspetti dell’impostazione che desideri riutilizzare.

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

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

• Contenuti
• Design
• Synonyms
• Accessori
• Audiences
• Rules
• Merchandising
• Modificatori

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

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

Elimina uno Store #

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

Puoi eliminarli andando su Settings > Store settings e poi cliccando su Delete Store in fondo alla pagina. Conferma nella schermata successiva, e dopo questo il tuo Store sarà eliminato.

Chiavi API #

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

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

La Public API key viene utilizzata per effettuare chiamate base a Clerk e può essere condivisa ovunque in quanto non dà accesso a dati sensibili di per sé.

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

Per garantire la sicurezza di Clerk, la Private API Key verrà generata alla creazione dello store e sarà inviata all’owner dell’account MyClerk.

Rotazione delle chiavi #

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

La rotazione invalida immediatamente la vecchia chiave: tutte le integrazioni che la utilizzano smetteranno di funzionare immediatamente. Assicurati di essere pronto a sostituirla ovunque venga utilizzata prima o subito dopo la rotazione.

Dopo la rotazione, potresti dover effettuare il logout dal backend di Clerk.io e accedere nuovamente, dato che la vecchia chiave può rimanere attiva nella sessione corrente.

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

Stato API #

Questo contiene una panoramica di tutte le chiamate API effettuate in un periodo di tempo definito. Include una serie di punti informativi:

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

Labels: Identificatori usati 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 usano filtri o limiti inferiori alla visualizzazione.

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

Success Rate: Percentuale di chiamate API che hanno restituito realmente risultati.

Developer Logs #

Usa i Developer Logs per ispezionare richieste, errori e avvertenze per il tuo Store in tempo reale. Vai a Developers > Logs.

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

Debug Dashboard #

Utilizza Debug per costruire richieste API e ispezionare perché viene restituito un determinato set di risultati.

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

Semplice vs Avanzato #

• Semplice: ogni parametro API è configurato in un proprio campo. Inizialmente 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 la URL completa). Utile quando hai già una chiamata API da 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 eventuali parametri extra che vuoi testare.
4. Clicca su Run Request (oppure Make full API call in modalità avanzata).

Output 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: configurazioni specifiche per la query che hanno influenzato i risultati.
• Merchandising: campagne che sono state applicate e cosa hanno modificato.
• Backfill: prodotti aggiunti ai risultati per raggiungere il limite.
• Metadata: dettagli calcolati aggiuntivi per la chiamata.

Funzionalità #

Gli Store hanno una serie di switch che possono essere utilizzati per controllare quali funzionalità sono attivate.

Customization Settings #

Funzionalità standard che possono essere attivate/disattivate. Usate principalmente per individuare problemi causati da modifiche al comportamento standard di Clerk. Quando una funzionalità è disabilitata, ogni funzionalità all’interno di essa smetterà di funzionare.

Le funzionalità attualmente modificabili sono:

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

Early Access #

Queste sono funzionalità ancora in fase attiva di sviluppo. Possono essere attivate manualmente per consentire il test di nuove funzioni prima che vengano rilasciate ovunque.

La maggior parte può essere attivata da qualsiasi utente sullo Store, alcune solo dai dipendenti Clerk se sono ancora in Beta, ovvero lo stadio prima di diventare Early Access pubblico.

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

Search 3.0 In Demo Store #

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

Search 3.0 è un grande miglioramento nel modo in cui capisce qualsiasi tipo di query e classifica i risultati di ricerca.

AI Demo Shop Assistant #

Attiva il Chat nello Store Demo, così potrai testarlo. Funziona solo se hai già attivato Search 3.0. Maggiori informazioni nella pagina di introduzione a Chat.

Search 3.0 #

Attiva la versione più recente del nostro motore Search sul tuo sito live. Search 3.0 rappresenta un grande miglioramento nel modo in cui capisce ogni tipo di query e ordina i risultati.

Non è necessario reinstallare Search sul tuo sito perché il cambiamento avviene a livello di API. Funzionerà con la tua attuale configurazione.

Semantic Fallback (Beta) #

Un modo innovativo di gestire le ricerche di frasi intere.

Se non viene trovato alcun match diretto, Clerk analizzerà la query e capirà semanticamente cosa cercano i visitatori. Ad es. una ricerca per “qualcosa per raffreddare il mio cibo” restituirà frigoriferi.

Recommendations 3.0 (Beta) #

Un modo molto più veloce per mostrare i risultati di Recommendations, basato sullo stesso framework utilizzato in 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 attribuire punteggi ai prodotti basandosi sui dati degli ordini nei risultati di ricerca delle versioni precedenti di Search. Sta venendo eliminato poiché la nostra ultima versione di Search (3.0) gestisce questo molto meglio.

Spell Fix (Legacy) #

Un modo differente di gestire gli errori ortografici nelle versioni precedenti di Search. Sta venendo eliminato perché la versione più recente di Search (3.0) gestisce questo molto meglio.

SKU Search Optimization (Legacy) #

Un modo diverso di gestire la ricerca per SKU nelle versioni precedenti di Search. Sta venendo eliminato perché la versione più recente di Search (3.0) gestisce questo molto meglio.

Autocomplete Improvement (Legacy) #

Un modo differente di autocompletare le ricerche nelle versioni precedenti di Search. Sta venendo eliminato perché la versione più recente di Search (3.0) gestisce questo molto meglio.

Improved Category Search (Legacy) #

Un modo diverso di cercare categorie nelle versioni precedenti di Search. Sta venendo eliminato perché la versione più recente di Search (3.0) gestisce questo molto meglio.

Color Scheme #

Gli Store erediteranno lo schema colori preferito dal tuo sistema operativo. Supporta sia la modalità chiara che scura.