Stores

Nozioni di base #

Un 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 debba funzionare come entità separata.

Funzionano in modo completamente indipendente e non condividono dati tra 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 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 l’indicizzazione funzionano su tutte le lingue supportate. Non è necessaria alcuna migrazione; le modifiche sono disponibili immediatamente. Vedi la lista completa delle lingue supportate.

Gestione degli Store #

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

Aggiungi nuovo #

I nuovi Store vengono aggiunti su my.clerk.io, facendo clic sul nome dello Store corrente in alto a sinistra e poi su + Add New Store.

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

La Piattaforma che selezioni personalizzerà le Guide di Configurazione dello Store per adattarsi a come Clerk è configurato sulla piattaforma, quindi è importante scegliere quella giusta.

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

Copia da esistente #

Quando crei un nuovo store in my.clerk.io, puoi risparmiarti molto lavoro se usi la stessa configurazione di quello esistente semplicemente copiando contenuto, design e altri aspetti che vuoi 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 copiare:

• Contenuto
• Design
• Synonyms
• Accessori
• Audiences
• Regole
• Merchandising
• Modificatori

Ora devi solo apportare piccole modifiche nei Design (ad esempio cambiando i simboli della 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 nel prossimo prompt 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, 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 quando si fanno chiamate di base a Clerk e può essere condivisa ovunque perché da sola non dà accesso a dati sensibili.

Combinando una Private API key, puoi ottenere accesso a dati sensibili come gli indirizzi email e apportare modifiche ai dati di uno Store.

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

API Status #

Qui trovi una panoramica di tutte le chiamate API effettuate in un determinato periodo di tempo. Contiene una serie di informazioni:

API: L’endpoint API chiamato. Ad es. recommendations/popular

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

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

Results: Il numero totale di risultati effettivamente mostrati ai clienti. Può differire da hits se usi filtri o limiti inferiori nella visualizzazione.

Avg. Response Time: Il tempo medio in millisecondi che l’endpoint API impiega a rispondere.

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

Developer Logs #

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

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

Debug Dashboard #

Usa Debug per costruire richieste API e ispezionare il motivo per cui viene restituito un determinato set di risultati.

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

Semplice vs Avanzato #

• Semplice: ogni parametro API è configurato nel proprio campo. Solo i campi richiesti sono mostrati all’inizio, puoi espandere Additional fields per accedere ai parametri opzionali.
• Avanzato: crea manualmente una richiesta API GET completa (ad esempio incollando l’URL intero). Utile se hai già una chiamata API da codice o dal network del browser che vuoi riprodurre.

Esegui una richiesta #

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

Debug Output #

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 della query che ha influenzato i risultati.
• Merchandising: campagne applicate e le relative modifiche.
• Backfill: prodotti aggiunti ai risultati per saturare il limite.
• Metadata: ulteriori dettagli calcolati per la chiamata.

Caratteristiche #

Gli Store dispongono di numerosi switch per controllare quali funzionalità sono abilitate.

Impostazioni di personalizzazione #

Funzionalità standard che possono essere attivate o disattivate. Usate principalmente per identificare problemi causati dalla modifica del comportamento standard di Clerk. Quando una funzionalità è disabilitata, qualsiasi funzione associata smetterà di funzionare.

Le funzionalità attualmente disattivabili sono:

• Regole
• Redirects
• Synonyms
• Merchandising
• Campaign AI
• Categoria con nome completo

Early Access #

Funzionalità ancora in fase di sviluppo attivo. Possono essere attivate manualmente per permettere il test di nuove feature prima che siano rilasciate ovunque.

La maggior parte può essere attivata da qualsiasi utente su uno Store, e alcune solo dagli impiegati Clerk se sono ancora in Beta, ovvero la fase precedente allo stato Early Access pubblico.

Se alcune delle seguenti non sono visibili, significa che sono ancora in Beta. Contatta un impiegato Clerk se sei interessato a testare le funzioni Beta.

Search 3.0 nello Store Demo #

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

Search 3.0 rappresenta un grande miglioramento nella comprensione di ogni tipo di query e nel ranking dei risultati di ricerca.

AI Demo Shop Assistant #

Attiva la Chat nello Store Demo, così puoi testarla. Funziona solo se hai attivato anche Search 3.0. Maggiori informazioni nella pagina introduzione 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 ogni tipo di query e nel ranking dei risultati di ricerca.

Non è necessario reinstallare Search sul tuo sito perché la modifica avviene a livello di API. Funziona con la tua configurazione attuale.

Semantic Fallback (Beta) #

Un modo rivoluzionario di gestire le ricerche con frasi complete.

Se non viene trovato alcun match diretto, Clerk analizzerà la query e capirà semanticamente cosa cercano i visitatori. Ad esempio una ricerca per “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 usato da Search 3.0.

Attualmente funziona per queste logiche:

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

Non è necessaria la reinstallazione di Recommendations perché la modifica avviene a livello API.

Order Scoring (Legacy) #

Un metodo diverso di assegnare punteggi ai prodotti basato sui dati degli ordini nei risultati di ricerca delle versioni precedenti di Search. In fase di dismissione poiché la versione più recente di Search (3.0) gestisce tutto in modo più efficiente.

Spell Fix (Legacy) #

Un metodo diverso di gestione degli errori ortografici nelle versioni precedenti di Search. In via di pensionamento poiché Search 3.0 lo gestisce in modo migliore.

SKU Search Optimization (Legacy) #

Un modo diverso di gestire le ricerche per SKU nelle vecchie versioni di Search. In via di dismissione poiché Search 3.0 lo gestisce in modo migliore.

Autocomplete Improvement (Legacy) #

Un modo diverso di completamento automatico nelle vecchie versioni di Search. In via di dismissione poiché Search 3.0 lo gestisce in modo migliore.

Improved Category Search (Legacy) #

Un modo diverso di ricercare le categorie nelle vecchie versioni di Search. In via di dismissione poiché Search 3.0 lo gestisce in modo migliore.

Colore del tema #

Gli Store erediteranno il tema colore preferito dal sistema operativo. Supporta sia la modalità chiara che scura.