Administrador de X Shopping

Guía de especificaciones de productos

El Administrador de X Shopping es un recurso integral único y centralizado donde podrás encontrar las herramientas de gestión que te permitirán incorporarte como comerciante y acceder al catálogo de productos. Utiliza la guía a continuación para estructurar tu archivo CSV con el catálogo de productos y subirlo al Administrador de X Shopping de forma adecuada. Puedes subir un archivo de hasta 100 MB en el momento que lo desees. 

Entre los productos que se utilizarán para crear tus conjuntos de productos y configurar tu presencia en la experiencia de compras, se encuentran los siguientes: Shop Spotlight, X Shops, Live Shopping y Dynamic Product Ads.

Pasar a: Especificaciones obligatorias || Especificaciones opcionales

 

Especificaciones obligatorias

Asegúrate de que todos los campos que aparecen aquí abajo estén incluidos en tu archivo CSV cuando lo subas al Administrador de X Shopping.

Atributo y tipo del producto

Descripción

Atributo y tipo del producto

id

Tipo: cadena

Descripción

Límite máximo de caracteres: 100

Identificador único para el artículo. Utiliza el SKU si es posible. Si hay varias instancias del mismo identificador, se las ignorará a todas.

Valor de ejemplo:

  • TWSHOES-22

Atributo y tipo del producto

title

Tipo: cadena

Descripción

Límite máximo de caracteres: 150

El nombre del producto. Debe ser el mismo nombre que el producto que aparece en la página de destino de productos que se proporcionó a través de los atributos "link" o "mobile_link".

Valor de ejemplo:

  • Calzado deportivo X Premium

Atributo y tipo del producto

description

Tipo: cadena

Descripción

Límite máximo de caracteres: 5000 (texto libre)

La descripción del producto. Este campo no admite HTML y debe estar en texto sin formato.

Valor de ejemplo:

  • X Premium, una opción deportiva elegante y a la moda, es el primer calzado de este tipo en X. Está hecho con algodón suave y transpirable. Y viene en un color azul que combina con la marca de X.

Atributo y tipo del producto

availability

Tipo: cadena

Descripción

Disponibilidad actual de tu artículo. Selecciona uno de los valores posibles en la siguiente lista.

Valores posibles:

  • en stock
  • disponible para pedidos
  • con pedido previo
  • fuera de stock
  • se discontinuó

Atributo y tipo del producto

condition

Tipo: cadena

Descripción

Condición del artículo que está a la venta. Selecciona uno de los valores posibles en la siguiente lista.

Valores posibles:

  • nuevo
  • usado
  • renovado

Atributo y tipo del producto

price

Tipo: cadena

Descripción

Precio del artículo. El formato que debes utilizar para el precio tiene que incluir un número seguido del código de moneda ISO de 3 dígitos (estándares ISO 4217), con un espacio entre el valor y la moneda. Usa un punto (".") como marca decimal.

Valores de ejemplo:

  • 99.99 USD
  • 20.00 CAD

Atributo y tipo del producto

link

Tipo: cadena

Descripción

URL de la página de producto específica donde las personas pueden comprar el artículo. Si un usuario está en un dispositivo móvil, y se incluye un atributo "mobile_link", a ese usuario se lo dirigirá a la URL proporcionada mediante ese atributo.

Validaremos la URL según las RFC. Específicamente, debe incluir "https" o "http".

Valor de ejemplo:

  • https://www.X.com/twtr_blue

Atributo y tipo del producto

image_link

Tipo: cadena

Descripción

URL para la imagen principal de tu artículo. Si cambias la imagen más adelante, la imagen nueva deberá tener una URL diferente, si no, la imagen no se actualizará.

Especificaciones de imagen:

  • Todas las imágenes deben estar en formato JPG, GIF, WEBP o PNG.
  • Recomendamos muy especialmente que las imágenes de productos tengan formato cuadrado (1:1).
  • El tamaño mínimo de la imagen es de 500 x 500 px.
  • Tamaño límite del archivo de imagen: 5 MB.

Valor de ejemplo:

  • https://t.co/demin_jeans_452.jpg

Atributo y tipo del producto

brand, gtin o mpn

Tipo: cadena

Descripción

Solo se requiere uno (1) de los atributos brand, gtin o mpn; sin embargo, se recomienda incluirlos a todos si están disponibles.

Límite máximo de caracteres para todos: 100

  • "Brand" hace referencia al nombre de la marca del artículo. Valor de ejemplo: X
  • "gtin" hace referencia al código comercial global de artículo (identificador de producto único universal) del artículo. Ingresa el UPC, EAN, JAN o ISBN del artículo. Valor de ejemplo: 012345678901
  • "mpn" hace referencia al número de pieza del fabricante del artículo. Valor de ejemplo: TW123456TTER
 

Especificaciones opcionales

Todos los campos que aparecen a continuación son opcionales, y puedes incluirlos o no en tu archivo CSV cuando lo subas al Administrador de X Shopping. Sin embargo, en muchos casos, lo recomendable es proporcionar contexto adicional para los productos que muestres en X.

Atributo y tipo del producto

Descripción

Atributo y tipo del producto

mobile_link

Tipo: cadena

Descripción

URL de la versión optimizada para dispositivos móviles de la página de producto específica donde las personas pueden comprar el artículo. Si un usuario está en un dispositivo móvil, a ese usuario se lo dirigirá a la URL proporcionada mediante el atributo "mobile_link".

Validaremos la URL según las RFC. Específicamente, debe incluir "https" o "http".

Valor de ejemplo:

  • https://lite.twttr.com/twtr_blue

Atributo y tipo del producto

additional_image_link

Tipo: cadena

Descripción

Para agregar más imágenes de tu artículo, utiliza "additional_image_link". Las URL deben estar separadas por comas. Sigue las mismas especificaciones que se mencionaron en el atributo "image_link". Puedes incluir hasta 10 imágenes adicionales.

Valor de ejemplo:

  • https://t.co/jeans_1.jpg, https://t.co/jeans_2.jpg, https://t.co/demin_jeans_3.jpg

Atributo y tipo del producto

google_product_category

Tipo: cadena

Descripción

La categoría del artículo, según la taxonomía de productos de Google. Utiliza la ruta taxonómica de la categoría, o bien su número de identificación de categoría. Ten en cuenta que, en algunos casos, los usuarios de X podrán ver esta categoría.

Valores de ejemplo:

  • Electrónica > Consolas de videojuegos
  • 1294

Atributo y tipo del producto

product_type

Tipo: cadena

Descripción

La categoría a la que pertenece el artículo, según la taxonomía de producto personalizada de tu empresa, si tienes una. También puedes ingresar una categoría de producto de Google (google_product_category). Las subcategorías deben enviarse separadas por " > ". El símbolo > debe estar entre espacios. Ten en cuenta que, en algunos casos, los usuarios de X podrán ver esta categoría.

Valor de ejemplo:

  • Vestimenta > Para hombre > Pantalones > Vaqueros

Atributo y tipo del producto

inventory

Tipo: valor entero

Descripción

Debe ser >= 0

La cantidad de este artículo que tienes disponible para vender en X. Si se lo incluye, el valor de inventario de un artículo debe ser 1, o bien un valor superior, cuando su campo de disponibilidad se establece como "en stock" para que el artículo se les muestre a los usuarios. De lo contrario, este valor podría ser mayor que 0, o bien igual a esta cifra, cuando su campo de disponibilidad se establece como "disponible para pedidos" o "con pedido previo" para que el artículo se les muestre a los usuarios.

Valor de ejemplo:

  • 10 000

Atributo y tipo del producto

sale_price

Tipo: cadena

Descripción

Debe ser >= 0

El precio del artículo con descuento. El formato que debes utilizar para el precio tiene que incluir un número seguido del código de moneda ISO de 3 dígitos (estándares ISO 4217), con un espacio entre el valor y la moneda. Usa un punto (".") como marca decimal. El atributo "sale_price" debe ser menor que el del precio.

Valores de ejemplo:

  • 89.99 USD
  • 15.00 CAD

Atributo y tipo del producto

sale_price_effective_date

Tipo: una o dos marcas de tiempo ISO-8601

Descripción

Intervalo de tiempo para el período de rebaja del artículo, incluida la fecha, la hora y la zona horaria en que tu rebaja empieza y termina. Si las fechas de la rebaja no se ingresan, los artículos que tengan un atributo "sale_price" seguirán en rebaja hasta que les quites el precio con descuento.

Es posible proporcionar solo una fecha de inicio sin una de finalización, en cuyo caso el precio con descuento permanecerá en la rebaja desde la fecha de inicio hasta el momento en que dicho precio se retire.

Formato: AAAA-MM-DDT23:59+00:00/AAAA-MM-DDT23:59+00:00

La fecha de inicio debe ser anterior a la de finalización.

Instrucciones detalladas:

  1. Escribe la fecha de inicio con el formato AAAA-MM-DD.
  2. Escribe "T" después de la fecha de inicio.
  3. Escribe la hora de inicio en un formato de 24 horas (00:00 a 23:59), seguida de la zona horaria UTC (-12:00 to +14:00).
  4. Escribe una "/" y, luego, repite el mismo formato para la fecha y la hora de finalización de la rebaja del artículo.

El ejemplo que aparece a continuación utiliza la zona horaria PST (-08:00).

Valor de ejemplo:

  • 2020-06-28T09:00-08:00/2020-07-28T23:59-08:00

Atributo y tipo del producto

item_group_id

Tipo: cadena

Descripción

Límite máximo de caracteres: 100

Utiliza el atributo "item_group_id" para agrupar las variantes de un producto. Las variantes son un grupo de artículos similares que solo se diferencian entre sí por los detalles de cada producto, como el tamaño, el color, el "age_group" o el género. Es obligatorio utilizar este campo si tu producto tiene variantes.

Valor de ejemplo:

  • twtrshoes1234_12

Atributo y tipo del producto

gender

Tipo: cadena

Descripción

Determina el género para el tamaño del artículo. Selecciona uno de los valores posibles en la siguiente lista.

Valores posibles:

  • femenino
  • masculino
  • unisex

Atributo y tipo del producto

color

Tipo: cadena

Descripción

Límite máximo de caracteres: 100

El color principal del producto. Utiliza una o más palabras para describir el color. No uses el código hexadecimal.

Valores de ejemplo:

  • azul
  • verde bosque

Atributo y tipo del producto

size

Tipo: cadena

Descripción

Límite máximo de caracteres: 100

Tamaño del artículo escrito en palabra, abreviatura o número.

Valores de ejemplo:

  • medio
  • M
  • 6

Atributo y tipo del producto

age_group

Tipo: cadena

Descripción

El grupo etario asociado al artículo. Selecciona uno de los valores posibles en la siguiente lista.

Valores posibles:

  • adultos
  • todas las edades
  • adolescentes
  • niños
  • niños pequeños
  • bebés
  • recién nacidos

Atributo y tipo del producto

custom_label

Tipo: cadena

Descripción

Hasta cinco campos personalizados (custom_label_0, custom_label_1, custom_label_2, custom_label_3, custom_label_4) para cualquier información adicional según la cual desees filtrar los artículos cuando creas conjuntos de productos basados en filtros.

Por ejemplo, podrías utilizar un campo de etiqueta personalizado para indicar todos los productos que son parte de una rebaja de verano y, luego, filtrar esos productos en un conjunto de productos. Estos campos admiten cualquier valor de cadena.

Ejemplo:

  • Venta de días festivos

¿Todo listo para comenzar?