Facebook katalog entegrasyonu: Meta feed alanları, güncelleme yolları ve katalog reklamları
Facebook katalog entegrasyonu, Meta Commerce Manager'daki ürün kataloğunu stok ve sipariş panelinize bağlayarak Facebook, Instagram ve Meta reklam ağındaki katalog reklamlarının ürünleri güncel fiyat ve stok bilgisiyle göstermesini sağlar. Reklamın hangi ürünü, hangi görselle ve hangi tutarla göstereceğine kampanya ayarı değil katalog karar verir; bu yüzden katalog verisi bayatladığında bütçe, artık satamadığınız ürünlere harcanır. Bu rehber, Ekim 2026 itibarıyla Meta'nın resmî geliştirici belgelerine dayanarak feed alanlarını, güncelleme yollarını, maliyeti ve kurulum öncesi kararları ele alıyor.
Facebook katalog entegrasyonu nedir, Meta kataloğu nerede kullanılır?
Meta kataloğu, envanterinizdeki ürünleri satır satır tutan yapılandırılmış bir veri kaynağıdır: her satır bir ürün varyantı, her sütun başlık, açıklama, görsel ya da fiyat gibi bir özelliktir. Katalog Commerce Manager'da (Türkçe arayüzde Ticaret Yöneticisi) yönetilir ve aynı katalog hem Facebook hem Instagram tarafında kullanılır. Facebook katalog entegrasyonu ise bu listeyi elle hazırlanan bir dosya olmaktan çıkarıp ürünlerinizi yönettiğiniz sisteme bağlar.
Advantage+ katalog reklamları kataloğu nasıl kullanır?
Meta'nın geliştirici belgeleri Advantage+ katalog reklamlarını (eski adıyla dinamik reklamlar) üç parçayla anlatır: ürün bilgisini taşıyan katalog, ölçüm ve kitle için Meta pikseli ya da uygulama olayları, kataloğa dayanan reklamın kendisi. Görsel, açıklama ve fiyat katalogdan otomatik gelir; bu yüzden katalogdaki her hata doğrudan reklama yansır.
Meta kataloğu, Facebook Shop ve Instagram Shop arasındaki ayrım
Bu üç kavram sık karıştırılır. Katalog, ürün verisinin tutulduğu ortak kaynaktır. Mağaza vitrini kurmak, kataloğu Sayfanızda ürün listesi olarak göstermek demektir; bunun için Facebook Shop entegrasyonu sayfasındaki adımlar geçerlidir. Gönderilerde ürün etiketleme tarafı Instagram Shop entegrasyonu sayfasında anlatılıyor. Bu sayfa yalnız katalog ve feed tarafına odaklanır; katalog reklamları için mağaza vitrini kurmanız gerekmez.
Commerce Manager'da katalog düzeni: tek katalog, ürün setleri ve özel etiketler
Katalog düzeninde verilecek ilk karar, ürünlerin tek katalogda toplanıp toplanmayacağıdır. Meta'nın katalog genel bakış belgesi, Advantage+ katalog reklamları yayınlayan bir işletmenin zaten bir kataloğu olduğunu ve yeni katalog açmak yerine mevcut olanı geliştirmesi gerektiğini söyler. Aynı belgeye göre bir ürün, id alanıyla tanımlandığı için aynı anda yalnız tek bir ürün feed'inde bulunabilir. Bu kural, iki ayrı sistemin aynı ürünü iki farklı feed'den göndermesini baştan engeller.
Ürün setleri ve custom_label alanlarıyla reklam kurgusu
Reklam setleri kataloğun tamamına değil, katalog içinden filtrelenen ürün setlerine bağlanır. Ürünleri gruplamak için kullanışlı bir araç custom_label_0 ile custom_label_4 arasındaki beş özel etiket alanıdır; her biri en fazla 100 karakter alır. Bir etiketi sezon, birini marj grubu için ayırırsanız düşük marjlı ürünleri ayrı bir sete toplayabilirsiniz. Hangi ürünün reklama değer olduğunu hesaplarken kâr hesaplama aracı ile komisyon ve kargo sonrası net tutarı görmek işinizi kolaylaştırır.
- Sezon ya da kampanya: yaz, okula dönüş, efsane cuma gibi dönemlik gruplar.
- Marj grubu: reklam harcamasını kaldırabilecek ürünleri ayırmak için.
- Satış hızı: çok satanlar ile yavaş dönen stok için farklı bütçe.
Yurt dışına satış için yerelleştirilmiş katalog
Ürünlerinizi farklı ülkelerde reklamla gösterecekseniz Meta'nın yerelleştirilmiş katalog yapısı, aynı ürün için ülkeye göre para birimi, fiyat, çevrilmiş başlık ve açıklama ile ülkeye özel ürün bağlantısı tanımlamaya izin verir. Her ülke için ayrı katalog açmanız gerekmez.
Facebook katalog entegrasyonunda zorunlu feed alanları ve resmî kurallar
Meta'nın katalog alanları referansına göre reklam ve ticaret için zorunlu alanlardan biri eksik ya da hatalı biçimde gelirse ürün kataloğa hiç yüklenmeyebilir. Aşağıdaki tablo, alanların resmî kuralını ve Türkiye'deki satıcıların en çok takıldığı noktayı birlikte gösteriyor.
| Alan | Meta kuralı (geliştirici belgesi) | Türkiye'de sık karşılaşılan hata |
|---|---|---|
| id | Metin, 100 karakter sınırı; mümkünse stok kodu (SKU). Tekrarlanan kimliğin bütün satırları yok sayılır. | İki varyanta aynı stok kodunu vermek |
| title | 200 karakter sınırı; kesilmemesi için 65 karaktere kadar önerilir | Pazaryeri başlığını anahtar kelime dizisiyle olduğu gibi taşımak |
| description | 9.999 karakter sınırı; düz metin, bağlantı ve tamamen büyük harf yok, başlıktan farklı | Açıklamaya HTML tablo ya da kargo duyurusu koymak |
| availability | in stock veya out of stock | Biten ürünü listeden silmek |
| condition | new, refurbished veya used | Yenilenmiş ürünü new olarak göndermek |
| price | Sayı, boşluk ve ISO 4217 para kodu; ondalıkta nokta, para simgesi yok | 1.299,90 TL yazmak (doğrusu 1299.90 TRY) |
| link | http ya da https ile başlar, işletmenizin web sitesi alan adında olur; Facebook alan adı kabul edilmez | Pazaryeri ilan adresini bağlantı olarak vermek |
| image_link | JPEG ya da PNG, kenarları 500 piksel ve üzeri, dosya 8 MB'a kadar; görsel değişince yeni adres gerekir | Aynı dosya adının üzerine yeni görsel yüklemek |
| brand | 100 karakter sınırı | Markasız üründe alanı boş bırakmak |
| size | Mağazalarda ve giyim, ayakkabı gibi kategorilerde zorunlu; "beden" kelimesi yazılmaz | Bedeni başlığa yazıp alanı boş bırakmak |
Fiyat ve stok alanlarında Türk lirası biçimi
Türkiye'de alışılmış yazım olan "1.299,90 TL" Meta için hatalıdır; doğru biçim 1299.90 TRY şeklindedir. Binlik ayırıcı ve TL simgesi kaldırılır, kuruş nokta ile ayrılır. Stok tarafında Meta'nın beklediği şey adet değil durumdur: ürün ya stokta ya da stok dışıdır. Stok dışı ürün mağaza vitrininde tükendi olarak görünür ve reklamlarda yer almaz. Adet bildiren quantity_to_sell_on_facebook alanı ise yalnız Facebook ve Instagram mağazalarında anlam taşır.
Önerilen alanlar: indirim tarihi, varyant grubu, GTIN ve ek görseller
Zorunlu alanlar ürünün kataloğa girmesini sağlar; önerilen alanlar ise ürünün doğru kişiye, doğru biçimde gösterilmesine yardım eder. Meta bu alanlardaki eksiklikleri ölümcül hata değil uyarı olarak bildirir: hatalı alan atlanır, ürünün geri kalanı işlenir.
| Alan | Ne işe yarar | Meta kuralı |
|---|---|---|
| sale_price | İndirimli fiyatı üstü çizili fiyatla göstermek | price'tan düşük olmalı, aynı biçimde yazılır |
| sale_price_effective_date | İndirimin başlangıç ve bitişini önceden tanımlamak | Eğik çizgiyle ayrılmış iki ISO 8601 zaman damgası |
| item_group_id | Beden ve renk varyantlarını tek ürün altında toplamak | 100 karakter sınırı; bütün varyantlarda aynı değer |
| gtin | Ürünün evrensel barkodla tanınması | Tire ve boşluk yok; EAN 13 hane |
| mpn | Barkodu olmayan ürünü üretici koduyla tanıtmak | 100 karakter sınırı; GTIN yoksa önerilir |
| additional_image_link | Ürünü farklı açılardan göstermek | 20 adrese kadar, ana görselle aynı özellikler |
| video | Ürün videosunu kataloğa eklemek | 20 bağlantıya kadar, her dosya 200 MB'a kadar; YouTube gibi oynatıcı bağlantıları geçmez |
| status | Ürünü silmeden arşive almak | active (varsayılan) ya da archived |
Varyantlarda item_group_id ve barkod tutarlılığı
Beden ve renk seçenekleri olan bir üründe her varyant kendi id değeriyle ayrı satırdır, ortak noktası item_group_id değeridir. Bu değer tutarsızsa Meta aynı tişörtün dört bedenini dört ayrı ürün sanar ve reklamda tekrar eden kartlar görürsünüz. GTIN alanına yalnız doğruluğundan emin olduğunuz barkodu yazın; kontrol hanesi hatalı bir EAN'ı göndermeden önce barkod hesaplama aracı ile doğrulayabilirsiniz.
Meta kataloğu ne sıklıkla güncellenir? Planlı feed, update takvimi ve Batch API
Meta'nın planlı feed belgesine göre planlı feed yüklemeleri saatte birden sık çalışmaz. Saatlik ya da günlük takvim kurulabilir, haftalık takvimde gün seçilir. Saatten daha sık ürün oluşturma ve güncelleme gerekiyorsa Meta, dosya yerine Catalog Batch API'yi önerir.
| Yöntem | Ne yapar | Sıklık | Uygun olduğu durum |
|---|---|---|---|
| Elle dosya yükleme | CSV, TSV, RSS XML, ATOM XML ya da Google Sheets bir kez yüklenir | Siz yükledikçe | İlk deneme, birkaç düzine ürün |
| Planlı feed, tam yenileme (schedule) | Dosyada olmayan ürünü siler, olanları günceller, yenileri ekler | En sık saatte bir | Ürün listesinin gece toplu olarak eşitlenmesi |
| Planlı feed, güncelleme (update_schedule) | Ekler ve günceller, dosyada olmayan ürüne dokunmaz | En sık saatte bir | Yalnız değişen fiyat ve stok satırlarını göndermek |
| Ek feed (supplementary) | Mevcut ürünlerin alanlarını değiştirir, ürün eklemez ya da silmez | Bağlı olduğu kaynağa göre | Özel etiket ya da kampanya başlığı eklemek |
| Catalog Batch API (items_batch) | Tek istekte ekleme, güncelleme ve silme gönderir | Saatten sık | Hızlı satan ürünlerde stok bilgisi |
Tam yenileme ile update takvimini birlikte kullanmak
Meta, iki takvimin birlikte kullanılabileceğini örnekle anlatır: saatlik update takvimi ile günlük tam yenileme takvimi yan yana çalışabilir. Meta, yalnız değişen satırları içeren update dosyasını özellikle kampanya dönemleri için önerir; günlük tam yenileme ise birikmiş tutarsızlıkları temizler. Buradaki risk, tam yenileme dosyasının eski veriyle üretilmesidir: o durumda dosya, gün içinde yapılan doğru güncellemelerin üzerine yazar.
Ek feed hangi işte işe yarar?
Ek feed, ana veri kaynağındaki ürünlere yeni ya da düzeltilmiş alan değerleri eklemek içindir. Meta'nın belgesine göre ek feed ürün ekleyemez ve silemez, her satırın id değeri ana kaynaktaki bir ürünle eşleşmelidir; her ana veri kaynağına en fazla bir ek feed bağlanır. Ana feed'i bir entegrasyon yönetirken özel etiketleri ayrı tutmak için uygundur.
Katalog reklamlarında ölçüm: Meta pikseli olayları ve ürün kimliği
Katalog reklamlarının ürünü inceleyen kişiye aynı ürünü yeniden gösterebilmesi için sitedeki olayların katalogdaki ürünle eşleşmesi gerekir. Meta'nın dinamik ürün kitleleri belgesi web sitesi için Search, ViewCategory, ViewContent, AddToCart ve Purchase olaylarını sayar; ürün kimliği bu olaylarda content_ids ya da contents ile gönderilir ve belge, daha isabetli hedefleme için ürün kimliklerinin kullanılmasını önerir.
content_type: product mı, product_group mu?
Sayfa belirli bir varyantı gösteriyorsa content_type=product kullanılır ve feed'deki id gönderilir. Sayfa bir varyant grubunu kapsıyorsa product_group ile item_group_id gönderilebilir; ancak AddToCart ve Purchase olaylarında product_group kullanılmaz. Dışlama kuralları varyant grubu düzeyinde çalışır: aynı item_group_id'ye sahip bir varyantı alan kişi kitleden çıkar.
- Sitenizin gönderdiği kimlik ile katalogdaki id aynı kaynaktan gelmeli; biri veritabanı numarası, diğeri stok kodu olursa eşleşme kopar.
- Search ve ViewCategory olaylarında belge, ilk sonuçlardan 5 ila 10 ürün kimliği gönderilmesini örnekler.
Facebook katalog entegrasyonu maliyeti: Meta'ya ve panele ne ödenir?
Katalog reklamlarında maliyetin iki ayrı kalemi vardır: Meta'ya ödenen reklam harcaması ve kataloğu güncel tutan yazılımın ücreti. Meta'nın reklam fiyatlandırma sayfası, harcamanın günlük ya da toplam bütçeyle sınırlandığını anlatır. Günlük bütçede Meta bazı günler bütçenin %75 fazlasına kadar harcayabilir; ancak bir haftalık harcama günlük tutarın yedi katını geçmez.
Yox İş Ortağım tarafında Meta Catalog, paketinizin kanal haklarından biri olarak sayılır. Başlangıç paketinde yer almaz, çünkü Başlangıç yalnız Trendyol, Hepsiburada, n11, Çiçeksepeti, Pazarama, PttAVM ya da idefix'ten birini kapsar. Kanal Büyüme paketinden itibaren seçilir.
| Paket | Aylık fiyat | Kanal bağlantısı | Meta Catalog | Ürün / aylık sipariş |
|---|---|---|---|---|
| Başlangıç | ₺499 | 1 (yalnız 7 pazaryerinden biri) | Yer almaz | 500 / 100 |
| Büyüme | ₺999 | 3 (80 kanaldan herhangi üçü) | Seçilebilir | 5.000 / 500 |
| Profesyonel | ₺1.999 | 5 (28 kanallık listeden) | Ön görüşmede birlikte kontrol edilir | 10.000 / 2.000 |
| Kurumsal | ₺3.999 | Sınırsız | Seçilebilir | 25.000 / 5.000 |
| Enterprise | ₺7.999 | Sınırsız | Seçilebilir | Sınırsız |
Yıllık ödemede bütün paketlerde %20 indirim uygulanır ve her paket 3 gün ücretsiz denenebilir. Meta Catalog'u iki pazaryeriyle birlikte kullanacaksanız Büyüme paketinin üç kanal hakkı dolar; Google tarafını da eklemek isterseniz Kurumsal paketin sınırsız kanal hakkı daha uygundur. Kullanıcı sayısı, kargo ve e-Fatura limitleri dahil farkları paket karşılaştırmasında görebilirsiniz.
Yox İş Ortağım ile Meta Catalog: katalog pazaryerleriyle aynı karttan beslenir
Yox İş Ortağım'da Meta Catalog, pazaryerleriyle aynı ürün kartına bağlı bir katalog kanalıdır. Ürün adı, görsel, açıklama, marka, barkod ve fiyat ürün kartından Meta kataloğuna gider. Bir pazaryerinde satış olduğunda ya da fiyat değiştiğinde katalog verisi de güncellenir; stoğu biten ürün katalog verisinde stokta yok olarak işaretlenir. Meta bu veriyi kendi döngüsünde okur ve ürünün kanalda nasıl gösterileceğine kendisi karar verir.
| İş | Elle hazırlanan feed dosyasıyla | Yox İş Ortağım ile |
|---|---|---|
| Ürün listesinin hazırlanması | Pazaryeri ilanlarından ayrı bir tablo ya da XML tutulur | Pazaryerlerinde kullandığınız ürün kartı kullanılır |
| Pazaryerinde satılan son adet | Dosya yeniden üretilip Meta tarafından çekilene kadar stokta görünür | Katalog verisinde stokta yok olarak işaretlenir |
| Fiyat değişikliği | Dosya ve site ayrı ayrı güncellenir | Ürün kartındaki fiyat katalog verisine yansır |
| Bağlantı | Dosya adresi ya da elle yükleme | Resmî API bağlantısıyla verilen yetki; mağaza şifresi paylaşılmaz |
| Katalogdaki ürünler | Dosyaya eklenen her satır | Ürün kartlarınızdan seçtiğiniz ürünler |
Örnek: Trendyol'da biten ürünün reklamdan düşmesi
Bir çantanın son adedi Trendyol mağazanızda satıldı diyelim. Günlük çekilen bir XML dosyasında çanta, dosya bir sonraki üretilip okunana kadar katalogda stokta görünür ve reklam bütçesi tıklamayı satamayacağınız ürüne harcamaya devam edebilir. Panelde satış ürün kartının stoğunu düşürür, Meta Catalog verisi de stokta yok olarak güncellenir. Değişikliğin reklamda görünme anı ise Meta'nın okuma döngüsüne bağlıdır.
Reklam fiyatı ile site fiyatı aynı kalmalı
Pazaryerlerinde komisyonu karşılamak için fiyatı yükseltmek yaygındır; panel kanal başına yüzde ya da tutar farkı tanımlamaya izin verir. Meta kataloğunda ise ürün bağlantısı sizin sitenize gider. Reklamdaki fiyat, ziyaretçinin sitede gördüğü fiyattan farklıysa alıcı sepette vazgeçer. Kurulumda Meta Catalog kanalının fiyat ayarını sitenizdeki satış fiyatıyla birlikte kontrol ediyoruz. Aynı mantık Google Merchant Center entegrasyonu için de geçerlidir; iki reklam kanalı aynı karttan beslenince aralarında fiyat farkı oluşmaz.
Kurulum adımları, sık hatalar ve karar rehberi
Facebook katalog entegrasyonunun kurulumu önce Meta tarafındaki katalog ve veri kaynaklarının düzenlenmesi, sonra panel bağlantısı sırasıyla ilerler. İsterseniz kurulumu birlikte yapıyoruz; siz onaylamadan hiçbir ilan değişmez.
- Commerce Manager'da kullanılacak kataloğu belirleyin, işletme hesabınızın ve reklam hesabınızın bu kataloğa erişimini kontrol edin.
- Kataloğa bağlı eski veri kaynaklarını listeleyin; tam yenileme takvimiyle çalışan eski bir XML adresi varsa ne yapılacağına karar verin.
- Yox İş Ortağım'a başvurun ve ön görüşmede Meta Catalog'u hangi pazaryerleriyle birlikte kullanacağınızı netleştirin.
- Panelde Meta Catalog kanalını ekleyin ve resmî API bağlantısıyla yetki verin.
- Katalogda görünecek ürünleri ürün kartlarınızdan seçin; her ürün bağlantısının kendi alan adınızdaki ürün sayfasına gittiğini kontrol edin.
- Marka, görsel ve açıklaması eksik kartları tamamlayın, ardından Commerce Manager'daki tanılama ekranında hata ve uyarıları inceleyin.
Hangi satıcı için ne zaman mantıklı?
- Kendi siteniz varsa ve Meta'da reklam veriyorsanız: katalog reklamlarının bayat stokla çalışmaması için kataloğun pazaryerleriyle aynı karttan beslenmesi doğrudan bütçe tasarrufudur.
- Kendi siteniz yoksa: ürün bağlantısı pazaryeri ilanı olamayacağı için önce site tarafını kurmanız gerekir; panelde bağlı siteler entegrasyon ana sayfasındaki altyapı listesinde.
- Ürün sayınız az ve stok seyrek değişiyorsa: elle yönetilen günlük bir feed de iş görür; entegrasyonun getirisi stok sık değiştikçe artar.
- Birden fazla pazaryerinde aynı stoğu satıyorsanız: reklamdaki ürünün başka kanalda tükenmiş olma ihtimali yüksektir, ortak stok kartı bu durumu çözer.
İlk hafta en sık görülen hatalar
- Fiyatı virgüllü ve TL simgeli göndermek.
- Tükenen ürünü katalogdan silmek; Meta stok dışı işaretlemeyi önerir, böylece ilgilenen kişiye benzer ürünler gösterilebilir.
- Görseli değiştirip aynı adresi kullanmak.
- Aynı ürünü hem eski XML'den hem yeni bağlantıdan göndermeye çalışmak; bir ürün aynı anda tek feed'de bulunabilir.
Emin değilseniz iletişim sayfasından yazın; 15 dakikalık görüşmede veri kaynaklarınıza birlikte bakarız.
Son kontrol: 13 Ekim 2026
Google Merchant
Facebook Shop
Instagram Shop
Microsoft Merchant Center
Pinterest Catalog
YouTube Shopping
TikTok Catalog
Snapchat Catalog
Google Free Listings