Embeds

Fondamentali #

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

Le raccomandazioni email incorporate consistono in un Embed dove configuri nome, logica di prodotto e altre impostazioni, e un Design che controlla l’aspetto e la presentazione delle raccomandazioni.

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

Configurazione #

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

Logiche di prodotto #

Email offre un ampio set di Logiche di Prodotto che puoi utilizzare per mostrare raccomandazioni.

Vanno dalle più ampie, come Best Sellers o Hot Products, fino a soluzioni completamente personalizzate come Recommendations Based On Orders. Le Logiche di Prodotto vengono configurate nella pagina Embed di una raccomandazione email incorporata.

Piattaforma e-mail #

Clerk ha integrazioni con una vasta gamma di piattaforme e-mail. Per le raccomandazioni incorporate, le integrazioni vengono utilizzate per ottenere due informazioni specifiche dal client email, tramite merge tags:

• L’indirizzo email del destinatario, per personalizzare con logiche di prodotto specifiche.
• Un cachebuster che aggiunge un valore unico per ogni 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 tags vengono aggiunti automaticamente all’embedcode.

Se la tua piattaforma email non fa già parte dell’elenco delle integrazioni, scegli semplicemente Other e aggiungi manualmente i merge tags.

Argomenti extra #

Alcune logiche richiedono l’aggiunta di informazioni extra, come ID di categoria o parole chiave, che vengono inseriti 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, che vengono resi tramite il design configurato in un browser headless, e restituiti come immagine da visualizzare nell’email.

Struttura #

Di seguito un esempio di embedcode che mostra 2 prodotti. Ogni prodotto comprende un link alla pagina del prodotto e 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 verso la pagina prodotto.

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

Parametri #

Questi sono i punti dati utilizzati nelle chiamate API:

Il cachebuster è necessario, perché un singolo embedcode per raccomandazioni email 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 all’immagine resta lo stesso, molti client email lo memorizzano in cache e mostrano gli stessi prodotti invece di effettuare una nuova chiamata API. Il cachebuster garantisce che i client email vedano ogni email come una richiesta unica.

Tracciamento #

La performance delle raccomandazioni incorporate viene tracciata tramite parametri URL inclusi quando l’utente viene indirizzato alla pagina prodotto.

Struttura #

L’URL di destinazione include:

• Codici UTM per Google Analytics
• Parametri di tracciamento propri di Clerk identificati 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 in base al tipo di tracciamento che desideri 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: