viewa/docs
Guía de implementación (Español)

Preselección de productos y materiales

Enlace directamente al visualizador con un producto, un material o ambos ya seleccionados.

Objetivo: llevar a sus visitantes directamente al producto que ya estaban viendo.

Cualquier enlace a su visualizador puede incluir parámetros opcionales que preseleccionan un producto, un material o ambos. El visitante se salta el selector y ve su elección en cuanto se abre el visualizador. Esto combina muy bien con los botones "Visualizar" en las páginas de producto.

Parámetros

ParámetroPreseleccionaAcepta
dp (o product)Un productoEl slug o el SKU del producto en su catálogo de Viewa, o uno de sus propios identificadores registrado como alias de catálogo
dm (o sku)Un materialEl slug o el SKU del material, o un alias de catálogo

product y sku son nombres alternativos de dp y dm, para integraciones que ya envían esos parámetros. Si se incluyen ambas formas, prevalecen dp y dm.

Ejemplos

Sustituya la URL de su instancia y los identificadores por los suyos:

<!-- Solo producto -->
<a href="https://your-instance-url?dp=ROLLER-BLIND-01">Visualízalo en tu casa</a>

<!-- Solo material: el visitante elige el producto -->
<a href="https://your-instance-url?dm=CHARCOAL-WEAVE">Visualízalo en tu casa</a>

<!-- Producto y material -->
<a href="https://your-instance-url?dp=ROLLER-BLIND-01&dm=CHARCOAL-WEAVE">Visualízalo en tu casa</a>

<!-- Directamente en un ambiente específico -->
<a href="https://your-instance-url/scene/living-room?dp=ROLLER-BLIND-01">Míralo en una sala</a>

<!-- Sus propios identificadores, resueltos mediante alias de catálogo -->
<a href="https://your-instance-url?product=roller-blinds&sku=FAB-1001">Visualízalo en tu casa</a>

Un material solo se aplica si el producto seleccionado lo ofrece. Si se indica solo el material, se aplica cuando el visitante elige un producto que lo ofrece.

Abrir en una pestaña nueva

Abrir o no el visualizador en una pestaña nueva depende del recorrido que usted quiera. Con target="_blank" su página permanece abierta detrás, así que los visitantes pueden cerrar el visualizador y seguir donde se quedaron; sin él, el visualizador reemplaza su página y tienen que regresar. Cuando use target="_blank", agregue también rel="noopener".

Alias de catálogo

Es poco común que su sitio use los slugs y SKU de Viewa. Un alias de catálogo asocia uno de sus propios identificadores con su catálogo de Viewa, para que sus enlaces puedan usar los valores que su plataforma ya tiene: el SKU de una variante de WooCommerce, un handle de Shopify o el slug de una categoría.

Cada alias asocia un identificador con uno de los siguientes:

Destino del aliasÚselo paraEjemplo
Un productoUn identificador de categoría o de producto de su sitioroller-blinds → Roller Blind
Un materialEl SKU de una tela o de un colorFAB-1001 → Linen Blockout, White
Un producto y un materialUn SKU que identifica ambos a la vezRB-1001-WHT → Roller Blind en Linen Blockout, White
Una línea de materialesSe registra por completitud: el SKU de una línea no preselecciona nadaLINEN-BO

Un SKU que identifica tanto un producto como un material preselecciona el elemento que pide cada parámetro, así que envíelo en ambos: ?product=RB-1001-WHT&sku=RB-1001-WHT.

Cómo se comparan los alias:

  • La comparación no distingue entre mayúsculas y minúsculas e ignora los espacios al inicio y al final; los alias son por instancia.
  • Un alias tiene prioridad sobre un slug o SKU de Viewa con el mismo valor.
  • Un alias que apunta a algo que el parámetro no puede usar (un alias de material en dp, o el SKU de una línea en cualquier parámetro) no coincide con nada. No se recurre al catálogo como alternativa.

Viewa configura sus alias por usted: envíenos los identificadores que usa su sitio (lo ideal es un feed o una exportación de productos) y los asociaremos con su catálogo.

Información importante

  • Los valores no distinguen entre mayúsculas y minúsculas.
  • Un producto o material no reconocido se ignora: el visualizador se abre con su configuración predeterminada en lugar de mostrar un error, así que un enlace a un SKU descontinuado sigue funcionando.
  • La selección se mantiene durante el resto de la sesión del navegador, incluso al navegar dentro del visualizador.
  • Algunos CMS y editores de correo electrónico codifican el carácter &. Si solo se aplica el primer parámetro, revise el & entre ambos.
  • La preselección todavía no es compatible con instancias hijas, es decir, un visualizador que comparte el catálogo de otra instancia, como el sitio de un distribuidor o de una sucursal. Los enlaces a esas instancias se abren con la configuración predeterminada. Contáctenos si la necesita.

On this page