Campaigns

La gestión de productos te brinda un alto grado de control sobre los productos mostrados por Clerk, como potenciar productos en oferta, priorizar marcas específicas, ocultar productos sin stock 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 de tiempo específico. La programación es especialmente útil si solo deseas influir en los resultados durante un periodo como la semana de Black Friday o durante tus rebajas de Navidad.

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

Selección de productos #

Al configurar Disparadores y Reglas, debes elegir productos de una forma que mantenga tus campañas actualizadas incluso cuando tu catálogo cambie.

Puedes seleccionar productos manualmente con Lista de productos; sin embargo, se recomienda escribir palabras clave con Search o usar Filtros para seleccionar productos de forma dinámica.

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

Lista de productos #

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

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

Orden de los productos #

Cuando una regla usa Product list, puedes establecer el orden de los productos seleccionados directamente en el selector de productos. Este es el orden que verán los compradores 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 por la regla para abrir el selector de productos.
3. Agarra el icono punteado al lado de un producto seleccionado y arrástralo a la posición que desees. La fila sigue tu cursor y una caja de trazos muestra dónde aterrizará.
4. Suelta la fila en la caja de trazos. Repite para cualquier otro producto que quieras mover.
5. Cierra el selector y haz clic en Save en la campaña.

Para reordenar usando el teclado, enfoca una fila de producto y presiona Alt + ↑ o Alt + ↓. Los lectores de pantalla anuncian el movimiento.

Por ejemplo, mueve un producto seleccionado del cuarto al primero para colocarlo antes que los otros productos seleccionados manualmente. Puedes cambiar este orden sin eliminar o 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 quieras incluir, como “Nike sneakers”, “strawberry whey powder” o “macbook pro”.

Todos los productos que coincidan con estas palabras clave en cualquier momento, serán parte de la campaña.

Filtros #

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

La interfaz de Filtro te permite elegir cualquier cantidad de atributos, como productos en oferta con un precio inferior a 100 € que además sean artículos de alto margen.

Valores dinámicos #

Cuando una campaña usa When Seeing Products Matching, puedes hacer que un filtro use 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 vez de usar un solo valor fijo.

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

1. El atributo de producto por el que filtrar, como marca, tipo de producto o etiquetas.
2. La condición, como es o contiene.
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 que tengan el mismo tipo. Puedes combinar esto con otros filtros, como una condición de precio fijo.

La expresión del filtro puede seguir editándose 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.

El recuento de productos no se muestra en el editor para filtros que utilizan 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 que se está visualizando.

Los valores del producto actual solo están disponibles para las reglas de campañas de Merchandising. Los filtros de Audience, Email y contenido no se ven afectados.

Valores de cliente #

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

Los valores de cliente funcionan en los widgets Search y Recommendations del escaparate y en Email Embeds. No son compatibles con los boletines de Clerk.io ni los correos de flujo automatizados.

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 de 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 productos que puedan enviarse 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 de un 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 disparador de atributo de cliente. El disparador decide cuándo se ejecuta la campaña; el valor de cliente decide qué productos selecciona la regla.

Identificación

Los valores de cliente requieren el Email del visitante y el atributo elegido en su registro de cliente en Clerk.io. Un Email identifica al cliente; no proporciona un país, género o grupo faltante.

Clerk.js maneja esto automáticamente para tiendas que ya reportan inicios de sesión o identificaciones de clientes a Clerk.io. Un clic en una campaña que transporta el Email del cliente también cuenta como una identificación.

Para un cliente autenticado, el Email se recuerda entre carga de páginas durante la sesión de navegación. Nunca se conserva en modo sin cookies o privado.

Para integraciones personalizadas, consulta Customer Context más abajo.

Valores faltantes

Si se desconoce el Email del visitante 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.

Por lo tanto, una regla regional solo restringe productos para clientes que pueden ser identificados y tienen el atributo necesario. Los visitantes anónimos no reciben esa restricción.

Disparadores #

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

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

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

Cross-Platform #

Se utiliza para orientar todos los elementos de Clerk o elegir manualmente elementos específicos según sus Content IDs o endpoints de la 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. Esto es generalmente necesario solo para configuraciones del lado del servidor.
• For Specific API Parameter: Permite activar la campaña programáticamente.
• When Customer Attribute …: Se activa cuando el Cliente identificado tiene atributos que coinciden con tus condiciones.
• When Customer is in Audience …: Se activa cuando el Cliente identificado pertenece a uno o más Audiences seleccionados.

Search #

Especializado para los resultados mostrados en Instant Search, la página Search o Omnisearch.

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

Chat #

Especializado para los resultados mostrados en Chat cuando busca productos.

• On All Chat Searches: Afecta todos los productos mostrados en Chat cuando los busca.
• When a Chat Search…: Solo afecta productos mostrados en Chat cuando se encuentran con palabras clave específicas. Elige palabra(s) para una coincidencia exacta o aproximada, o dirige consultas que simplemente contengan la(s) palabra(s).

Recommendations #

Especializado para los elementos del sitio que usan lógicas de Recommendations, como los más vendidos 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 la categoría sin importar si se muestra como banner o en la página de categoría completa.
• On All Categories: Igual que arriba, pero en todas las páginas de categoría.
• When Seeing Products Matching: Se 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 del sitio.

Email #

Especializado para el marketing por correo electrónico, tanto al insertar 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: Aplica a todas las AI Campaigns activas.
• On All Newsletters: Aplica a todas las Newsletters activas.
• On All Triggers: Aplica a todos los Triggers activos.
• On All Embedded Emails: Aplica a todos los Email Embeds activos.

Reglas #

Estas deciden cómo se ven influenciados tus resultados al cambiar su posición en los resultados. La posición simplemente significa si un producto se muestra como el primer resultado, décimo, trigésimo cuarto, y así sucesivamente.

Las reglas pueden ir desde algo muy amplio, como impulsar todos los productos en oferta, hasta algo muy específico, como fijar un par de Nike sneakers en el banner de alternativas para otro par similar.

Forzado #

Ignora la lógica existente, incluidos los filtros y otras reglas de Merchandising. Además, los productos pueden ser forzados a los resultados donde de otro modo no se mostrarían.

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

Ordenación #

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 ordenación influyen en los resultados manteniendo la inteligencia de la IA de Clerk.io.

• Adjust position in results: Mueve los productos coincidentes hacia arriba por un porcentaje. Un ajuste del 50 % mueve un producto que se muestra en la posición 20 a la 10; 100 % lo mueve a la posición 1.
• Promote in results: Distribuye los productos seleccionados a lo largo de los resultados, como colocar un artículo de alto margen cada 3 productos desde el segundo resultado.
• Promote to position: Coloca productos seleccionados empezando en una posición específica, por ejemplo, mostrar 3 productos Adidas desde el cuarto resultado.
• Bury below others: Los productos seleccionados se mostrarán después de los demás productos. Ejemplo: mostrar productos sin stock al final de los resultados de búsqueda.
• Promote slightly (Outdated): Los productos seleccionados se priorizan un poco más, pero no tendrá un gran impacto en los resultados. Se recomienda usar Adjust position in results en su lugar.
• Give a significant boost (Outdated): Los productos seleccionados se priorizan mucho más, llevándolos normalmente a aparecer entre los primeros resultados. Se recomienda usar Adjust position in results en su lugar.
• Give a custom boost (Outdated): Elige un multiplicador personalizado para priorizar productos. Se recomienda usar Adjust position in results en su lugar.

Eliminación #

Selecciona productos específicos que pueden mostrarse, ocultando otros que no cumplan el criterio.

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

Ámbitos #

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

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

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

Desde la vista general de Merchandising, puedes ver y crear campañas para la tienda actual desde la página de Single Store y usar la página de Multiple Stores para campañas multiplataforma.

Detalles adicionales #

Estos detalles explican los casos límite que debes considerar al configurar o solucionar problemas de reglas de reordenamiento:

• Promote in Results, Promote to Position y Adjust Position solo reordenan productos que ya están en la ventana de resultados actual. Pin puede añadir productos que no están en los resultados orgánicos.
• La prioridad de las reglas es Pin, Promote to Position, luego Promote in Results y luego Adjust Position. Los productos se mueven, no se duplican.
• Mantén estos límites separados:
  • API limit: productos devueltos en cada página.
  • Promote to Position limit: productos insertados en su bloque.
  • Adjust Position Max depth: hasta qué profundidad en la lista ordenada se pueden encontrar productos coincidentes.
• Merchandising se ejecuta antes de la paginación. Mantén el tamaño de la página constante al usar Load more, y verifica la primera página junto con la siguiente.
• El servicio Search subyacente 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 reordenación a todo el resultado del endpoint antes de recortarlo con el limit de la API; Search v3 las aplica a una ventana limitada antes de recortar. Por lo tanto, un producto con un ranking profundo puede estar disponible en Search v2 pero quedar fuera de la ventana en Search v3. Usa Pin cuando el producto debe aparecer.

Para desarrolladores #

Las campañas también pueden ser activadas y desactivadas programáticamente, dándote más control sobre dónde aplicarlas. Los casos de uso incluyen activar campañas cuando ciertos grupos de clientes inician sesión o cuando se ha alcanzado un tamaño de carrito deseado.

Customer Context #

Para reglas basadas en el cliente en una integración personalizada de escaparate, establece el Email conocido del visitante en Clerk.js antes de hacer las llamadas que deban usarlo:

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

Reemplaza el ejemplo con el Email del visitante identificado. También puedes pasar su Email en la propia llamada a la API del escaparate. Clerk.io lo usa para buscar los atributos del cliente sin esperar un mapeo cliente-visitante.

API Trigger #

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

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

$ 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 embedcode. Debe contener una lista de uno o varios IDs de campaña:

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

Deshabilitar en API #

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

Esto puede hacerse añadiendo el parámetro flags=disable.merchandising a tu llamada API:

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

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