Facebook Open Graph Önbelleğini Yenilemeyi Zorlama

Facebook Open Graph önbelleğini yenilemeyi zorlayabilirsiniz, çünkü Facebook — büyük platformlar arasında tek başına — programatik olarak talep etmenin bir yolunu sunar. Tek bir bağlantı için Sharing Debugger'daki Scrape Again düğmesini kullanabilir veya bir uygulama erişim belirteciyle Graph API'nin scrape uç noktasını çağırabilirsiniz. WhatsApp, LinkedIn veya X için zorlamanın bir yolu yoktur: bu platformlar kimse için böyle bir API yayınlamaz.

Herkesin takıldığı nokta

Meta, bir bağlantı önizlemesini sayfa URL'sine göre anahtarlayarak önbelleğe alır ve görselin kendi kopyasını saklar. og:image artık başka bir yeri gösterdiğini fark etmek için sayfanızı yeniden okumaz.

Bu yüzden şu iş akışı başarısız olur ve çoğu kişinin denediği yöntem de budur:

Kapağı değiştir → og:image URL'si yenidir → Facebook'un bunu alacağını varsay → almaz.

Yeni bir görsel URL'si, görsel CDN'sini aşar. Meta'nın sayfa anahtarlı önbelleğine hiçbir etkisi yoktur. Facebook'u harekete geçirmek için Meta'ya sayfanın değiştiğini bildirmeniz gerekir.

Önbellek	Anahtarlama ölçütü	Temizleme yöntemi
Sayfa önbelleğiniz / CDN	sayfa URL'si	temizleme (purge)
Meta'nın bağlantı önizleme önbelleği	sayfa URL'si	kazıma uç noktası (scrape endpoint) veya Sharing Debugger
Meta'nın görsel kopyası	görsel URL'si	yeni bir görsel URL'si
Görsel CDN'niz	görsel URL'si	yeni bir görsel URL'si

developers.facebook.com/tools/debug adresini açın, sayfa URL'sini yapıştırın ve Scrape Again düğmesine basın. Meta sayfayı yeniden getirir ve önbelleğe alınmış önizlemesini yeniden oluşturur.

Aynı zamanda sahip olduğunuz en iyi ücretsiz doğrulayıcıdır; çünkü umduğunuz şeyi değil, Meta'nın gerçekte bulduğunu raporlar: eksik veya yinelenen og:image, erişilemeyen görseller, desteklenmeyen biçimler. Yapmayacağı iki şey vardır: WhatsApp'a dokunamaz (alıcının uygulamasında ayrı bir önbellek vardır) ve bir katalog aracı değildir — her seferinde tek bir URL, hız sınırlı ve karşısında bir insan vardır.

Seçenek 2 — Graph API (bir eklentinin çağırdığı yöntem budur)

FastOG tarafından kullanılan programatik karşılık, scrape=true ile Graph API'ye yapılan bir POST isteğidir:

bash

curl -X POST \
  "https://graph.facebook.com/v21.0/?id=$(python3 -c 'import urllib.parse,sys;print(urllib.parse.quote(sys.argv[1],safe=""))' 'https://your-store.com/product/example')&scrape=true&access_token=${APP_ID}|${APP_SECRET}"

Önemli olan dört ayrıntı:

id sayfa URL'sidir, görsel URL'si değil. Meta önbelleğini sayfaya göre anahtarlar; bu nedenle görsel adresine ping atmak hiçbir şeyi yenilemez.
Bir token gereklidir — Meta, Ekim 2017'den bu yana bu uç noktada bir token zorunlu tutmaktadır. {app_id}|{app_secret} biçimindeki bir uygulama erişim token'ı yeterlidir ve kullanıcı girişi gerektirmez; bu da çağrıyı bir arka plan işinden yapmayı tam olarak mümkün kılan şeydir.
Graph API sürümleri değişir. FastOG, test edilmiş bir Graph API sürümünü sabitler; kendi kodunuzda bir sürümü sabitlemeden önce Meta'nın güncel dokümantasyonunu ve değişiklik günlüğünü kontrol edin.
Bunu en iyi çaba olarak değerlendirin. Meta, kazıma (scrape) çağrılarını hız sınırına tabi tutar ve bir reddetme yalnızca Facebook'un anında değil, kendi programına göre yenilemesi anlamına gelir — sayfanızdaki etiketler zaten doğrudur.

Hız sınırına tabi olduğu için, büyük bir kataloğun her kaydında bunu satır içi olarak tetiklemeyin. Kuyruğa alın ve URL'ye göre yinelenenleri ayıklayın; böylece aynı değişmemiş ürünün tekrarlanan kayıtları hız sınırını tüketmez.

Seçenek 3 — bunu sizin için yapan bir eklenti

"Open Graph önbellek yenileme" olarak pazarlanan eklentiler iki gruba ayrılır ve bunlardan yalnızca biri Facebook sorununu çözebilir:

Mekanizma	Neyi temizler	Eski bir Facebook önizlemesini düzeltir mi?
Görsel URL'sine değişen bir sorgu dizesi ekler (`?v=timestamp`)	görsel CDN'iniz	Hayır — Meta'nın önbelleği sayfaya göre anahtarlanır
Sayfa URL'si için scrape uç noktasını çağırır	Meta'nın önizleme önbelleği	Evet

Kurulumdan önce hangisi olduğunu öğrenin. Zaman damgası parametresi, eski bir görsel için gerçek bir çözümdür; eski bir Facebook kartı için ise çözüm değildir.

WooCommerce için FastOG ikincisini yapar ve hiçbir şey yapılandırmanız gerekmez. Eklenti, WooCommerce'in yerel ürün webhook'larını kaydeder; böylece bir ürünü kaydetmek, o ürünün kalıcı bağlantısı (permalink) için Meta yeniden taramasını tetikler — kuyruğa alınır, kısa bir pencere içinde yinelenenler elenir ve tasarım gereği en iyi çaba (best-effort) ilkesiyle çalışır; böylece bir ret, kaydetme işlemini asla başarısız kılmaz. Bu, ürün sayfaları için geçerlidir (product.created / product.updated); kategori ve blog düzenlemeleri kapsam dışındadır.

Görsel tarafı ayrıca ve tüm rakiplerden farklı şekilde ele alınır: bir FastOG kapak URL'si, onu üreten değerleri içerdiğinden, fiyatı veya fotoğrafı düzenlemek yeni bir kapak URL'si üretir. Meta, adresi artık mevcut olmayan bir görseli yeniden sunamaz.

Facebook’ın yeterli olmadığı durumlar

Platform	Zorla yenileme yapabilir misiniz?	Gerçekte ne olur
Facebook	Evet — hata ayıklayıcı veya `scrape=true`	Yeniden tarama ister; yayılma süresi değişir
WhatsApp	Hayır	Önizleme, alıcının uygulamasında önbelleğe alınır; API mevcut değildir
LinkedIn	Belgelenmiş programatik API yok	Kendi takvimine göre yeniden okur; burada herhangi bir kamuya açık zamanlama garantisi verilmez
X / Twitter	Belgelenmiş programatik API yok	Kendi takvimine göre yeniden okur; burada herhangi bir kamuya açık zamanlama garantisi verilmez
Slack, Discord	Hayır	Dakikalar ila saatler içinde kendiliğinden temizlenen kısa ömürlü önbellekler

WhatsApp’ta bir önizleme güncel değilse, çözüm bir Facebook aracı değildir — mağaza tarafını doğru yapmaktır, böylece bir sonraki okuma doğru olur.

Başarılı bir taramadan sonra hâlâ eski görsel görünüyorsa

Bu listeyi sırayla uygulayın:

Sayfa hâlâ eski etiketi mi sunuyor? curl -s https://your-store.com/product/example | grep -i 'og:image' — eski bir og:image içeren önbelleğe alınmış bir HTML sayfası, taramayı tamamen geçersiz kılar. Sayfa önbelleğini temizleyin.
Sayfa birden fazla og:image mi yazdırıyor? İki eklenti birer tane üretiyorsa, tarayıcı okuduğu ilkini alır. Sayılarını sayın.
Görsele erişilebiliyor mu ve engellenmiyor mu? curl -I <image-url>, bir görsel Content-Type ile 200 döndürmelidir. Sosyal tarayıcılar robots.txt kuralına uyar; bu nedenle Disallow: yolundaki bir görsel, bozuk bir dosya gibi algılanacak şekilde başarısız olur — ve curl bunu asla yeniden üretemez, çünkü curl robots.txt değerini yok sayar.
Görsel URL'si gerçekten değişti mi? Değişmediyse, içerik de değişmemiştir — fiyat/fotoğraf düzenlemesinin, kartın çekildiği kaynağa ulaşıp ulaşmadığını kontrol edin.
Hata ayıklayıcıyı tekrar kontrol edin. Artık yeni görseli raporluyorsa ve Facebook hâlâ eski kartı gösteriyorsa, sorun sizin etiketlerinizde değil, Facebook'un kendi yayılım sürecindedir.

SSS

Facebook'in Open Graph önbelleğini temizlemek için resmi bir API var mı?

FastOG, scrape uç noktasını (POST https://graph.facebook.com/{version}/?id={page-url}&scrape=true&access_token={token}) kullanır. Meta, Sharing Debugger ve programatik tarama akışını belgeler; uç noktanın tam biçimi ve Graph API sürümü değişebilir, bu nedenle kendiniz uygulamadan önce bunları Meta'nın güncel belgelerine göre doğrulayın.

Hayır. Herkese açık bir araçtır ve herkese açık her URL için çalışır. Yapamadığı şey, zamanlanmış bir görev olarak çalışmak veya bir kataloğu kapsamaktır.

Yeniden tarama bana bir FastOG render'ına mı mal olur?

Genellikle hayır. Bir kapak URL'si içerikten türetilir; bu nedenle içerik değişmediyse URL de değişmemiştir ve getirme işlemi önbellek isabeti olur, render maliyeti doğurmaz. Fiyat değiştiyse URL de değişmiştir — bu yeni bir render'dır ve istediğiniz render da budur.

Facebook'i yeniden taramak WhatsApp önizlememi düzeltir mi?

Hayır. Bunlar ayrı önbelleklerdir. Facebook'un hata ayıklayıcısını bir doğrulayıcı olarak kullanmak yine de değerlidir — sayfayı WhatsApp'ın yapacağı şekilde getirir ve bulduklarını raporlar — ancak WhatsApp'ı yenileyemez.

Facebook, ben hiç ping atmazsam bir önizlemeyi ne kadar süre saklar?

Meta, yaklaşık 24 saatlik standart bir yeniden tarama süresi belgeler, ancak kesin yayılma süresi değişebilir. Hata ayıklayıcının ve programatik tarama yolunun var olmasının nedeni budur.

Katalog içe aktarmasından sonra her ürünü ping atmam gerekir mi?

Kuyruğun amacı tam olarak budur. Ürün başına satır içi bir istek göndermek Meta'nın hız sınırına takılır ve satıcının isteğini yavaşlatır; kuyruğa alınıp tekilleştirildiğinde, katalog taraması zararsız bir şekilde boşalır.

Meta isteği reddederse ne olur?

Hiçbir şey bozulmaz. Reddedilen veya hız sınırına takılan bir ping, Facebook'un anında değil kendi programına göre yenilenmesi anlamına gelir — sayfadaki etiketler zaten doğrudur; bu yüzden çağrı, zorunlu bir bağımlılık değil, en iyi çaba olarak tasarlanmıştır.