Facebook ve Meta Catalog entegrasyonu: zorunlu alanlar, güncelleme yolları ve sık hatalar
Facebook katalog entegrasyonu (Meta Catalog entegrasyonu), Facebook ve Instagram'daki katalog reklamlarınızı besleyen ürün listesini stok programınıza bağlar. Facebook'ta mağaza vitrini kurmak için Facebook Shop entegrasyonu sayfasına bakın. Katalog doğru alanlarla ve güncel stokla beslenmezse reklam, artık satamayacağınız bir ürünü göstermeye devam edebilir. Aşağıda Meta'nın hangi alanları istediğini, kataloğun hangi yollarla güncellendiğini, pikselle katalog arasındaki kimlik eşleşmesinin neden önemli olduğunu ve kurulumdan önce kontrol etmeniz gerekenleri anlatıyoruz.
Facebook katalog entegrasyonu ne işe yarar? Katalog reklamları ve stok
Meta kataloğu, Commerce Manager'da tutulan ve Facebook, Instagram ile Meta'nın reklam ağında kullanılan ürün listesidir. Advantage+ katalog reklamları ürünleri bu listeden çeker; reklam setleri de kataloğun içinden seçtiğiniz ürün setlerine bağlanır. Kısacası reklamda hangi ürünün, hangi fiyatla ve hangi görselle görüneceğini katalog belirler.
Pazaryerinde satış yapan bir mağazada sorun çoğu zaman kataloğun ayrı bir stok listesine dönüşmesidir. Trendyol'da tükenen ürün katalogda "stokta" görünmeye devam eder, kampanyada değişen fiyat reklama yansımaz. Meta Catalog stok entegrasyonu bu ikinci listeyi ortadan kaldırır: katalog, pazaryerlerine giden ürünle aynı stok kartından beslenir.
- Meta, stokta olmayan ürünleri reklamlarda göstermez; stok bilgisi güncel olduğunda bütçe satılabilir ürünlere gider.
- Fiyat ve indirimli fiyat, pazaryerleri ve web sitenizle aynı kaynaktan gelir.
- Beden ve renk varyantları tek ürün grubu altında toplanır.
- Yeni ürünü bir kez ürün kartına girersiniz; katalog için ayrı bir liste hazırlamanız gerekmez.
Meta kataloğunun zorunlu alanları ve ürün kartındaki karşılıkları
Meta'nın geliştirici belgelerine göre reklam ve ticaret için zorunlu alanlar şunlardır: id, title, description, availability, condition, price, link, image_link ve brand. Giyim ve ayakkabı gibi bazı kategorilerde size alanı da istenir. Aşağıdaki tablo her alanın kuralını ve kurulumdan önce ürün kartında neyi kontrol etmeniz gerektiğini gösteriyor.
| Meta alanı | Kural (Meta belgesi) | Ürün kartında kontrol edeceğiniz bilgi |
|---|---|---|
| id | En çok 100 karakter; aynı ID katalogda birden fazla kez geçerse hepsi yok sayılır | Stok kodu |
| title | En çok 200 karakter; kesilmemesi için en çok 65 karakter önerilir | Ürün adı |
| description | En çok 9.999 karakter, düz metin; HTML, bağlantı ve tamamı büyük harf metin kullanılmaz, başlıktan farklı olmalı | Ürün açıklaması |
| availability | in stock ya da out of stock | Stok adedi |
| condition | new, refurbished ya da used | Ürünün yeni, yenilenmiş ya da ikinci el olması |
| price | Sayı, boşluk, üç harfli para birimi kodu; ondalık ayırıcı nokta, para simgesi yok | Kanal fiyatı |
| image_link | JPEG veya PNG, en az 500x500 piksel, en çok 8 MB | Ana görsel |
| brand | En çok 100 karakter | Marka |
Önerilen alanlar: GTIN, MPN ve ürün grubu
GTIN zorunlu değil ama öneriliyor; yalnız doğru olduğundan eminseniz, tire ve boşluk olmadan girin. GTIN yoksa MPN ürünün tanınmasına yardım eder. Varyantlarda item_group_id alanına aynı ürünün bütün varyantları için aynı değer yazılır. İndirimli fiyat için kullanılan sale_price, price'tan düşük olmalı ve aynı biçimde yazılmalıdır.
Meta kataloğu nasıl güncellenir: planlı besleme (feed) ve Batch API
Meta'nın belgeleri kataloğu güncellemenin birkaç yolunu anlatır; stok programları açısından önemli olan ikisidir. Hangisinin kullanıldığını bilmek, "stok değişti ama reklamda hâlâ eski" şikâyetinin sebebini bulmanızı kolaylaştırır.
Planlı besleme dosyası: biçimler ve güncelleme sıklığı
Besleme dosyası CSV, TSV, RSS XML ya da ATOM XML biçiminde olabilir; elle yüklenir ya da saatlik, günlük veya haftalık bir takvimle Meta tarafından çekilir. Meta'nın belgesine göre planlı beslemeler saatte birden sık çalışmaz. İki tür takvim vardır: tam yenileme (replace) dosyada olmayan ürünleri katalogdan siler, güncelleme takvimi (update) ise yalnız ekler ve günceller, eksik ürüne dokunmaz.
Batch API ile ürün bazında güncelleme
Stoğu daha sık güncellemek gerektiğinde Meta, dosya yerine istek gövdesiyle çalışan Catalog Batch API'yi öneriyor. Tek istekte ekleme, güncelleme ve silme bir arada gönderilebilir; işlemin tamamlanıp tamamlanmadığı ayrıca sorgulanır.
Tükenen ürün, varyant ve paket stoğu Meta kataloğunda nasıl görünür?
Meta, tükenen ürünü beslemeden silmek yerine "out of stock" olarak işaretlemeyi öneriyor; böylece ürünü görmüş kişilere benzer ve satılabilir ürünler gösterilebiliyor. Stoğu biten ürün mağaza vitrininde "tükendi" olarak görünür ve reklamlarda yer almaz. Stok geri geldiğinde ürün aynı ID ile yeniden satışa açılır. Bu mantığın bütün kanallarda nasıl işlediğini stok ve fiyat senkronu sayfasında bulabilirsiniz.
Paket ürünlerde ayrı bir durum var: 5'li ya da 10'lu paket ayrı bir ilan olsa da stoğu tek stok biriminden hesaplanır. Teklik ürün azaldıkça paket ilanın satılabilir adedi de azalır. Set ürünlerde stok bileşenlerden düşer; bileşenlerden biri biterse set de tükenmiş sayılır.
- Beden ve renk varyantları ayrı ID ile, ortak item_group_id altında gönderilir.
- Kritik stok uyarısı, ürün tükenmeden önce reklam setini gözden geçirmeniz için zaman tanır.
- Aynı ürünü pazaryerlerinde de satıyorsanız fazla satışı önlemek için çok kanallı stok kontrol listesine göz atın.
Meta pikseli ile katalog eşleşmesi: ürün kimlikleri neden aynı olmalı?
Katalog reklamlarında yeniden hedefleme, sitenizdeki Meta pikseli ya da Dönüşümler API'si olaylarına dayanır. Meta'nın alan referansına göre katalogdaki id değeri, pikselde gönderilen içerik kimliğiyle birebir aynı olmalıdır. 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 parametresiyle gönderilir.
En sık görülen hata şudur: site pikseli ürünün veritabanı numarasını gönderir, katalog ise stok kodunu kullanır. Bu durumda olaylar katalogdaki ürünlerle eşleşmez ve ürünü inceleyen kişiye o ürün yeniden gösterilemez. Çözüm, iki tarafta aynı kimliği kullanmaktır. Panelde ilanlar barkod ve stok koduyla eşleştiği için kurulumda katalogdaki ID değerini netleştirin, sitenizin pikselinin de aynı değeri göndermesini sağlayın.
- content_type değeri, content_ids içinde gönderilen kimliğin türüyle uyumlu olmalı.
- AddToCart ve Purchase olaylarında content_type=product kullanılmalı, product_group kullanılmamalı.
- Piksel ve varsa uygulama olay kaynağı, Commerce Manager'da katalogla ilişkilendirilmeli.
Meta Catalog entegrasyon programı kurulumu ve reddedilen ürünler
Meta Catalog entegrasyon programı kurulurken katalogdaki mevcut ürünler bozulmamalıdır. Panel bağlantıyı resmî API izniyle kurar; şifre paylaşılmaz ve siz onaylamadan hiçbir ürün değişmez. İsterseniz kurulumu birlikte yapabiliriz. Önerdiğimiz sıra şöyle:
- Commerce Manager'da hangi kataloğun kullanılacağını belirleyin ve varsa eski besleme takvimini not edin.
- Ürün kartlarınızda marka, ana görsel ve açıklama alanlarının dolu olduğunu kontrol edin.
- Meta için kanal fiyat farkına (yüzde ya da tutar) ihtiyacınız olup olmadığına karar verin; reklamdaki fiyatla ürün sayfasındaki fiyatın farklı olması alıcının vazgeçmesine yol açar.
- Mevcut katalog ürünlerini stok koduyla eşleştirip farkları inceleyin, ardından gönderimi onaylayın.
- Commerce Manager'daki Tanılama (Diagnostics) bölümünde hata ve uyarıları kontrol edin.
Meta kataloğunda ürünler neden reddedilir?
- Fiyatta TL simgesi ya da ondalık virgül kullanmak; doğru biçim 349.90 TRY gibidir.
- Aynı stok kodunu iki ürüne vermek: Meta bu durumda o ID'nin bütün satırlarını yok sayar.
- Görseli değiştirip aynı adresi kullanmak; yeni görsel yeni bir URL ister.
- Açıklamaya HTML, bağlantı ya da tamamı büyük harf metin koymak.
Meta hataları iki düzeyde bildirir: "fatal" hatalı ürün kataloğa hiç alınmaz; "warning" ise önerilen bir alanın eksik ya da hatalı olduğunu gösterir, ürün o alan atlanarak işlenir. Panelin senkron sağlığı ekranında da reddedilen ürünün sebebi listelenir.
Meta Catalog'u Google ve Instagram ile birlikte kullanmak ve paket seçimi
Çoğu satıcı aynı ürünleri Meta'nın yanında Google'da da gösterir. Google Merchant entegrasyonu aynı ürün kartından beslendiğinde iki reklam kanalı arasında fiyat ve stok farkı oluşmaz. Instagram'da ürün etiketlemek istiyorsanız Instagram Shop entegrasyonu sayfası bu tarafı ayrıca anlatıyor.
Panelde Meta Catalog bir satış kanalı olarak sayılır. Başlangıç paketi yalnız belirli pazaryerlerinden birini kapsadığı için Meta Catalog için en az Büyüme paketi gerekir; bu pakette 80 kanaldan herhangi üçünü seçebilirsiniz. Profesyonel ve üstü paketlerde ürün başlığı ve açıklaması için yapay zekâ önerisi de bulunur; uzun başlıkları gözden geçirirken işinize yarar. Paket ayrıntıları fiyatlar sayfasında; 15 dakikalık bir demo görüşmesi için iletişim sayfasından bize ulaşabilirsiniz.
- Meta for Developers: Catalog fields reference (zorunlu alanlar, fiyat ve görsel kuralları, piksel kimliği)
- Meta for Developers: Manage catalog items (Feed API ve Batch API farkı)
- Meta for Developers: Schedule feeds (replace/update, saatte bir sınırı, stok dışı önerisi)
- Meta for Developers: Feed API (CSV/TSV/RSS XML/ATOM XML, fatal ve warning, hızlı güncelleme için Batch API)
- Meta for Developers: Catalog Batch API (items_batch)
- Meta for Developers: Dynamic product audiences (olaylar, content_type kuralları)
Son kontrol: · Bilgiler resmî kaynaklardan derlendi · Hazırlayan: eticaretcim ekibi
