FAQ

Sincronizzazione con HTTP Auth #

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

Questo bloccherà anche l’importatore Clerk e visualizzerà 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 su prodotto, categoria 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.

401 Errore del 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

403 Errore del 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 lingue diverse e ciascuno 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 controllare queste parti:

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

• Limite di frequenza per il server riguardo a cloudflare.

404 Errore del 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 impedisce l’inizializzazione del link

Prima assicurati di aver installato correttamente l’app.

Secondo, assicurati di svuotare la cache del tuo webshop prima di provare un nuovo import.

429 Errore del server: Troppe richieste #

Questo errore si verifica se il tuo server nega l’accesso all’importatore 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 della pagina su un valore più alto nell’importatore di Clerk.io, causando all’importatore di effettuare meno richieste, ma più grandi:

500 Errore interno del server #

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

In questi casi puoi controllare il tuo Registro del 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 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.

503 Errore del 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 si avvicina 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 fai clic su Nuovo Design:

1.2 Segui la procedura guidata di 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 utilizzando Clerk.js2).

1.3. Nell’Editor di Design, fai clic 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. Fai clic 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. Fai clic 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! Sei ora 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 fai clic e seleziona la casella accanto a Usa Clerk.js 2 e fai clic su Salva: