Koleksiyonlar

Bir Koleksiyon, ürünleri gruplandırarak alışveriş yapanların onları daha hızlı bulmasını sağlar - “Koşu Ayakkabıları” veya “Yaz İndirimi” gibi düşünün.
DataEase ile şunları yapabilirsiniz:

Tek bir yüklemede yüzlerce koleksiyon oluşturun veya yeniden adlandırın.
Ürünleri, kuralları, kaynakları ve koşulları toplu olarak ekleyin veya kaldırın.
Sıralama düzenini, görselleri ve SEO metnini hızlıca değiştirin.

Shopify’ın yeni koleksiyonlar modeli (Admin API 2026-07). Shopify artık koleksiyonları “smart” ve “custom” olarak ayırmıyor. Bir koleksiyon bir veya daha fazla kaynaktan (source) oluşur; her kaynağın include/exclude koşulları ve/veya manuel olarak seçilmiş ürünleri, varyantları veya alt koleksiyonları olabilir. DataEase bu modeli Kaynaklar ve koşullar sütunları aracılığıyla destekler (aşağıda ayrıntılar). Klasik kural ve ürün sütunlarını içeren dosyalar, klasik sütunların hâlâ tanımlayabildiği koleksiyonlar için çalışmaya devam eder.

Shopify koleksiyon kılavuzu.

2. Dışa Aktarma

CSV veya Excel seçin.
Varlık olarak Collection seçin.
İhtiyacınız olan alanları seçin - title, sortOrder, ruleColumn, vb. Yeni modelle oluşturulmuş koleksiyonları dışa aktarmak için Kaynaklar ve koşullar sütun grubunu etkinleştirin.
İsteğe bağlı: kaynak ve koşul sütunlarını API değerleri (sourceType, INCLUDE, ANY) yerine Matrixify başlıkları ve değerleriyle (örneğin Source: Type, Include, any condition) yazmak için Matrixify tarzı başlıklar ve değerler seçeneğini işaretleyin.
Görevi çalıştırın ve dosyanızı indirin.

Klasik sütunların tanımlayamadığı koleksiyonlar. Bir koleksiyon, klasik kural sütunlarının ifade edemeyeceği bir şekilde yeni modeli kullanıyorsa (örneğin birden fazla kaynak, hariç tutmalar, varyant kaynakları veya manuel seçimlerle karışık koşullar), ruleColumn/ruleRelation/ruleCondition/appliedDisjunctively hücreleri boş kalır ve dışa aktarma günlüğü Kaynaklar ve koşullar sütunlarını etkinleştirmenizi isteyen bir uyarı gösterir. Yalnızca klasik sütunlar etkinken, böyle bir koleksiyon yalnızca ana satırıyla dışa aktarılır.

Adım adım: Dışa aktarma kılavuzu

3. İçe Aktarma

command içinde desteklenen komutlar: CREATE, UPDATE, REPLACE, DELETE, IGNORE
Satır öğesi komutları (kurallar veya ürünler): CREATE, MERGE, UPDATE, DELETE, IGNORE

manual koleksiyonlar için ürün satırlarını (productId) kullanın.
smart koleksiyonlar için kural satırlarını (ruleColumn / ruleCondition…) kullanın.
Yeni modeli kullanan koleksiyonlar için (birden fazla kaynak, hariç tutmalar, varyant kaynakları, alt koleksiyonlar) Kaynaklar ve koşullar sütunlarını kullanın.

Mod koleksiyon bazında belirlenir: bir koleksiyonun herhangi bir satırı bir Kaynaklar ve koşullar sütununu doldurursa (örneğin sourceType veya conditionField), koleksiyonun tamamı yeni modda içe aktarılır ve productId / productHandle / productPosition satırları yalnızca sıralama pozisyonunu ayarlar — ürün eklemez veya kaldırmaz. Aksi halde klasik davranış geçerlidir: ürün satırları manuel olarak seçilmiş ürünleri ekler (CREATE, MERGE), taşır (UPDATE) veya kaldırır (DELETE).

Mevcut bir smart koleksiyonda klasik ürün satırları. Mevcut bir smart koleksiyon için ürün satırları (productId + itemCommand CREATE) içeren klasik bir dosya, artık bu ürünleri manuel seçim olarak ekler, böylece koleksiyon koşullar ve seçilmiş ürünlerin bir karışımı haline gelir. Bundan sonra bu koleksiyon için klasik kural içe aktarmaları (kayıtlı zamanlanmış içe aktarmalar dahil) “The collection uses the new collections model (MIXED_SELECTIONS_AND_CONDITIONS)” hatasıyla başarısız olur. Bu tür koleksiyonlar için Kaynaklar ve koşullar sütunlarını kullanın.

İpucu: Yalnızca sortOrder = MANUAL olan koleksiyonlar productPosition ayarlamanıza izin verir.

Örnek dosyayı indirin: Collection-import-sample.xlsx
Gerekli alanları doldurun: CREATE için title ve handle; UPDATE/DELETE için id veya handle ekleyin.
DataEase’de sütunları eşleyin, yükleyin ve içe aktarmayı başlatın.

Tam adımlar: İçe aktarma kılavuzu

4. Alan Referansı

Temel

id — Koleksiyon ID’si. UPDATE, REPLACE veya DELETE için gereklidir.
command — Koleksiyon satırı için eylem: CREATE, UPDATE, REPLACE, DELETE, IGNORE.
title — Alışveriş yapanlara gösterilen ad.
handle — URL dostu dize. Benzersiz olmalıdır.
descriptionHtml — HTML ile zengin metin açıklaması.
templateSuffix — Alternatif Liquid şablonu (.liquid olmadan).
sortOrder — Varsayılan ürün sırası: ALPHA_ASC, ALPHA_DESC, CREATED, CREATED_DESC, MANUAL, MOST_RELEVANT, PRICE_ASC, PRICE_DESC. Admin API 2026-07’den itibaren Shopify, en çok satanlara göre sıralanmış koleksiyonları MOST_RELEVANT olarak döndürür, bu yüzden dışa aktarmalar BEST_SELLING yerine MOST_RELEVANT yazar. BEST_SELLING artık DataEase tarafından desteklenmiyor - dosyalarınızda MOST_RELEVANT kullanın.
updatedAt — Son değiştirilme tarihi (ISO 8601). Yalnızca dışa aktarma.

SEO

seoTitle — Özel sayfa başlığı etiketi.
seoDescription — Özel meta açıklaması.

Görsel

imageUrl — Öne çıkan görselin URL’si.
imageAltText — Görsel için alternatif metin.
imageHeight — Görsel yüksekliği (px). Yalnızca dışa aktarma.
imageWidth — Görsel genişliği (px). Yalnızca dışa aktarma.

Satır öğesi (kural veya ürün)

itemCommand — Bu satır için CREATE, MERGE, UPDATE, DELETE veya IGNORE.

Akıllı koleksiyon kural alanları

Bu klasik sütunlar, dışa aktarmada yalnızca koleksiyon tek bir kurallar seti olarak tanımlanabildiğinde doldurulur; aksi halde boş kalır (bkz. Dışa Aktarma).

ruleColumn — Kural için ürün özelliği (örneğin, TITLE, TAG, VENDOR).
ruleCondition — Kuralın karşılaştırdığı değer, örneğin Shoes.
ruleConditionObjectId — Bazı kural türleri için ekstra bilgi (örneğin, kategori ID’si).
ruleRelation — Operatör: EQUALS, CONTAINS, NOT_EQUALS, vb.
appliedDisjunctively — true = HERHANGİ bir kuralla eşleşir; false = TÜM kurallarla eşleşir.

Manuel koleksiyon ürün alanları

productId — Dahil edilecek ürünün ID’si.
productPosition — Pozisyon numarası (yalnızca sortOrder = MANUAL ise çalışır).
productTitle — Ürün başlığı. Yalnızca dışa aktarma.
productHandle — Ürün handle’ı. Yalnızca dışa aktarma.

Yayın

publicationScope — Koleksiyonun yayınlandığı satış kanalları.

Metafields

metafields — Ekstra uygulama alanları. Metafields kılavuzu bakın.

5. Filtreler

CollectionType — Smart (with conditions) veya Custom (manual only). Shopify’ın yeni modelinde koleksiyon türü olmadığından, DataEase bunu koleksiyonun kaynaklarından çıkarır: en az bir include koşuluna sahip kaynak varsa smart; diğer her durumda (yalnızca manuel seçilmiş ürünler, alt koleksiyonlar veya hiç kaynak yoksa) custom. Bu filtre Shopify koleksiyonları döndürdükten sonra uygulandığından, dışa aktarma formundaki koleksiyon sayısı ≤ N (en fazla N) olarak gösterilebilir.
Handle — handle içeren metni girdiğiniz koleksiyonları dışa aktarın.
Id — Tek bir koleksiyonu id ile dışa aktarın.
ProductId — Belirli bir productId içeren koleksiyonları dışa aktarın.
ProductPublicationStatus — Koleksiyon içindeki ürün yayın durumu ile filtreleyin.
PublishableStatus — Hazır, planlanmış veya yayınlanmamış koleksiyonları seçin.
PublishedAt — Koleksiyonun görünür hale geldiği tarih aralığı.
PublishedStatus — Yayınlanmış için true, gizli için false.
Title — title metninizi içeren koleksiyonları dışa aktarın.
UpdatedAt — Son güncellenme tarih aralığı ile filtreleyin.

Kaynaklar ve koşullar

Shopify’ın yeni koleksiyonlar modelinde koleksiyonları dışa ve içe aktarmak için Kaynaklar ve koşullar sütun grubunu etkinleştirin. Bir satır = bir kaynağın bir koşulu veya manuel olarak seçilmiş bir öğesi; kaynak sütunları o kaynağın her satırında tekrar eder. Koleksiyonun temel sütunları (handle, title, …) her zamanki gibi tekrar eder.

Değerler API stilinde (INCLUDE, ALL, TAGGED_WITH, COMPARE_AT_PRICE) veya Matrixify stilinde (Include, all conditions, Includes, Compare at price), büyük/küçük harfe duyarsız şekilde kabul edilir. Matrixify’ın Collections sayfasından dışa aktarılan dosyalar, başlıklarından (Source: ID, Condition: Field, …) tanınır.

sourceId — Kaynağın ID’si. Mevcut bir kaynağı değiştirmek için dışa aktarılan ID’yi, yeni bir kaynağın satırlarını gruplamak için ise kendi etiketinizi (örneğin s1) kullanın.
sourceCommand — MERGE (varsayılan) satırları kaynağa ekler; REPLACE kaynağı temizler ve dosyadan doldurur; DELETE kaynağı kaldırır.
sourceType — PRODUCTS, VARIANTS, COLLECTIONS (alt koleksiyonlar) veya başka bir uygulama tarafından paylaşılan bir kaynak için APP <app id> | PRODUCTS / APP <app id> | VARIANTS (içe aktarmada salt okunur). UNKNOWN yalnızca dışa aktarmada kullanılır.
sourceTitle — Kaynağın başlığı. Bir kaynak oluşturulduğunda boşsa, DataEase koleksiyon başlığından bir tane oluşturur.
sourceDescription — Kaynağın açıklaması.
inclusionType — INCLUDE (varsayılan) veya EXCLUDE.
inclusionMatch — ALL veya ANY: ürünlerin kaynağın include (veya exclude) koşullarının tümüyle mi yoksa herhangi biriyle mi eşleşmesi gerektiği. Yeni bir kaynak varsayılan olarak ALL kullanır.
conditionCommand — MERGE (varsayılan) koşul henüz yoksa ekler; DELETE kaldırır. Bir koşulun değerini değiştirmek için eski koşulu silip yenisini ekleyin, veya sourceCommand = REPLACE kullanın.
conditionField — TAG, TITLE, TYPE, VENDOR, STATUS, CATEGORY, CATEGORY_WITH_SUBCATEGORIES, PRICE, COMPARE_AT_PRICE, INVENTORY_STOCK, WEIGHT, VARIANT_TITLE, COLLECTION (yalnızca exclude), MANUAL_SELECTION, METAFIELD: namespace.key, VARIANT_METAFIELD: namespace.key. UNKNOWN yalnızca dışa aktarmada kullanılır (DataEase’in yazamadığı bir koşul; bu satırlar içe aktarmada bir uyarıyla atlanır).
conditionRelation — Operatör, örneğin TAGGED_WITH, EQUALS, CONTAINS, DOES_NOT_CONTAIN, GREATER_THAN, IS_SET, INCLUDES. MANUAL_SELECTION ve COLLECTION için boş bırakın.
conditionValue — Değer(ler), virgülle ayrılmış (gerçek bir virgül için \,). Fiyatlar isteğe bağlı bir para birimi kabul eder (12.50 EUR, varsayılan = mağaza para birimi); ağırlıklar isteğe bağlı bir birim kabul eder (1.5 kg, varsayılan = mağaza birimi). MANUAL_SELECTION için satır başına bir ürün handle’ı veya ID’si, bir varyant için product-handle | Variant Title, veya bir COLLECTIONS kaynağında bir koleksiyon handle’ı kullanın. Dışa aktarma, dosyaların mağazalar arasında taşınabilmesi için handle yazar.
conditionMatch — Birden fazla değere sahip bir koşul için ANY (varsayılan) veya ALL; içe aktarmada OR / AND da kabul edilir.

Yeni modda, productId / productHandle / productPosition satırları yalnızca sıralama pozisyonunu ayarlar (sortOrder = MANUAL için). Yeni model için Shopify’ın sınırları, içe aktarma Shopify’ı çağırmadan önce kontrol edilir: koleksiyon başına en fazla 10 kaynak, kaynak başına 60 koşul (her değer sayılır), 5 hariç tutulan koleksiyon, 10 alt koleksiyon ve 1.000 manuel hariç tutma.

Örnek — tek bir kaynakta etiket koşulu, artı bir manuel seçim ve bir manuel hariç tutma:

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,

Aynı dosyayı yeniden içe aktarmak, kaynakların veya koşulların kopyalarını oluşturmaz.

Yardıma mı ihtiyacınız var? Destek ekibimiz 24 saat içinde yanıt verir.

Ek alanlar

DataEase’in bu varlık için desteklediği daha fazla sütun:

productsCount — Koleksiyondaki ürün sayısı.