M masamenu.tr
🔗 Entegrasyonlar

📌 Pinterest Product Feed

Pinterest Catalogs için otomatik ürün akışı (XML/CSV): ürün pinleri (product pins) ve reklamlar

Dokümantasyon

Pinterest Product Feed — Pinterest Catalogs İçindeki Ürünler

Pinterest Product Feed eklentisi, mağazanızın kataloğunu Pinterest Catalogs'a (Pinterest Business bölümü, business.pinterest.com) aktarır. Pinterest, katalog temelinde şunları oluşturur:

  • ürün pinleri (product pins) — güncel fiyat, stok durumu ve ürün bağlantısı içeren pinler;
  • profilinizin Shop bölümünde ürün vitrini;
  • ürün reklamları (Shopping ads) ve katalog üzerinden dinamik yeniden hedefleme.

Pinterest; ev ürünleri, dekorasyon, giyim, takı, kozmetik ve hediye kategorilerinde yüksek satın alma amacına sahip bir platformdur. Sipariş tamamlama adımı mağazanızın vitrin web sitesine yönlendirir.

Eklenti, API anahtarı gerektirmeyen feed modeli ile çalışır: platform, Google Product Feed formatında (Pinterest bu şemayı kabul eder) herkese açık bir ürün feed'i oluşturur ve bunu sürekli günceller. Pinterest Catalogs bölümüne feed bağlantısını bir kez eklemeniz 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. "Pinterest Product Feed" (Pinterest Catalogs) 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/pinterestfeed/{hesap-id}/{lokasyon-id}.xml (ve .csv).
  5. İlgili bağlantıyı kopyalayın.

Feed, lokasyon kataloğundan (perakende modu) oluşturulur ve ürünlerde, fiyatlarda veya stok miktarlarında değişiklik olduğunda otomatik olarak güncellenir. Varyasyonlar, ortak bir item_group_id ile ayrı ögeler olarak dışa aktarılır.


Adım 2. Akışın Pinterest Catalogs'a Eklenmesi

  1. Pinterest Business (business.pinterest.com) hesabınıza giriş yapın ve vitrin sitenizin alan adını doğrulayın (Pinterest kataloglar için alan adı doğrulaması gerektirir).
  2. İş araçları menüsünden "Kataloglar" (Catalogs) bölümünü açın (Reklam/Ads → Kataloglar).
  3. Bir veri kaynağı (data source) ekleyin — bağlantı üzerinden ürün akışı.
  4. Dosya URL'sini belirtin — Adım 1'deki akış bağlantısını yapıştırın (önerilen XML), ülkeyi ve dili/para birimini seçin.
  5. Kaydedin — Pinterest akışı periyodik olarak yüklemeye başlayacaktır.

Pinterest akışı işleyecek ve ürün pinleri oluşturacaktır; ardından katalog incelemeden geçer. Onaylandıktan sonra ürünler reklamlar ve Shop bölümü için kullanılabilir hale gelir.

Pinterest Business'taki menü ögelerinin adları değişebilir — "Kataloglar" bölümüne ve URL ile veri kaynağı ekleme seçeneğine odaklanın.


Hangi format seçilmeli: XML mi CSV mi

Pinterest her ikisini de kabul eder. XML varyasyonlar ve birden fazla görsel için tercih edilir; CSV ise içeriğin manuel olarak kontrol edilmesi için uygundur.

Feed'in temel alanları:

Alan Ne içerir
id Ürünün benzersiz tanımlayıcısı
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

Pinterest Feed'i Nasıl Alır

Pinterest, feed'i belirtilen URL'den bir takvime göre kendisi indirir (genellikle günlük olarak). Platform feed'i otomatik olarak günceller, bu nedenle veriler her zaman günceldir. Feed'i manuel olarak göndermenize gerek yoktur; önerilen güncelleme sıklığı — günde bir kez.


Gereksinimler ve Sık Karşılaşılan Sorunlar

  • Alan adı doğrulaması (claim). Pinterest, vitrin sitesinin alan adı haklarını doğrulamanızı gerektirir; aksi takdirde katalog kabul edilmez.
  • Ç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 reddedilir; Pinterest dikey ve kaliteli görselleri tercih eder.
  • Para birimi ve ülke. Pinterest hesap ayarlarıyla eşleşmelidir.
  • Moderasyon. Katalog incelemeden geçer; yasaklı kategoriler reddedilir.
  • Açıklama ve başlık. Metinleri doldurun — bu durum onay sürecini ve Pin erişimlerini etkiler.

İlgili Bölümler


Sıkça Sorulan Sorular

Siparişler Pinterest içinde mi alınıyor?

Hayır — müşteri ürün pinine tıklayarak mağazanızın vitrin sitesine geçer ve siparişi orada oluşturur.

Bu ücretli mi?

Eklenti ücretlidir ve her bir lokasyon için ayrı tanımlanır. Pinterest'teki katalog ve product pin'ler ücretsizdir; reklam için ödemeyi Pinterest Ads üzerinden yaparsınız.

Feed'i manuel olarak yüklemek gerekiyor mu?

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

Katalog kabul edilmiyor — neden?

En yaygın nedenler: alan adının doğrulanmamış olması (claim), fotoğraf bulunmaması, bağlantıların erişilemez olması (web kataloğunun açılmamış olması) veya para birimi/ülke uyuşmazlığıdır. Alan adınızı doğrulayın ve kataloğu kontrol edin.

Ürün varyasyonları nasıl dışa aktarılır?

Her varyasyon, ortak bir item_group_id değerine sahip ayrı bir üründür.