Personyze Wiki Personyze Wiki docs
Español
  • English
  • Español
  • Français
  • Deutsch
  • Italiano
  • Nederlands
  • Português
  • Polski
  • 日本語
  • العربية
Open Personyze
Documentación/ Campañas de email/ Obtener el código para insertar recomendaciones en emails de terceros
Campañas de email

Obtener el código para insertar recomendaciones en emails de terceros

Recomendaciones de productos que se actualizan solas en el momento de apertura, con un solo fragmento de HTML en Mailchimp, Klaviyo, HubSpot, ActiveCampaign, Brevo o Constant Contact.

18 min read Actualizado hace 2 horas

Su plataforma de email es estupenda enviando. Pero ¿y si las recomendaciones de productos de cada email se actualizaran solas en tiempo real, mostrando a cada destinatario exactamente lo que tiene más probabilidades de comprar, según su comportamiento más reciente, en el momento en que abre el email?

Eso es lo que hace la personalización de email en el momento de apertura de Personyze. Funciona colocando un solo fragmento de HTML en cualquier plantilla de campaña, sea cual sea su plataforma de email. Esta guía recorre todo el proceso para Mailchimp, Klaviyo, HubSpot, ActiveCampaign, Brevo y Constant Contact.

Cómo funciona la personalización en el momento de apertura

Los bloques de producto tradicionales del email fijan el contenido en el momento del envío: todos los destinatarios reciben lo mismo. El enfoque de Personyze es distinto: usted incrusta un fragmento de HTML una sola vez dentro de la plantilla de su campaña. Cada vez que un cliente abre ese email, el fragmento llama a Personyze en vivo, identifica al destinatario y muestra en ese mismo momento una imagen de recomendación personalizada.

De la compra al email personalizado: el flujo

  1. Personyze registra la compra en vivo — su sitio dispara un evento purchase con los detalles del pedido hacia Personyze.
  2. Su plataforma de email envía la confirmación del pedido con el fragmento de Personyze incrustado como etiquetas de imagen.
  3. El cliente abre el email — su cliente de correo pide las URL de las imágenes a Personyze.
  4. Personyze genera las imágenes personalizadas al vuelo — a partir del perfil de comportamiento de cada destinatario y de su catálogo de productos en vivo.

Funciona con cualquier plataforma de email.El fragmento es HTML puro: etiquetas <img> que apuntan a URL de Personyze. Funciona cualquier plataforma de email que le permita colocar HTML propio: Mailchimp, Klaviyo, HubSpot, ActiveCampaign, Brevo, Constant Contact, Campaign Monitor, Salesforce Marketing Cloud y más.

Requisitos previos

  • Una cuenta activa de Personyze con las recomendaciones por email habilitadas en su plan
  • Acceso a su plataforma de email con permiso para editar el HTML de las campañas
  • Un catálogo de productos listo para subir, o uno ya sincronizado en Personyze
  • El script de seguimiento de Personyze instalado en su sitio web, para los datos de comportamiento

¿Ya usa Personyze en el sitio?Si tiene recomendaciones funcionando en el sitio, su catálogo está cargado y el seguimiento de interacciones está activo. Sáltese los pasos 1 y 2 y vaya directamente a construir su widget de email.

Paso 1 — Suba su catálogo de productos

Personyze usa una única base de datos de productos unificada. Si ya ha subido productos para las recomendaciones en el sitio, sáltese este paso por completo. Si no, vaya a Configuración → Catálogo de productos y elija uno de estos tres métodos de sincronización:

Subida de CSVExporte su feed de productos desde Shopify, WooCommerce o Magento y súbalo directamente. Obligatorios: product_id, name, price, image_url, product_url. Recomendados: category, brand, availability.
Feed XML / JSON (sincronización automática)Indique la URL de un feed; el formato XML de Google Shopping funciona de forma nativa. Personyze lo sincroniza automáticamente cada hora, cada día o cada semana. Imprescindible para mantener la disponibilidad y los precios al día en el momento de apertura del email.
Integración por APIEnvíe los productos de forma programática desde su backend mediante la API de catálogo de Personyze. Lo mejor para catálogos grandes o para un inventario exacto en tiempo real.

Mantenga su catálogo actualizado.Las recomendaciones se generan en el momento de apertura. Un producto que aparece como disponible y en realidad está agotado es una experiencia frustrante: configure la sincronización programada del feed siempre que pueda.

Paso 2 — Configure el seguimiento de interacciones con productos

Personyze capta los datos de comportamiento mediante eventos de interacción con productos —vistas, añadidos al carrito y compras— disparados desde su sitio web. Si Personyze ya funciona en el sitio, esto ya está hecho.

Instale la etiqueta de Personyze

Añada el script de seguimiento de Personyze al <head>de su sitio. Encontrará su fragmento único en Configuración → Código de seguimiento. Tiene este aspecto:

<script>
window._S_T || function(s) {
  s.async = true;
  s.src = '//counter.personyze.com/stat-track-lib.js';
  s.onload = function() {
    _S_T.async = true;
    _S_T.setup(YOUR_ACCOUNT_ID, "your-domain.com");
  };
  (document.querySelector('head') || document.documentElement).appendChild(s);
}(document.createElement('script'))
</script>

Dispare eventos de vista de producto

En cada ficha de producto, dispare un evento product_view para que Personyze pueda construir perfiles de comportamiento. Es lo que impulsa el algoritmo de recomendaciones personalizadas en el email:

window.personyze = window.personyze || [];
window.personyze.push(['trackEvent', 'product_view', {
  product_id:   'SKU-1234',
  product_name: 'Blue Running Shoe',
  category:     'Footwear > Running',
  price:        89.99,
  currency:     'USD'
}]);

Registre los añadidos al carrito y las compras

Para obtener las recomendaciones más sólidas, dispare también los eventos add_to_cart y purchase en las páginas correspondientes:

// On add-to-cart
window.personyze.push(['trackEvent', 'add_to_cart', {
  product_id: 'SKU-1234', price: 89.99, currency: 'USD'
}]);

// On purchase confirmation
window.personyze.push(['trackEvent', 'purchase', {
  order_id: 'ORD-9876',
  products: [
    { product_id: 'SKU-1234', price: 89.99, quantity: 1 }
  ],
  total: 89.99, currency: 'USD'
}]);

Vincular los eventos registrados con los destinatarios del email.Para que Personyze pueda relacionar el comportamiento en el sitio con un destinatario del email, necesita conocer su identidad. Pase a Personyze el email o el ID del CRM del usuario tras el inicio de sesión o desde una sesión conocida. Consulte la guía de seguimiento de interacciones con productos para ver todos los detalles sobre cómo identificar a los usuarios.

Paso 3 — Construya su widget en Personyze

Vaya a Recomendaciones por email → Asistente Get Code. El asistente le lleva por tres subpasos: algoritmo, plantilla y personalización.

Opciones de algoritmo

🎯 Recomendaciones personalizadasBasadas en el historial individual de navegación y de compra de cada destinatario. Las más potentes para audiencias templadas que ya han visitado su sitio.
🔥 Más vendidos / más popularesProductos populares en este momento según el comportamiento agregado. Ideal para suscriptores nuevos o audiencias frías. Una alternativa estupenda para cualquier campaña.
🛒 Según la última compraRecomienda productos relacionados o complementarios con lo último que compró el destinatario. Perfecto para secuencias de seguimiento tras la compra.
👁 Según lo visto recientementeMuestra los productos que el destinatario estuvo mirando más recientemente. Estupendo para campañas de reactivación o de abandono de navegación.
🏷 Banner promocionalUn banner promocional totalmente diseñado, segmentado por segmento o por hora del día, o personalizado con el nombre o la ubicación del destinatario, en lugar de tarjetas de producto.

Plantilla y personalización

Tras elegir un algoritmo, seleccione una disposición de plantilla de la biblioteca y use después el panel izquierdo para personalizar los colores, las insignias, el texto del botón, el tamaño de las imágenes y el espaciado. La vista previa en vivo se actualiza en tiempo real.

Entre las plantillas disponibles están Tarjeta en fila, Superposición degradada, Minimalista elegante, Escaparate oscuro y Filas horizontales:

Plantilla Tarjeta en fila Plantilla Superposición degradada Plantilla Minimalista elegante Plantilla Escaparate oscuro Plantilla Filas horizontales

Fije el número de productos que se mostrarán: normalmente 3 o 4 en los emails transaccionales, y hasta 6 en las campañas dedicadas a recomendaciones.

Paso 4 — Entender el código de inserción

Cómo funciona en realidad: URL únicas por destinatario

El fragmento que genera Personyze no es una imagen genérica. Cada <img src> es una URL única que codifica la identidad del destinatario. Cuando un suscriptor abre el email, su cliente de correo pide esa URL a Personyze. Entonces Personyze:

  1. Consulta el perfil de comportamiento del suscriptor (historial de navegación, compras, categorías vistas)
  2. Ejecuta el algoritmo de recomendación que usted eligió sobre ese perfil
  3. Comprueba su catálogo de productos en vivo para obtener los precios y la disponibilidad actuales
  4. Genera y devuelve una imagen de producto personalizada, en vivo, en ese momento

Cada posición de producto del widget tiene su propia URL (que termina en /k=...v, /k=...w, etc.), de modo que Personyze puede optimizar por separado lo que va en cada posición.

El fragmento generado

<table>
  <tr>
    <td>
      <a href="https://pic.personyze.com/href/k=8qy0zs2vbzcv/email={INSERT EMAIL HERE}">
        <img src="https://pic.personyze.com/png/k=8qy0zs2vbzcv/email={INSERT EMAIL HERE}" alt="Recommended"/>
      </a>
    </td>
    <td>
      <a href="https://pic.personyze.com/href/k=8qy0zs2vbzcw/email={INSERT EMAIL HERE}">
        <img src="https://pic.personyze.com/png/k=8qy0zs2vbzcw/email={INSERT EMAIL HERE}" alt="Recommended"/>
      </a>
    </td>
  </tr>
</table>

La alternativa: por qué siempre recibe algo útil

Cuando envía una campaña, Personyze nunca ha visto antes su lista de destinatarios: no sabe quién está en su audiencia de Mailchimp o de Klaviyo hasta que se abre el email. Por eso Personyze está diseñado con una alternativa inteligente:

  • Si Personyze conoce el email de un destinatario (ha visitado su sitio con el seguimiento activo y se capturó su identidad), recibe recomendaciones totalmente personalizadas.
  • Si el email de un destinatario aún no está en Personyze (un suscriptor nuevo, o un seguimiento todavía sin vincular), el widget recurre al algoritmo alternativo que haya configurado —normalmente Más populares o Más vendidos—, de modo que el email siga mostrando sugerencias relevantes en lugar de una imagen rota.

Configure su alternativa en el paso de Recomendación, en Recomendación alternativa si no hay resultados.

Recomendaciones no personales (sin necesidad de seguimiento)

¿Aún no tiene configurado el seguimiento de comportamiento? Puede usar igualmente Personyze para las recomendaciones por email con enfoques basados en el contexto:

  • Pase un ID de producto en la URL — por ejemplo, en un email tras la compra del pedido n.º XYZ, pase el ID del producto y Personyze mostrará artículos comprados o vistos junto con ese producto, según el comportamiento agregado.
  • Lo más vendido en todo el sitio — sin contexto individual ni de producto, Personyze muestra sus productos de mayor rendimiento en este momento según la actividad de todos los visitantes. Una base sólida que sigue superando a las selecciones editoriales estáticas.

Sustituya todas las apariciones del marcador.Cada posición de producto tiene dos apariciones de {INSERT EMAIL HERE} — una en el href (seguimiento de clics) y otra en el src (renderizado de la imagen). Sustituya todas las apariciones, no solo la primera.

Paso 5 — Insértelo en su plataforma de email

El proceso es el mismo en todas las plataformas de email: añada el fragmento de HTML de Personyze a su campaña y cambie después el marcador por la etiqueta de combinación de esa plataforma para la dirección de email del suscriptor. La etiqueta exacta varía según la plataforma; las secciones de abajo cubren las principales.

🐒 Mailchimp
  1. Abra la plantilla de su campaña. Vaya a Campaigns → Email Templates (o abra un borrador y haga clic en Edit Design) para abrir el editor de arrastrar y soltar.
  2. Añada un bloque de contenido Code. Arrastre un bloque Code desde la barra lateral a su plantilla, normalmente bajo la imagen principal y encima del pie.
  3. Pegue el fragmento y sustituya el marcador. Haga clic dentro del bloque Code, pegue el HTML completo y sustituya después {INSERT EMAIL HERE} por la etiqueta de combinación de Mailchimp: *|EMAIL|*
  4. Envíe un email de prueba para verificarlo. Use Preview & Test → Send a Test Email: la vista previa visual no sustituye las etiquetas de combinación. Abra la prueba en su bandeja de entrada para confirmar que la imagen carga con recomendaciones reales.

Limitación de la vista previa visual.La vista previa de arrastrar y soltar de Mailchimp no sustituye las etiquetas de combinación: muestra el texto literal *|EMAIL|* en la URL. Envíe siempre un email de prueba real para verificarlo.
🎯 Klaviyo
  1. Abra el editor de plantillas de email. Vaya a Content → Templates, o abra el email de su flujo o campaña y haga clic en Edit.
  2. Añada un bloque de texto o de HTML. Arrastre un bloque de texto y pase al modo HTML, o use un bloque HTML si su plantilla lo admite. Pegue el fragmento de Personyze.
  3. Sustituya el marcador. Klaviyo usa plantillas con dobles llaves al estilo de Django. Sustituya {INSERT EMAIL HERE} por: {{ email }}
  4. Previsualice con un perfil real. Use la función Preview as Person de Klaviyo, seleccione un suscriptor real y compruebe que la imagen carga con recomendaciones personalizadas.

Consejo para los flujos de Klaviyo.Los flujos de Klaviyo son especialmente potentes combinados con los algoritmos de Visto recientemente o de Abandono de navegación: los disparadores de comportamiento de Klaviyo unidos a la generación en el momento de apertura de Personyze producen emails muy relevantes y oportunos.
🟠 HubSpot
  1. Abra el editor de email. Vaya a Marketing → Email y abra o cree una campaña. Haga clic en Edit para abrir el editor de arrastrar y soltar.
  2. Añada un módulo de texto enriquecido o de HTML personalizado. Arrastre un módulo de texto enriquecido a su plantilla. Haga clic en el icono </> Source Code de la barra de herramientas para pasar al modo HTML. Pegue el fragmento de Personyze.
  3. Sustituya el marcador. HubSpot usa HubL (el lenguaje de plantillas de HubSpot). Sustituya {INSERT EMAIL HERE} por: {{ contact.email }}
  4. Envíe una prueba y previsualice. Use Send Test Email de HubSpot con un registro de contacto real para confirmar que la etiqueta de combinación se resuelve y que cargan las recomendaciones.

Flujos de trabajo de HubSpot.Esto combina especialmente bien con los flujos de trabajo de ciclo de vida de contactos de HubSpot. Dispare un email con Personyze en los momentos clave —tras una demostración, tras una compra o para reactivar— en los que las recomendaciones de productos personalizadas aportan un valor real.
⚡ ActiveCampaign
  1. Abra el diseñador de email. Vaya a Campaigns → Create a Campaign o abra un email de automatización existente. Use el New Email Designer.
  2. Añada un bloque HTML. Arrastre un bloque de contenido HTML a su plantilla. Haga clic para editarlo y pegue el fragmento de Personyze.
  3. Sustituya el marcador. ActiveCampaign usa etiquetas rodeadas de signos de porcentaje. Sustituya {INSERT EMAIL HERE} por: %EMAIL%
  4. Pruebe mediante la automatización. Añada un contacto de prueba a la automatización o use Send Preview Email con un contacto real para verificar que la etiqueta se resuelve y aparecen las recomendaciones.
💙 Brevo (antes Sendinblue)
  1. Abra el editor de plantillas. Vaya a Email → Templates y abra o cree una plantilla.
  2. Pase al editor HTML. Haga clic en el botón </> HTML de la esquina superior derecha para acceder al HTML en bruto. Pegue el fragmento de Personyze donde quiera que aparezcan las recomendaciones.
  3. Sustituya el marcador. Brevo usa la sintaxis de dobles llaves. Sustituya {INSERT EMAIL HERE} por: {{ contact.EMAIL }} (en mayúsculas).
  4. Envíe una prueba. Use Preview & Test → Send Test Email con un contacto real para confirmar que la personalización se genera correctamente.
📮 Constant Contact
  1. Abra la plantilla de email. Vaya a Campaigns → Create an Email, elija su plantilla y abra el editor.
  2. Añada un bloque de código personalizado. Haga clic en Insert → More → Custom Code para añadir un bloque de HTML en bruto. Pegue el fragmento de Personyze.
  3. Sustituya el marcador. Constant Contact usa un formato de etiqueta más antiguo. Sustituya {INSERT EMAIL HERE} por: $[LN:EMAIL:$]
  4. Previsualice y pruebe. Use Preview → Preview As Subscriber y seleccione un suscriptor real para verificar que la etiqueta de personalización se resuelve correctamente antes de enviar.

Referencia rápida: etiquetas de combinación de email

Resumen de la etiqueta de combinación exacta que debe usar en cada plataforma al sustituir {INSERT EMAIL HERE}:

Plataforma de email Sustituir {INSERT EMAIL HERE} por Notas
Mailchimp *|EMAIL|* Etiqueta de combinación estándar de Mailchimp
Klaviyo {{ email }} Variable de plantilla al estilo de Django
HubSpot {{ contact.email }} Propiedad de contacto de HubL
ActiveCampaign %EMAIL% Etiqueta de personalización rodeada de signos de porcentaje
Brevo {{ contact.EMAIL }} Nombre del campo en mayúsculas
Constant Contact $[LN:EMAIL:$] Etiqueta de sustitución
Campaign Monitor [email] Etiqueta de combinación entre corchetes
Salesforce Marketing Cloud %%emailaddr%% Cadena de sustitución de AMPscript
Cualquier otra plataforma de email La etiqueta de combinación del email de su plataforma Consulte la documentación de su plataforma

¿Prefiere el ID del CRM a la dirección de email?Si sus perfiles de Personyze usan como clave un ID de usuario interno en lugar del email, use la variante del marcador {INSERT USER ID HERE} en el fragmento y sustitúyala por la etiqueta de combinación de su plataforma para ese campo. Así además evita pasar direcciones de email en parámetros de URL.

Paso 6 — Pase el QA y previsualice sus recomendaciones

Antes de enviar a toda su lista, use la herramienta de QA integrada de Personyze (el paso de QA del asistente) para verificar que las recomendaciones funcionan y se personalizan correctamente.

Busque a cualquier suscriptor por su email

En el paso de QA, escriba la dirección de email de cualquier suscriptor en el campo Buscar usuario. Personyze mostrará al instante las imágenes de producto exactas que vería ese usuario al abrir su email, según su perfil de comportamiento actual en tiempo real.

Debajo de las recomendaciones generadas, despliegue la fila del usuario para ver todo su historial de interacciones con productos: cada producto que ha visto, añadido al carrito o comprado, con marcas de tiempo y datos de sesión. Útil para confirmar que el seguimiento funciona correctamente y que el algoritmo está captando las señales adecuadas.

¿Y si el usuario aún no está en Personyze?Si el email que introduce no tiene historial en Personyze, la herramienta de QA muestra las recomendaciones alternativas que haya configurado (Más populares / Más vendidos). Es exactamente lo que recibiría ese suscriptor en el email real, así que confirma también que la alternativa funciona correctamente.

Qué verificar antes de enviar

  • Las recomendaciones parecen personalizadas. Los productos de la vista previa del QA deben estar relacionados con los intereses conocidos de ese usuario, no ser aleatorios. Si parecen genéricos, compruebe que se están disparando los eventos de seguimiento de comportamiento y que el email del usuario se está pasando correctamente desde su sitio.
  • La alternativa se muestra limpiamente. Pruebe con una dirección de email completamente nueva, sin historial. Debería ver Más vendidos o Más populares, no un widget vacío o roto.
  • Envíe una prueba real desde su plataforma de email. Envíe siempre un email de prueba desde su plataforma de email real (no solo la vista previa visual, que no resuelve las etiquetas de combinación). Ábralo en su bandeja de entrada real.
  • El destino del clic es correcto. Haga clic en cada imagen de producto de su email de prueba. Verifique que lleva a la ficha de producto correcta y que se dispara el seguimiento de clics de Personyze, para una atribución exacta.

Nunca se fíe solo de la vista previa visual.Las vistas previas visuales de arrastrar y soltar de todas las grandes plataformas de email no sustituyen las etiquetas de combinación: muestran el texto del marcador en bruto en la URL, lo que hace que falle la petición de la imagen. Use siempre un envío de prueba real.

Paso 7 — Informes de rendimiento

Una vez que su campaña está en vivo, la pestaña Rendimiento de Personyze le da métricas de atribución detalladas que van más allá de lo que ofrece la analítica nativa de su plataforma de email para el bloque de recomendaciones.

Métricas a nivel de campaña

📊 VistoTotal de veces que se generó el widget de recomendaciones, es decir, que se abrió el email con la carga de imágenes activada. Su recuento de impresiones de la capa de personalización.
🖱 Con clicPorcentaje de quienes lo vieron y hicieron clic en al menos un producto, más el total de clics en productos y la media de clics por usuario. Le indica lo atractiva que resulta la selección de recomendaciones.
🛒 Añadido al carritoUsuarios que hicieron clic y después añadieron al carrito un producto recomendado, registrado mediante el seguimiento de eventos de Personyze en su sitio.
💰 Comprado e ingresosTotal de transacciones, ingresos y ratio de contribución atribuidos al widget de recomendaciones del email. El retorno directo de la capa de personalización.

Profundizar por usuario

Pase a la pestaña Usuarios dentro de Rendimiento para ver un desglose por suscriptor individual: qué direcciones de email concretas hicieron clic, añadieron al carrito o compraron, y exactamente con qué productos interactuaron. Útil para:

  • Validar que los usuarios con alta intención reciben las recomendaciones más relevantes
  • Identificar qué segmentos de usuarios generan más conversiones de compra desde el email
  • Llevar lo aprendido a la elección de algoritmos o segmentos de sus próximas campañas

Rangos de tiempo de los informes.Use el selector de rango de tiempo (Desde el inicio, Desde la última edición, Últimos 7 días, rango de fechas personalizado) para aislar el rendimiento de un envío de campaña o de un periodo de prueba concretos. Los datos de rendimiento se actualizan aproximadamente 1 hora después de que terminen las sesiones de los visitantes.

Consejos para obtener los mejores resultados

  • Mantenga su catálogo actualizado. Programe sincronizaciones del feed diarias o cada hora. Los precios desactualizados y los productos agotados minan la confianza al instante.
  • La colocación en mitad del email rinde más que arriba o abajo. Debajo del banner principal y encima del pie genera de forma constante más clics que otras posiciones.
  • 3 o 4 productos en los emails transaccionales, de 4 a 6 en los envíos dedicados a recomendaciones. Más productos significa más desplazamiento: pruebe para encontrar su punto óptimo.
  • Configure una alternativa con sentido. Para los suscriptores nuevos sin historial de comportamiento, recurra a Más vendidos o a Mejor valorados, no a productos aleatorios.
  • Haga que la línea de asunto encaje con la personalización. Si su asunto dice «Elegidos solo para ti», las recomendaciones tienen que parecer realmente personales. Asegúrese de que los datos de comportamiento se están rellenando antes de desplegarlo a gran escala.
  • No se salte el texto alternativo. Un atributo alt descriptivo en la imagen de recomendación garantiza que los usuarios de Outlook corporativo que bloquean las imágenes por defecto sigan viendo una llamada a la acción clara.
Did this page answer your question?
Thank you — that goes to whoever maintains this page.