Sincronizzazione con HTTP Auth #
Spesso l’autenticazione HTTP viene utilizzata sui siti di staging per evitare visitatori non invitati.
Questo bloccherà anche l’importatore Clerk e visualizzerà un errore 401 Unauthorized nel log di sincronizzazione.
È possibile verificare facilmente l’importatore inserendo le informazioni di autenticazione nell’URL di importazione come di seguito, in Data Sync a my.clerk.io:
https://USER:OASS@dandomain.clerk.io/api/6155349/28
Errori comuni di sincronizzazione #
Quando si importano i dati con l’App DanDomain di Clerk.io, il server del webshop è responsabile dell’invio dei dati relativi alle categorie di prodotti e alle vendite a Clerk.io..
Tuttavia, in alcuni casi, la configurazione del server potrebbe impedire l’accesso all’importazione, causando un errore in Data Sync.
Di seguito è riportato un elenco degli errori più comuni e di come risolverli.
401 Errore del server: Non autorizzato #
Questo errore si verifica se il vostro webshop/ambiente di sviluppo richiede l’autenticazione HTTP per accedervi.
Per risolvere questo problema è sufficiente inserire Nome utente e 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 server blocca l’accesso all’importatore. Nella maggior parte dei casi è sufficiente inserire nella whitelist l’indirizzo IP dell’importatore per consentirgli l’accesso.
L’indirizzo IP più recente [può essere trovato qui] (http://help.clerk.io/it/platform/data/sync/#whitelisting-the-importer-ip-address).
Verificare anche che la chiave pubblica, la chiave privata e l’url di importazione siano corretti per il negozio che si sta gestendo all’interno di my.clerk.io
In alcuni casi (se si utilizza una versione precedente di dandomain), questo errore viene visualizzato anche se si utilizzano domini di lingue diverse e ognuno ha ID diversi. In questo caso, assicuratevi che gli ID di ciascun negozio corrispondano a quelli del vostro backend dandomain.
**Cosa succede se ho già effettuato la whitelist ma si verifica ancora lo stesso errore?
Ci sono alcuni casi in cui l’indirizzo IP dell’importatore è stato inserito nella whitelist e l’errore persiste:
La parte di autenticazione del corpo può essere rimossa dalla richiesta del server del negozio.
Limite di velocità del server per quanto riguarda cloudflares.
404 Errore del server: Non trovato #
Questo errore si verifica se l’importatore non è riuscito ad accedere al link che ci invia i dati dal negozio web. Nella maggior parte dei casi accade perché l’estensione è o:
Non è installata affatto
Una cache impedisce l’inizializzazione del collegamento
Assicurarsi innanzitutto di aver installato correttamente l’app.
In secondo luogo, assicurarsi di svuotare la cache del webshop prima di provare una nuova importazione.
429 Errore del server: Troppe richieste #
Questo errore si verifica se il server nega l’accesso all’importatore a causa di un numero eccessivo di richieste in entrata.
È possibile risolvere il problema impostando un limite di richieste più alto per il proprio server o impostando Page Size su un valore più alto nell’importatore di Clerk.io, in modo che l’importatore faccia un numero minore di richieste più grandi:
500 Errore interno del server #
Questo errore significa che il vostro server ha riscontrato un errore interno e non siete stati in grado di specificare quale errore si sia verificato.
In questi casi è possibile controllare il registro del server per identificare quale processo si è bloccato e perché. Nella maggior parte dei casi si tratta semplicemente di un prodotto con un attributo non valido o di una funzione chiamata in modo errato nel webshop. Se si verifica la seconda ipotesi, si consiglia di contattare il nostro team di assistenza tecnica per questa parte.
###3 Errore del server: Servizio non disponibile
Questo errore è solitamente temporaneo ed è causato dal fatto che il server è troppo occupato per gestire la richiesta. Riprovare più tardi.
Se il problema continua a verificarsi, potrebbe significare che il server è sovraccarico di processi ed è vicino alla capacità massima.
Controllate il carico del server per verificare 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 negozio web un gioco da ragazzi.
Tuttavia, poiché le due versioni funzionano in modo leggermente diverso, è necessario seguire i seguenti passaggi per eseguire correttamente l’aggiornamento.
Le due differenze principali in Clerk.js 2 sono che i progetti in my.clerk.io utilizzano il Liquid linguaggio di template, ma possono anche essere facilmente creati utilizzando l’Editor di progetti.
Passo 1: Conversione dei progetti #
Poiché Clerk.js 2 ha un approccio diverso ai disegni, è necessario crearne di nuovi.
È possibile creare i progetti di Clerk.js 2 in due modi:
1. Utilizzando l’intuitivo Editor di progetti per creare nuovi progetti, come descritto nei punti seguenti.
2. Convertire i vecchi progetti. [Seguire questa guida per vedere come fare].(http://help.clerk.io/it/integrations/any-webshop/faq/#converting-designs-for-clerkjs-2)
1.1 Iniziare andando su my.clerk.io -> Raccomandazioni / Ricerca -> Disegni e fare clic su Nuovo disegno:
1.2 Seguire la procedura guidata di impostazione del progetto e selezionare il tipo di progetto e assegnare al progetto un nome (si consiglia di aggiungere " V2" in modo che sia evidente che si sta utilizzando Clerk.js2).
1.3. Nell’Editor del disegno, fare clic su uno qualsiasi degli elementi esistenti, come il nome, l’immagine, il pulsante ecc. per modificarlo o aggiungere nuovi elementi al disegno per aggiungere ulteriori informazioni sui prodotti.
1.5. Infine, andare su Recommendations / Search -> Content e modificare il contenuto di Clerk.io per utilizzare il nuovo progetto.
1.6. Fare clic su Aggiornamento dei contenuti, in modo che non vengano temporaneamente visualizzati nel negozio web, fino a quando non si è terminato il Fase 2 Scegliere il nuovo design per tutti i contenuti che devono essere aggiornati.
1.9. Ecco fatto! Ora siete pronti per passare a Clerk.js 2.
Passo 2: Passare a Clerk.js 2 nell’app DanDomain #
Successivamente è necessario attivare Clerk.js 2 nell’app DanDomain Classic.
2.1. Accedere al backend di DanDomain Classic e andare all’applicazione Clerk.io nel menu laterale.
2.2. In Generale fare clic e selezionare la casella accanto a Brug Clerk.js 2 e fare clic su Salva:
