İkas'ta Merchant Center ürün videosu, ürün kaydındaki video URL'si feed içindeki video_link alanına eşlenerek gönderilir. İkas feed'i bu alanı doğrudan üretmiyorsa ara feed veya Merchant API gerekir.
İşlem üç bileşenden oluşur: İkas'ta saklanan video adresi, ürün kimliğiyle çalışan eşleme tablosu ve Merchant Center'a gönderilen veri kaynağı. Üçündeki ürün kimlikleri aynı olmalıdır.
Önce tek ürünle test yapılmalıdır. Alanın Merchant Center teşhis ekranında işlendiği doğrulandıktan sonra tüm kataloğa geçilmelidir. Böylece hatalı URL yüzlerce ürüne yayılmaz.
İkas'ta video_link aktarımı hangi yöntemle yapılır?
İkas'tan video_link göndermek için doğrudan feed, ara feed veya Merchant API yöntemlerinden biri kullanılmalıdır. Seçim, mevcut ürün alanlarına ve entegrasyonun çalışma biçimine bağlıdır.
İlk olarak İkas ürün dışa aktarımını inceleyin. Ürün videosu için ayrılmış bir alan ve bu alanı Google feed'ine bağlayan eşleme seçeneği görünüyorsa doğrudan aktarım kullanılabilir.
Alan ürün kaydında bulunuyor ancak Google veri kaynağına çıkmıyorsa ara feed gerekir. Ara katman, İkas feed'ini okur ve ilgili ürün satırına video_link sütununu ekler.
İkas'ta video adresini tutacak uygun alan yoksa ürün kodu ile video URL'sini ayrı tabloda eşleyebilirsiniz. Tablo, ürünler güncellendikçe otomatik işlenmeli ve elle kopyalamaya dayanmamalıdır.
Üçüncü seçenek Merchant API'dir. Bu yöntem, ürün verisini uygulama üzerinden güncelleyen mağazalarda daha kontrollüdür. Geçiş planı için Merchant API'ye geçiş nasıl yapılır? rehberindeki kimlik ve test adımları kullanılabilir.
Yanlış: Aynı video adresini, ürün ilgisi kontrol edilmeden bütün kataloğa yazmak. Doğru: Her Merchant Center ürün kimliğini, yalnız o ürünü veya geçerli varyant grubunu gösteren videoyla eşlemek.
Doğrudan yöntem, İkas feed'i alanı eksiksiz üretiyorsa uygundur. Alan feed içinde hiç oluşmuyorsa Merchant Center'a aynı kaynağı tekrar çekmek sorunu çözmez; veri kaynağından önce dönüşüm yapılmalıdır.
İkas ürün videosu alanı nasıl hazırlanır?
İkas ürün videosu alanı, her ürün için tek ve kararlı bir URL saklayacak biçimde hazırlanmalıdır. Alan adı açık olmalı ve başka medya bağlantılarıyla karıştırılmamalıdır.
Önce İkas yönetim panelinde ürün düzenleme ekranını kontrol edin. Panel sürümüne göre video, özel alan veya ek özellik adı kullanılabilir. Menü adı değişse bile amaç URL saklamaktır.
Bir özel alan oluşturulabiliyorsa teknik adı boşluksuz belirleyin. Örneğin google_video_link adı, alanın hangi kanalda kullanılacağını açıkça gösterir ve sonraki eşleme işlemlerini kolaylaştırır.
Alan varyant seviyesinde tutulabiliyorsa her varyantın Merchant Center kimliğini ayrıca kontrol edin. Renk değişimini göstermeyen ortak video, renk bazında farklı gönderilen ürünlerde yanıltıcı olabilir.
Varyant seviyesinde alan bulunmuyorsa ana ürün videosu bütün varyantlara aktarılabilir. Ancak videoda yalnız belirli renk, paket içeriği veya ölçü gösteriliyorsa ortak aktarım yapılmamalıdır.
İkas'taki ürün videosunun Meta kataloğuna aktarılması ayrı bir veri akışıdır. Google eşlemesini kurarken İkas'ta ürün videosu Meta kataloğuna nasıl gider? içeriğindeki kanal ayrımına dikkat edin.
Alanı toplu doldurmadan önce beş farklı ürün tipi seçin. Basit ürün, varyantlı ürün, videosuz ürün, pasif ürün ve yeni eklenen ürün üzerinde dışa aktarımı ayrı ayrı inceleyin.
Özel alan feed çıktısında görünmüyorsa yalnız panelde doldurulması yeterli değildir. Bu durumda alanı İkas API çıktısından almak veya ürün koduyla harici tabloda birleştirmek gerekir.
İkas feed'inde video_link alanı nasıl eşlenir?
İkas feed'inde eşleme, ürünün benzersiz kimliği korunarak kaynak video alanının video_link sütununa yazılmasıyla yapılır. Başlık veya ürün adına göre eşleme kullanılmamalıdır.
Önce mevcut Google ürün feed'ini indirin. id, item_group_id, bağlantı ve stok alanlarını kontrol edin. Video tablosundaki anahtar, feed içindeki id değeriyle birebir eşleşmelidir.
Başlıkla eşleme güvenilir değildir. Ürün adı değişebilir, aynı başlık iki varyantta kullanılabilir veya kampanya metni eklenebilir. SKU da yalnız Merchant Center kimliği olarak gönderiliyorsa güvenlidir.
Ara feed kullanıyorsanız işlem sırası aşağıdaki gibi kurulmalıdır:
- İkas'ın güncel ürün feed'ini zamanlanmış görevle alın.
- Her satırdaki Merchant Center ürün kimliğini okuyun.
- Kimliği video URL tablosundaki kayıtla eşleştirin.
- Eşleşen kayda
video_linkalanını ekleyin. - Eşleşmeyen ürünlerde alanı boş bırakın; örnek video yazmayın.
- Yeni feed'i Merchant Center veri kaynağına gönderin.
Tamamlayıcı veri kaynağı kullanılabiliyorsa yalnız id ve video_link sütunlarını içeren ayrı dosya hazırlanabilir. Bu kaynak yeni ürün oluşturmaz; mevcut ürün kimliklerini ek veriyle tamamlar.
Merchant Center hesabınız tamamlayıcı kaynağı veya gerekli dönüşümü desteklemiyorsa ana feed'i değiştirmek gerekir. Genel uygulama adımları Merchant Center'a ürün videosu nasıl eklenir? sayfasında ayrıca açıklanır.
İşe yaramayan durum, İkas feed'indeki kimlik ile Merchant Center'daki kimliğin farklı olmasıdır. Böyle bir eşlemede URL doğru olsa bile video yanlış ürüne bağlanır veya hiç işlenmez.
Merchant API ile video_link nasıl gönderilir?
Merchant API ile gönderim, İkas ürün kimliği ve video URL'si uygulama tarafından hazırlanıp ilgili Merchant Center ürün kaydına yazılarak yapılır. Önce tek ürün üzerinde deneme yapılmalıdır.
API katmanı, İkas'tan ürün güncelleme zamanını takip etmelidir. Video değişmediği halde her çalışmada bütün kataloğu yeniden göndermek yerine yalnız değişen kayıtları işlemek daha güvenlidir.
Uygulamada en az dört değer tutulmalıdır: İkas ürün kimliği, Merchant Center ürün kimliği, gönderilen video URL'si ve son güncelleme zamanı. Hata yanıtı da kayıtla ilişkilendirilmelidir.
Ürün kimliği oluşturulurken mevcut entegrasyonun ülke, dil ve kanal yapısı korunmalıdır. Yeni bir kimlik üretmek, aynı ürünü ikinci kez oluşturabilir ve geçmiş performans verisini bölebilir.
Gönderim akışı şu mantıkla çalışmalıdır: Ürünü İkas'tan oku, URL'yi doğrula, mevcut Merchant ürününü bul, alanı güncelle, API yanıtını kaydet ve teşhis sonucunu daha sonra kontrol et.
API'nin isteği kabul etmesi, videonun kesin yayımlandığı anlamına gelmez. İlk yanıt yalnız veri biçiminin işlendiğini gösterebilir. URL erişimi ve politika değerlendirmesi sonradan tamamlanabilir.
API şeması ve alan adları zamanla değişebileceği için geliştirme sırasında güncel Merchant API dokümanı esas alınmalıdır. Eski Content API örneklerini doğrudan kopyalamak uyumsuz alanlara neden olabilir.
Bu yöntem, sık güncellenen geniş kataloglarda işe yarar. Ayda birkaç video eklenen küçük kataloglarda ise iki sütunlu tamamlayıcı kaynak, özel yazılım bakımından daha düşük operasyon yükü oluşturabilir.
API kurulumu yalnız video için düşünülmemelidir. Teslimat, iade veya başka ürün alanları aynı akıştan yönetilecekse merkezi entegrasyon daha anlamlı hale gelir.
Video URL'si hangi teknik koşulları karşılamalı?
Video URL'si herkese açık, kararlı ve Merchant Center tarayıcısının erişebileceği bir HTTPS adresi olmalıdır. Oturum, tek kullanımlık anahtar veya kısa süreli imza isteyen bağlantılar kullanılmamalıdır.
URL'yi gizli tarayıcı penceresinde açmak ilk kontroldür. Video yalnız yönetici oturumunda çalışıyorsa Google da dosyaya ulaşamayabilir. Farklı ağdan yapılan test daha güvenilir sonuç verir.
Sunucu, Google'ın isteğine başarılı HTTP yanıtı vermelidir. Yönlendirme zinciri, coğrafi engel, robot kuralı veya güvenlik duvarı erişimi kesiyorsa alan feed'de bulunsa bile işlenmez.
URL türü, Merchant Center'ın güncel video_link özelliğinde kabul ettiği biçimle uyumlu olmalıdır. Video sayfası ile doğrudan medya dosyası aynı değildir; dokümanda istenen URL türü kullanılmalıdır.
Dosya veya sayfa adresi kalıcı olmalıdır. Her ürün güncellemesinde URL'nin değişmesi, Google'ın videoyu yeniden taramasına yol açar. Süresi dolan depolama bağlantıları üretim feed'ine yazılmamalıdır.
Video, gönderildiği ürünle açık biçimde ilişkili olmalıdır. Başka modelin görüntüsü, farklı paket adedi veya videoda bulunmayan aksesuarlar ürün verisiyle çelişebilir.
Video hazırlığı, yalnız bağlantı oluşturmaktan ibaret değildir. Google yüzeylerindeki diğer kullanım biçimleri için Google SEO'da yeni ürün videosu alanı nasıl kullanılır? içeriği incelenebilir.
Tarayıcı testi geçse bile robots.txt, CDN güvenlik ayarı ve referans kontrolü ayrıca incelenmelidir. Yalnız kendi alan adınızdan oynatmaya izin veren koruma, Google erişimini engelleyebilir.
Video ürün detayını göstermiyorsa teknik olarak erişilebilir olması yeterli değildir. Logo animasyonu, mağaza tanıtımı veya genel kategori videosu, ürün bazlı video_link için uygun kaynak sayılmaz.
Merchant Center'da video gönderimi nasıl test edilir?
Video gönderimi, önce feed önizlemesi, sonra veri kaynağı işleme sonucu ve son olarak ürün teşhis ekranı üzerinden test edilir. Yalnız İkas panelindeki bağlantıya bakmak yeterli değildir.
İlk test için farklı yapıda beş ürün seçin. Bu ürünlerin Merchant Center kimliklerini kaydedin. Feed işlendiğinde aynı kimliklerde video_link değerinin bulunup bulunmadığını kontrol edin.
Ana feed dosyasını açabiliyorsanız alan adını ve satır değerini doğrudan arayın. XML kullanılıyorsa etiket yapısını, CSV kullanılıyorsa sütun başlığını ve ayırıcı karakteri inceleyin.
Alan dosyada yoksa sorun Merchant Center'da değildir. İkas dışa aktarımı veya ara feed dönüşümü eksiktir. Dosyada varsa veri kaynağının işleme raporuna geçilmelidir.
Alan dosyada doğru görünüyor fakat ürün ekranına ulaşmıyorsa kimlik eşleşmesini kontrol edin. Tamamlayıcı kaynaktaki id, ana kaynakta bulunan değerle karakter karakter aynı olmalıdır.
URL hatalarında aşağıdaki kontroller uygulanmalıdır:
- Bağlantı gizli pencerede oturum açmadan açılıyor mu?
- Adres HTTPS ile başlıyor ve süresiz çalışıyor mu?
- Sunucu yönlendirme döngüsü oluşturuyor mu?
- Video doğru ürün, varyant ve paket içeriğini gösteriyor mu?
- Feed'deki ürün kimliği doğru videoyla eşleşiyor mu?
Merchant Center'daki hata metnini aynen kaydedin. “İşlenmedi” ifadesini tek başına raporlamak yerine ürün kimliği, kaynak adı, URL, işlem zamanı ve hata mesajını birlikte saklayın.
Bir ürün başarılı olmadan toplu gönderim yapılmamalıdır. Tek ürün testi eşleme hatasını gösterir; beş ürün testi ise basit, varyantlı ve videosuz kayıtların farklı davranışlarını ortaya çıkarır.
Doğrudan feed, tamamlayıcı kaynak ve Merchant API arasındaki fark nedir?
Doğrudan feed en az bileşene, Merchant API en yüksek güncelleme kontrolüne sahiptir. Tamamlayıcı kaynak ise mevcut İkas feed'ini bozmadan video alanı eklemek için kullanılabilir.
Yöntemi katalog büyüklüğüne göre değil, güncelleme sıklığı ve mevcut teknik altyapıya göre seçin. Bin ürünlü fakat ayda bir değişen katalog, API geliştirmesini tek başına gerektirmez.
| Yöntem | Gereken yapı | Uygun durum | İşe yaramadığı durum |
|---|---|---|---|
| İkas doğrudan feed | Video alanı ve Google eşlemesi | Alan feed'de yerel olarak üretiliyorsa | İkas çıktısı video_link üretmiyorsa |
| Ara feed | Feed dönüştürücü ve kimlik tablosu | Mevcut kaynak korunacaksa | Kimlikler kararlı değilse |
| Tamamlayıcı kaynak | id ve video_link dosyası | Mevcut ürünlere alan eklenecekse | Ürün ana kaynakta bulunmuyorsa |
| Merchant API | Uygulama, yetkilendirme ve kayıt sistemi | Sık ve otomatik güncelleme gerekiyorsa | Bakım sorumlusu yoksa |
Doğrudan feed'de hata noktası azdır. Ancak platform alanı desteklemiyorsa kullanıcı müdahalesiyle yeni sütun eklenemez. Her feed yenilemesinde elle yapılan değişiklikler kaybolur.
Ara feed esnektir. İkas çıktısına dokunmadan yeni alan ekler. Buna karşılık zamanlanmış görev durursa Merchant Center eski videoyu kullanabilir veya güncel ürünleri eksik alabilir.
Tamamlayıcı kaynak, az sayıda alan için pratiktir. Fakat ana kaynaktaki ürün kimliği değişirse satırlar eşleşmez. Bu nedenle kimlik üretim kuralı belgelenmelidir.
Merchant API, hata kaydı ve seçili ürün güncellemesi sağlar. Buna karşılık erişim anahtarları, sürüm değişiklikleri ve başarısız istekler düzenli izlenmelidir. Sorumlusu olmayan API kalıcı çözüm değildir.
Web sitesi altyapısından bağımsız genel eşleme seçenekleri için Web sitesine Merchant Center video_link nasıl eklenir? rehberi de kullanılabilir.
Yayına almadan önce hangi kontrol listesi uygulanmalıdır?
Yayına almadan önce ürün kimliği, video erişimi, feed alanı ve Merchant Center işleme sonucu birlikte kontrol edilmelidir. Dört kontrolden biri eksikse katalog geneline geçilmemelidir.
Kontrol listesini yalnız ilk kurulumda kullanmayın. Yeni video yükleme, alan adı değişikliği, CDN geçişi veya İkas feed ayarı güncellemesi sonrasında aynı test yeniden uygulanmalıdır.
- İkas ürün kaydında doğru video URL'si bulunuyor.
- Video adresi oturumsuz ve farklı ağdan açılabiliyor.
- URL geçici imza veya kısa süreli anahtar içermiyor.
- Feed çıktısında
video_linkalanı oluşuyor. - Kaynak ve Merchant Center ürün kimlikleri birebir eşleşiyor.
- Varyant videosu doğru renk, ölçü veya paketi gösteriyor.
- Videosuz ürünlerde alan boş bırakılıyor.
- Test ürünleri veri kaynağında hatasız işleniyor.
- API veya feed hataları ürün kimliğiyle kaydediliyor.
- Video değişikliklerinin sorumlusu ve kontrol sıklığı belirleniyor.
Operasyon kaydında en az ürün kimliği, eski URL, yeni URL, değişiklik tarihi ve işlem sonucu tutulmalıdır. Böylece reddedilen videonun hangi gün ve hangi kaynakla gönderildiği bulunabilir.
Videosu kaldırılan üründe eski URL'nin feed'de kalmadığını doğrulayın. İkas alanını boşaltmak, ara tablo veya önbellek eski değeri koruyorsa Merchant Center kaydını kendiliğinden temizlemeyebilir.
Ürün yayından kalktığında video dosyasını hemen silmek yerine veri kaynaklarının güncellenmesini bekleyin. Aksi durumda Google, ürün güncellemesi tamamlanmadan erişilemeyen bir bağlantıyla karşılaşabilir.
Son kabul testi, tek bir başarılı ürün görüntülemek değildir. Seçilen örneklerde videosuz kayıt, varyant eşleşmesi, kaldırılan video ve yeni eklenen video senaryoları birlikte doğrulanmalıdır.
Düzenli kontrol, feed'in son işlenme zamanı ile İkas'taki son ürün güncellemesini karşılaştırmalıdır. Aradaki fark beklenen çalışma planını aşıyorsa veri akışı araştırılmalıdır.
İkas alan eşlemesi, Merchant Center veri kaynağı kurulumu veya ürün videosu üretimi birlikte planlanacaksa Sen Medyografya, örnek ürün üzerinden teknik kapsam ve çekim listesini çıkarabilir.
İlgili Yazılar
Sık Sorulan Sorular
İkas video_link alanını doğrudan Merchant Center'a gönderir mi?
İkas feed'inde video alanı ve Google eşlemesi bulunuyorsa doğrudan gönderilebilir. Alan çıktıda oluşmuyorsa ara feed, tamamlayıcı kaynak veya Merchant API kullanılmalıdır.
Merchant Center için video URL'si nasıl olmalıdır?
URL herkese açık, HTTPS kullanan, oturum istemeyen ve süresi dolmayan bir adres olmalıdır. URL türü güncel video_link teknik şartlarıyla da eşleşmelidir.
Tamamlayıcı veri kaynağı yeni ürün oluşturur mu?
Hayır. Tamamlayıcı kaynak, ana veri kaynağında bulunan ve kimliği eşleşen ürünlere video_link gibi ek alanlar sağlar.
İkas ürün adıyla video eşlemesi yapılabilir mi?
Önerilmez. Ürün adları değişebilir veya varyantlarda tekrarlanabilir. Eşleme, Merchant Center'a gönderilen benzersiz ürün kimliği üzerinden yapılmalıdır.
Merchant API isteğinin başarılı olması videonun yayımlandığını gösterir mi?
Her zaman göstermez. Başarılı API yanıtından sonra veri kaynağı işleme sonucu, URL erişimi ve ürün teşhis ekranı ayrıca kontrol edilmelidir.