Bộ sưu tập

Một Bộ sưu tập nhóm các sản phẩm lại để người mua hàng có thể tìm thấy chúng nhanh hơn - nghĩ đến “Giày chạy bộ” hoặc “Giảm giá mùa hè.”
DataEase cho phép bạn:

Tạo hoặc đổi tên hàng trăm bộ sưu tập chỉ trong một lần tải lên.
Thêm hoặc xóa sản phẩm, quy tắc, nguồn và điều kiện hàng loạt.
Thay đổi thứ tự sắp xếp, hình ảnh và văn bản SEO nhanh chóng.

Mô hình bộ sưu tập mới của Shopify (Admin API 2026-07). Shopify không còn chia bộ sưu tập thành “thông minh” và “thủ công” nữa. Một bộ sưu tập được xây dựng từ một hoặc nhiều nguồn; mỗi nguồn có điều kiện bao gồm/loại trừ và/hoặc sản phẩm, biến thể hoặc bộ sưu tập con được chọn thủ công. DataEase hỗ trợ mô hình này thông qua các cột Nguồn & điều kiện (chi tiết bên dưới). Các tệp có cột quy tắc và sản phẩm cổ điển vẫn hoạt động đối với các bộ sưu tập mà các cột cổ điển vẫn có thể mô tả được.

Hướng dẫn bộ sưu tập Shopify tại đây.

2. Xuất

Chọn CSV hoặc Excel.
Chọn Bộ sưu tập làm thực thể.
Chọn các trường bạn cần - title, sortOrder, ruleColumn, v.v. Để xuất các bộ sưu tập được xây dựng bằng mô hình mới, hãy bật nhóm cột Nguồn & điều kiện.
Tùy chọn: đánh dấu Tiêu đề và giá trị kiểu Matrixify để ghi các cột nguồn và điều kiện với tiêu đề và giá trị kiểu Matrixify (ví dụ Source: Type, Include, any condition) thay vì giá trị API (sourceType, INCLUDE, ANY).
Thực hiện tác vụ và tải xuống tệp của bạn.

Bộ sưu tập mà các cột cổ điển không thể mô tả. Nếu một bộ sưu tập sử dụng mô hình mới theo cách mà các cột quy tắc cổ điển không thể diễn đạt (ví dụ nhiều nguồn, loại trừ, nguồn biến thể, hoặc điều kiện kết hợp với lựa chọn thủ công), các ô ruleColumn/ruleRelation/ruleCondition/appliedDisjunctively của nó sẽ để trống và nhật ký xuất sẽ hiển thị cảnh báo yêu cầu bạn bật các cột Nguồn & điều kiện. Khi chỉ bật các cột cổ điển, bộ sưu tập như vậy chỉ được xuất với dòng chính của nó.

Hướng dẫn từng bước: Hướng dẫn xuất

3. Nhập

Các lệnh được hỗ trợ trong command: CREATE, UPDATE, REPLACE, DELETE, IGNORE
Lệnh mục dòng (quy tắc hoặc sản phẩm): CREATE, MERGE, UPDATE, DELETE, IGNORE

Đối với bộ sưu tập thủ công sử dụng dòng sản phẩm (productId).
Đối với bộ sưu tập thông minh sử dụng dòng quy tắc (ruleColumn / ruleCondition…).
Đối với bộ sưu tập sử dụng mô hình mới (nhiều nguồn, loại trừ, nguồn biến thể, bộ sưu tập con) sử dụng các cột Nguồn & điều kiện.

Chế độ được quyết định theo từng bộ sưu tập: nếu bất kỳ dòng nào của một bộ sưu tập điền vào một cột Nguồn & điều kiện (ví dụ sourceType hoặc conditionField), toàn bộ bộ sưu tập sẽ được nhập ở chế độ mới và các dòng productId / productHandle / productPosition của nó chỉ đặt vị trí sắp xếp — chúng không thêm hoặc xóa sản phẩm. Nếu không, hành vi cổ điển sẽ được áp dụng: dòng sản phẩm thêm (CREATE, MERGE), di chuyển (UPDATE), hoặc xóa (DELETE) các sản phẩm được chọn thủ công.

Dòng sản phẩm cổ điển trên một bộ sưu tập thông minh. Một tệp cổ điển với dòng sản phẩm (productId + itemCommand CREATE) cho một bộ sưu tập thông minh đã tồn tại giờ đây sẽ thêm các sản phẩm đó dưới dạng lựa chọn thủ công, khiến bộ sưu tập trở thành sự kết hợp giữa điều kiện và sản phẩm được chọn. Sau đó, các lần nhập quy tắc cổ điển cho bộ sưu tập đó (bao gồm cả nhập theo lịch đã lưu) sẽ thất bại với “The collection uses the new collections model (MIXED_SELECTIONS_AND_CONDITIONS)”. Hãy sử dụng các cột Nguồn & điều kiện cho các bộ sưu tập như vậy.

Mẹo: Chỉ các bộ sưu tập với sortOrder = MANUAL cho phép bạn đặt productPosition.

Tải xuống tệp mẫu: Collection-import-sample.xlsx
Điền vào các trường bắt buộc: title và handle cho CREATE; bao gồm id hoặc handle cho UPDATE/DELETE.
Ánh xạ các cột trong DataEase, tải lên và bắt đầu nhập.

Các bước đầy đủ: Hướng dẫn nhập

4. Tham chiếu trường

Cơ bản

id — ID Bộ sưu tập. Cần thiết cho UPDATE, REPLACE, hoặc DELETE.
command — Hành động cho dòng bộ sưu tập: CREATE, UPDATE, REPLACE, DELETE, IGNORE.
title — Tên hiển thị cho người mua hàng.
handle — Chuỗi thân thiện với URL. Phải là duy nhất.
descriptionHtml — Mô tả văn bản phong phú với HTML.
templateSuffix — Mẫu Liquid thay thế (không có .liquid).
sortOrder — Thứ tự sản phẩm mặc định: ALPHA_ASC, ALPHA_DESC, CREATED, CREATED_DESC, MANUAL, MOST_RELEVANT, PRICE_ASC, PRICE_DESC. Kể từ Admin API 2026-07, Shopify trả về các bộ sưu tập được sắp xếp theo bán chạy nhất dưới dạng MOST_RELEVANT, vì vậy các bản xuất ghi MOST_RELEVANT thay vì BEST_SELLING. BEST_SELLING không còn được DataEase hỗ trợ — hãy sử dụng MOST_RELEVANT trong tệp của bạn.
updatedAt — Ngày sửa đổi cuối cùng (ISO 8601). Chỉ xuất.

SEO

seoTitle — Thẻ tiêu đề trang tùy chỉnh.
seoDescription — Mô tả meta tùy chỉnh.

Hình ảnh

imageUrl — URL của hình ảnh nổi bật.
imageAltText — Văn bản thay thế cho hình ảnh.
imageHeight — Chiều cao hình ảnh (px). Chỉ xuất.
imageWidth — Chiều rộng hình ảnh (px). Chỉ xuất.

Mục dòng (quy tắc hoặc sản phẩm)

itemCommand — CREATE, MERGE, UPDATE, DELETE, hoặc IGNORE cho dòng này.

Trường quy tắc bộ sưu tập thông minh

Các cột cổ điển này chỉ được điền khi xuất nếu bộ sưu tập vẫn có thể được mô tả như một tập hợp quy tắc duy nhất; nếu không chúng sẽ để trống (xem Xuất).

ruleColumn — Thuộc tính sản phẩm cho quy tắc (ví dụ, TITLE, TAG, VENDOR).
ruleCondition — Giá trị mà quy tắc so sánh, như Shoes.
ruleConditionObjectId — Thông tin thêm cho một số loại quy tắc (ví dụ, ID danh mục).
ruleRelation — Toán tử: EQUALS, CONTAINS, NOT_EQUALS, v.v.
appliedDisjunctively — true = khớp với BẤT KỲ quy tắc nào; false = khớp với TẤT CẢ quy tắc.

Trường sản phẩm bộ sưu tập thủ công

productId — ID của một sản phẩm để bao gồm.
productPosition — Số vị trí (chỉ hoạt động nếu sortOrder = MANUAL).
productTitle — Tiêu đề sản phẩm. Chỉ xuất.
productHandle — Handle sản phẩm. Chỉ xuất.

Xuất bản

publicationScope — Kênh bán hàng nơi bộ sưu tập được xuất bản.

Metafields

metafields — Trường ứng dụng bổ sung. Xem Hướng dẫn Metafields.

5. Bộ lọc

CollectionType — Smart (with conditions) hoặc Custom (manual only). Mô hình mới của Shopify không có loại bộ sưu tập, vì vậy DataEase tự xác định từ các nguồn của bộ sưu tập: smart = có ít nhất một nguồn với điều kiện bao gồm; custom = mọi trường hợp khác (chỉ có sản phẩm được chọn thủ công, bộ sưu tập con, hoặc không có nguồn). Vì bộ lọc này được áp dụng sau khi Shopify trả về các bộ sưu tập, số lượng bộ sưu tập trong biểu mẫu xuất có thể hiển thị là ≤ N (tối đa N).
Handle — Xuất các bộ sưu tập mà handle chứa văn bản bạn nhập.
Id — Xuất một bộ sưu tập duy nhất theo id.
ProductId — Xuất các bộ sưu tập bao gồm một productId cụ thể.
ProductPublicationStatus — Lọc theo trạng thái xuất bản sản phẩm trong bộ sưu tập.
PublishableStatus — Chọn bộ sưu tập đã sẵn sàng, đã lên lịch hoặc chưa xuất bản.
PublishedAt — Khoảng thời gian khi bộ sưu tập trở nên hiển thị.
PublishedStatus — true cho đã xuất bản, false cho ẩn.
Title — Xuất các bộ sưu tập có title chứa văn bản của bạn.
UpdatedAt — Lọc theo khoảng thời gian cập nhật lần cuối.

Nguồn & điều kiện

Bật nhóm cột Nguồn & điều kiện để xuất và nhập bộ sưu tập theo mô hình bộ sưu tập mới của Shopify. Một dòng = một điều kiện hoặc một mục được chọn thủ công của một nguồn; các cột của nguồn lặp lại trên mỗi dòng của nguồn đó. Các cột cơ bản của bộ sưu tập (handle, title, …) lặp lại như bình thường.

Giá trị được chấp nhận theo kiểu API (INCLUDE, ALL, TAGGED_WITH, COMPARE_AT_PRICE) hoặc kiểu Matrixify (Include, all conditions, Includes, Compare at price), không phân biệt chữ hoa/thường. Các tệp được xuất từ trang tính Collections của Matrixify được nhận diện qua tiêu đề của chúng (Source: ID, Condition: Field, …).

sourceId — ID của nguồn. Sử dụng ID đã xuất để thay đổi một nguồn hiện có, hoặc nhãn của riêng bạn (ví dụ s1) để nhóm các dòng của một nguồn mới.
sourceCommand — MERGE (mặc định) thêm các dòng vào nguồn; REPLACE xóa nguồn và điền lại từ tệp; DELETE xóa nguồn.
sourceType — PRODUCTS, VARIANTS, COLLECTIONS (bộ sưu tập con), hoặc APP <app id> | PRODUCTS / APP <app id> | VARIANTS cho nguồn được chia sẻ bởi ứng dụng khác (chỉ đọc khi nhập). UNKNOWN chỉ dành cho xuất.
sourceTitle — Tiêu đề của nguồn. Nếu để trống khi tạo nguồn, DataEase sẽ tạo một tiêu đề từ tên bộ sưu tập.
sourceDescription — Mô tả của nguồn.
inclusionType — INCLUDE (mặc định) hoặc EXCLUDE.
inclusionMatch — ALL hoặc ANY: liệu sản phẩm có phải khớp với tất cả hay bất kỳ điều kiện bao gồm (hoặc loại trừ) nào của nguồn. Một nguồn mới mặc định là ALL.
conditionCommand — MERGE (mặc định) thêm điều kiện nếu chưa tồn tại; DELETE xóa nó. Để thay đổi giá trị của một điều kiện, hãy xóa điều kiện cũ và thêm điều kiện mới, hoặc sử dụng sourceCommand = REPLACE.
conditionField — TAG, TITLE, TYPE, VENDOR, STATUS, CATEGORY, CATEGORY_WITH_SUBCATEGORIES, PRICE, COMPARE_AT_PRICE, INVENTORY_STOCK, WEIGHT, VARIANT_TITLE, COLLECTION (chỉ loại trừ), MANUAL_SELECTION, METAFIELD: namespace.key, VARIANT_METAFIELD: namespace.key. UNKNOWN chỉ dành cho xuất (một điều kiện mà DataEase không thể ghi; các dòng như vậy sẽ bị bỏ qua khi nhập kèm cảnh báo).
conditionRelation — Toán tử, ví dụ TAGGED_WITH, EQUALS, CONTAINS, DOES_NOT_CONTAIN, GREATER_THAN, IS_SET, INCLUDES. Để trống đối với MANUAL_SELECTION và COLLECTION.
conditionValue — (Các) giá trị, phân tách bằng dấu phẩy (\, cho dấu phẩy thực). Giá cả chấp nhận đơn vị tiền tệ tùy chọn (12.50 EUR, mặc định = tiền tệ cửa hàng); trọng lượng chấp nhận đơn vị tùy chọn (1.5 kg, mặc định = đơn vị cửa hàng). Đối với MANUAL_SELECTION sử dụng một handle hoặc ID sản phẩm mỗi dòng, product-handle | Variant Title cho một biến thể, hoặc handle bộ sưu tập trong nguồn COLLECTIONS. Xuất ghi handle để các tệp có thể di chuyển giữa các cửa hàng.
conditionMatch — ANY (mặc định) hoặc ALL cho một điều kiện có nhiều giá trị; OR / AND được chấp nhận khi nhập.

Ở chế độ mới, các dòng productId / productHandle / productPosition chỉ đặt vị trí sắp xếp (đối với sortOrder = MANUAL). Giới hạn của Shopify đối với mô hình mới được kiểm tra trước khi lệnh nhập gọi Shopify: tối đa 10 nguồn mỗi bộ sưu tập, 60 điều kiện mỗi nguồn (mỗi giá trị được tính), 5 bộ sưu tập bị loại trừ, 10 bộ sưu tập con và 1.000 loại trừ thủ công.

Ví dụ — điều kiện thẻ cộng với một lựa chọn thủ công và một loại trừ thủ công trong một nguồn:

handle,title,sourceId,sourceType,sourceTitle,inclusionType,inclusionMatch,conditionField,conditionRelation,conditionValue,conditionMatch
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,ANY,TAG,TAGGED_WITH,"vegan,plant-based",ANY
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,INCLUDE,,MANUAL_SELECTION,,oat-milk,
vegan,Vegan picks,s1,PRODUCTS,Vegan tag,EXCLUDE,,MANUAL_SELECTION,,leather-belt,

Nhập lại cùng một tệp không tạo ra các nguồn hoặc điều kiện trùng lặp.

Cần trợ giúp? Đội ngũ hỗ trợ của chúng tôi sẽ trả lời trong vòng 24 giờ.

Các trường bổ sung

Nhiều cột hơn mà DataEase hỗ trợ cho thực thể này:

productsCount — Số lượng sản phẩm trong bộ sưu tập.