Embeds

Conceptos básicos #

Estos se utilizan para insertar recomendaciones directamente en cualquier email dentro de cualquier cliente de correo electrónico. Es la forma más fácil y flexible de mejorar los flujos de correo existentes utilizando la IA de Clerks.

Las recomendaciones incrustadas en emails constan de un Embed donde configuras el nombre, la lógica de productos y otras configuraciones, y un Design que controla el aspecto y la sensación de las recomendaciones.

Una vez que hayas configurado tu Embed y Design, simplemente puedes copiar y pegar el embedcode en tu plataforma de mail para mostrar los resultados en esa ubicación.

Configuración #

Cada recomendación incrustada en email tiene una serie de ajustes que te permiten adaptarla a tu configuración de correo única.

Lógicas de productos #

Email viene con una amplia gama de Product Logics que puedes usar para mostrar recomendaciones.

Estas van desde opciones amplias, como Best Sellers o Hot Products, hasta completamente personalizadas como Recommendations Based On Orders. Las Product Logics se configuran en la página de Embed de una recomendación de email incrustada.

Plataforma de e-mail #

Clerk tiene integraciones con una amplia gama de plataformas de correo electrónico. Para las recomendaciones incrustadas, las integraciones se usan para extraer dos piezas específicas de información del cliente de correo, a través de merge tags:

• La dirección de email del destinatario, para personalizar con lógicas de producto específicas.
• Un cachebuster que añade un valor único para cada email enviado, para evitar el caché, lo que de lo contrario mostraría los mismos productos en múltiples correos.

Al elegir tu plataforma de la lista, estas merge tags se añaden automáticamente al embedcode.

Si tu plataforma de correo electrónico no está ya en la lista de integraciones, simplemente elige Other y añade las merge tags manualmente.

Argumentos adicionales #

Algunas lógicas requieren que añadas información extra, como IDs de categoría o palabras clave, que se agregan en la pestaña Insert into e-mail.

Embedcode #

Cuando un usuario abre un email que contiene un embedcode, se hace una llamada a la API de Clerk para obtener los productos, que son renderizados a través del diseño que has configurado en un navegador headless, y devueltos como una imagen para ser mostrados en el email.

Estructura #

A continuación se muestra un ejemplo de un embedcode mostrando 2 productos. Cada producto consiste en un enlace a la página del producto, y una imagen mostrando el producto.

<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>

Los enlaces utilizan llamadas a campaigns/click que redirigen al cliente a través del sistema de seguimiento de Clerk y luego a la página del producto.

Las imágenes utilizan llamadas a campaigns/embed que devuelven la imagen que se mostrará en el correo.

Parámetros #

Estos son los datos utilizados en las llamadas a la API:

El cachebuster es necesario porque un solo embedcode de recomendaciones en email puede usarse para mostrar productos en miles de emails, ya que simplemente hace llamadas a la API de Clerk cuando el usuario abre el correo.

Como el enlace de la imagen permanece igual, muchos clientes de correo la almacenarán en caché y mostrarán los mismos productos en vez de hacer una nueva llamada a la API. El cachebuster asegura que los clientes de email vean cada correo como una solicitud única.

Seguimiento #

El rendimiento de las recomendaciones incrustadas se rastrea mediante los parámetros de URL incluidos cuando el usuario es redirigido a la página del producto.

Estructura #

La URL de destino incluye:

• Códigos UTM de Google Analytics
• Parámetros de seguimiento propios de Clerk, identificados por Clerk.js.

Aquí tienes un ejemplo de 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

Parámetros #

Los parámetros UTM para Google Analytics pueden ajustarse para que coincidan con el seguimiento que quieres en Tracking Code bajo Insert into e-mail, mientras que los parámetros de Clerk se agregan automáticamente en la solicitud API a campaigns/click.

Los parámetros incluidos son: