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 #
Quando importi dati con l’App Clerk per Dandomain, il server del tuo webshop è responsabile dell’invio di dati su prodotti, categorie e vendite a Clerk.
Tuttavia, in alcuni casi la configurazione del server può 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 Nome utente e Password come parte dell’URL di importazione:
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, basta autorizzare l’indirizzo IP dell’importatore per consentirgli l’accesso.
L’ultimo indirizzo IP può essere trovato qui.
Controlla anche che il tuo public key, private key e import URL siano corretti per lo shop che stai gestendo dentro my.clerk.io.
In alcuni casi (se utilizzi una versione Dandomain più vecchia), questo errore viene riscontrato anche se utilizzi differenti domain-lingua con ID diversi.
In questo caso, assicurati che gli ID per ogni negozio corrispondano a quelli presenti nel backend di Dandomain.
Cosa succede se ho già autorizzato ma l’errore persiste?
Ci sono alcune situazioni in cui hai autorizzato l’indirizzo IP dell’importatore, ma l’errore persiste comunque.
In questi casi, consigliamo di controllare questi punti:
La parte di autenticazione del corpo potrebbe essere rimossa dalla richiesta dal server dello shop.
Limitazione della velocità per il server relativa 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ò avviene perché l’app è:
Non installata affatto
Una cache fa sì che il link non venga inizializzato
Innanzitutto, assicurati di aver installato correttamente l’app.
In secondo luogo, svuota la cache del tuo webshop prima di tentare una nuova importazione.
429 Too Many Requests #
Questo errore si verifica se il tuo server nega l’accesso all’importatore a causa di troppe richieste in entrata.
Puoi risolverlo impostando il limite di richieste più alto per il tuo server o impostando la Page Size a un valore maggiore in my.clerk.io > Data > Configuration, così l’importatore farà 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 Server Log per identificare quale processo sia andato in crash e perché.
Nella maggior parte dei casi, la causa è semplicemente un prodotto con un attributo non valido o una funzione chiamata in modo errato nel webshop.
Se si verifica quest’ultima situazione, suggeriamo di contattare il nostro team di supporto tecnico per questo aspetto.
503 Service Unavailable #
Questo errore è di solito temporaneo e causato dal fatto che il server è troppo occupato per gestire la richiesta.
Riprovare più tardi.
Se il problema persiste, potrebbe significare che il server è sovraccaricato di processi ed è vicino alla sua capacità massima.
Controlla il carico del server per identificare se questa è la causa.
Aggiorna a Clerk.js 2 #
Clerk.js 2 è una versione più veloce e flessibile della nostra libreria JavaScript.
Rende più semplice l’installazione di Clerk su qualsiasi webshop.
Tuttavia, dato che le due versioni funzionano in modo leggermente diverso, è necessario seguire questi passaggi per aggiornare con successo.
Le due principali differenze di Clerk.js 2 sono che i Designs in my.clerk.io utilizzano il linguaggio di templating Liquid, ma possono essere facilmente creati anche utilizzando il Design Editor.
Creare Designs #
Poiché Clerk.js 2 utilizza un approccio diverso ai Designs, è necessario crearne di nuovi.
Puoi creare i tuoi Designs per Clerk.js 2 in due modi:
Usa l’intuitivo Design Editor per creare nuovi Designs, come descritto nei seguenti punti.
Converti i tuoi vecchi Designs. Segui questa guida per scoprire come fare.
Opzione Design Editor #
- Vai su my.clerk.io > Recommendations/Search > Designs > New Design.
Segui la procedura guidata di impostazione e seleziona il tipo di design e attribuisci un nome al design (consigliamo di aggiungere “V2” così è chiaro che stai usando Clerk.js 2).
Nel Design Editor, clicca su uno degli elementi esistenti come nome, immagine, pulsante ecc. per modificarlo oppure aggiungi nuovi elementi al Design per includere più informazioni sui prodotti.
Clicca su Publish Design quando hai finito e passa al Step 2 della guida.
Vai su Recommendations/Search > Elements e modifica il tuo Clerk Element per utilizzare il nuovo Design.
Clicca su Update Element. Questo causerà temporaneamente la loro scomparsa dal tuo webshop fino al completamento dello Step 2. Scegli il nuovo Design per tutti gli elementi da aggiornare.
Ora sei pronto per passare a Clerk.js 2.
Attiva Clerk.js 2 #
Successivamente devi attivare Clerk.js 2 nell’app Dandomain Classic.
Accedi al backend del tuo Dandomain Classic e vai all’App Clerk nel menu laterale.
Sotto General, clicca e seleziona 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.