Metacampos
Los metacampos sirven para almacenar información extra o personalizada que no viene de serie en Shopify, de forma que se consideran campos adicionales para enriquecer la información base.
Sales Layer permite sincronizar metacampos desde el conector, teniendo en consideración que:
- El metacampo tiene que estar creado en Shopify previo al envío desde el conector.
- El metacampo debe estar definido en Shopify.
Creación de metacampos en Shopify
Entrando en Settings -> Metafields and Metaobjects se puede elegir entre Productos, Variantes y Colecciones.
Para crear metacampos en la tabla seleccionada hay que acceder al botón Add definition.
Insertando el nombre del metacampo, debajo aparecerá automáticamente el Namespace and key, que se puede abrir clicando sobre el mismo en el caso de querer personalizarlo.
Finalmente, Select type permite definir el metacampo eligiendo una de las opciones predeterminadas.
Para más información sobre gestión de metacampos consultar la documentación oficial de Shopify aquí.
Cómo mapear un metacampo en el canal
Para asignar un metacampo en el conector de Sales Layer ha de utilizarse la sintaxis "metafields” + "_" + namespace + "_" + key.
Por ejemplo, el siguiente metacampo configurado en Shopify tendría el nombre “metafields_saleslayer_expirydate” en el conector:
Atento: No se debe utilizar el carácter "_" en el espacio de nombres del metacampo.
Metacampos soportados
Para más información sobre cada metacampo consultar la documentación oficial de Shopify aquí.
Tipo | Descripción | Valor de ejemplo |
|---|---|---|
boolean | Valor verdadero o falso. | true |
collection_reference | Referencia a una colección de la tienda. En SL se puede mapear directamente con el ítem relacionado teniendo en cuenta que en Shopify solo permite relacionar un valor. Para vincular varias referencias a la vez a través del ítem relacionado, usar list.collection_reference en Shopify. | gid://shopify/ Collection/1 |
color | El código hexadecimal de un color. Para lista de valores usar list.color | #fff123 |
date | Una fecha en formato ISO 8601 sin una zona horaria presupuesta. | 2022-02-02 |
date_time | Una fecha en formato ISO 8601 sin zona horaria presupuesta. Por defecto en GMT. Para lista de valores usar list.date_time | 2022-01-01T12:30:00 |
dimension | Un valor y una unidad de longitud. Valores de unidad válidos: in, ft, yd, mm, cm, m. Para lista de valores usar list.dimension | { "value": 25.0, "unit": "cm"} |
file_reference | Una referencia a un archivo en la tienda. En SL se puede mapear directamente con el campo de imagen/archivo teniendo en cuenta que en Shopify solo permite relacionar un valor. Para vincular varias referencias a la vez a través del campo imagen/archivo, usar list.file_reference Los metafields de imágenes no se vinculan a las imágenes normales del producto en Shopify. Existen como entidades separadas. | gid://shopify/ MediaImage/123 |
JSON | Un valor en formato JSON. Puede ser un objeto, una matriz, una cadena, un número, un booleano o un valor nulo. | { "ingredient": "flour", "amount": 0.3} |
link | Texto junto con la URL. Puede usarse para guardar el contenido del enlace. Para lista de valores usar list.link
| {"text": "Learn more", "url": "https://shopify.com"} |
money | Una cantidad numérica, con un código de moneda que coincida con la moneda de la tienda. | {"amount": "5.99", "currency_code": "CAD"} |
multi_line_text_field | Un campo de texto multilínea. | Ingredients Flour Water Milk |
number_decimal | Un número con decimales en el rango de +/-9999999999999.999999999. Para lista de valores usar list.number_decimal | 10.4 |
number_integer | Un número entero comprendido entre +/-9,007,199,254,740,991. Para lista de valores usar list.number_integer | 10 |
page_reference | Una referencia a una página de la tienda. Nota: hay que indicar el valor exacto de la referencia | gid://shopify/ OnlineStorePage/1 |
product_reference | Una referencia a un producto en la tienda. En SL se puede mapear directamente con el ítem relacionado teniendo en cuenta que en Shopify solo permite relacionar un valor. Para vincular varias referencias a la vez a través del ítem relacionado, usar list.product_reference en Shopify. | gid://shopify/ Product/1 |
rating | Calificación medida en una escala determinada. Las validaciones son necesarias para las valoraciones y para soportar min y max. Para lista de valores usar list.rating | { "value": "3.5", "scale_min": "1.0", "scale_max": "5.0"} |
rich_text_field | Un campo de texto enriquecido que admite títulos, listas, enlaces, negrita y cursiva. Más información sobre el formato de texto enriquecido. | { "type": "root", "children": [ { "type": "paragraph", "children": [ { "type": "text", "value": "Bold text.", "bold": true } ] } ] } |
single_line_text_field | Un campo de texto de una sola línea. Para lista de valores usar list.single_line_text_field | VIP shipping method |
URL | Una URL con uno de los esquemas permitidos: https, http, mailto, sms, tel. Para lista de valores usar list.url | https://www.shopify.com |
variant_reference | Una referencia a una variante del producto en la tienda. En SL se puede mapear directamente con el ítem relacionado teniendo en cuenta que en Shopify solo permite relacionar un valor. Para vincular varias referencias a la vez a través del ítem relacionado, usar list.product_reference en Shopify. | gid://shopify/ ProductVariant/1 |
volume | Un valor y una unidad de volumen. Valores de unidad válidos: ml, cl, l, m3 (metros cúbicos), us_fl_oz, us_pt, us_qt, us_gal, imp_fl_oz, imp_pt, imp_qt, imp_gal. Para lista de valores usar list.volume | { "value": 20.0, "unit": "ml"} |
weight | Un valor y una unidad de peso. Valores de unidad válidos: oz, lb, g, kg. Para lista de valores usar list.weight | { "value": 2.5, "unit": "kg"} |
En los metacampos referenciados con la opción del envío de lista de valores hay que definir el tipo de metacampo en Shopify para poder seleccionar si ha de ser de valor único o lista de valores.
Nota importante: los tipos de metacampos multi-idioma que se encuentren fuera de los descritos en la lista, deberán ser testeados por el cliente para saber si son soportados. Se consideran fuera del alcance de la funcionalidad.
Los metacampos incluidos por defecto en el conector, metafields_global_title_tag y metafields_global_description_tag, son considerados legados (legacy) y se mantienen por retrocompatibilidad. Shopify recomienda el envío a través de seo_title y seo_description. Para más información sobre la configuración consultar el siguiente enlace.
