FAQ

Riscontri problemi con la tua 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 è spesso utilizzata su siti di staging per evitare visitatori indesiderati.

Questo bloccherà l’importatore di Clerk e mostrerà un errore 401 Unauthorized nel registro della 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 come segue:

https://USER:PASS@dandomain.clerk.io/api/6155349/28

Errori comuni di sincronizzazione #

Quando importi dati con la Dandomain App di Clerk, il server del tuo webshop è responsabile dell’invio dei dati di prodotto, categoria 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 l’ambiente di sviluppo richiede autenticazione HTTP per accedervi.

Si risolve inserendo Username 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, è sufficiente inserire nella whitelist l’indirizzo IP dell’importatore per consentirgli l’accesso.

L’ultimo indirizzo IP può essere trovato qui.

Verifica inoltre che la tua public key, private key e import URL siano corrette per il negozio su cui stai operando all’interno di my.clerk.io.

In alcuni casi (se utilizzi una versione più vecchia di Dandomain), questo errore verrà mostrato anche se stai usando diversi domini-lingua e ognuno ha ID differenti.

In tal caso, assicurati che gli ID di ogni negozio corrispondano a quelli presenti nel backend di Dandomain.

Cosa fare se ho già inserito nella whitelist ma si verifica ancora lo stesso errore?

Ci sono alcuni casi in cui hai già inserito l’indirizzo IP dell’importatore nella whitelist, ma l’errore persiste.

In questi casi, ti consigliamo di esaminare questi punti:

• La parte di autenticazione del corpo potrebbe essere rimossa dalla richiesta dal server del negozio.

• 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, succede perché l’app è:

• Non installata affatto

• Una cache causa la mancata inizializzazione del link

Prima di tutto, assicurati di aver installato correttamente l’app.

In secondo luogo, ricorda di svuotare la cache del tuo webshop prima di provare 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 arrivo.

Puoi risolvere aumentando il limite di richieste del server o impostando una Page Size più alta in my.clerk.io > Data > Configuration. Una dimensione pagina più elevata fa sì che l’importatore invii un numero minore di richieste, ma più grandi.

500 Internal Server Error #

Questo errore significa che il tuo server ha incontrato 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 si sia bloccato e perché.

Nella maggior parte dei casi, è semplicemente dovuto a un prodotto con un attributo non valido, o una funzione chiamata in modo errato nel webshop.

Se si verifica quest’ultimo caso, suggeriamo di contattare il nostro team di supporto tecnico per questa parte.

503 Service Unavailable #

Questo errore è solitamente temporaneo ed è causato dal server troppo occupato per gestire la richiesta.

Prova di nuovo 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 identificare se è questo il caso.

Passa 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 in Clerk.js 2 sono che i Design in my.clerk.io utilizzano il linguaggio di templating Liquid, ma possono anche essere facilmente creati utilizzando il Design Editor.

Crea i design #

Poiché Clerk.js 2 utilizza un approccio diverso ai Design, devi crearne di nuovi.

Puoi creare i tuoi Design di Clerk.js 2 in due modi:

• Utilizza il pratico 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 #

1. Vai su my.clerk.io > Recommendations/Search > Designs > New Design.

2. Segui la procedura guidata di configurazione e seleziona il tipo di design e inserisci un nome per il design (consigliamo di aggiungere “V2” per rendere evidente che stai utilizzando Clerk.js 2).

3. Nel Design Editor, clicca su uno degli elementi esistenti come nome, immagine, pulsante ecc. per modificarlo, oppure aggiungi nuovi elementi al Design per mostrare più informazioni sui prodotti.

4. Clicca su Publish Design quando hai terminato e passa a Step 2 della guida.

5. Vai su Recommendations/Search > Elements e cambia il tuo Clerk Element per utilizzare il nuovo Design.

6. Clicca su Update Element. Questo causerà temporaneamente la mancata visualizzazione nel tuo webshop, finché non completi anche Step 2. Scegli il nuovo Design per tutti gli Elements che devono essere aggiornati.

Ora sei pronto per passare a Clerk.js 2.

Attiva Clerk.js 2 #

Successivamente devi attivare Clerk.js 2 nell’app Dandomain Classic.

1. Accedi al backend di Dandomain Classic e vai all’App Clerk nel menu laterale.

2. Sotto General, clicca e seleziona la casella accanto a Brug Clerk.js 2 e clicca su Save: