Embeds

Basi #

Questi vengono utilizzati per incorporare raccomandazioni direttamente in qualsiasi email, all’interno di qualsiasi client di posta elettronica. È il modo più semplice e flessibile per migliorare i flussi email esistenti utilizzando l’AI di Clerk.

Per iniziare #

Quando apri per la prima volta la pagina Email Embeds, un pratico wizard di configurazione ti guida nella creazione delle embed migliori per i flussi email più comuni.

Il wizard raggruppa le embed per tipo di flusso email, rendendo facile selezionare quelle che corrispondono alla tua configurazione di email marketing:

Seleziona le embed che vuoi creare e clicca su Create selected. Se non esiste ancora un design email, ne viene creato uno standard automaticamente che potrai personalizzare in seguito nel Design Editor.

In alternativa, clicca su or create your own per configurare manualmente un embed da zero.

Le raccomandazioni email incorporate sono costituite da un Embed in cui configuri nome, logica prodotto e altre impostazioni, e da un Design che controlla l’aspetto visivo delle raccomandazioni.

Una volta configurati Embed e Design, puoi semplicemente copiare e incollare l’embedcode nella tua piattaforma email per mostrare i risultati nella posizione desiderata.

Configurazione #

Ogni raccomandazione email incorporata ha una serie di impostazioni che ti permettono di adattarla alla tua specifica configurazione email.

Logiche prodotto #

Email offre una vasta gamma di Product Logics che puoi utilizzare per mostrare le raccomandazioni.

Vanno da logiche ampie, come Best Sellers o Hot Products, fino a opzioni completamente personalizzate come Recommendations Based On Orders. Le logiche prodotto si configurano nella pagina Embed di una raccomandazione email incorporata.

Piattaforma E-mail #

Clerk integra una vasta gamma di piattaforme e-mail. Per le raccomandazioni incorporate, le integrazioni vengono utilizzate per prelevare due informazioni specifiche dal client di posta elettronica, tramite merge tags:

• L’indirizzo email del destinatario, per la personalizzazione con logiche prodotto specifiche.
• Un cachebuster che aggiunge un valore univoco a ciascuna email inviata, per evitare la memorizzazione nella cache, che altrimenti mostrerebbe gli stessi prodotti in più email.

Scegliendo la tua piattaforma dall’elenco, questi merge tag vengono aggiunti automaticamente nell’embedcode.

Se la tua piattaforma email non è già presente nella lista delle integrazioni, seleziona semplicemente Other e aggiungi manualmente i merge tag.

Argomenti extra #

Alcune logiche richiedono di aggiungere informazioni extra, come ID di categoria o keyword, che vengono aggiunte nella scheda Insert into e-mail.

Embedcode #

Quando un utente apre un’email contenente un embedcode, viene effettuata una chiamata all’API di Clerk per recuperare i prodotti, i quali vengono resi attraverso il design che hai configurato in un browser headless, e restituiti come immagine da mostrare nell’email.

Struttura #

Di seguito un esempio di embedcode che mostra 2 prodotti. Ogni prodotto consiste in un link alla pagina del prodotto e in un’immagine che mostra il prodotto.

<center> 
    <a  class="clerk-email-product" 
        href="https://api.clerk.io/v2/campaigns/click?key=Ipkv9tKfxRdpLv3mpMhqxfWGNdqugE0c&embed=personalised-recommendations&email={{ email }}&n=0&v={% current_day %}{% current_month_name %}{% current_year %}&append=utm_source%3Dclerk%26utm_medium%3Demail%26utm_campaign%3Dpersonalised-recommendations%26utm_content%3Dclerk-recommendations&keywords=star%20wars" 
        target="_blank" 
        style="text-decoration: none; ">
        <img src="https://api.clerk.io/v2/campaigns/embed?key=Ipkv9tKfxRdpLv3mpMhqxfWGNdqugE0c&embed=personalised-recommendations&email={{ email }}&n=0&v={% current_day %}{% current_month_name %}{% current_year %}&append=utm_source%3Dclerk%26utm_medium%3Demail%26utm_campaign%3Dpersonalised-recommendations%26utm_content%3Dclerk-recommendations&keywords=star%20wars" />
    </a>
    <a  class="clerk-email-product" 
        href="https://api.clerk.io/v2/campaigns/click?key=Ipkv9tKfxRdpLv3mpMhqxfWGNdqugE0c&embed=personalised-recommendations&email={{ email }}&n=1&v={% current_day %}{% current_month_name %}{% current_year %}&append=utm_source%3Dclerk%26utm_medium%3Demail%26utm_campaign%3Dpersonalised-recommendations%26utm_content%3Dclerk-recommendations&keywords=star%20wars" 
        target="_blank" 
        style="text-decoration: none; ">
        <img src="https://api.clerk.io/v2/campaigns/embed?key=Ipkv9tKfxRdpLv3mpMhqxfWGNdqugE0c&embed=personalised-recommendations&email={{ email }}&n=1&v={% current_day %}{% current_month_name %}{% current_year %}&append=utm_source%3Dclerk%26utm_medium%3Demail%26utm_campaign%3Dpersonalised-recommendations%26utm_content%3Dclerk-recommendations&keywords=star%20wars" />
    </a>
</center>

I link utilizzano chiamate a campaigns/click che instradano il cliente attraverso il sistema di tracciamento di Clerk e poi alla pagina del prodotto.

Le immagini utilizzano chiamate a campaigns/embed che restituiscono l’immagine da visualizzare nell’email.

Parametri #

Questi sono i dati utilizzati nelle chiamate API:

Il cachebuster è necessario perché un singolo embedcode per raccomandazioni e-mail può essere usato per mostrare prodotti in migliaia di email, poiché effettua semplici chiamate API a Clerk quando l’email viene aperta da un utente.

Poiché il link dell’immagine rimane lo stesso, molti client di posta elettronica lo memorizzano nella cache e mostrano sempre gli stessi prodotti invece di effettuare una nuova chiamata API. Il cachebuster assicura che i client e-mail vedano ogni email come una richiesta unica.

Tracciamento #

Le prestazioni delle raccomandazioni incorporate vengono tracciate tramite i parametri URL inclusi quando l’utente viene indirizzato alla pagina prodotto.

Struttura #

L’URL di destinazione include:

• Codici UTM di Google Analytics
• Parametri di tracciamento propri di Clerk riconosciuti da Clerk.js.

Ecco un esempio di URL:

https://www.theschwartz.com/?utm_source=clerk&utm_medium=email&utm_campaign=personalised-recommendations&utm_content=clerk-recommendations&clerk_product=28081&clerk_labels=Personalised+Recommendations&clerk_api=recommendations%2Akeywords&clerk_n=0&clerk_external=1&clerk_email=gAAAAABnoLO_YDvTRvfT4ed8pRIYjqQzo38JtrdwRIM-VYDuJO8awxImzfgDB3M-Jfr29WUoayvYNV4XxqixK3-bvukeYy6uDEgRfvuomLxhpVLVn6xoUPk%3D

Parametri #

I parametri UTM per Google Analytics possono essere modificati per adattarsi al tracciamento desiderato in Tracking Code sotto Insert into e-mail, mentre i parametri Clerk vengono aggiunti automaticamente nella richiesta API a campaigns/click.

I parametri inclusi sono: