FAQ
Hai problemi con l’integrazione Dandomain Classic? Questa FAQ copre i problemi più comuni e le loro soluzioni, dall’autenticazione HTTP agli errori di sincronizzazione.
Autenticazione HTTP #
L’autenticazione HTTP viene spesso utilizzata sui siti di staging per evitare visitatori indesiderati.
Questo bloccherà l’importatore Clerk e mostrerà un errore 401 Unauthorized nel registro di sincronizzazione.
Puoi risolvere questo problema inserendo le informazioni di autenticazione nell’URL di importazione.
In my.clerk.io > Data > Configuration, aggiorna il tuo URL di importazione in questo modo:
https://USER:PASS@dandomain.clerk.io/api/6155349/28
Errori comuni di sincronizzazione #
Durante l’importazione dei dati con la Dandomain App di Clerk, è il server del tuo webshop a inviare i dati di prodotti, categorie e vendite a Clerk.
Tuttavia, in alcuni casi, la configurazione del server potrebbe bloccare l’importazione dall’accesso ai dati, causando un errore in Data Sync.
Di seguito è riportato un elenco degli errori più comuni e come risolverli.
401 Unauthorized #
Questo errore si verifica se il tuo webshop o ambiente di sviluppo richiede autenticazione HTTP per accedervi.
Questo si risolve inserendo Username e Password come parte dell’Import URL:
http://USER:PASS@dandomain.clerk.io/api/6155349/28
403 Forbidden #
Questo errore si verifica se il tuo server blocca l’importatore dall’accesso.
Nella maggior parte dei casi, è sufficiente whitelistare l’indirizzo IP dell’importatore per concedergli l’accesso.
L’ultimo indirizzo IP può essere trovato qui.
Controlla anche che la tua public key, private key e import URL siano corrette per lo store su cui stai operando in my.clerk.io.
In alcuni casi (se stai usando una versione Dandomain più vecchia), questo errore viene mostrato anche se stai utilizzando diversi domini linguistici ognuno con un ID differente.
In tal caso, assicurati che gli ID di ogni store corrispondano a quelli nel tuo backend Dandomain.
Cosa devo fare se ho già whitelistato ma l’errore si verifica ancora?
Ci sono alcuni casi in cui hai già whitelistato l’indirizzo IP dell’importatore, ma l’errore persiste.
In queste situazioni, ti consigliamo di controllare questi aspetti:
La parte di autenticazione del body potrebbe essere stata rimossa dalla richiesta dal server dello shop.
Limite di richieste per il server rispetto a Cloudflare.
404 Not Found #
Questo errore si verifica se l’importatore non riesce ad accedere al link che invia i dati dal webshop.
Nella maggior parte dei casi, ciò accade perché l’app è:
Non installata affatto
Una cache impedisce l’inizializzazione del link
Per prima cosa, assicurati di aver installato l’app correttamente.
Poi, svuota la cache del tuo webshop prima di provare una nuova importazione.
429 Too Many Requests #
Questo errore si verifica quando il tuo server nega l’accesso all’importatore a causa di troppe richieste in ingresso.
Puoi risolvere questo problema aumentando il request limit per il tuo server oppure impostando un valore più alto per Page Size in my.clerk.io > Data > Configuration, così l’importatore effettuerà meno richieste ma più grandi:
500 Internal Server Error #
Questo errore significa che il tuo server ha riscontrato un errore interno e non è stato in grado di specificare quale errore sia avvenuto.
In questi casi, controlla il tuo Server Log per identificare quale processo è andato in crash e perché.
Nella maggior parte dei casi, si tratta semplicemente di un prodotto con un attributo non valido oppure di una funzione chiamata in modo errato nel webshop.
Se si verifica quest’ultimo caso, ti consigliamo di contattare il nostro team di supporto tecnico.
503 Service Unavailable #
Questo errore di solito è temporaneo e causato dal server troppo occupato per gestire la richiesta.
Riprova più tardi.
Se il problema persiste, potrebbe significare che il server è sovraccarico di processi ed è vicino alla capacità massima.
Controlla il carico del server per verificare se è questo il caso.
Aggiorna a Clerk.js 2 #
Clerk.js 2 è una versione più veloce e flessibile della nostra libreria JavaScript.
Rende più semplice installare Clerk su qualsiasi webshop.
Tuttavia, poiché le due versioni funzionano in modo leggermente diverso, è necessario seguire questi passaggi per aggiornare correttamente.
Le due principali differenze in Clerk.js 2 sono che i Design in my.clerk.io utilizzano il linguaggio di templating Liquid, ma possono anche essere creati facilmente tramite il Design Editor.
Crea i design #
Poiché Clerk.js 2 adotta un approccio diverso ai Design, devi crearne di nuovi.
Puoi creare i Design di Clerk.js 2 in due modi:
Utilizza l’intuitivo Design Editor per creare nuovi Design, come descritto nei punti seguenti.
Converti i tuoi vecchi Design. Segui questa guida per vedere come fare.
Opzione Design Editor #
- Vai su my.clerk.io > Recommendations/Search > Designs > New Design.
Segui la procedura guidata di configurazione del design e seleziona il type del tuo design, dandogli un name (consigliamo di aggiungere “V2” per evidenziare che stai usando Clerk.js 2).
Nel Design Editor, clicca su uno degli elementi esistenti come il nome, immagine, pulsante ecc. per modificarlo, oppure aggiungi nuovi elementi al Design per fornire più informazioni sui prodotti.
Clicca su Publish Design quando hai finito e passa a Step 2 nella guida.
Vai su Recommendations/Search > Content e cambia il tuo Clerk Content in modo che usi il nuovo Design.
Clicca su Update Content. Questo farà sì che temporaneamente non vengano mostrati nel tuo webshop, finché non avrai completato Step 2. Scegli il nuovo Design per tutti i Content da aggiornare.
Ora sei pronto per passare a Clerk.js 2.
Attiva Clerk.js 2 #
Ora devi attivare Clerk.js 2 nell’app Dandomain Classic.
Accedi al backend di Dandomain Classic e vai su Clerk App nel menu laterale.
Sotto General, clicca e spunta la casella accanto a Brug Clerk.js 2 e poi clicca su Save:
Questa pagina è stata tradotta da un'utile intelligenza artificiale, quindi potrebbero esserci errori linguistici. Grazie per la comprensione.