Shopify Metafields Kurulumu: Geliştirici için Adım Adım Kurulum Rehberi

Shopify metafields'i doğru şekilde kurmak için her zaman aynı üç adımlı döngüyü izlersiniz: adminde bir tanım oluşturun (veya GraphQL yolu ile), her kaynağa değer girin, ardından bu değerleri temada Liquid veya dinamik kaynak aracılığıyla gösterin. Herhangi bir adımı atlarsanız veya kısaltırsanız, ya görünmez veriler ya da bozuk şablonlar elde edersiniz. Bu döngü değişmemiştir, ancak bir tanımla 2026'da neler yapabileceğiniz önemli ölçüde genişlemiştir.

Temel çıkarımlar

• Metafields sahip kaynağı, namespace ve anahtar ile tanımlanır. Herhangi birini değiştirirseniz, farklı bir alana başvurursunuz.
• Standart tanımlar (bakım talimatları, renk, boyut, bileşenler) önceden yapılandırılmış, tema uyumlu ve uygulama ile birlikte çalışabilen şekildedir. Özel bir namespace oluşturmadan önce bunları kullanın.
• API sürümü 2026-04 itibariyle, sepet metafields'i cartToOrderCopyable yeteneği ile ödeme sırasında otomatik olarak sipariş metafields'ine kopyalanabilir.
• 2026-04 itibariyle, analyticsQueryable yeteneği herhangi bir metafield'i Shopify Analytics ve ShopifyQL'de canlı bir boyut ve filtre haline getirir.
• 2026-10 itibariyle, GraphQL Admin API filtreleme için işaretlenmeyen bir metafield'e göre filtreleme yaptığınızda sessizce göz ardı etmek yerine bir hata verir. Yükseltmeden önce sorgularınızı denetleyin.
• Siyah Cuma 2026 27 Kasım'da olduğundan, şu an (ekim sonunda) metafield şemanız kilitlemek için tam doğru zamandır; çünkü BFCM hazırlığı devam ederken namespace veya anahtarı değiştirmek Liquid başvurularını ve Flow otomasyon tetikleyicilerini aynı anda bozar.

Bu BFCM döngüsü için neden metafield kurulumu daha önemlidir

Siyah Cuma 2026 27 Kasım'da, Siber Pazartesi ise 30 Kasım'da olacak ve planlama dört günlük hafta sonunu kapsayacaktır. Bunu 27 Ekim'de okuyorsunuz, yani tam olarak bir ayınız var. Bu, BFCM hazırlıkları devam ettikten sonra metafield şemanızda yaptığınız herhangi bir yapısal değişikliğin en yüksek trafikli günlerinizde test edilmemiş olarak yayınlandığı anlamına gelecek kadar sıkıdır.

Takvim ötesinde ikinci bir neden vardır. Yapay zeka destekli alışveriş asistanları ürün açıklamalarını insanların yaptığı şekilde okumaz; yapılandırılmış verileri analiz ederler. Bir müşteri yapay zeka ajanından belirli bir fiyat altında vegan deri çantalar göstermesini ve belirli bir garanti istediğinde, ajan malzeme, garanti_süresi ve fiyat gibi yapılandırılmış alanları arar. Shopify tüm yıl boyunca metafields'i bu pipeline'a daha derinlemesine entegre etmiştir. değişim yapan kontrol noktaları yapılandırılmış ürün verileri, temiz metafields, düz İngilizce yazılmış politika sayfaları, güven sinyalleri için şema işaretleme ve yapay zeka ajanının mağazanızı önermenin bir nedeni olarak alıntı yapabileceği marka tanımlayan içeriktir. Kataloğunuz BFCM'ye yazılı bir açıklama içine gömülü verilerle girerse, yapay zeka kanalı trafiği sizi geçecektir.

Adım 1: Tanımı oluşturun

Shopify admininde Ayarlar > Özel veriler > Metafields'a gidin ve kaynak türünü (Ürünler, Varyantlar, Koleksiyonlar, Müşteriler, Siparişler, vb.) seçin. Tanım ekle'ye tıklayın.

İki yol arasından seçim yapıyorsunuz:

• Standart tanım: Shopify, uygulamalar ve temalar tarafından zaten nasıl tüketileceği bilinecek önceden oluşturulmuş şemalar. Örnekler descriptors.care_guide, information.ingredients, measurements.weight içerir. Standart tanımlar Shopify'ın adlandırma kurallarını izler ve temalar, uygulamalar ve yapay zeka ajanları ile otomatik olarak uyumludur. Shopify zaten bir standart renk tanımına sahip olduğunda custom.colour alanı oluşturmak, verilerinizin ekosistem ile sorunsuz bir şekilde entegre olmayacağı anlamına gelir.
• Özel tanım: custom.shelf_life_days gibi kendi namespace ve anahtarınız. Standart bir tanım konsepti kapsamadığında bunu kullanın.

Doldurduğunuz alanlar:

• Ad: adminde gösterilen etiket (örn., "Bakım Talimatları").
• Namespace ve anahtar: Liquid ve API çağrılarında kullanılan teknik tanımlayıcı (örn., custom.care_instructions). Değerleri doldurduktan sonra namespace'i veri taşıması yapmadan yeniden adlandıramazsınız.
• İçerik türü: tek satırlı metin, çok satırlı metin, tamsayı, ondalık, renk, tarih, dosya, URL, JSON, ürün başvurusu, vb. Uygun olan en dar türü seçin. Yazılı alanlar yazma sırasında doğrular ve Liquid'de tahmin edilebilir bir şekilde işlenir.
• Yetenekler: aşağıdaki Adım 1b'ye bakın.

Adım 1b: Doğru yetenekleri etkinleştirin

Yetenekler, 2026 tanımlarını önceki olanlardan anlamlı bir şekilde farklı kılar. Her biri tanım üzerinde bir bayraktır, değer değildir.

analyticsQueryable yeteneği şu anda MetafieldDefinition.capabilities aracılığıyla GraphQL Admin API'deki MetafieldDefinition türünde mevcuttur ve metafieldDefinitionCreate ve metafieldDefinitionUpdate ile yapılandırılabilir.

Bu yeteneği etkin olarak bir tanım oluşturmak için mutasyondur:

mutation {
 metafieldDefinitionCreate(definition: {
 name: "Fabric"
 namespace: "custom"
 key: "fabric"
 type: "single_line_text_field"
 ownerType: PRODUCT
 capabilities: {
 analyticsQueryable: { enabled: true }
 }
 }) {
 createdDefinition {
 id
 capabilities {
 analyticsQueryable { enabled }
 }
 }
 userErrors { field message }
 }
}

Etkinleştirildikten sonra, metafield ShopifyQL ve Shopify Analytics'te bir boyut ve filtre haline gelir. Bu şu anda PRODUCT, PRODUCTVARIANT, ORDER ve CUSTOMER sahip türlerini destekler.

cartToOrderCopyable deseni için: API sürümü 2026-04 namespace'ler ve anahtarlar eşleştiğinde, siparişin oluşturulması sırasında sepet metafields'inin otomatik olarak sipariş metafields'ine yayılmasını tanıtır. Ürün kişileştirme jetonları ve sadakat meta verilerinden teslimat talimatları veya üçüncü taraf kargo bayraklarına kadar özel sepet düzeyinde verilerine dayanan mağazalar için bu, sepet ve sipariş arasında veri sürekliliğini basitleştirir.

Kontrol etmek için bir diğer 2026-10 bayrağı: [[extensions.metafields]] ve [[extensions.targeting.metafields]] içindeki Metafield bildirimleri artık owner_type (örn. PRODUCT veya CUSTOMER gibi) kabul ederler, bu nedenle Shopify yalnızca uzantınızın ihtiyaç duyduğu metafields'i getirir. Daha sonraki API sürümleri onu atlayan dağıtımları engeller.

Adım 2: Değerleri doldurun

Tanım mevcut olduktan sonra, değerler her kaynak örneğine girilir. Bunu yapmak için üç yol:

• Admin Kullanıcı Arayüzü: herhangi bir ürünü (veya siparişi, koleksiyonu, müşteri) açın ve Özel veri bölümüne kaydırın. Tanımı tanım listesinde ilk sabitleyin (aşağıdaki Adım 4), böylece kaymadan öne çıkar.
• CSV üzerinden toplu: ürün ve varyant metafields için çalışır. Sütun başlığı biçimi standart Shopify ürün dışarı aktarımında metafields.namespace.key [type] şeklindedir.
• GraphQL metafieldsSet mutasyonu: programlı geri doldurma veya ERP entegrasyonları için doğru yaklaşım. Çağrı başına 25 metafield'e kadar kabul eder.

Büyük kataloglar için (10.000'in üzerinde SKU'ya sahip bir tane yönetiyorum), toplu CSV ilk popülasyon için en hızlı yoldur, ancak GraphQL mutasyonu devam eden harici sistem senkronizasyonu için istediğiniz şeydir. Tek bir metafieldsSet çağrısı herhangi bir kaynak kimliğini ve herhangi bir namespace/anahtar çiftini hedefleyebilir.

Adım 3: Temada görüntüleyin

Metafields'in Shopify admininde tanımlanması veya API kullanan bir uygulama tarafından oluşturulması gerekir. Liquid yalnızca mevcut metafield değerlerini okuyabilir ve görüntüleyebilir; şablon içinde yeni metafield tanımları oluşturamaz.

İki görüntüleme yolunuz vardır:

Yol A: Tema editöründe dinamik kaynak (kod yok)

Herhangi bir Online Store 2.0 temada tema editörünü açın, dinamik kaynakları destekleyen bir blok seçin (örn. ürün şablonundaki metin bloğu), içerik alanının yanındaki veritabanı simgesine tıklayın ve metafield'inizi seçin. Shopify Liquid başvurusunu otomatik olarak oluşturur. Bu, teknik olmayan tüccarlar ve içerik editörünün canlı olarak önizlemesi gereken herhangi bir alan için doğru yaklaşımdır.

Yol B: Liquid (kod kontrolü)

Erişim deseni her zaman:

{{ resource.metafields.namespace.key.value }}

Örneğin, bir ürün bakım kılavuzu:

{% assign care = product.metafields.custom.care_instructions.value %}
{% if care != blank %}
 <div class="care-guide">{{ care }}</div>
{% endif %}

Bilmeniz gereken bazı türe özgü desenler:

• Tek satırlı metin, çok satırlı metin, tamsayı, ondalık: .value ham değeri doğrudan döndürür.
• Dosya (görüntü, video): .value bir GenericFile nesnesi döndürür ve .url özelliğine sahiptir. Görüntüler için .value | image_url: width: 800 kullanın.
• Ürün başvurusu: .value bir product nesnesi döndürür. Liste türleri için {% for p in metafield.value %} ile yineleyin.
• JSON: .value ayrıştırılmış nesneyi doğrudan Liquid'de döndürür. Anahtarlara nokta veya köşeli parantez notasyonu ile erişin.
• Renk: .value bir CSS onaltılı dizesi döndürür (örn., #ff6600).

Yaygın bir hata: yazılı metafields için .value'yu atlamak. Onsuz içerik yerine tam metafield nesnesini (türü, namespace, anahtarı vb. içeren) alırsınız.

Çıktınızı kontrol etme

Bir metafield'in beklediğiniz şeyi işleyip işlenmediğini doğrulamak için geçici olarak şablonunuza bu hata ayıklamalarını bırakın:

{% log product.metafields.custom.care_instructions %}

{% log %} etiketi, personel olarak oturum açtığınızda depo önizleme çubuğundan mevcuttur olan tarayıcıdaki Shopify tema müfettişine yazar. Canlı ortamına göndermeden önce günlüğü kaldırın.

Metafield türlerine bakış

Adım 4: Tanımınızı sabitleyin

Tanım listesinde (Ayarlar > Özel veriler), ekibinizin en sık doldurduğu tanımları sabitleyin. Sabitlenmiş alanlar, Özel veri bölümünü genişletmek zorunda kalmadan her kaynak düzenleme sayfasının en üstünde görünür. Bu, BFCM son tarihi gelmeden önce yüzlerce ürünü düzenleyen bir içerik takımı için çok büyük önem taşıyan küçük bir UX ayrıntısıdır.

Denetlemeniz gereken 2026-10 filtre değişikliği

GraphQL Admin API artık filtreleme için geçerli olmayan bir metafield'e göre filtreleme yaptığınızda sessizce göz ardı etmek yerine bir hata döndürür. Yükseltmeden önce etkilenen metafield filtre sorgularını güncelleyin ve tanımların filtreleme ve karşılaştırma operatörlerini desteklediklerinden emin olun. Bu, metafield yüklemi kullanan koleksiyon veya ürün sorgularında herhangi bir özel uygulama veya entegrasyon için geriye dönük uyumluluğu bozan bir değişikliktir. metafieldDefinitions çalıştırarak tanımlarınızı listeleyin ve filtreleme yaptığınız her alan için adminFilterable yeteneğinin etkinleştirildiğini doğrulayın.

Metafields ve BFCM: somut bir hazırlık dizisi

27 Kasım bir ay ötede olduğundan, işte mevcut zaman sınırına sığan dizi:

1. Bu hafta (27 Ekim - 2 Kasım): metafield tanımlarınızı denetleyin. Kullanımda olan her namespace/anahtar listeleyin ve her birinin açık bir tanımı olduğunu doğrulayın. Beyan edilmemiş metafields (tanım olmaksızın yazılmış) türleri doğrulamaz ve yetenekleri açığa çıkarmaz.
2. 3 Kasım Haftası: analyticsQueryable'ı üst ürün özelliklerinizde (malzeme, kategori, koleksiyon türü) etkinleştirin. Renk, malzeme ve uyum gibi kategori metafields artık Shopify Analytics'te mevcuttur. Ürünleri zaten kategorilendirmişsek, bu özellikler zaten Analytics'tedir. Bu, satış sonrası veri işleme olmadan BFCM segmenti raporlaması sağlar.
3. 10 Kasım Haftası: en gelirli 20 ürünü popüle edin. Bunlar en fazla BFCM yükünü taşıyacak sayfalar olacaktır.
4. 13 Kasım (kod dondurma): tema değişikliklerini kilitleyin. Metafield'lerinize başvuran herhangi bir Liquid, bir kopya temada sonlandırılmış ve test edilmiş olmalıdır.
5. 20 - 26 Kasım: yalnızca izleyin. Metafield tanımı değişikliği yok, namespace yeniden adlandırması yok.

Shopify tüccarları 2025 Siyah Cuma ve Siber Pazartesi boyunca rekor 14,6 milyar dolar sattılar ve bu, 2024'ten yüzde 27 fazladır. Bu pencerede performans gösteren mağazalar, trafik fırlaması olmadan önce yapılandırılmış ürün verileri tamamlanmış olan mağazalardır, 26 Kasım'da metafield değerleri doldurmaya çalışan mağazalar değildir.

Sonra ne okuyacağınız

Metafields'in metaobjects'le birlikte daha geniş özel veri mimarisi içine nasıl uyduğunu anlamak istiyorsanız, metafields için Shopify sözlüğü girişi türü sistemini ve sahiplik modellerini bir yerde kapsar. Metafields'i karmaşık bir ürün kataloğu taşımasına bağlama konusunda çalışmış bir örnek için, örnek olay incelemesi bölümüne bakın.

Bu işi dışarıya vermek isteyen mağazalar için Lintel gibi stüdyolar Shopify tema geliştirme hizmeti veriyor.