FAQ

Sincronizzazione con HTTP Auth #

Spesso l’autenticazione HTTP è utilizzata sui siti di staging per evitare visitatori indesiderati.

Questo bloccherà anche l’importatore Clerk e mostrerà un errore 401 Non autorizzato nel registro di sincronizzazione.

Puoi facilmente verificare l’importatore inserendo le informazioni di autenticazione nell’URL di importazione come di seguito, in Data Sync su my.clerk.io:

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

Errori di sincronizzazione comuni #

Quando si importano dati con l’app DanDomain di Clerk.io, il server dei webshop è responsabile dell’invio dei dati sui prodotti, categorie e vendite a Clerk.io.

Tuttavia, in alcuni casi, la configurazione del server potrebbe impedire all’importazione di accedere, causando un errore in Data Sync.

Di seguito è riportato un elenco degli errori più comuni e come risolverli.

Errore 401 Server: Non autorizzato #

Questo errore si verifica se il tuo webshop/ambiente di sviluppo richiede autenticazione HTTP per accedervi.

Questo si risolve semplicemente inserendo il Nome utente e la Password come parte dell’URL di importazione:

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

Errore 403 Server: Vietato #

Questo errore si verifica se il tuo server blocca l’importatore dall’accesso. Nella maggior parte dei casi, è sufficiente aggiungere alla lista bianca l’indirizzo IP dell’importatore per dargli accesso.

L’ultimo indirizzo IP può essere trovato qui.

Controlla anche che la tua chiave pubblica, chiave privata e URL di importazione siano corretti per il negozio in cui stai operando su my.clerk.io

In alcuni casi (se sei su una versione più vecchia di dandomain), questo errore verrà mostrato anche se stai utilizzando domini di lingua diversi e ognuno ha ID diversi. In questo caso, assicurati che gli ID per ciascun negozio corrispondano a quelli nel tuo backend di dandomain.

E se ho già aggiunto alla lista bianca ma si verifica ancora lo stesso errore?

Ci sono alcuni casi in cui hai aggiunto alla lista bianca l’indirizzo IP dell’importatore e l’errore persiste, quindi ti consigliamo di esaminare queste parti:

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

• Limite di frequenza per il server riguardo a cloudflares.

Errore 404 Server: Non trovato #

Questo errore si verifica se l’importatore non è riuscito ad accedere al link che ci invia dati dal webshop. Nella maggior parte dei casi si verifica perché l’estensione è:

• Non installata affatto

• Una cache causa il mancato avvio del link

Prima assicurati di aver installato correttamente l’app.

In secondo luogo, assicurati di svuotare la cache del tuo webshop prima di provare un nuovo import.

Errore 429 Server: Troppe richieste #

Questo errore si verifica se il tuo server nega all’importatore l’accesso a causa di troppe richieste in arrivo.

Puoi risolvere questo impostando il limite di richiesta più alto per il tuo server o impostando la Dimensione Pagina a un valore più alto nell’importatore di Clerk.io, causando all’importatore di effettuare richieste più grandi e meno numerose:

Errore 500 Server interno #

Questo errore significa che il tuo server ha riscontrato un errore interno e non è stato in grado di specificare quale errore si sia verificato.

In questi casi puoi controllare il tuo Registro Server per identificare quale processo è andato in crash e perché. Nella maggior parte dei casi è semplicemente a causa di un prodotto con un attributo non valido, o di una funzione chiamata in modo errato nel webshop. Se si verifica quest’ultimo, ti suggeriamo di contattare il nostro team di supporto tecnico per questa parte.

Errore 503 Server: Servizio non disponibile #

Questo errore è solitamente temporaneo ed è causato dal server che è troppo occupato per gestire la richiesta. Riprova più tardi.

Se il problema continua a verificarsi, potrebbe significare che il server è sovraccarico di processi e vicino alla capacità massima.

Controlla il carico del server per identificare se questo è il caso.

Aggiornamento a Clerk.js 2 #

Clerk.js 2 è una versione più veloce e molto più flessibile della nostra libreria JavaScript che rende l’installazione di Clerk.io su qualsiasi webshop un gioco da ragazzi.

Tuttavia, poiché le due versioni funzionano in modo leggermente diverso, devi seguire questi passaggi per eseguire correttamente l’aggiornamento.

Le due principali differenze in Clerk.js 2 sono che i Design in my.clerk.io utilizzano il Liquid linguaggio di templating, ma possono anche essere facilmente creati utilizzando l’Editor di Design.

Passo 1: Conversione dei Design #

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

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

• 1. Usa l’intuitivo Editor di Design per creare nuovi Design, come descritto nei punti seguenti.

• 2. Converti i tuoi vecchi Design. Segui questa guida per vedere come farlo.

1.1 Inizia andando su my.clerk.io -> Raccomandazioni / Ricerca -> Design e clicca su Nuovo Design:

1.2 Segui la procedura guidata per la configurazione del design e seleziona il tuo tipo di design e dai un nome al tuo design (ti consigliamo di aggiungere " V2" in modo che sia ovvio che stai usando Clerk.js2).

1.3. Nell’Editor di Design, clicca su uno degli elementi esistenti come il nome, l’immagine, il pulsante, ecc. per modificarlo, o aggiungi nuovi elementi al Design per aggiungere ulteriori informazioni sui prodotti.

1.4. Clicca su Pubblica Design quando hai finito e vai al Passo 2 nella guida.

1.5. Infine, vai su Raccomandazioni / Ricerca -> Contenuto e cambia il tuo Clerk.io Contenuto per utilizzare il tuo nuovo Design.

1.6. Clicca su Aggiorna Contenuto. Questo causerà temporaneamente che non vengano visualizzati sul tuo webshop, fino a quando non avrai finito con il Passo 2. Scegli il nuovo Design per tutto il Contenuto che deve essere aggiornato.

1.9. Ecco! Ora sei pronto per passare a Clerk.js 2.

Passo 2: Passa a Clerk.js 2 nell’app DanDomain #

Successivamente, devi attivare Clerk.js 2 nell’app DanDomain Classic.

2.1. Accedi al tuo backend di DanDomain Classic e vai all’ App Clerk.io nel menu laterale.

2.2. Sotto Generale clicca e spunta la casella accanto a Usa Clerk.js 2 e clicca su Salva: