FAQ

Riscontri problemi con la tua integrazione email? Questa FAQ copre i problemi più comuni e le relative soluzioni, dalle immagini bloccate ai problemi di caching.

Immagini prodotto bloccate #

Come probabilmente sai, i client email non supportano il tipico HTML/CSS/JS che funziona senza problemi su tutti i browser.

Per questo motivo, utilizziamo una soluzione alternativa per generare dinamicamente i consigli di prodotto Email.

Utilizziamo un motore di template web chiamato Jinja e, tramite questo, possiamo stampare dinamicamente tutti gli attributi e gli stili dei prodotti come semplici immagini con link.

Queste immagini verranno visualizzate nelle tue newsletter come consigli di prodotto.

Quindi, quando apri uno dei nostri contenuti Email, il nostro sistema richiama tutti i dati dei prodotti dal nostro database tranne uno: le immagini dei prodotti.

Quelle vengono prese in tempo reale dal tuo sito web.

Se il tuo server o servizio di hosting ha un firewall robusto, il nostro sistema potrebbe essere bloccato durante il recupero delle immagini dei prodotti e quindi generare consigli di prodotto senza le immagini dei prodotti.

Per evitare questo problema, devi fare quanto segue nelle impostazioni del tuo firewall:

1. Metti nella whitelist il nostro IP, che è disponibile qui.

2. Metti nella whitelist il nostro user-agent, che si chiama clerk-XYZ.

3. Metti nella whitelist il nostro user-agent Jinja, che si chiama webkit2png o wkhtmltoimage.

Queste tre impostazioni del firewall dovrebbero consentire al nostro sistema di recuperare e visualizzare correttamente le raccomandazioni Email.

Immagini non aggiornate #

Se le immagini aggiornate dei prodotti non vengono visualizzate nell’anteprima delle email o nelle email di prova, quasi sempre si tratta di un problema di cache.

Sono diversi i livelli che possono memorizzare in cache le immagini:

• La cache interna di Clerk che velocizza il caricamento degli Email Embeds. Questo solitamente non è il problema durante l’anteprima, poiché le immagini vengono memorizzate solo quando un vero indirizzo email fa parte del codice embed.

• La cache della tua piattaforma email (ad es. Brevo), che spesso causa immagini obsolete nelle anteprime o nelle email di prova.

• La cache del client email del destinatario, che in genere influenza l’anteprima di email già ricevute in passato.

Queste soluzioni di solito funzionano immediatamente:

1. Crea un nuovo Email Embed e utilizza quel codice embed nel tuo template email. Essendo nuovo, nessuno dei livelli di cache avrà ancora memorizzato le immagini. Puoi creare un nuovo embed seguendo la guida qui: /integrations/any-email/email-recs/.

2. Apporta una modifica non visuale al tuo Design (ad esempio, aggiungi una classe CSS extra senza stile) e salva nuovamente. Questo modifica il markup e spesso costringe la piattaforma email a recuperare immagini aggiornate.

Nota: Quando visualizzi l’anteprima senza un vero indirizzo email nel codice embed, Clerk generalmente non memorizza le immagini in cache. La maggior parte dei problemi relativi a immagini obsolete deriva dalla piattaforma email o dalla cache del client email del destinatario.