Reklam Yönetimi

Reklam yönetimi modülü, sitede gösterilecek banner ve reklam kodlarını tek yerden yönetir. Her kayda bir etiket adı verilir; şablonda bu etiket çağrıldığında motor, konum, üye grubu, kategori, cihaz, tarih ve ülke kurallarına göre uygun reklamı seçip basar.

Konu	Ayrıntı
Yönetim modülü	`engine/inc/banners.php`
Panel adresi	`admin.php?mod=banners`
Liste adresi	`admin.php?mod=banners&action=list`
Rubrik filtresi	`admin.php?mod=banners&rubric=N`
Yetki anahtarı	`admin_banners`
Veritabanı tabloları	`PREFIX_banners`, `PREFIX_banners_logs`, `PREFIX_banners_rubrics`

İşlem (action) değerleri

action	Görevi
`list`	Reklam listesini gösterir
`add`	Yeni reklam formunu açar
`doadd`	Yeni reklamı kaydeder
`edit`	Var olan reklamın düzenleme formunu açar
`doedit`	Düzenlenen reklamı kaydeder
`delete`	Reklamı siler
`on` / `off`	Reklamı aktive / pasif eder
`view`	Reklam istatistiklerini gösterir
`clearviews`	Görüntülenme sayacını sıfırlar
`clearclicks`	Tıklama sayacını sıfırlar
`addrubric`	Yeni reklam kategorisi (rubrik) ekler
`editrubric`	Rubriği düzenler
`deleterubric`	Rubriği siler

Tablolar ve görevleri

Tablo	İçeriği
`PREFIX_banners`	Reklam kayıtları ve ayarları
`PREFIX_banners_logs`	İstatistikler; görüntülenme ve tıklama kayıtları
`PREFIX_banners_rubrics`	Reklam kategorileri (rubrikler)

Reklam alanları: `PREFIX_banners`

Alan	Görevi
`banner_tag`	Şablonda kullanılacak ad; `{banner_ETIKET}` karşılığı
`descr`	Panelde görünen açıklama
`code`	Reklam kodu (HTML/JS) — ön yüzde doğrudan basılır
`approve`	Aktif / pasif durumu (`on` / `off`)
`short_place`	Kısa haber listesinde gösterim
`main`	Ana sayfada gösterim
`innews`	Haber içinde gösterim
`fpage`	Tam makale sayfasında gösterim
`comments_place`	Yorumlarda gösterim
`bstick`	"Yapışkan" (sabit) gösterim
`category`	Gösterileceği içerik kategorileri
`rubric`	Ait olduğu reklam kategorisi (rubrik)
`grouplevel`	Reklamı görecek üye grupları
`start` / `end`	Yayın tarih aralığı
`devicelevel`	Cihaz hedeflemesi (masaüstü / tablet / telefon)
`allow_views` / `max_views`	Görüntülenme sınırı ve davranışı
`allow_counts` / `max_counts`	Tıklama sınırı ve davranışı
`allowed_country`	Yalnızca bu ülkelerde göster
`not_allowed_country`	Bu ülkelerde gösterme

Gösterim konumları

Bir reklamın hangi sayfa bağlamında çıkacağı birkaç bayrakla belirlenir. Aynı reklam birden çok konumda görünecek şekilde işaretlenebilir.

Bayrak	Gösterim yeri
`main`	Ana sayfa
`short_place`	Kısa haber listesi
`fpage`	Tam makale sayfası
`innews`	Haber içi
`comments_place`	Yorumlar
`bstick`	Sabit / yapışkan gösterim

Hedefleme kuralları

Kural	Açıklama
`grouplevel`	Reklam yalnızca seçilen üye gruplarına gösterilir
`category`	Yalnızca seçilen içerik kategorilerinde çıkar
`rubric`	Reklamın ait olduğu reklam kategorisi
`devicelevel`	Masaüstü, tablet ve telefon için ayrı hedefleme
`start` / `end`	Yalnızca tarih aralığı içinde yayınlanır
`allowed_country` / `not_allowed_country`	Ülke bazlı gösterim kısıtı

Ön yüzde hangi reklamın çıkacağına motor karar verir; bu karar yukarıdaki tüm kuralların birlikte değerlendirilmesiyle verilir.

Görüntülenme ve tıklama sınırları

Ayar	Anlamı
`allow_views`	Görüntülenme sınırı etkin mi
`max_views`	Sınır değeri; `0` = sınırsız, `1` / `2` = sınıra ulaşınca davranış
`allow_counts`	Tıklama sınırı etkin mi
`max_counts`	Sınır değeri; `0` = sınırsız, `1` / `2` = sınıra ulaşınca davranış

!

Sınır dolduğunda reklam kaybolur max_views veya max_counts sınırına ulaşıldığında reklam ön yüzde artık gösterilmez. Bu bir arıza değildir; sınırı yükseltmeniz veya 0 (sınırsız) yapmanız gerekir.

Şablonda kullanım

Reklamlar main.tpl veya haber şablonlarına etiketle yerleştirilir. banner_tag değeriniz header ise etiket {banner_header} olur. Koşullu blok biçiminde kullanıldığında, gösterilecek reklam yoksa bloğun tamamı silinir.

Kullanım	Davranış
`{banner_ETIKET}`	Etikete uyan reklamın kodunu basar
`[banner_ETIKET]…[/banner_ETIKET]`	Reklam varsa bloğu korur, yoksa içeriğiyle siler

<aside class="banner-slot">
    [banner_header]
        <div class="banner-header">{banner_header}</div>
    [/banner_header]
</aside>

i

Reklam kodundaki süslü parantezler code alanı ön yüzde doğrudan basılır. Ancak reklam kodu blok veya içerik içine gömülürken { / } karakterleri şablon motorunda sorun çıkarabilir; bu tür kodlarda dikkatli olun.

Reklam kategorileri (rubrikler)

Rubrikler, reklamları gruplamak için kullanılır ve PREFIX_banners_rubrics tablosunda tutulur. Listeden ?mod=banners&rubric=N ile yalnızca bir rubriğin reklamları görüntülenebilir.

İşlem	Görevi
`addrubric`	Yeni rubrik tanımlar
`editrubric`	Rubriğin adını/ayarını düzenler
`deleterubric`	Rubriği siler

İstatistikler

İşlem	Etkisi
`view`	Reklamın istatistiklerini gösterir
`clearviews`	Görüntülenme sayacını sıfırlar
`clearclicks`	Tıklama sayacını sıfırlar

Reklam oluşturma akışı

Yetkiyi doğrulayın Grubunuzda admin_banners izni açık olmalıdır.
Yeni reklam formunu açın admin.php?mod=banners&action=add adresini kullanın.
Etiket ve kodu girin banner_tag benzersiz olmalı; reklam kodunu code alanına yazın.
Konum ve hedeflemeyi ayarlayın Konum bayraklarını, grouplevel, kategori, cihaz ve ülke seçimlerini yapın.
Tarih ve sınırları belirleyin start / end ile max_views / max_counts değerlerini girin.
Aktifleştirip sınayın on durumuna alın ve etiketi şablonda doğrulayın.

Sık yapılan hatalar

Hata	Sonuç
`banner_tag` değerini şablonda yanlış yazmak	Reklam hiç görünmez
Aynı etiketi iki reklama vermek	Hangi reklamın basılacağı belirsizleşir
`max_views` / `max_counts` sınırını unutmak	Sınır dolunca reklam kaybolur
Tarih aralığı dışında kalmak	Reklam ön yüzde görünmez
`grouplevel` ayarını eksik bırakmak	Beklenen grup reklamı görmez
Reklam kodunda `{` / `}` kullanmak	Şablon motorunda beklenmedik sonuçlar doğabilir

Kontrol listesi

Grubumda admin_banners izni açık.
Her reklamın banner_tag değeri benzersiz ve şablondaki etiketle birebir aynı.
Gösterim konumlarını doğru bayraklarla işaretledim.
grouplevel, kategori, cihaz ve ülke hedeflemesini kontrol ettim.
start / end tarih aralığını geçerli tuttum.
Reklamı on durumuna aldım ve ön yüzde test ettim.