Shopify Catalog API medya filtresi kozmetikte ne değiştiriyor?

Shopify Catalog API medya filtresi, ürün aramasını ürünün taşıdığı medya türüne göre daraltıyor. Filtre `image`, `video` ve `model_3d` değerlerini kabul ediyor; `video` ile `model_3d` birlikte istendiğinde koşullar AND mantığıyla birleşiyor ve yalnızca iki türü de taşıyan ürünler dönüyor (Shopify Changelog (2026)).

Değişiklik üç Catalog API aracının yanıtını da genişletiyor. `search_catalog`, `get_product` ve `lookup_catalog` ürünün medya dizisinde video ve 3D model varlıklarını döndürebiliyor; daha önce bu dizi yalnızca görsel taşıyordu (Shopify Changelog (2026)). Filtrenin kendisi yalnızca `search_catalog` için geçerli, ancak medya bağlantıları filtre kullanılmasa da diğer iki araçtan gelebiliyor.

Buradaki ayrım önemli: filtre medyanın varlığını arama koşulu yapıyor, yeni medya üretmiyor. Shopify'ın ürün medya altyapısı zaten görsel, platformda barındırılan video, harici video ve 3D modeli destekliyor (Shopify Developer Docs). Güncelleme, mevcut varlıkları ajanların ve araçların keşfedebileceği Catalog API yanıtına taşıyor.

Shopify Catalog API video ve 3D filtresi, önce uygun ürünü bulup sonra her ürünü tek tek medya açısından eleme döngüsünü arama katmanına taşıyor. Shopify, önceki yöntemde ürünlerin çekildiğini, kullanılabilir medya için incelendiğini ve medyası olmayanların elendiğini; yeni filtrenin bu deseni değiştirdiğini belirtiyor (Shopify Changelog (2026)). Global Catalog MCP, yapay zekâ ajanlarının Shopify ekosistemindeki ürünleri arayıp keşfetmesi için tasarlandığından, bu elemenin kapsamı tek bir ürün sayfasıyla sınırlı değil (Shopify Developer Docs).

• Yalnızca video gereken akışta `catalog.filters.media` içine `video` eklenir.
• Video ve 3D model birlikte gerekiyorsa iki değer de eklenir; sonuç yalnızca iki koşulu da karşılayan ürünlerden oluşur.
• Eşleşen ürünün medya dizisindeki video ve 3D kayıtları, farklı dosya biçimlerini içeren bir `sources` dizisi taşır.
• İstenen medya türü üründe olsa bile uygulamanın oynatabildiği dosya biçimi olmayabilir; istemci bu durumu ayrıca kontrol etmelidir.

Video ve 3D yanıtlarını almak için istemcinin ajan profilinde `dev.shopify.catalog.global` uzantısının taslak sürümünü bildirmesi gerekiyor. Taslak sürüm bildirilmezse medya alanı yalnızca görsel döndürüyor; Shopify bu şemanın sonraki UCP sürümünde kararlı duruma geçeceğini söylüyor (Shopify Changelog (2026)). Mevcut sorgular için migrasyon yok ve video ya da 3D gerekmiyorsa işlem yapmak gerekmiyor.

Shopify Catalog API medya filtresi kozmetik markasına, kamera veya zengin ürün sunumu isteyen bir akışa yalnızca uygun varlığı bulunan ürünleri alma imkânı sağlar. Bir ruj uygulama videosu, parfüm şişesinin 3D modeli ya da ambalaj detayını farklı açılardan gösteren bir varlık yoksa, ürün deneyime seçilmeden elenebilir.

Bu, özellikle sanal deneme ve kamera öncelikli keşif için anlamlıdır; Shopify da güncellemenin AR deneme, 3D ürün görüntüleyici ve kamera öncelikli alışveriş geliştiren ekipler için önemini açıkça vurguluyor (Shopify Changelog (2026)). Google'ın 2025 tarihli alışveriş duyurusu da ABD'deki kullanıcıların birden fazla makyaj ürününü aynı görünümde sanal olarak deneyebildiğini gösteriyor (Google (2025)). Bu, kamera tabanlı güzellik alışverişinin yalnızca teorik bir kullanım olmadığını gösteren ayrı bir platform örneği.

Yine de `model_3d` ile yüz üzerinde sanal makyaj denemesini aynı şey saymamak gerekir. Shopify'ın 3D ürün modelleri GLB ve USDZ biçimlerini destekler ve desteklenen cihazlarda AR için kullanılabilir (Shopify Developer Docs). Fondöten veya rujun yüzde görünmesini sağlayan güzellik AR'ı ise yüz takibi, renk eşleme ve ayrı bir deneyim katmanı ister. Yeni filtre kullanılabilir varlığı bulur; o katmanı inşa etmez.

Kozmetik kataloğu Shopify medya filtresine, dosya sayısını artırarak değil ürün, varyant ve kullanım amacı arasındaki eşleşmeyi temizleyerek hazırlanmalı. Arama filtresi yalnızca üründe belirli bir medya türünün bulunduğunu doğrular; varlığın doğru tonu, ambalajı veya uygulama biçimini gösterdiğini garanti etmez.

• Her ürün için medya amacını yaz: uygulama tekniği, ambalaj görünümü, doku, bitiş veya 3D inceleme.
• Video kaydını doğru ürünle eşleştir ve dosyanın istemcinin oynatabildiği biçimde döndüğünü test et.
• 3D modellerde GLB ve USDZ çıktılarının ikisini de kontrol et; Shopify bu biçimleri sırasıyla web ve iOS AR için sunuyor (Shopify Developer Docs).
• Varyanta özgü medya gerekiyorsa ilişkiyi ayrıca denetle. Shopify'a göre medya önce üründe bulunmalı; bir varyant yalnızca üründe zaten bulunan medyaya referans verebilir (Shopify Developer Docs).
• Medya türü filtresini ton, stok ve teslimat gibi diğer seçim koşullarının yerine koyma; bunlar ayrı katalog kontrolleridir.

Bu hazırlık, Shopify mağazasının temel ürün ve varyant mimarisinin devamıdır. Platform kararlarını yeni veriyorsan kozmetik markaları için Shopify kurulum rehberimiz önce ürün veri temelini kurar. Ajanın mağaza içinde katalog araması ve sepeti yönetmesi tarafı içinse Shopify WebMCP yazımız ayrı mekanizmayı anlatır.

Shopify Catalog API medya filtresi için bugün yapılacak iş, medya envanterini çıkarmak ve bir küçük sorguyla uçtan uca doğrulama yapmaktır. Video veya 3D kullanan bir ajan ya da alışveriş uygulaması geliştirmiyorsan Shopify açıkça işlem gerekmediğini ve mevcut sorguların aynı ürünleri döndürmeye devam ettiğini söylüyor (Shopify Changelog (2026)).

• Katalogda video veya 3D taşıyan ürünleri ve bunların hangi varyantı temsil ettiğini listele.
• Ajan profilinde taslak `dev.shopify.catalog.global` uzantısını yalnızca bu medya türlerine ihtiyacın varsa bildir.
• Önce `video`, sonra `model_3d`, ardından iki değeri birlikte isteyen üç test sorgusu çalıştır.
• Yanıttaki medya `sources` kayıtlarını hedef cihazlarda aç; var ama oynatılamayan biçimleri hata olarak kaydet.
• Sonucu ürün, ton ve stok doğruluğuyla birlikte değerlendir; “medya var” koşulunu “deneyim hazır” sonucu gibi raporlama.

Bu güncellemenin en iyi kullanımı her ürüne aceleyle 3D model eklemek değil, belirli bir alışveriş deneyiminin gerçekten hangi varlığa ihtiyaç duyduğunu tanımlamaktır. Filtre seçim maliyetini düşürüyor; içerik üretimi, ürün doğruluğu ve deneyim tasarımı hâlâ markanın sorumluluğunda.