# Ürünler

> Ürün kaynağının bağlanması, alanların eşlenmesi ve ürün listesinin güncel tutulması.

Kaynak: /tr/features/products/

Her yorum bir ürünle ilişkilendirilir. **Ürünler** ekranı, ürünlerinizin Sayproof'a hangi kaynaktan aktarıldığını ve hangi ürünlerin kayıtlı olduğunu gösterir. Ürün listesi güncel olduğunda:

- yorumlar doğru ürünle eşleşir;
- **İstatistikler** ekranında ürün adları gösterilir;
- ürün tipine göre doğru **değerlendirme başlıkları** sorulur;
- kanalda davet sayfası tanımlı değilse davet bağlantısı ürünün kendi sayfasını açar.

Katalogda bulunmayan bir ürün için yazılan yorum, "Katalog eşleşmesi" kontrolü tarafından onaya bırakılır.

Ekranın üstündeki sayaçların altında iki sekme bulunur. Her sekmenin üstündeki tek cümle o sekmenin ne işe yaradığını anlatır:

- **Ürünler:** Sayproof'a kayıtlı bütün ürünleriniz. Listenin **Başlık listesi** sütunu her ürüne sorulan değerlendirme başlıklarını gösterir; listeler kartın başlığındaki **Değerlendirme başlıklarına git** düğmesiyle açılan **Değerlendirme başlıkları** ekranında hazırlanır. **Yazılan yorum** sütunu ürüne yazılmış bütün yorumları, durumlarından bağımsız olarak sayar.
- **Ürün kaynakları:** ürün listenizin Sayproof'a nereden ve ne sıklıkla geldiği. Yeni kaynak bu sekmeden eklenir; listede bir kaynağa tıklandığında kaynağın ayrıntısı açılır. **Sonraki adım** sütunu kaynağın sıradaki işini gösterir: **Eşleme ekleyin**, **Bağlantıyı düzeltin**, **Okumayı izleyin**, **Pasife almayı onaylayın** ya da **Hazır**; kapatılmış kaynakta **Kapalı** yazar.

Bu ekranı kullanmak için "Ayarları değiştirebilir" izni gerekir (Yönetici); diğer roller ekranı menüde görmez.

## Ürün kaynağı

Ürünler bir ya da daha fazla **ürün kaynağından** okunur. İki kaynak türü vardır; tür, kaynak kaydedildikten sonra değiştirilemez:

| Tür | Kullanım durumu |
|---|---|
| **Ürün dosyası (XML, CSV, JSON)** | Sitenizin belirli bir adreste yayınladığı ürün dosyası. Google ürün dosyası da bu türdedir. |
| **Ürün servisi (API)** | Ürünleri sayfalar hâlinde döndüren bir servis. Bağlantı bilgilerini genellikle yazılım ekibiniz sağlar. |

Hazır ayarlar bağlantı ve eşleme alanlarını sizin yerinize doldurur: Google Merchant XML dosyası, Google Merchant CSV dosyası ve Akinon Omnitron ürün servisi.

### Yeni kaynak eklenmesi

**Ürün kaynakları** sekmesindeki **Yeni kaynak ekle** düğmesi üç adımlık sihirbazı açar:

1. **Tür ve ad:** kaynağın türü ve adı.
2. **Bağlantı:** varsa **Hazır ayar** (seçildiğinde alanlar dolar), adres (`https`, port numarası olmadan), dosya biçimi, kayıtların dosyadaki konumu ya da sütun ayırıcı, giriş yöntemi ve okuma sıklığı.
   - Giriş yöntemleri: Giriş yok · Erişim anahtarı · Kullanıcı adı ve parola · Özel istek başlığıyla (header) · Adresteki parametreyle · Giriş yaparak.
   - Ürün servisi için sayfalama: Tek sayfa · Sayfa numarasıyla · Başlangıç ve adetle · Sonraki sayfa işaretiyle. Servis değişiklik tarihini döndürüyorsa yalnızca değişen ürünler istenebilir.
   - Okuma sıklığı seçenekleri: 15 dakikada bir · Saatte bir · 6 saatte bir · Günde bir.
3. **Deneme:** Birkaç kayıt okunur ve sonuç açıklamasıyla gösterilir: çalışıyor, kayıt gelmedi, ulaşılamadı, ayarlar hatalı ya da okunamadı. Deneme sırasında hiçbir veri kaydedilmez.

Sihirbazın alt çubuğundaki **Kaynağı kaydet** düğmesi kaynağı o anki bilgileriyle kaydeder (kaynağın adı zorunludur); kaydedilen kaynak listede görünür ve kurulumuna kaynağın ayrıntısından devam edilebilir.

Parola ve erişim anahtarı gibi değerler şifrelenerek saklanır ve bir daha ekranda gösterilmez. Kaynağın adresi ya da giriş adresi başka bir alan adına taşınırsa kayıtlı giriş bilgileri yeni adrese aktarılmaz; yeniden girilmeleri gerekir. Sayfalama sırasında servis başka bir alan adındaki sonraki sayfa adresini verirse o isteğe giriş bilgisi eklenmez.

## Eşleme

Kaynak bağlandıktan sonra **Eşleme** sekmesinde, kaynaktaki alanların Sayproof'taki hangi alanlara aktarılacağı belirlenir. Sol tarafta kaynakta bulunan alanlar (kaç kayıtta yer aldıkları ve örnek değerleri) ile örnek kayıtlar, sağ tarafta eşleme satırları gösterilir.

| Sayproof alanı | Açıklama |
|---|---|
| **Varyant kodu** | Ürünü tanımlayan alandır ve zorunludur. Sipariş aktarımındaki `variant_key` değeriyle ve sayfadaki yorum container'ının ürün koduyla aynı olmalıdır. |
| Ürün grubu | Aynı ürünün varyantlarını bir araya getiren kod |
| Ürün adı | Zorunlu alan |
| Ürün sayfası | Davet bağlantısı için yedek adres |
| Ürün görseli | Ürünün görsel adresi |
| Ürün tipi | Hangi değerlendirme başlıklarının sorulacağını belirler |
| GTIN (barkod) | Ürünün barkodu; Google ürün yorumları dosyasında ürünü eşleştirir |
| Üretici parça numarası (MPN) | Markayla birlikte Google ürün yorumları dosyasında ürünü eşleştirir |
| Marka | Ürünün markası; MPN ile birlikte kullanılır |
| Katalog numarası | Ürünün katalogdaki numarası |
| Özel alanlar | Markanın kendi tanımladığı ek alanlar |

**GTIN (barkod)**, **Üretici parça numarası (MPN)** ve **Marka** metin olarak okunur; Google Merchant hazır ayarları bu alanları kendiliğinden eşler. Kullanımları için: [Google ürün yorumları](/tr/integrate/google-reviews.md).

Her satır için değer türü seçilir: Metin, Tam sayı, Ondalıklı sayı, Evet / hayır, Tarih ve saat, Liste. **Dene** düğmesi, her örnek kaydın okunup okunmayacağını ve okunmayacaksa nedenini gösterir.

Ürünü tanımlayan alan başka bir kaynak alanına taşınırsa kaydetmeden önce onay istenir. Bu durumda eski kodlarla aktarılan ürünler bir sonraki tam okumada pasif duruma alınabilir.

## Okumalar ve sorunlar

**Okumalar** sekmesi, devam eden okumanın ilerlemesini, geçmiş okumaları ve kayıt bazındaki sorunları gösterir: ürünü tanımlayan alanın boş olması, zorunlu alanın eksik olması, bir değerin okunamaması, aynı varyant kodunun birden fazla kayıtta bulunması. Sekmedeki tablonun **Sorunlu satır** sütununda sayıya tıklandığında o okumanın sorunlu satırları yan panelde kayıt numarası, neden ve ayrıntıyla listelenir.

Bir kaynak art arda belirli sayıda okunamazsa (varsayılan 3) marka yöneticilerine bir kez e-posta gönderilir. Bu sayı **Ayarlar** ekranının **Uyarı sınırları** sekmesinden değiştirilebilir; 0 değeri uyarıyı kapatır.

Ürün servisi okumalarında:

- Okuma sayfa sınırına (varsayılan 10.000 sayfa) ulaştığında hâlâ okunacak sayfa varsa okuma `page_limit_reached: <sınır>` koduyla başarısız sayılır; sonraki okuma kaldığı yerden devam eder. Katalog tam olarak sınır kadar sayfayı doldurup bitiyorsa okuma normal biçimde tamamlanır.
- Servis aynı sonraki sayfa işaretini ikinci kez verirse okuma `cursor_repeated` koduyla durdurulur.
- Yalnızca değişen ürünleri isteyen bir okuma yarıda kesilirse sonraki okuma aynı tarih filtresiyle kaldığı yerden devam eder.
- Hizmeti dondurulmuş ya da kapatılmış markaların kaynakları okunmaz.

## Ürünlerin korunması

- Tam bir okumada bulunmayan ürünler silinmez, **pasif duruma alınır**; bu ürünlerin yorumları korunur. Yalnızca ilgili kaynağın ürünleri etkilenir. Yalnızca değişen ürünleri isteyen okuma (yarıda kesilip devam ettirilmiş olsa bile) ve sayfa sınırına takılan okuma tam okuma sayılmaz; bu okumalardan sonra hiçbir ürün pasif duruma alınmaz.
- Tek bir okumada etkin ürünlerin yarısından fazlası (en az 10 ürün) pasif duruma geçecekse ya da hiç kayıt gelmemişse pasife alma bekletilir ve onayınız beklenir; okumanın diğer sonuçları (yeni ve güncellenen ürünler) kaydedilir. Böylece hatalı bir dosya kataloğun boşalmasına yol açmaz. Kaynağın ayrıntısında **Pasife alma bekletildi** uyarısı gösterilir. Kaynak doğruysa uyarıdaki **Pasife almayı onayla ve çalıştır** düğmesi, onayınızı aldıktan sonra kaynağı onaylı olarak yeniden okur ve **Okumalar** sekmesini açar. Onaylanana kadar sonraki okumalarda da pasife alma bekletilir.
- Kaynak, ayrıntısının başlığında durum etiketinin yanındaki **Kaynağı kapat** düğmesiyle (onay ister) kapatılır, **Kaynağı aç** ile yeniden açılır; kapalı kaynak listede de **Kaynağı aç** düğmesiyle görünür. Kapalı kaynakta **Şimdi oku** düğmesi pasiftir. Kaynağın kapatılması ya da silinmesi (**Silme** sekmesi) ürünleri silmez.
- Bağlantı ya da eşleme sekmesinde kaydedilmemiş değişiklik varken başka sekmeye geçmek, **Şimdi oku** ya da **Yeniden eşle** önce onay ister; böylece kaydedilmemiş değişiklik sessizce kaybolmaz.

## Dosyadan yükleme

Ürün dosyası türündeki kaynaklarda, adres yerine elinizdeki bir dosya bir kez okutulabilir. Dosya, kaynağın biçim ayarlarıyla okunur. **Önce dene (kaydetmez)** seçeneği, sonucu hiçbir kayıt yazmadan gösterir. Deneme, **Okumalar** sekmesinde **Deneme · kaydedilmedi** işaretiyle ayrı bir satır olarak görünür; kaynak listesindeki **Son okuma** ve **Sonraki adım** bilgisini değiştirmez. Başarısız bir deneme art arda okunamama sayısına eklenmez ve uyarı e-postası göndermez. Kapatılmış kaynakta **Dosyadan yükle** kartı gösterilmez.

## Ürün ayrıntısı

Kaynak ayrıntısının **Ürünler** sekmesinde bir ürüne tıklandığında eşlenen alanlar, özel alanlar, ürünün kaynakta en son görüldüğü zaman ve kaynaktan gelen ham kayıt gösterilir.