Analisi degli errori di interfaccia delle interfacce CleverReach

Stiamo sviluppando continuamente plugin e interfacce per collegare un sistema esterno (ad esempio CRM, CMS o sistemi di negozio) al nostro strumento di email marketing CleverReach. I nostri plugin vi permettono di stabilire rapidamente una connessione tra i due sistemi in pochi passi e di iniziare il vostro email marketing. I nostri plugin sono tutti gratuiti (tranne PrestaShop) e vengono aggiornati regolarmente.

Questo post del centro assistenza serve esclusivamente per l'analisi dei messaggi di errore dei plugin CleverReach per Shopware 5, Shopware 6, WordPress, WooCommerce, Typo3, Joomla!, Zapier, lexoffice, OpenCart, Prestashop, Magento 2, Shopify, XTCommerce, BigCommerce, Ecwid, ZohoCRM, Drupal e Oxid. 

Altri plugin sono offerti da fornitori esterni. In caso di messaggi di errore, rivolgersi allo sviluppatore o al fornitore del rispettivo plugin. Saranno in grado di aiutarvi il più rapidamente possibile. Grazie in anticipo.

Iniziamo questo post fornendovi una lista di controllo dei criteri più importanti per voi, dopodiché elencheremo i messaggi di errore più comuni e risponderemo alle domande più frequenti. Nel caso in cui il nostro elenco non risolva il vostro problema, o abbiate problemi o domande diverse, vi forniamo un elenco di note e dati di contatto alla fine del post.

Lista di controllo

1. Stai utilizzando l'ultima versione del plugin?

È sempre possibile trovare l'ultima versione del plugin direttamente nel gestore dei plugin, cercando "CleverReach".

2. Il plugin è collegato e attivato?

Assicurarsi che il plugin sia collegato correttamente al proprio account. Andare al plugin nella Gestione plugin. Se si riceve una nota in cui si dice che è necessario collegare il plugin al proprio account, significa che non è ancora collegato. Stabilire una connessione con il plugin. Controllare anche che il plugin sia attivato nella Gestione plugin.  

3. Dati del conto

Avete inserito tutti i dati del vostro account tramite l'icona del profilo >[Il mio account -> Impostazioni -> I miei dati]

È possibile stabilire una connessione corretta solo dopo aver inserito tutti i dati.

4. Accesso API per l'utente

Avete attivato l'accesso "REST API" per l'utente che si connette a CleverReach tramite il plugin? Le istruzioni sono disponibili qui.

5. Restrizioni di accesso

Il negozio deve essere direttamente accessibile via Internet. Non deve essere attivo alcun HTACCESS che limiti l'accesso al negozio o al plugin.

Assicurarsi che tutti i file del plugin abbiano le autorizzazioni generali per l'invio e la ricezione dei dati da parte del plugin. 

6. Requisiti tecnici

Il negozio o il server deve essere in grado di elaborare ed eseguire CURL. 

Il browser con cui si cerca di connettersi deve essere l'ultima versione di Chrome o Firefox. 

Messaggi di errore comuni

"Richiesta errata: superato il numero massimo di attributi":

Sono stati creati troppi campi dati nel vostro account CleverReach. È possibile creare un massimo di 45 campi dati. Il plugin crea automaticamente 17 campi di dati durante la sincronizzazione iniziale, ad esempio nome e cognome, indirizzo, ecc.

Eliminate dal vostro account CleverReach i campi dati non compilati o non più necessari. Il messaggio di errore dovrebbe poi scomparire.

"(InitialSyncTask) non è riuscito a causa del prolungato periodo di inattività":

La sincronizzazione richiede più tempo del previsto. Ad esempio, può essere utile aumentare il timeout del negozio.

  1. Regolare la configurazione PHP (file php.ini) sul server del negozio.
    1. Impostare la variabile max_execution_time a 300 (5 minuti),
    2. poi impostare la variabile PHP max_input_vars a 10000
    3. e poi avviare nuovamente l'importazione iniziale

"Impossibile determinare l'URL corretto. Negozio non configurato correttamente o plugin non attivo!".

Questo messaggio di errore indica che l'URL del negozio e l'URL di configurazione del negozio non sono identici.

Andate nelle Impostazioni del vostro negozio e date un'occhiata all'URL del negozio, confrontandolo con quello visualizzato nella barra degli indirizzi del vostro browser. Gli URL devono essere gli stessi.  

Nel caso in cui non siano identici, accedere dall'URL fornito nella configurazione del negozio.

Domande frequenti

Domanda: Non tutti i miei destinatari vengono trasferiti. Cosa posso fare?

Risposta: Dipende dalla versione del plugin. L'ultima versione dei nostri plugin trasferisce tutti i destinatari come destinatari attivi, se sono iscritti alla newsletter nel vostro sistema, compreso il Double Opt in.

Anche tutti gli altri destinatari - acquirenti ecc. - vengono trasferiti a CleverReach come destinatari attivi quando si utilizzano i nostri plugin v3.

Domanda: Abbiamo enormi problemi di prestazioni quando utilizziamo il plugin CleverReach Shopware. Le prestazioni del negozio sono estremamente lente. Perché?

Risposta: Il motivo più probabile per cui il vostro negozio è più lento del solito può essere dovuto al controllo asincrono del nostro plugin. Ogni 5 secondi, il sistema controlla se è necessario trasferire nuovi dati del destinatario, ordini, etichette, ecc.

In questo modo garantiamo la sincronizzazione in tempo reale nel nostro plugin. Ad esempio, se utilizzate la nostra automazione di marketing e volete attivare un'automazione dopo che un cliente si è iscritto o ha acquistato qualcosa, la sincronizzazione live è molto importante per inviare immediatamente un'e-mail.

Il plugin CleverReach svolge la maggior parte delle attività in background. Per rilevare e avviare le attività in background, il plugin CleverReach simula i processi a lunga durata (in background) chiamando in modo asincrono le "richieste web dei lavoratori in background" con un ritardo minimo di 5 secondi tra due chiamate consecutive.

Ciò significa che il plugin invia le richieste web (cioè l'URL del frontend) a se stesso ogni 5 secondi. Se lo desiderate, possiamo anche aumentare questo periodo a qualsiasi intervallo di tempo, ma questo significherebbe che le modifiche nel negozio necessitano di un certo tempo (intervallo di tempo che il cliente desidera impostare) per essere trasferite a CleverReach.

L'intervallo di tempo di 5 secondi è il valore predefinito per tutti i nostri clienti (poiché vogliamo trasferire i dati a CleverReach non appena appaiono nel negozio). Se desiderate personalizzare il periodo o possiamo farlo per voi, non esitate a inviarci un'e-mail o una richiesta con tutte le informazioni descritte di seguito. Grazie in anticipo.

Domanda: La connessione tra il plugin e CleverReach non funziona.

Possibile risposta: Se si utilizza un'autorizzazione aggiuntiva (htaccess) sul proprio server, è necessario rendere pubblicamente accessibili gli URL del plugin CleverReach. I seguenti URL devono essere accessibili da Internet quando si utilizza Shopware 5, ad esempio:

{shop_url}/CleverReachAsyncProcess/run

{shop_url}/CleverReachAuth/redirectCallback

{shop_url}/CleverReachAutomationEventsController/handle

{shop_url}/CleverReachBlogSearch/search

{shop_url}/CleverReachFormEventsController/webhookHandle

{shop_url}/CleverReachForms/form

{shop_url}/CleverReachProductSearch/search

{shop_url}/CleverReachReceiverEventsController/webhookHandle

{shop_url}/CleverReachSearch/productSearch

{shop_url}/CleverReachWebhooks/processWebhookRequest

 

Per ogni integrazione, gli URL sono diversi. Se utilizzate un'integrazione diversa, contattateci come sotto indicato, in modo da potervi inviare gli URL appropriati. Grazie mille in anticipo.

Domanda: L'autoconfigurazione non è riuscita.

Risposta: L'autoconfigurazione viene eseguita quando il modulo viene aperto per la prima volta (dopo l'installazione). Controlla le configurazioni del negozio esistenti e cerca di effettuare una chiamata interna per impostare correttamente le impostazioni del plugin o del negozio.

Questo processo serve a determinare la configurazione ottimale del plugin e a garantirne la successiva usabilità.

Queste configurazioni vengono poi salvate e utilizzate per tutte le chiamate al processo asincrono del plugin.

Se il sistema rileva che qualcosa non va con i processi in background e l'esecuzione dei task, il sistema deve prendere i parametri URL predefiniti del negozio e provare a eseguire la chiamata di test asincrona con la configurazione di sistema predefinita. Se la chiamata non riesce, il sistema deve ripetere il test con tutte le combinazioni delle seguenti opzioni:

  1. Cambiare il protocollo di chiamata da HTTP a HTTPS e viceversa, a seconda di quello utilizzato di default.
  2. Aumenta il timeout di una chiamata asincrona, poiché alcuni sistemi non accettano un timeout di cURL inferiore a un secondo.
  3. Impostare/ripristinare l'opzione per seguire i reindirizzamenti 301/302.
  4. Utilizzare le opzioni di risoluzione IPv4 o IPv6.
  5. Quando tutte le opzioni sono state eseguite e salvate con successo, si verrà reindirizzati alla selezione dell'importazione del destinatario.

Se il plugin o voi stessi non riuscite a modificare le impostazioni del negozio, contattate il nostro servizio di assistenza. Grazie in anticipo.

Continuate a ricevere messaggi di errore o diversi da quelli del nostro elenco? Oppure volete contattare il nostro team di assistenza?

Per analizzare meglio il vostro caso, inviateci una descrizione dettagliata dell'errore. Potete anche inviarci degli screenshot che visualizzino l'errore.

Per un'analisi dettagliata, inviateci anche l'URL del vostro backend e un nome utente e una password. Inoltre, abbiamo bisogno dei dati di accesso FTP del vostro server per poter eseguire l'analisi in modo rapido e corretto.

Prima di accedere al software esterno, chiediamo di confermare la clausola di esclusione di responsabilità di cui sotto. A tal fine, è sufficiente un'e-mail dell'amministratore dell'account CleverReach o del titolare dell'account:

Prendo atto delle seguenti informazioni:

"Riconosco che CleverReach® deve solo un supporto via e-mail secondo le CGC. L'accesso al mio sistema è un servizio volontario che va oltre il contratto. Questo processo è un rapporto di cortesia in senso stretto, per il quale CleverReach non si assume alcuna responsabilità.per il quale CleverReach non si assume alcuna responsabilità".

Inviate un'e-mail con tutti i dettagli a support@cleverreach.com. Il nostro servizio di assistenza sarà lieto di aiutarvi nel miglior modo possibile. Grazie in anticipo.