Microsoft Merchant Center entegrasyonu: katalog kurulumu, alan eşleme ve bakım rehberi
Microsoft Merchant Center entegrasyonu, ürünlerinizi Microsoft Alışveriş kampanyalarında gösterebilmek için kataloğunuzu stok kartınızdan beslemeniz demektir. Katalog bir kez yüklenip unutulacak bir dosya değildir: fiyat sitenizle aynı kalmalı, tükenen ürün işaretlenmeli ve ürünlerin süresi dolmadan yenilenmelidir. Bu rehberde Microsoft'un resmî belgelerine dayanarak yükleme yöntemlerini, zorunlu alanları, varyant ve paket ürünlerin nasıl gönderileceğini ve en sık görülen red sebeplerini anlatıyoruz.
Microsoft Merchant Center nedir, pazaryeri satıcısı için ne işe yarar?
Microsoft Merchant Center (MMC), Microsoft Advertising hesabınıza bağlı bir mağaza ve katalog alanıdır. Alışveriş reklamında görünen başlık, fiyat, görsel ve ürün bağlantısı bu katalogdan okunur; kampanyanın kalitesi kataloğun doğruluğuna bağlıdır.
Pazaryeri satıcıları için kritik nokta şudur: MMC'deki ürün bağlantısı, mağazayı açarken doğruladığınız kendi alan adınıza gitmek zorundadır. Bağlantının alan adı mağazanınkiyle eşleşmeli ve adres yönlendirme yapmamalıdır. Bu yüzden Trendyol ya da Hepsiburada ilan sayfasını MMC'ye ürün sayfası olarak veremezsiniz; satışın gerçekleşeceği bir web siteniz olmalıdır. Siteniz Shopify üzerinde çalışıyorsa ya da başka bir altyapıdaysa, aynı stok kartı hem siteyi hem MMC kataloğunu besler.
- Hedef ülke ve dil listelerinde Türkiye ve Türkçe yer alıyor (ayrıntı aşağıdaki SSS'de).
- Mağaza oluşturulduğunda varsayılan bir katalog açılır; ihtiyaç halinde ek kataloglar eklenebilir.
- Ürünler yüklendikten sonra editoryal incelemeden geçer; inceleme bitmeden reklamda görünmez.
Microsoft Merchant Center'a ürün yükleme yöntemleri: dosya, FTP/SFTP ve Content API
Microsoft, kataloğu beslemek için üç yol sunar; seçim, stok ve fiyatın ne kadar sık değiştiğine bağlıdır. Az ürünlü bir katalogda dosya yüklemek yeterli olabilir; çok kanallı satışta ise her stok düşüşünü elle dosyaya işlemek kısa sürede hataya döner.
| Yöntem | Nasıl çalışır | Ne zaman uygun |
|---|---|---|
| Web arayüzünden dosya | Feed dosyasını Merchant Center ekranından yüklersiniz | Az ürün, seyrek değişiklik |
| FTP/SFTP | Feed dosyası sunucuya planlı olarak bırakılır; işlenmesi birkaç saat sürebilir | Düzenli ama toplu güncelleme |
| Content API | Ürünler tek tek ya da toplu (batch) eklenir, güncellenir, silinir | Sık değişen stok ve fiyat, çok kanallı satış |
Content API'nin farkı ürün bazında güncellemedir: bütün dosyayı yeniden yüklemek yerine yalnız değişen ürünleri gönderirsiniz. Ancak güncelleme, ürünü baştan yazar; tek bir alanı değiştirseniz bile ürünün tüm alanlarını göndermeniz gerekir. Bir toplu istek en fazla 4 MB olabilir; bu, sıkıştırmasız 2.000 ile 6.000 ürün, GZip sıkıştırmasıyla en çok 12.000 ürün demektir.
Microsoft Merchant Center zorunlu ürün alanları ve stok kartıyla eşleme
Content API belgelerine göre her üründe şu alanlar bulunmalıdır: availability, channel, condition, contentLanguage, imageLink, link, offerId, price, targetCountry ve title. Üreticinin atadığı bir değer varsa brand, gtin ve mpn de zorunludur. Panelde bu alanların karşılığı stok kartında zaten durur; asıl iş doğru eşlemedir.
Kimlik alanları: offerId ve ürün kimliği
Microsoft ürün kimliğini channel, contentLanguage, targetCountry ve offerId alanlarını birleştirerek oluşturur ve bu alanlar sonradan değiştirilemez. Kimlik büyük-küçük harfe duyarlıdır; yazım farkı aynı ürünün iki kez eklenmesine yol açabilir. Bu yüzden offerId olarak (en fazla 50 karakter) stok kodunuzu tek bir yazımla kullanın ve sonradan yeniden adlandırmayın; panelde ilanlar barkod ve stok koduyla eşleştiği için aynı kod tüm kanallarda tutarlı kalır.
Barkod (GTIN), barkodsuz ürünler ve alan sınırları
Ürünün EAN gibi bir barkodu varsa gtin alanına gönderin. Kendi üretiminiz olan, barkodu bulunmayan ürünlerde identifierExists alanı false yapılmalıdır. Barkodu olduğu bilinen bir ürünü kimliksiz gönderirseniz ürün kabul edilir ama uyarı alır; bu uyarıları birikmeden temizlemek gerekir.
- title: en fazla 150 karakter, tanıtım ifadesi içermemeli.
- description: en fazla 10.000 karakter, tanıtım metni yasak.
- imageLink: bmp, gif, exif, jpg, png veya tiff; dosya 3,9 MB'ı aşmamalı.
- price: ürün sayfasındaki fiyatla aynı olmalı.
Microsoft Merchant Center'da stok, fiyat ve 30 günlük ürün süresi
Bir Microsoft Merchant Center entegrasyon programından beklenen asıl iş, katalogdaki stok ve fiyatın siteyle aynı kalmasıdır. Tükenen ürün reklamda kalırsa tıklama bütçesi boşa gider; fiyat farkı ise ürünün incelemede takılmasına yol açabilir. Panelde stok bir pazaryerinden satışla düştüğünde aynı stok kartı üzerinden katalog da güncellenir; mantığını stok ve fiyat senkronu sayfasında ayrıntılı anlattık.
Ürünler 30 gün sonra neden yayından kalkar?
Bir ürün, eklendiği ya da güncellendiği andan itibaren varsayılan olarak 30 gün sonra sona erer. Ürünü yeniden göndermek (hiçbir alanı değişmese bile) süreyi 30 gün uzatır. Ancak expirationDate alanını elle verdiyseniz uzatma otomatik olmaz; yeni tarihi sizin göndermeniz gerekir. Bu yüzden fiyatı ve stoğu uzun süre değişmeyen ürünler, kimse fark etmeden katalogdan düşebilir.
Tükenen ürün silinmeli mi, stok dışı mı işaretlenmeli?
Silinen bir ürünün yayından kalkması 12 saati bulabilir. Microsoft, silmeden önce availability alanının out of stock yapılmasını öneriyor. Satışı durdurulacak üründe önce stoğu sıfırlayın, sonra silin.
Varyantlı, paket (multipack) ve set ürünler nasıl gönderilir?
Renk, beden, desen ya da malzemeye göre değişen ürünlerde Microsoft her varyant için ayrı ürün ister ve bunları itemGroupId ile gruplar. Panelde varyantlar tek stok kartı altında durduğu için her varyantın kendi stok koduyla ayrı offerId olarak gitmesi, ana ürün kodunun da grup kimliği olması en temiz düzendir.
Paket satışta dikkat edilecek alan multipack'tir. Örneğin aynı kalemden 4 adetlik bir paket satıyorsanız multipack 4 olur ve price alanına paketin toplam fiyatı yazılır, tek adet fiyatı değil. Panelde 5'li ya da 10'lu paketler tek stok biriminden düştüğü için 100 adet stokta 10'lu paket 10 adet görünür; katalogda da paket bitince ürün stok dışı olur.
- Her varyant: ayrı offerId, aynı itemGroupId.
- Giyimde color, sizes ve gerekiyorsa material ya da pattern alanlarını doldurun.
- Paket: multipack adedi ve paketin toplam fiyatı.
- Set ürün: farklı ürünlerden kendi oluşturduğunuz bir setse isBundle alanı true.
Microsoft Merchant Center kurulumu: Advertising hesabı, site doğrulama ve katalog bağlantısı
Aşağıdaki sıra, Microsoft'un Content API başlangıç belgesindeki adımlarla panel tarafındaki işleri birleştirir. Bağlantı resmî API erişimiyle kurulur; mağaza şifrenizi paylaşmanız gerekmez.
- Microsoft hesabınızla bir Microsoft Advertising hesabı açın.
- Sitenizi Bing Webmaster Tools'ta, Advertising hesabıyla aynı Microsoft hesabını kullanarak doğrulayın ve sahiplenin.
- Merchant Center'da mağazayı oluşturun; varsayılan katalog kendiliğinden açılır.
- Hedef ülke olarak Türkiye'yi, dil olarak Türkçeyi seçeceğiniz kataloğu belirleyin.
- Panelde Microsoft Merchant Center kanalını bağlayın ve mevcut ürünlerinizin stok koduyla eşleşmesini kontrol edin.
- Eksik barkod, marka ve görselleri tamamlayın; gönderim siz onayladıktan sonra başlar.
- İlk gönderimden sonra incelemenin bitmesini bekleyin ve uyarıları tek tek temizleyin.
Aynı ürün kartlarını Google Merchant kataloğuna da gönderiyorsanız iki kanal için ayrı stok tutmanız gerekmez. Kurulumu birlikte yapmak isterseniz bizimle iletişime geçip demo görüşmesi planlayabilirsiniz.
Microsoft Merchant Center'da ürün neden reddedilir? Kontrol listesi
Ürün temel doğrulamayı geçtikten sonra editoryal incelemeye girer ve Microsoft'a göre bu süreç 36 saate kadar sürebilir; bu sürede ürün yayına girmez. Belgelerdeki kurallara göre ilk gönderimden önce şu noktaları kontrol edin:
- Ürün bağlantısı mağaza alan adından farklı ya da yönlendirme yapıyor.
- Katalogdaki fiyat ürün sayfasındaki fiyatla tutmuyor.
- Başlık veya açıklamada tanıtım dili var (örneğin indirim ya da ücretsiz kargo vurgusu).
- Barkodu bilinen üründe gtin, brand ya da mpn eksik.
- Görsel desteklenmeyen formatta ya da boyutu sınırın üstünde.
- Yetişkin ürünü gönderilmiş; Microsoft bu ürünleri kabul etmiyor.
Panelde senkron sağlığını ve reddedilen ilanın sebebini görürsünüz; düzeltmeyi kanal kanal değil, tek stok kartında yaparsınız. Çok kanallı satışta stok hatalarının önüne geçmek için aşırı satışı önleme kontrol listesine de göz atın.
Microsoft Merchant Center entegrasyonu hangi pakette var?
Başlangıç paketinde tek kanal bağlanır ve bu kanal Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM ya da idefix olmalıdır; Microsoft Merchant Center bu listede yer almaz. Büyüme paketinde 80 kanaldan herhangi üçünü seçebildiğiniz için örneğin bir pazaryeri, kendi siteniz ve Microsoft Merchant Center birlikte bağlanabilir. Kurumsal ve Enterprise paketlerde kanal sayısı sınırsızdır.
Ürün ve sipariş limitlerini paket fiyatları sayfasında karşılaştırabilir, eşleşmeyi 3 günlük ücretsiz denemede kendi ürünlerinizle görebilirsiniz.
- Microsoft Learn: Content API Overview
- Microsoft Learn: Managing your Products (zorunlu alanlar, 30 gün, 36 saat inceleme, batch 4 MB)
- Microsoft Learn: Products Resource (alan sınırları, TR hedef ülke, multipack, itemGroupId, 12 saat silme)
- Microsoft Learn: Get Started with the Content API (site doğrulama, mağaza, katalog)
- Microsoft Learn: Can I Use the API and FTP/SFTP?
Son kontrol: · Bilgiler resmî kaynaklardan derlendi · Hazırlayan: eticaretcim ekibi
