Usted está aquí:
Noticias en tiempo real de datos de ETL de categoría
Utilice las noticias en tiempo real de datos de Categoría ETL para agregar categorías a su catálogo al crear sus jerarquías de categorías. Puede actualizar categorías cargando archivos posteriores que incluyen Id. de categoría existentes. Las categorías están configuradas de forma predeterminada, pero puede agregar atributos para ellas.
Acerca del ingreso de datos de categoría
Las categorías admiten una estructura de jerarquía que permite a las categorías individuales tener categorías principales y secundarias. Una categoría solo puede tener una categoría principal, pero puede tener múltiples categorías secundarias. Algunas categorías de ejemplo son ropa, camisas, chaquetas, camisetas, camisas de vestir, chaquetas de lluvia y chaquetas de invierno.
Algunos ejemplos de jerarquías completas son ropa>camisas>camisetas, ropa>camisas>camisas de vestir, ropa>chaquetas>chaquetas de lluvia, ropa>chaquetas>chaquetas de invierno. Las noticias en tiempo real de datos de Categoría ETL crean estas relaciones utilizando el valor correspondiente del campo attribute:parentCategoryId.
- Cada categoría solo debe aparecer en un único registro en un archivo. Múltiples registros con el mismo Id. causan errores, especialmente si tienen diferentes Id. de categoría principal.
- La personalización actualiza todas las columnas (campos) que incluye en el archivo, sustituyendo los datos existentes por el contenido en las filas de la columna. Si una fila de columna está en blanco, Personalización elimina los datos existentes que se asignan a la fila en blanco. Si no desea actualizar o modificar un valor existente, no incluya la columna para ese valor en su archivo ETL.
- Los Id. de categoría en productos, o cualquier otro elemento de catálogo en Personalización, deben coincidir con los Id. de categoría proporcionados en el archivo ETL Categoría.
- Las noticias en tiempo real de datos de Categoría ETL no aceptan archivos delta. Debe enviar la estructura de categoría completa en el archivo, independientemente de si cada registro del archivo cambió. La personalización elimina valores existentes del catálogo cuando una columna contiene valores en blanco.
Requisitos
- Los archivos ETL deben tener un formato de archivo CSV que se ajuste al esquema de las noticias en tiempo real de datos. Los archivos que no siguen las convenciones de nomenclatura de archivos o el esquema apropiado dan como resultado errores y no se procesan.
- Los nombres de campo que comienzan por
attribute:deben coincidir con los nombres de atributo personalizados en la sección Atributos de la página Objetos de catálogo y perfil > Categoría.
Formato de nombre de archivo
category-YYYY-MM-DD_HH-MM-SS.csv
Esquema
| Nombre del campo | Descripción | Valores de ejemplo | Longitud máxima | Tipo de datos |
|---|---|---|---|---|
id
|
Obligatorio. Representa el identificador de la categoría. Los Id. de categoría no deben contener ninguna indicación de jerarquía. El archivo ETL construye la jerarquía para el catálogo. |
ropa camisas pantalones cat0001 |
255 |
Cadena |
attribute:
|
Los atributos personalizados para la categoría. Los encabezados de columna comienzan por |
attribute:commonName Toda la ropa attribute:size grande |
1023 |
Cualquiera |
attribute:parentCategoryId
|
Recomendado. El principal singular para un Id. de categoría. No se espera que las categorías raíz tengan un parentCategoryId y en su lugar se espera que tengan un valor de true en la columna attribute:department. Cada Id. debe tener un único parentCategoryId. La personalización utiliza identificadores de categoría principales para crear una jerarquía interna. Por ejemplo, una categoría de “pantalones” con un parentCategoryId de “pantalones de vestir” que tiene un parentCategoryId de “pantalones” da como resultado una jerarquía de pantalones|pantalones de vestir|pantalones. La profundidad máxima de jerarquía es de 10 niveles. |
ropa pantalones zapatos |
255 |
Cadena |
attribute:department
|
Representa si una categoría es una categoría de nivel superior. Este valor es falso de forma predeterminada. |
Verdadero Falso |
1023 |
Booleano |
attribute:name
|
Representa el nombre de la categoría y debe contener al menos un carácter alfanumérico. |
Calzado |
1023 |
Cadena |
attribute:url
|
URL compatible con RFC-3986 que representa la página de visualización canónica para la categoría. |
https://example.com/products/cat1.html |
1023 |
Cadena |
attribute:imageUrl
|
URL completamente cualificada para una imagen de la categoría. |
https://example.com/img/img1.png |
1023 |
Cadena |
attribute:description
|
Representa la descripción de la categoría y debe contener al menos un carácter alfanumérico. |
Zapatos de hombre |
250 |
Cadena |
attribute:promotable
|
Este campo toma como valor predeterminado true. Cuando se establece como falso, Personalización no devuelve el producto en el sistema de recomendación Recetas de Einstein. Si no se establece ningún valor, este campo toma como valor predeterminado true. |
TRUE |
1023 |
Booleano |
attribute:published
|
Cadena de fecha y hora ISO 8601 para la fecha de publicación de la categoría. Las compensaciones de zona horaria no son compatibles. |
2022-04-12T10:23:37Z |
1023 |
Fecha |
attribute:expiration
|
Cadena de fecha y hora ISO 8601 para la fecha de caducidad de la categoría. Las compensaciones de zona horaria no son compatibles. |
2022-04-12T10:23:37Z |
1023 |
Fecha |
attribute:rating
|
El valor de valoración asociado con la categoría. Sin embargo, no se requiere ninguna escala específica, proporcione solo el valor. 9 es válido, 9/10 no es válido. |
4.5 |
1023 |
Decimal/Flotante |
attribute:numRatings
|
El número de puntuajes asociados con la categoría. |
57 |
1023 |
Entero |
attribute:archived
|
Indica si la categoría es visible en el catálogo. Cuando true, la categoría no es visible. El valor predeterminado es false. Si se omite esta columna del archivo, no se realizan cambios en el atributo. Si no se establece ningún valor, este campo toma como valor predeterminado false. |
FALSE false TRUE true |
1023 |
Booleano |
Archivo de muestra
| Id. | attribute:parentCategoryId | atributo:departamento | atributo:nombre | atributo:archivado | atributo:url | attribute:imageUrl | atributo:descripción | atributo:promotable | atributo:publicado | atributo:caducidad | atributo:calificación | atributo:numRatings | attribute:commonName |
cat0001 |
TRUE |
Inicio |
FALSE |
test.com/c/home |
test.com/c/home.jpeg |
Todos los artículos para el hogar |
TRUE |
2020-06-15 |
2100-01-01 |
5.0 |
5 |
Artículos para el hogar |
|
cat002 |
TRUE |
Calzado |
FALSE |
test.com/c/zapatos |
test.com/c/shoes.jpeg |
Todos los zapatos |
TRUE |
2020-06-15 |
2100-01-01 |
4.25 |
10 |
Nuestros zapatos |
|
cat003 |
TRUE |
Camisas |
FALSE |
test.com/c/shirts |
test.com/c/shirts.jpeg |
Todas las camisas |
TRUE |
2020-06-15 |
2100-01-01 |
4.75 |
35 |
Nuestras camisas |
|
cat004 |
TRUE |
Pantalones |
FALSE |
test.com/c/pantalones |
test.com/c/pants.jpeg |
Todos los pantalones |
TRUE |
2020-06-15 |
2100-01-01 |
3.0 |
31 |
Nuestros pantalones |
|
cat005 |
TRUE |
Sombreros |
FALSE |
test.com/c/hats |
test.com/c/hats.jpeg |
Todos los sombreros |
TRUE |
2020-06-15 |
2100-01-01 |
3.0 |
11 |
Nuestros sombreros |
|
cat006 |
TRUE |
Accessories |
FALSE |
test.com/c/accessories |
test.com/c/accessories.jpeg |
Todos los accesorios |
FALSE |
2020-06-15 |
2100-01-01 |
18 |
Nuestros accesorios |
||
cat0021 |
cat002 |
Zapatillas |
FALSE |
test.com/c/home/zapatillas/zapatillas |
test.com/c/home/shoes/sneakers.jpeg |
Zapatillas deportivas para atletismo, caminar, correr y mucho más |
TRUE |
2020-06-15 |
Nuestras zapatillas |
||||
cat0041 |
cat004 |
Slacks |
FALSE |
test.com/c/pantalones/pantalones |
test.com/c/pants/slacks.jpeg |
Pantalones para trabajo y noche de citas |
TRUE |
2020-06-15 |
1.0 |
1 |
Nuestras holguras de negocio |
||
cat0061 |
cat006 |
Relojes |
FALSE |
test.com/c/accessories/watches |
test.com/c/accessories/watches.jpeg |
Nuestros relojes clásicos |
TRUE |
2020-06-15 |
4.5 |
8 |
Nuestros relojes |
||
cat00211 |
cat0021 |
Zapatillas de running |
FALSE |
test.com/c/shoes/sneakers/running-sneakers |
test.com/c/shoes/sneakers/running-sneakers.jpeg |
Zapatillas deportivas para carreras de ruta, carreras de trail, carreras de pista y mucho más |
TRUE |
2020-06-15 |
4.0 |
6 |
Nuestros entrenadores y corredores |
||
cat002111 |
cat00211 |
Picos de carreras |
FALSE |
test.com/c/shoes/sneakers/running-sneakers/racing-spikes |
test.com/c/shoes/sneakers/running-sneakers/racing-spikes.jpeg |
Zapatillas específicas para carreras en pistas |
TRUE |
2020-06-15 |
2.33 |
23 |
Nuestros picos de seguimiento y campo |
