M masamenu.tr
🔗 Entegrasyonlar

🛍️ Google Product Feed

Google Merchant Center için otomatik ürün akışı (XML/CSV): Alışveriş kampanyaları ve ücretsiz listelemeler

Dokümantasyon

Google Product Feed — Google Merchant Center'daki Mağaza Ürünleri

Google Product Feed eklentisi, mağazanızın kataloğunu Google'ın ürün merkezi olan Google Merchant Center'a (merchants.google.com) aktarır. Ürünleriniz buradan şuralara ulaşır:

  • Alışveriş (Shopping) kampanyaları (doğrudan arama sonuçlarında fotoğraf, fiyat ve ürün adı içeren Google Ads reklamları);
  • Ücretsiz ürün listelemeleri (free listings) — tık başına ödeme yapmadan "Alışveriş" (Shopping) sekmesinde ve ana Google aramasında gösterimler;
  • Google Görseller ve aramadaki ürün blokları.

Bu bir pazaryeri değildir: Google içinde sipariş alınmaz. Müşteri ürünü gördüğünde mağazanızın vitrin sitesine geçer ve siparişi orada verir. Merchant Center bir satış platformu değil, ürün verilerinin vitrinidir.

Eklenti API anahtarı olmadan feed modeli ile çalışır: bağlantı yapıldıktan sonra platform, Google Product Feed formatında herkese açık bir ürün akışını (feed) otomatik olarak oluşturur ve sürekli günceller. Size sadece bu feed bağlantısını Merchant Center'da bir kez belirtmek kalır.


Adım 1. Cenaly Bağlantısı ve Feed Linki

  1. Uygulama Mağazası (admin.masamenu.tr/app-store) sayfasını açın ve "Lokasyonlara göre" sekmesine geçin.
  2. Dışarı aktarımı bağlamak istediğiniz lokasyonu seçin.
  3. "Google Product Feed" (Google Merchant Center) kartını bulun ve "Bağla" butonuna tıklayın.
  4. Bağlantı sağlandıktan sonra kart, her biri kopyalama butonuna sahip olan XML ve CSV olmak üzere iki formatta genel feed URL'sini gösterecektir.
  5. İhtiyacınız olan bağlantıyı kopyalayın. URL biçimi: https://cdn.masamenu.tr/feeds/googlefeed/{hesap-id}/{lokasyon-id}.xml (ve CSV sürümü için .csv).

Feed, lokasyon kataloğundan (perakende modu) derlenir ve herhangi bir değişiklikte otomatik olarak güncellenir: ürün oluşturma, düzenleme veya silme, fiyat ve stok değişiklikleri. Tek bir ürünün varyasyonları, ortak bir item_group_id ile ayrı kalemler olarak dışa aktarılır. Fiyatlar indirimleri (sale_price) ve kanala özel fiyat kurallarını, stoklar ise depo tamponunu dikkate alır.

Manuel olarak hiçbir şeyi yeniden oluşturmanıza gerek yoktur — feed'in güncelliği platform tarafından sağlanır.


Adım 2. Akışın Merchant Center'a Eklenmesi

  1. Google Merchant Center hesabınıza giriş yapın (bir Google hesabı ve doğrulanmış bir mağaza web sitesi gereklidir).
  2. Veri kaynakları bölümüne gidin — «Ürünler» → «Veri kaynakları» (Products → Data sources).
  3. «Veri kaynağı ekle» butonuna tıklayın ve ürünleri bir dosyadan zamanlanmış alma (scheduled fetch / «Zamanlanmış alma») yöntemiyle eklemeyi seçin.
  4. Satış ülkesini ve dili belirtin, kaynağa bir isim verin.
  5. Dosya URL'si alanına 1. adımdaki akış bağlantısını yapıştırın (XML önerilir).
  6. Alma programını (sıklık ve zaman) ayarlayın ve kaydedin.

Google, belirtilen bağlantıdan akışı indirecek ve ürünleri incelemeye alacaktır. İlk inceleme genellikle birkaç saat ile 3 iş günü arasında sürer.

Merchant Center arayüzündeki menü başlıklarının tam adları farklılık gösterebilir — veri kaynakları bölümünü ve URL üzerinden dosyayı zamanlanmış alma seçeneğini esas alın.


Hangi format seçilmeli: XML mi CSV mi

Her iki format da aynı Google Product Feed alanlarını içerir. XML (g: ad alanına sahip RSS 2.0) önerilen seçenektir: daha sıkı doğrulanır ve birden fazla fotoğrafı ile varyasyonları daha güvenilir bir şekilde aktarır. CSV, akışı bir tabloda açmak ve içeriği manuel olarak kontrol etmek istiyorsanız kullanışlıdır. Merchant Center için XML seçeneğini tercih edin.

Akışın temel alanları:

Alan İçerik
id Ürünün benzersiz tanımlayıcısı
title Ürün adı
description Açıklama
link Mağazanın web kataloğundaki ürün sayfasına bağlantı
image_link Ana fotoğraf
additional_image_link Ek fotoğraflar
availability Stok durumu: in_stock / out_of_stock
price Fiyat
sale_price İndirimli fiyat
brand Marka
gtin Barkod (GTIN/EAN)
mpn Ürün kodu
condition Durum (new)
item_group_id Aynı ürünün varyasyon grubu
product_type Ürün kategorisi

Google Feed'i Nasıl Alır

Google, belirtilen URL'den feed'i belirli bir programa göre (scheduled fetch) kendisi indirir — hiçbir şey göndermenize gerek yoktur. Önerilen sıklık günde bir kezdir; fiyatların ve stokların sık değiştiği işletmeler için daha sık ayarlanabilir. Platform feed'i otomatik olarak güncellediği için Google her veri aldığında güncel bilgileri görür.


Gereksinimler ve Tipik Sorunlar

  • Çalışan ürün bağlantıları. link alanı açılan bir ürün sayfasına yönlendirmelidir — mağazanın mutlaka etkinleştirilmiş bir web kataloğu (lokasyonun müşteri vitrin sitesi) olmalıdır. Bu olmadan ürünler "erişilemez" olarak reddedilecektir.
  • Fotoğraf zorunludur. Görseli bulunmayan (image_link) ürünler reddedilecektir. Tüm ürünlerin fotoğraflarını doldurun.
  • Açıklama ve başlık. Boş veya çok kısa açıklamalar kaliteyi düşürür; anlamlı bir metin ekleyin.
  • Para birimi ve ülke. Feed para birimi ve satış yapılan ülke, Merchant Center hesap ayarlarıyla eşleşmelidir.
  • Moderasyon. Google, feed verileri ile ürün sayfası arasındaki uyumu (fiyat, stok durumu) kontrol eder. Uyuşmazlıklar reddedilmeye yol açar — kataloğu ve vitrini senkronize tutun; düzeltmeden sonra Google bir sonraki taramada güncellemeleri çekecektir.
  • GTIN/Marka. Birçok kategori için Google geçerli gtin ve brand alanlarını şart koşar — ürünlerin barkodlarını ve markalarını doldurun.

İlgili Bölümler


Sıkça Sorulan Sorular

Ücretli mi?

Uzantı ücretlidir (pazarlama araçları içeren tarife) ve her konum için ayrı olarak yapılandırılır. Google Merchant Center hesabının kendisi ücretsizdir; Shopping kampanyalarındaki tıklamalar için Google Ads üzerinden ödeme yaparsınız, ücretsiz listelemeler ise tamamen ücretsizdir.

Manuel olarak bir şey dışa aktarmak gerekiyor mu?

Hayır. Platform akışı (feed) otomatik olarak oluşturur ve günceller, Google ise belirlenen programa göre indirir.

XML mi yoksa CSV mi?

Merchant Center için XML öneririz — doğrulama süreçleri daha katıdır. CSV ise içeriğin manuel kontrolü için elverişlidir.

Ürünler reddedildi — nedeni nedir?

En sık karşılaşılan nedenler: fotoğraf eksikliği, ürün bağlantılarının erişilemez olması (web kataloğu etkinleştirilmemiş), akıştaki fiyat ile sayfadaki fiyatın uyuşmaması, para birimi/ülke uyuşmazlığı. Kataloğu ve vitrini düzeltin — Google bir sonraki akış alımında verileri otomatik olarak güncelleyecektir.

Ürün varyasyonları (boyut/renk) nasıl dışa aktarılır?

Google'ın bunları varyasyon seçeneği olan tek bir üründe birleştirmesi için her varyasyon, ortak bir item_group_id değerine sahip ayrı bir öğedir.