OG Görselleri Nasıl Önbelleğe Alınır
OG görsellerini önbelleğe almak, daha önce oluşturulmuş bir sosyal önizlemeyi her paylaşımda yeniden oluşturmak yerine bir CDN'den sunmak anlamına gelir. FastOG, aynı görselleri uçta (edge) bir yıl boyunca önbelleğe alır — aynı URL, kotanızdan düşmeden ve neredeyse sıfır gecikmeyle önbelleğe alınmış PNG'yi döndürür; böylece bir sitenin OG trafiğinin çoğu oluşturucuya (renderer) hiç dokunmaz.
Önbelleğe alma neden önemlidir
Bir sosyal paylaşım, platformun tarayıcısının (crawler) bir getirme (fetch) işlemi yapmasını tetikler. Her paylaşım yeniden işlenirse, aynı içerik için kota ve gecikme süresi harcarsınız. Görselin içeriğine göre anahtarlanan agresif önbelleğe alma, "her paylaşım 1 işleme sayar" durumunu "ilk paylaşım 1 işleme sayar, diğer tüm paylaşımlar ücretsizdir" durumuna dönüştürür.
İçerik anahtarlı modelin çalışma prensibi
FastOG, içerik imzalı URL'ler kullanır: URL, parametrelerin saf bir fonksiyonudur. Aynı başlık + aynı şablon → aynı URL. Bu şu anlama gelir:
- FastOG'un uç noktası görseli URL altında tutar.
- Aynı içerik 10.000 kez paylaşılırsa → tek bir render, tek bir kota sayımı, 9.999 önbellek isabeti.
- İçeriği değiştir → farklı URL → tek yeni render.
GET /api/v1/og?title=Hello&template=default&key=...&s=... → render (1 quota count), then
GET /api/v1/og?title=Hello&template=default&key=...&s=... → cached (0 counts, instant)
GET /api/v1/og?title=Changed&template=default&key=...&s=... → render (1 quota count)
FastOG'un önbellek başlıkları
FastOG, oluşturulan görseller için Cache-Control: public, max-age=31536000, immutable (bir yıl) döndürür. Bir kapak görseli, FastOG'un uç ağından iki katman halinde sunulur: fastog.com önündeki işleme önbelleği ve arkasındaki kalıcı nesne deposu. Tekrarlanan istekler yeniden işleme yapılmadan yanıtlanır ve yanıttaki X-FastOG-Worker-Cache, hangi katmanın yanıt verdiğini belirtir (HIT, R2, MISS).
Kalıcı kopya işleyiciye bağlı olmadığından, en az bir kez getirilmiş kapak görselleri, FastOG'un işleme hizmeti kısa süreliğine kullanılamadığında bile sunulmaya devam eder — bir kesinti, daha önce oluşturulmuş bir önizlemeyi boş bırakmaz. Daha önce hiç işlenmemiş bir kapak görseli, işleyiciye ihtiyaç duyan tek durumdur ve bu durumda FastOG, hata yerine bir görselle yanıt verir:
| Durum | Tarayıcının aldığı şey |
|---|---|
| Kapak görseli zaten işlenmiş | kapak görseli, uç ağdan veya kalıcı depodan |
| Hiç işlenmemiş, işleme hizmeti çalışıyor | kapak görseli, istek üzerine işlenir |
| Hiç işlenmemiş, işleme hizmeti kısa süreliğine kapalı | URL'de taşınan sayfanın kendi görseli (ürün fotoğrafınız) veya nötr bir kart — asla bir hata sayfası değil |
İsteğin kendisi geçersizse (değiştirilmiş bir imza, eksik bir title), yine de ilgili 4xx yanıtını alırsınız.
Yayınladığınız bir görseli değiştirme
| Değiştirdiğiniz şey | Yapmanız gereken |
|---|---|
| İçerik (başlık, fiyat, fotoğraf) | hiçbir şey: içerik URL'de yer alır, bu nedenle yeni içerik yeni bir URL'dir ve taze olarak işlenir |
| Şablon veya bir işleme varsayılanı | önbellek kırma sürümünü (FASTOG_CACHE_BUST) artırın, böylece her URL yeni bir v parametresi kazanır |
| Aynı URL'nin yeniden işlenmesi gerekiyor | destek ekibinden o URL'yi temizlemesini isteyin — tam URL temizleme işlemi herkese açık bir uç nokta olarak sunulmaz |
Daha önce paylaşılan bağlantılar çalışmaya devam eder ve vaat ettikleri görseli göstermeye devam eder; ancak o tam URL'yi temizlemediğiniz sürece bu böyledir.
Kendi og:image dosyanızı önbelleğe alma (self-hosted)
Görselleri FastOG'un önbelleği yerine kendiniz saklıyorsanız, aynı kuralları uygulayın:
| Adım | Ayrıntı |
|---|---|
| Önbellek anahtarı = içerik karması | Veriyi değişken bir dosya adı yerine bir karma (hash) ile saklayın |
| Uzun TTL | Kararlı içerik için max-age=31536000, immutable |
| Sürümlü URL'ler | İçerik değiştiğinde bir karma/sürüm ekleyin |
| Önde CDN | Tekrarlanan istekleri CDN'in karşılamasını sağlayın |
SSS
Tekrarlanan paylaşımlar gerçekten 0 render mı tüketir?
Evet. Aynı URL'ler uç önbelleğe (edge cache) takılır ve renderlayıcıya asla ulaşmaz; bu nedenle kota kullanımı tükenmez.
FastOG bir görseli ne kadar süre önbelleğe alır?
Bir yıl (immutable). İlk renderdan çok sonra bile, paylaşılan bir kart önbellekten sunulur.
Görselin güncellenmesini istersem (ör. canlı fiyat) ne olur?
Bir parametreyi (fiyatı) değiştirin → yeni URL → yeni render. Sabit içerik önbellekte kalır; dinamik içerik istediğinizde güncellenir.