Campaigns

La comercialización te brinda un alto grado de control sobre los productos mostrados por Clerk, como potenciar productos en oferta, priorizar marcas específicas, ocultar productos agotados y mucho más.

Información Básica #

Las campañas siempre tienen un Nombre de tu elección. Opcionalmente, puedes añadir una Descripción para recordarte a ti y a tus colegas el propósito de la campaña.

Programación #

Decide si una campaña debe ejecutarse indefinidamente o durante un periodo específico. La programación es especialmente útil si solo quieres influir en los resultados durante un periodo como la semana del Black Friday o durante tus ventas navideñas.

Utilizar la programación significa que no olvidarás apagar la campaña cuando ya no sea aplicable.

Selección de Productos #

Al configurar Disparadores y Reglas, debes seleccionar productos de una forma que mantenga tus campañas actualizadas incluso a medida que cambia tu catálogo.

Puedes seleccionar manualmente productos con Product List, pero se recomienda escribir palabras clave con Search o usar Filters para seleccionar productos de forma dinámica.

Hacer esto mantendrá tus campañas relevantes, incluso cuando los productos se agoten y se agreguen nuevos a tu catálogo.

Lista de Productos #

Esta es la manera más sencilla de elegir productos para tu campaña. Simplemente busca los productos que quieres y haz clic sobre ellos para seleccionarlos.

Puedes seleccionar tantos productos como desees. Si luego los productos desaparecen de tu catálogo, ya no se incluirán en los resultados.

Orden de los productos #

Cuando una regla utiliza Product list, puedes establecer el orden de los productos seleccionados directamente en el selector de productos. Este es el orden en que los compradores los verán cuando la regla coloque esos productos en los resultados.

1. Abre Merchandising y edita la campaña.
2. Bajo Rules, haz clic en el botón que muestra los productos seleccionados de la regla para abrir el selector de productos.
3. Toma el asa punteada junto a un producto seleccionado y arrástralo a la posición que desees. La fila seguirá tu cursor y una caja discontinua mostrará dónde aterrizará.
4. Suelta la fila en la caja discontinua. Repite para cualquier otro producto que desees mover.
5. Cierra el selector y haz clic en Save en la campaña.

Para reordenar con el teclado, enfócate en una fila de producto y presiona Alt + ↑ o Alt + ↓. Los lectores de pantalla anuncian el movimiento.

Por ejemplo, mueve un producto seleccionado de la cuarta a la primera posición para colocarlo antes que los demás productos seleccionados manualmente. Puedes cambiar este orden sin eliminar y volver a seleccionar los productos. La regla aún controla dónde se colocan los productos en los resultados.

Search #

Elige productos usando texto libre. Simplemente escribe palabras clave que coincidan con los productos que quieres incluir, como “Nike sneakers”, “strawberry whey powder” o “macbook pro”.

Cualquier producto que coincida con estas palabras clave en cualquier momento formará parte de la campaña.

Filters #

Estos pueden usarse para elegir dinámicamente productos según sus atributos. Cualquier producto que coincida con los filtros en cualquier momento formará parte de la campaña.

La interfaz de Filtros te permite elegir cualquier número de atributos, como productos en oferta con un precio inferior a €100 que además sean de alto margen.

Valores Dinámicos #

Cuando una campaña usa When Seeing Products Matching, puedes hacer que un filtro utilice un atributo del producto que el visitante está viendo. Esto permite que la misma campaña se adapte a cada página de producto en lugar de usar un valor fijo.

En la sección de Filtros de la campaña, configura cada filtro con:

1. El atributo del producto a filtrar, como marca, tipo de producto o etiquetas.
2. La condición, como is o contains.
3. Fixed value para ingresar un valor específico, o Current product para usar el producto que se está visualizando.
4. El valor a comparar, o el atributo a usar del producto actual.

Por ejemplo, elige Current product y usa el tipo del producto actual para mostrar productos del mismo tipo. Puedes combinar esto con otros filtros, como una condición de precio fijo.

La expresión del filtro aún puede editarse manualmente. Los valores dinámicos usan el formato {{ attribute_name }}, donde attribute_name se reemplaza por el atributo correspondiente del producto que se está visualizando.

Los conteos de productos no se muestran en el editor para filtros que usan valores del producto actual porque no hay un producto actual hasta que un visitante abre una página de producto. Estos valores se resuelven en el sitio a partir del producto visualizado.

Los valores del producto actual están disponibles solo para reglas de campañas de Merchandising. Audience, email y los filtros de contenido no cambian.

Valores del Cliente #

El filtro de producto de una regla puede comparar un atributo del producto con un atributo del cliente identificado. Esto permite que una regla elija diferentes productos para cada visitante o destinatario de email, según su país, género o grupo de cliente.

Los valores del cliente funcionan en los widgets de Search y Recommendations de la tienda, Email Embeds, AI Newsletters y Flows.

1. Abre Merchandising y edita la campaña.
2. Bajo Rules, abre la selección de productos de la regla.
3. Abre la pestaña Filter y haz clic en Add filter.
4. Elige el atributo del producto y la condición a comparar.
5. Establece la fuente del valor en Customer y elige el atributo del cliente.
6. Cierra la selección de productos y haz clic en Save en la campaña.

Por ejemplo, compara los países disponibles de un producto con el país del cliente para seleccionar los productos que se pueden enviar a ese cliente. Ambos atributos deben contener valores compatibles para que la comparación coincida.

Si registras el género del cliente y lo envías a Clerk.io, puedes compararlo con el atributo de género del producto para seleccionar productos coincidentes. Esto requiere datos de género tanto en el cliente como en los productos, con valores compatibles.

También puedes usar un grupo de clientes para seleccionar productos relevantes.

Puedes combinar esto con un trigger de atributo de cliente. El trigger decide cuándo se ejecuta la campaña; el valor del cliente decide qué productos selecciona la regla.

Identificación

Los valores del cliente requieren el email del cliente y el atributo seleccionado en el registro del cliente en Clerk.io. Un email identifica al cliente; no proporciona un país, género o valor de grupo que falte.

Para newsletters y emails de flujos, la regla usa los atributos del cliente del destinatario. Asegúrate de que el atributo elegido esté disponible en el registro del cliente en Clerk.io.

Clerk.js lo gestiona automáticamente para las tiendas que ya reportan inicios de sesión o identificaciones de clientes a Clerk.io. Un clic en la campaña que lleva el email del cliente también cuenta como una identificación.

Para un cliente con sesión iniciada, el email se recuerda entre las páginas durante la sesión de navegación. Nunca se conserva en modo sin cookies o privado.

Para integraciones personalizadas, consulta Customer Context a continuación.

Valores faltantes

Si el email del cliente es desconocido, o el cliente no tiene valor para el atributo seleccionado, la regla basada en el cliente se omite. Esto no causa un error. Las reglas existentes mantienen su comportamiento actual.

Una regla regional, por tanto, solo restringe productos para los clientes que pueden ser identificados y tienen el atributo requerido. Los visitantes anónimos no reciben esa restricción.

Triggers #

Estos controlan dónde deben estar activas tus campañas. Los triggers van desde cualquier lugar, hasta un banner específico en una página de producto específica.

Las campañas pueden ejecutarse en cualquiera de los triggers seleccionados, o solo cuando se cumplen todos los criterios de los triggers.

A continuación, se muestran todos los triggers disponibles actualmente.

Cross-Platform #

Se usa para orientar todos los elementos de Clerk o elegir manualmente elementos específicos según sus IDs de Contenido o endpoints de API.

• Anywhere: Todos los elementos de Clerk en tu sitio, emails y Chat.
• Only for Specific Content: Cualquier bloque de Contenido seleccionado que hayas creado en Search, Recommendations y Email.
• For Specific API Endpoint: Endpoints como recommendations/complementary o search/predictive. Normalmente, esto solo es necesario para configuraciones del lado del servidor.
• For Specific API Parameter: Permite activar la campaña programáticamente.
• When Customer Attribute …: Activa cuando el Customer identificado tiene atributos que coinciden con tus condiciones.
• When Customer is in Audience …: Activa cuando el Customer identificado pertenece a una o más Audiences seleccionadas.

Search #

Especializado para resultados mostrados en Instant Search, la Search Page u Omnisearch.

• On All Searches: Cualquier búsqueda realizada por los visitantes.
• When a Search: Palabra(s) específicas de tu elección, ya sea para una coincidencia exacta o cercana, o cuando la consulta simplemente contiene la(s) palabra(s). También puede dejarse vacío para orientar el estado vacío en Omnisearch antes de que se haya escrito una consulta.

Chat #

Especializado para resultados mostrados en Chat cuando busca productos.

• On All Chat Searches: Impacta todos los productos mostrados en Chat cuando los busca.
• When a Chat Search…: Impacta solo los productos mostrados en Chat cuando se encuentran con palabras clave específicas. Elige palabra(s) para una coincidencia exacta o cercana, o consulta para orientar consultas que simplemente contienen la(s) palabra(s).

Recommendations #

Especializado para elementos en sitio que usan lógicas de Recommendations, como Bestsellers en la página principal o Cross-Sell en las páginas de producto.

• When Seeing Category: Selecciona una página de categoría específica por su nombre. Se aplica a las lógicas Bestsellers y Trending en Category, ya sea que se muestre como banner o como la página completa de categoría.
• On All Categories: Igual que arriba, pero en todas las páginas de categorías.
• When Seeing Products Matching: Aplica a las lógicas Best Cross-Sell y Best Alternatives en las páginas de producto que coincidan con tu selección.
• On All Recommendations: Todos los elementos de Recommendations en el sitio.

Email #

Especializado para marketing por email, tanto al incrustar productos como al usar Clerk para enviar los emails.

• Only for Specific AI Campaign: Seleccionado por su nombre.
• Only for Specific Newsletter: Seleccionado por su nombre.
• Only for Specific Trigger: Seleccionado por su nombre.
• Only for Specific Embedded Email: Seleccionado por su nombre de Embed.
• On All AI Campaigns: Dirigido a cualquier AI Campaign activa.
• On All Newsletters: Dirigido a cualquier Newsletter activa.
• On All Triggers: Dirigido a cualquier Trigger activo.
• On All Embedded Emails: Dirigido a cualquier Email Embed activo.

Rules #

Estas deciden cómo se ven influenciados tus resultados cambiando su posición en los resultados. Posición simplemente significa si un producto se muestra como el primer resultado, el décimo, el 34º, y así sucesivamente.

Las reglas pueden ir desde muy generales, como potenciar todos los productos en oferta, hasta muy específicas, como fijar un par de Nike sneakers en el banner de alternativas de otro par similar.

Forzando #

Ignora la lógica existente, incluidos filtros y otras reglas de Merchandising. Los productos también pueden ser forzados a aparecer en los resultados donde normalmente no aparecerían.

• Pin: La regla más agresiva. Obliga a que uno o más productos aparezcan en la parte superior, sin importar la otra lógica.

Ordenando #

Cambia el orden de los resultados mostrando solo los productos que ya estaban en el conjunto de resultados.

Por ejemplo, si promocionas tus Nike Air 2.0 sneakers, no aparecerán en búsquedas de “t-shirts”, pero tendrán más visibilidad en búsquedas de “sneakers”.

Las reglas de orden influyen los resultados manteniendo la inteligencia de la IA de Clerk.io intacta.

• Adjust position in results: Mueve los productos coincidentes arriba según un porcentaje. Un ajuste del 50% mueve un producto en la posición 20 a la posición 10; 100% lo mueve a la posición 1.
• Promote in results: Distribuye productos seleccionados en los resultados, como colocar un producto de alto margen cada 3 productos desde el segundo resultado.
• Promote to position: Coloca productos seleccionados empezando desde una posición específica, como mostrar 3 productos Adidas a partir del cuarto resultado.
• Bury below others: Los productos seleccionados se mostrarán después de otros productos. Por ejemplo, mostrar productos agotados al final de los resultados de búsqueda.
• Promote slightly (Outdated): Los productos seleccionados tienen un poco más de prioridad, pero el impacto es bajo en los resultados. Recomendamos usar Adjust position in results en su lugar.
• Give a significant boost (Outdated): Los productos seleccionados son mucho más priorizados, a menudo mostrándose en los primeros resultados. Recomendamos usar Adjust position in results en su lugar.
• Give a custom boost (Outdated): Elige un multiplicador personalizado para priorizar productos. Recomendamos usar Adjust position in results en su lugar.

Eliminando #

Selecciona productos específicos que puedan mostrarse, ocultando los demás que no coincidan con los criterios.

• Show Only: Solo se mostrarán los productos seleccionados, aunque existan otras coincidencias.
• Remove any: Oculta completamente los productos seleccionados.

Scopes #

Clerk usa los IDs de producto y categoría para aplicar campañas. Las campañas en varias Tiendas solo funcionan correctamente si estos IDs son consistentes entre tus Tiendas.

Las campañas pueden añadirse a una sola Tienda o a varias al mismo tiempo. Esto te da la libertad de influir en los resultados en todo tu negocio o solo en las partes que importan.

Cada campaña puede configurarse con un Scope según dónde quieres que se ejecute. Utiliza el menú Edit scope para seleccionar las Tiendas en las que debe ejecutarse la campaña.

Desde la vista general de Merchandising, puedes ver y crear campañas para la Tienda actual en la página de Single Store y usar la página de Multiple Stores para campañas entre cuentas.

Detalles Adicionales #

Estos detalles explican los casos borde importantes al configurar o solucionar reglas de reordenamiento:

• Promote in Results, Promote to Position y Adjust Position solo reordenan productos ya en la ventana de resultados actual. Pin puede agregar productos que no estén en los resultados orgánicos.
• La prioridad de reglas es Pin, Promote to Position, Promote in Results y luego Adjust Position. Los productos se mueven, no se duplican.
• Mantén estos límites por separado:
  • API limit: productos devueltos en cada página.
  • Promote to Position limit: productos insertados en su bloque.
  • Adjust Position Max depth: hasta dónde en la lista ordenada pueden encontrarse los productos coincidentes.
• Merchandising se ejecuta antes de la paginación. Mantén el tamaño de página consistente al usar Load more y revisa la primera página junto con la siguiente página.
• El servicio subyacente de Search realiza gran parte del trabajo para Merchandising, por lo que la versión de Search afecta la ventana de resultados. Search v2 aplica reglas de reordenamiento a todo el resultado del endpoint antes de recortar al limit de API; Search v3 las aplica a una ventana acotada antes de recortar. Por tanto, un producto muy abajo en el ranking puede estar disponible en Search v2 pero fuera de la ventana de Search v3. Usa Pin si el producto debe aparecer.

Para desarrolladores #

Las campañas también pueden ser activadas y desactivadas programáticamente, brindándote más control sobre dónde aplicarlas. Incluye casos como activar campañas cuando ciertos grupos de clientes inician sesión o cuando se alcanza el tamaño de cesta deseado.

Customer Context #

Para reglas basadas en el cliente en una integración personalizada de storefront, establece el email conocido del visitante en Clerk.js antes de realizar las llamadas que deban utilizarlo:

Clerk('context', 'email', 'customer@example.com');

Sustituye el ejemplo por el email identificado del visitante. También puedes pasar su email en la propia llamada a la API del storefront. Clerk.io lo utiliza para buscar los atributos del cliente sin esperar el mapeo de cliente a visitante.

API Trigger #

Crea la campaña con el trigger For Specific API Parameter. Copia su ID de campaña para usarlo en llamadas de API.

Incluye el parámetro merchandising en las llamadas de API. Debe enviarse como una lista de uno o varios IDs de campañas:

$ curl -X POST \
       -H 'Content-Type: application/json' \
       -d '{"key":      "your_api_key",
            "visitor":  "aR9Km32l",
            "limit":    4,
            "labels":   ["Most Popylar"],
            "merchandising": ["boost-bracelets", "high-margin"]' \
       http://api.clerk.io/v2/recommendations/popular

Clerk.js Trigger #

Incluye el parámetro data-merchandising en tu código de embed. Debe contener una lista de uno o varios IDs de campañas:

<span class="clerk"
  data-template="@home-page-popular"
  data-merchandising="['boost-bracelets', 'high-margin']"
></span>

Desactivar en la API #

Si Clerk.io muestra resultados inesperados, un buen punto de partida es desactivar todas las campañas de Merchandising en una llamada de API para comprobar si esa es la causa.

Puedes hacerlo añadiendo el parámetro flags=disable.merchandising a tu llamada de API:

https://api.clerk.io/v2/recommendations/popular?key=your_api_key&flags=disable.merchandising=true

Esto desactivará todas las campañas de Merchandising para esa llamada de API, sin afectar el resto de tu configuración de Clerk.io.