Embeds

Conceptos básicos #

Estos se utilizan para insertar recomendaciones directamente en cualquier Email en cualquier cliente de correo electrónico. Es la forma más sencilla y flexible de mejorar los flujos de correo electrónico existentes utilizando la IA de Clerk.

Primeros pasos #

Cuando abras por primera vez la página de Email Embeds, un asistente de configuración te guiará para crear embebidos siguiendo las mejores prácticas para los flujos de correo electrónico más comunes.

El asistente agrupa los embebidos por tipo de flujo de Email, lo que facilita seleccionar los que coinciden con la configuración de tu marketing por correo electrónico:

Selecciona los embebidos que deseas crear y haz clic en Create selected. Si aún no existe un diseño de correo, se creará automáticamente un diseño estándar que luego puedes personalizar en el Editor de diseños.

Alternativamente, haz clic en or create your own para configurar manualmente un embebido desde cero.

Las recomendaciones incrustadas en emails consisten en un Embed donde configuras el nombre, lógica de productos y otros ajustes, y un Design que controla el aspecto y estilo de las recomendaciones.

Una vez configurados tu Embed y Design, puedes simplemente copiar y pegar el embedcode en tu plataforma de correo, para mostrar los resultados en ese lugar.

Configuración #

Cada recomendación de Email embebida tiene varios ajustes que te permiten adaptarla a tu configuración específica.

Lógicas de producto #

Email incluye una amplia variedad de Product Logics que puedes usar para mostrar recomendaciones.

Van desde generales, como Best Sellers o Hot Products, hasta completamente personalizadas como Recommendations Based On Orders. Las lógicas de producto se configuran en la página de Embed de una recomendación de Email embebida.

Plataforma de E-mail #

Clerk tiene integraciones con una gran variedad de plataformas de correo electrónico. Para las recomendaciones embebidas, las integraciones se utilizan para obtener dos elementos específicos del cliente de Email, mediante merge tags:

• La dirección de correo electrónico del destinatario, para personalizar con lógicas de producto específicas.
• Un cachebuster que agrega un valor único a cada Email enviado, para evitar el almacenamiento en caché, lo que de otro modo mostraría los mismos productos en varios correos.

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

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

Argumentos extra #

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

Embedcode #

Cuando un usuario abre un Email que contiene un embedcode, se hace una solicitud a la API de Clerk para obtener los productos, que se renderizan a través del diseño que hayas configurado en un navegador sin interfaz, y se devuelven en forma de imagen para ser mostrada en el correo electrónico.

Estructura #

A continuación se muestra un ejemplo de embedcode que muestra 2 productos. Cada producto consiste en un enlace a la página del producto, y una imagen que muestra 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 enrutan 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 a mostrar en el Email.

Parámetros #

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

El cachebuster es necesario porque un solo embedcode de recomendaciones de Email puede usarse para mostrar productos en miles de correos, ya que simplemente realiza llamadas a la API de Clerk cada vez que el usuario abre el correo.

Como el enlace de la imagen permanece igual, muchos clientes de Email la almacenarán en caché y mostrarán los mismos productos en lugar de realizar nuevas peticiones API. El cachebuster garantiza que los clientes de Email vean cada correo como una solicitud única.

Seguimiento #

El rendimiento de las recomendaciones embebidas se rastrea a través de 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 ser editados para coincidir con el seguimiento deseado en Tracking Code bajo Insert into e-mail, mientras que los parámetros de Clerk se añaden automáticamente en la solicitud API a campaigns/click.

Los parámetros incluidos son: