Otopilot Pixel Kurulumu
Hazırlayan Ersin DorlakSon güncelleme:
Bu Sayfa Ne Yapar
Otopilot Pixel, sitenin head bölümüne eklenen tek satırlık bir betiktir ve onaylanmış SEO düzeltmelerini sayfa açılırken ziyaretçinin tarayıcısında uygular. PHP, ASP.NET, kapalı e-ticaret altyapıları ya da eklenti kurulamayan özel yazılımlar gibi sunucu tarafına erişilemeyen sitelerde düzeltme yapmanın en hızlı yoludur; kod sunucuya dokunmadan, şablona ya da Google Tag Manager'a eklenir.
Kurulum ekranı SEO Onarım ekranında Kanal & Kurulum görünümündeki Otopilot Pixel kartından açılır. Üstte durum satırı (Pixel sinyali bekleniyor ya da Pixel canlı), altında Kurulum yöntemi için Özel Script ve Google Tag Manager sekmeleri, üç numaralı adım (Adım 1: Kodu Kopyalayın, Adım 2: Sitenize Ekleyin (<head> içine), Adım 3: Bağlantıyı Doğrulayın) ve en altta kanalın sınırlarını açıklayan bilgi kutusu yer alır. Başka bir kanal da sinyal gönderiyorsa en üstte çakışma uyarısı çıkar.
Betik yüklendiğinde projenin onaylı kurallarını alır, sayfadaki hedef öğeleri bulup değiştirir ve panele sinyal gönderir. Sinyal ziyaretçilerin tarayıcısından geldiği için az trafikli sitelerde saatlerce gelmeyebilir; son sinyalden 24 saat geçmeden kanal ulaşılamıyor sayılmaz. Kod yalnız projenin alan adındaki sayfalarda çalışır. Önbellek ve optimizasyon eklentilerinin betiği birleştirip geciktirmemesi için kod data-no-optimize, data-cfasync, nowprocket ve nitro-exclude özniteliklerini taşır.
Pixel'in temel sınırı, kaynak HTML'in değişmemesidir. Google sayfayı JavaScript işledikten sonra düzeltmeleri görür; JavaScript çalıştırmayan botlar (çoğu yapay zekâ botu) görmez ve doğrulama taraması bu düzeltmeleri sunucudan teyit edemez. robots.txt, site haritası, yönlendirme, güvenlik başlıkları, sayfa adresi ve yeni sayfa oluşturma Pixel ile yapılmaz; blog yazısı da yayınlanmaz. Bu işler için WordPress eklentisi, Otopilot API ya da site Cloudflare arkasındaysa Cloudflare Worker gibi sunucu tarafı bir kanal gerekir.
Kılavuz, eklenti ya da mağaza bağlantısı kuramayan site sahipleri ve hızlı bir başlangıç isteyen ajanslar içindir. Yayınladığınız düzeltmelerin durumu Tarayıcıda uygulandı olarak görünür; bunun "doğrulanmadı" anlamına geldiğini, sayfa kaynağını görüntüle ekranında değişikliği göremeyeceğinizi baştan bilmek beklenti yönetimini kolaylaştırır.
Anlatılan sayfayı panelde aç(giriş yapınca açılır)
Ön Koşullar
- Sitenin tüm sayfalarında yüklenen ortak head şablonuna kod ekleyebilmeniz ya da Google Tag Manager kapsayıcısını yayınlama yetkiniz olmalıdır.
- Projede tamamlanmış bir SEO taraması ve paketinizde otomatik düzeltme hakkı bulunmalıdır.
- Sitede içerik güvenlik politikası (CSP) tanımlıysa Otopilot betiğinin yüklenmesine ve panele istek göndermesine izin verilmelidir.
- Kurulumu ve kanal seçimini proje sahibi yapar.
Adım Adım Kullanım
- SEO Onarım ekranında Kanal & Kurulum görünümüne geçin, Site ve geliştirici grubundaki Otopilot Pixel kartında Bağla düğmesine basın. Otomatik düzeltme açıksa "Niyet kaydedildi: Pixel. Kurulum tamamlanınca aktif kanal olur." bildirimi çıkar; kapalıysa önce kurulum penceresinde modu seçip Kaydet ve başlat deyin.
- Kurulum yöntemi seçin. Özel Script head bölümüne kod ekleyebiliyorsanız seçilmelidir; düzeltmeler sayfa açılırken en erken aşamada uygulanır. Google Tag Manager head erişiminiz yoksa kullanılır; kod sayfa yüklendikten sonra çalıştığı için düzeltmeler biraz geç görünebilir.
- Adım 1: Kodu Kopyalayın bölümündeki kodu Kopyala düğmesiyle alın. "Kod kopyalandı." bildirimi gelmezse "Kopyalanamadı — kodu elle seç ve kopyala." uyarısı çıkar; kutudaki metni elle seçin.
- Özel Script yönteminde kodu tüm sayfalarda yüklenen head bölümünün en başına, mümkünse diğer betiklerden önce yapıştırın ve async ya da defer eklemeyin. Yalnız ana sayfa şablonuna eklemek düzeltmeleri diğer sayfalarda çalıştırmaz.
- Google Tag Manager yönteminde yeni bir Özel HTML etiketi oluşturun, kodu yapıştırın, tetikleyiciyi tüm sayfalar olarak seçin ve kapsayıcıyı yayınlayın. Yayınlanmamış kapsayıcı ziyaretçilerde çalışmaz.
- Sitede önbellek ya da optimizasyon eklentisi varsa betiği birleştirme ve geciktirme ayarlarının dışında bırakın, ardından site önbelleğini temizleyin; aksi hâlde ziyaretçiler kodsuz eski sayfayı görmeye devam eder.
- Sitenin herhangi bir sayfasını tarayıcıda bir kez ziyaret edin, sonra Adım 3: Bağlantıyı Doğrulayın bölümünde Bağlantıyı Test Et düğmesine basın. Test ana sayfayı okuyup kodu arar ve tarayıcı sinyalini kontrol eder; genellikle yaklaşık 1 dakika içinde "Pixel canlı — son 24 saat içinde sitenden sinyal geldi." mesajı çıkar.
- Durum satırı Pixel canlı olduğunda kanal aktifleşir. Yeni Düzeltme sekmesinden bir sayfa için düzeltme üretip Düzeltmeler sekmesinde Canlıya Al ile yayınlayın; ziyaret sonrasında kartın durumu Tarayıcıda uygulandı olur.
- Düzeltmeyi kontrol etmek için sayfayı gizli pencerede açın ve tarayıcının geliştirici araçlarındaki öğeler panelinde başlığı ya da meta açıklamayı inceleyin. Sayfa kaynağını görüntüle ekranı ham HTML'i gösterdiği için değişikliği göstermez; bu beklenen davranıştır.
Pixel kanalının sınırları
- Düzeltmeler ziyaretçinin tarayıcısında uygulanır; kaynak HTML değişmez ve ham HTML'de görünmez.
- Doğrulama taraması Pixel düzeltmelerini teyit edemez; kartta "Tarayıcıda uygulanır, sunucu doğrulaması yok" yazar.
- robots.txt, site haritası, yönlendirme, güvenlik başlıkları, sayfa adresi ve yeni sayfa oluşturma bu kanalda desteklenmez; blog yazısı yayınlanmaz.
- Otomatik düzeltmeyi kapatırken Evet, Sil ve Kapat onayı Pixel ile uygulanan tüm düzeltmeleri temizler; kod sonradan yüklendiğinde hiçbir şey uygulanmaz.
- Sunucu tarafı bir kanal bağladığınızda yalnız Pixel ile canlı olan düzeltmeler o kanala otomatik devredilir.
Ekrandaki öğeler
- Pixel sinyali bekleniyor / Pixel canlı — Son 24 saatte tarayıcıdan sinyal gelip gelmediğini gösteren durum satırı.
- Kurulum yöntemi — Özel Script ve Google Tag Manager sekmeleri; seçime göre kod ve yönerge değişir.
- Adım 1: Kodu Kopyalayın — Projenin anahtarını içeren kod kutusu ve Kopyala düğmesi.
- Adım 2: Sitenize Ekleyin (<head> içine) — Seçilen yönteme göre yapıştırma yönergesi.
- Adım 3: Bağlantıyı Doğrulayın — Bağlantıyı Test Et düğmesi ve test sonucu satırı.
- Bilgi kutusu — Tarayıcıda uygulama, doğrulanamama, sinyal gecikmesi ve önbellek hariç tutma notları.
- Çakışma uyarısı — Pixel ile WordPress eklentisi aynı anda sinyal gönderdiğinde en üstte görünür.
- Tarayıcıda uygulandı — Düzeltmeler sekmesinde Pixel ile uygulanan düzeltmelerin durum etiketi.
Sonuçları nasıl yorumlarsınız
- Test sonucu dört ayrı durum söyler: kod bulunamadı, kod başka projenin, kod var ama sinyal yok, Pixel canlı. Yalnız sonuncusu kanalı aktif eder.
- Tarayıcıda uygulandı düzeltmenin en az bir ziyaretçinin tarayıcısında çalıştığını gösterir; sunucu doğrulaması olmadığı için Doğrulandı durumuna geçmez.
- Kanal & Kurulum özetindeki Google'ın gördüğü düzeltmeler oranı yalnız Pixel kullanan sitelerde düşük kalır; bu oran Pixel düzeltmelerinin ilk HTML'e girmediğini hatırlatır.
- Tarama raporunda düzeltilmiş görünen bir bulgu hâlâ listeleniyorsa ve düzeltme Pixel ile yapıldıysa bu çelişki değildir: tarayıcımız ham HTML'i okur ve Pixel değişikliğini görmez.
Örnek senaryo
örnek.com, ajansın kendi yazdığı PHP altyapısında çalışan bir hukuk bürosu sitesi; sunucuya eklenti kurulamıyor ama ortak header.php dosyasına erişim var. Ajans Otopilot Pixel kartında Bağla diyor, Özel Script yöntemini seçip kodu kopyalıyor ve header.php içinde head etiketinin hemen altına, diğer betiklerden önce yapıştırıyor.
Siteyi bir kez ziyaret ettikten sonra Bağlantıyı Test Et "Pixel canlı" yanıtını veriyor. 35 hizmet sayfasındaki eksik meta açıklamalar üretilip Canlıya Al ile yayınlanıyor; kartlar ziyaretlerle birlikte Tarayıcıda uygulandı durumuna geçiyor. Ajans tarayıcının öğeler panelinde yeni açıklamaları görüyor. Kurulum yönergesindeki uyarıyı dikkate alarak robots.txt ve yönlendirme düzeltmeleri için ileride Otopilot API'ye geçmeyi planlıyor; o kanal bağlandığında Pixel ile canlı olan düzeltmeler sunucu tarafına devredilecek.
İpuçları
- Kodu mümkün olduğunca head bölümünün en başına koyun; başlık ve açıklama değişiklikleri sayfa çizilmeden önce uygulanır.
- Site Cloudflare arkasındaysa Cloudflare Worker kanalını düşünün; düzeltmeler Google'ın gördüğü HTML'e sunucu tarafında yazılır ve Pixel'in tarayıcıya bağlı sınırı ortadan kalkar.
- WordPress sitelerinde Pixel yerine WordPress eklentisini tercih edin; robots.txt, site haritası ve blog yayını da dahil daha geniş kapsam sunar.
- Tag Manager kullanıyorsanız etiketin tetikleyicisini tüm sayfalar yapın ve önizleme modunda etiketin tetiklendiğini kontrol ettikten sonra yayınlayın.
- Pixel'i kaldırmak istediğinizde önce otomatik düzeltmeyi kapatın, sonra kodu siteden silin; böylece yarım kalmış kurallar bırakmazsınız.
Sık yapılan hatalar
- Kodu async ya da defer ile eklemek; düzeltmeler gecikir ve sayfa ilk hâliyle görünür.
- Değişikliği sayfa kaynağını görüntüle ekranında aramak ve kurulumun çalışmadığını sanmak.
- Optimizasyon eklentisinin betiği birleştirmesine izin vermek; kod geç yüklenir ya da hiç çalışmaz.
- Aynı sitede eski bir projenin Pixel kodunu bırakmak; test "bu projenin anahtarı değil" der.
Sık Karşılaşılan Sorunlar
- Kod sitenin ana sayfasında bulunamadı. Kodu tüm sayfalarda </head> öncesine eklediğinden emin ol.: Kod eklenmemiş, yalnız iç sayfalara eklenmiş ya da önbellek eski sayfayı sunuyordur. Ortak head şablonuna ekleyip önbelleği temizleyin ve testi yineleyin.
- Sitende bir Pixel kodu var ama bu projenin anahtarı değil. Kodu bu sayfadaki kodla değiştir.: Sayfada başka bir projeye ait eski bir kod kalmıştır. Eski kodu silip bu ekrandaki kodu yapıştırın; iki kodu aynı anda bırakmayın.
- Kod bulundu ama tarayıcı sinyali henüz gelmedi — siteyi bir kez ziyaret et.: Kod sayfada ama henüz hiçbir tarayıcı çalıştırmamıştır. Siteyi kendiniz ziyaret edip testi tekrarlayın; Tag Manager kullanıyorsanız kapsayıcının yayınlandığını kontrol edin.
- Ana sayfa okunamadı. Siteye erişilebildiğinden emin ol ve tekrar dene.: Test ana sayfanıza ulaşamamıştır; site kapalı olabilir ya da bir güvenlik duvarı panel isteklerini engelliyordur. Cloudflare kullanıyorsanız Cloudflare WAF Geçişi kılavuzundaki izin kuralını ekleyin.
- Tarayıcıda uygulanamadı: sayfada hedef eleman bulunamadı veya kural bu sayfada çalışmadı.: Kural hedef öğeyi bu sayfada bulamamıştır; şablon değiştiyse ya da öğe JavaScript ile geç oluşuyorsa olur. Yeni tarama başlatıp düzeltmeyi yeniden üretin.
- Bu projede aktif kanal Pixel ama WordPress Connector eklentisi de sinyal gönderiyor.: Çift uygulamayı önlemek için yalnız Pixel kuralları uygulanır. WordPress sitelerinde eklentiyi aktif kanal yapmak daha güçlü sonuç verir; aksi hâlde eklentiyi siteden kaldırın.
- Bu adres projenin alan adına ait değil; düzeltme gönderilmedi.: Kod, projenin alan adı dışındaki bir sitede ya da alt alan adında çalıştırılmıştır. Kodu yalnız projenin alan adındaki sayfalara ekleyin; başka bir site için ayrı proje açın.
İlgili Kılavuzlar
Bu adımları kendi sitenizde uygulayın
Önce ücretsiz site analiziyle sitenizdeki sorunları görün. Hesabınız varsa rehberde anlatılan sayfayı panelde açın.