M masamenu.tr
🔗 Entegrasyonlar

📘 Meta Product Feed

Meta Commerce Manager için otomatik ürün akışı (XML/CSV): Facebook/Instagram Mağazaları için katalog

Dokümantasyon

Meta Product Feed — Facebook ve Instagram Shops İçin Katalog

Meta Product Feed eklentisi, mağazanızın kataloğunu Meta'nın katalog merkezi olan Meta Commerce Manager (business.facebook.com/commerce) platformuna aktarır. Bu katalog temelinde şunlar çalışır:

  • Facebook Shop ve Instagram Shop — profillerinizdeki ürün vitrinleri;
  • Instagram/Facebook gönderilerindeki ve Stories'deki alışveriş etiketleri (shopping tags);
  • Dinamik reklamlar ve Advantage+ Shopping — Meta'nın hedef kitleye otomatik olarak uyarladığı ürün reklamları;
  • Katalog üzerinden yeniden pazarlama (remarketing) (incelenen ürünlerin gösterilmesi).

Sipariş oluşturma işlemi bu durumda genellikle mağazanızın vitrin web sitesine yönlendirir (tüm ülkelerde sunulmayan Meta içi checkout senaryoları hariç).

Eklenti, API anahtarı gerektirmeyen veri akışı (feed) modeli ile çalışır: platform, Google Product Feed formatında (Meta bu şemayı kabul eder) herkese açık bir ürün akışı oluşturur ve bunu sürekli günceller. Commerce Manager'da akış bağlantısını yalnızca bir kez belirtmeniz yeterlidir.


Adım 1. Cenaly'ye Bağlanma ve Feed Bağlantısı

  1. Uygulama Mağazası'nı (admin.masamenu.tr/app-store) açın ve "Lokasyonlara göre" sekmesine geçin.
  2. İstediğiniz lokasyonu seçin.
  3. "Meta Product Feed" (Facebook / Instagram) kartını bulun ve "Bağlan" butonuna tıklayın.
  4. Kart, kopyalama butonlarıyla birlikte XML ve CSV formatlarında feed URL'sini gösterecektir. URL görünümü: https://cdn.masamenu.tr/feeds/metafeed/{account-id}/{location-id}.xml (ve .csv).
  5. Gerekli bağlantıyı kopyalayın.

Feed, lokasyon kataloğundan (perakende modu) oluşturulur ve ürünler, fiyatlar ile stok miktarları değiştiğinde otomatik olarak güncellenir. Varyasyonlar, ortak bir item_group_id ile ayrı ürünler olarak dışa aktarılır.


Adım 2. Commerce Manager'a Veri Akışı Ekleme

  1. Meta Business hesabınızda Commerce Manager'ı açın.
  2. Henüz yoksa "Ürünler" (Ecommerce) türünde bir katalog oluşturun.
  3. Kataloğun içinde "Veri kaynakları" (Data sources) bölümüne gidin ve ürünleri veri akışı (Data feed) üzerinden eklemeyi seçin.
  4. "Zamanlanmış yükleme" yöntemini seçin — dosya URL'sini belirtin (scheduled feed).
    1. adımdaki veri akışı bağlantısını yapıştırın (XML önerilir) ve kataloğun para birimini ayarlayın.
  5. Yenileme sıklığını (günlük/saatlik) ayarlayın ve kaydedin.

Meta veri akışını yükleyecek ve ürünleri işleyecektir. İlk işleme genellikle birkaç dakika ile birkaç saat arasında sürer; ardından ürünler Meta ticaret politikalarına uygunluk denetiminden geçer.

Commerce Manager'daki öğelerin isimleri değişebilir — katalog → veri kaynakları → URL ile zamanlanmış veri akışı adımlarını temel alın.


Hangi format seçilmeli: XML mi CSV mi

Meta ikisini de kabul eder. XML, varyasyonları ve birden fazla fotoğrafı olan mağazalar için tercih edilir. CSV ise manuel kontrol için uygundur.

Feed'in temel alanları:

Alan Ne içerir
id Benzersiz ürün kimliği
title Başlık
description Açıklama
link Web kataloğundaki ürün sayfasının bağlantısı
image_link Ana fotoğraf
additional_image_link Ek fotoğraflar
availability in_stock / out_of_stock
price Fiyat
sale_price İndirimli fiyat
brand Marka
gtin Barkod
mpn Stok kodu
condition Durum (new)
item_group_id Varyasyon grubu
product_type Kategori

Meta Akışı Nasıl Alır

Meta, akışı belirtilen URL'den bir takvime göre kendisi indirir. Önerilen sıklık günde bir kezdir; aktif mağazalar için daha sık yapılabilir. Platform akışı güncel tutar, bu nedenle Meta her zaman güncel verileri alır. Akışı manuel olarak göndermenize gerek yoktur.


Gereksinimler ve Yaygın Sorunlar

  • Çalışan ürün bağlantıları. link, açılan bir ürün sayfasına yönlendirmelidir — web kataloğunu (lokasyonun vitrin sitesini) etkinleştirin.
  • Fotoğraf zorunludur. image_link olmadan ürün onaylanmaz. Meta ayrıca görsel kalitesi için de gereksinimler belirler.
  • Meta Ticaret İlkeleri. Katalog moderasyondan geçer — yasaklı ürün kategorileri reddedilir ve hesap incelemeye alınabilir.
  • Para birimi. Feed para birimi, Commerce Manager'daki katalog para birimiyle eşleşmelidir.
  • İşletme doğrulaması. Shops ve reklamlar için Meta, işletme ve alan adı doğrulaması talep edebilir.
  • Açıklama ve ürün adı. Metinleri doldurun — boş ürün kartları moderasyondan daha zor geçer ve daha az satar.

İlgili Bölümler


Sıkça Sorulan Sorular

Siparişler Facebook/Instagram içinde mi alınıyor?

Genellikle hayır — müşteri mağazanızın vitrin web sitesine yönlendirilir ve siparişini orada tamamlar. Entegre Meta checkout her ülkede kullanılabilir değildir.

Bu ücretli mi?

Eklenti ücretlidir ve her bir lokasyon için bağlanır. Meta'daki katalog ve Shops ücretsizdir; reklamlar için ödemeyi Meta reklam yöneticisinde yaparsınız.

Feed'i manuel olarak yüklemek gerekiyor mu?

Hayır. Platform feed'i kendisi günceller, Meta ise belirlenen programa göre indirir.

Ürünler reddedildi — nedeni nedir?

Genellikle: fotoğraf yok veya kalitesi düşük, bağlantılar erişilemiyor (web kataloğu etkinleştirilmemiş), ürün Meta ticaret politikası kısıtlamalarına takılıyor, işletme/alan adı doğrulaması tamamlanmamış veya para birimi uyuşmazlığı var.

Ürün varyasyonları nasıl aktarılır?

Her bir varyasyon, Meta'nın bunları varyasyon seçeneği olan tek bir üründe birleştirebilmesi için ortak bir item_group_id değerine sahip ayrı bir ögedir.