app-ads.txt Nedir ve Nasıl Eklenir? AdMob ve Mobil Reklam Doğrulama Rehberi

Mobil uygulama geliştiricileri için reklam gelirlerini artırmak kadar bu gelirleri teminat altına almak da hayati bir önem taşır. Mobil reklamcılık ekosisteminde app-ads.txt nedir sorusu, uygulamasında AdMob veya diğer reklam ağlarını kullanan her yazılımcının yanıtlaması gereken temel bir teknik sorudur. Dijital reklam dünyasında sıkça karşılaşılan taklit envanter ve alan adı sahtekarlığı (domain spoofing) gibi kural dışı uygulamaların önüne geçmek amacıyla geliştirilen bu standart, mobil uygulamanızın reklam alanlarını yalnızca yetkilendirdiğiniz satıcıların satabilmesini sağlar.

Bu rehberde, app-ads.txt dosyasının ne olduğunu, reklam gelirlerinizi nasıl koruduğunu, Google AdMob başta olmak üzere popüler reklam ağları için bu dosyanın nasıl hazırlanacağını ve adım adım web sitenize nasıl yükleneceğini inceleyeceğiz. 2026 yılı standartlarına uygun, somut kod örnekleri ve senaryolarla uygulamanızı güvene almanın tüm detaylarını bulabilirsiniz.

app-ads.txt Nedir ve Mobil Reklamlarda Neden Hayati Önem Taşır?

app-ads.txt nedir sorusuna en yalın yanıt: Mobil uygulamanızın reklam envanterini satmaya yetkili kılınan şirketleri ve aracı kurumları listeleyen, herkese açık, doğrulanabilir bir metin belgesidir. IAB Tech Lab (Interactive Advertising Bureau) tarafından web siteleri için çıkarılan ads.txt standardının mobil uygulamalara uyarlanmış sürümüdür.

Mobil uygulama mağazalarında (Google Play Store ve Apple App Store) kötü niyetli kişiler, kendi kalitesiz veya sahte uygulamalarının trafiğini sanki sizin yüksek indirme sayısına sahip popüler uygulamanızdan geliyormuş gibi gösterebilir. Reklam verenler, sizin uygulamanızda yayınlandığını düşünerek yüksek bütçeler harcarken, gerçekte reklamlar sahte veya alakasız yerlerde görüntülenir. Bu durum reklam verenlerin güvenini zedeler ve gerçek uygulama sahibinin reklam gelirlerinin düşmesine neden olur.

IAB Tech Lab tarafından geliştirilen app-ads.txt mekanizması, programmatic reklam satın alım araçlarına (DSP - Demand Side Platform) şu sorunun cevabını otomatik olarak verir: "Bu uygulamadaki reklam alanını satan ajans veya ağ, gerçekten bu uygulamanın sahibinden yetki almış mı?"

Eğer uygulamanızda reklam yayınlıyorsanız ve app-ads.txt dosyanız eksik ya da hatalıysa:

• AdMob ve diğer programmatic reklam ağları, envanterinizi "yetkisiz" olarak işaretler.
• Reklam veren bütçeleri uygulamanıza aktarılmaz ve eCPM (bin gösterim başı kazanç) oranlarınız ciddi oranda düşer.
• Belli bir süre sonra reklam gösterimleri tamamen durabilir.

app-ads.txt Nasıl Çalışır? Mobil Reklam Doğrulama Mekanizması

Sistemin çalışma mantığı oldukça şeffaf ve otomatiktir. Taramalar otomatik botlar (crawler) tarafından yürütülür. Doğrulama süreci şu 4 temel adımla gerçekleşir:

• Uygulama Mağazası Bağlantısı: AdMob veya reklam ağı botları, uygulamanızın Google Play Store veya Apple App Store'daki mağaza sayfasına gider.
• Geliştirici Web Sitesi Tespiti: Bot, mağaza detaylarında yer alan Geliştirici Web Sitesi (Developer Website) URL adresini okur.
• Kök Dizin Taraması: Reklam ağının tarayıcısı, bu web sitesinin kök dizinine giderek https://domaininiz.com/app-ads.txt adresini çağırır.
• Yayıncı Kimliği Eşleştirmesi: Dosya içerisindeki Yayıncı Kimliği (Publisher ID) ile uygulamanıza entegre ettiğiniz SDK'daki kimlik eşleşirse envanter onaylanır.

Bu sürecin sorunsuz işlemesi için geliştirici web sitenizin performansı ve erişilebilirliği kritik önem taşır. Yavaş yanıt veren veya sık sık çöken sunucular bot taramasını engelleyebilir. Sitenizin hızını artırmak ve botların dosyaya kesintisiz ulaşmasını sağlamak adına CDN Nedir, Nasıl Çalışır? Cloudflare ile Site Hızlandırma Rehberi içeriğimizden faydalanabilirsiniz.

app-ads.txt Dosya Yapısı ve Satır Formatı (AdMob Örneği)

Bir app-ads.txt belgesi, standart metin formatında (.txt) hazırlanan ve her satırında tek bir yetkilendirme bilgisi barındıran veri dizilerinden oluşur. Bir satır genel olarak 3 zorunlu ve 1 isteğe bağlı parametreden meydana gelir:

<Reklam Ağının Alan Adı>, <Yayıncı Hesabı ID'niz>, <İlişki Türü>, <Sertifika Otoritesi ID'si>

Bu parametrelerin ayrıntılı açıklaması şu şekildedir:

• Reklam Ağının Alan Adı (Zorunlu): Reklam ağının resmi kanonik domain adresidir (örneğin: google.com).
• Yayıncı Hesabı ID'niz (Zorunlu): İlgili reklam platformundaki size özel yayıncı hesabının kimlik numarasıdır (örneğin: pub-1234567890123456).
• İlişki Türü (Zorunlu): Reklam alanının doğrudan mı yoksa aracı kanalıyla mı satıldığını belirtir. DIRECT veya RESELLER değerlerini alır.
• Sertifika Otoritesi ID'si (İsteğe Bağlı): Reklam ağının TAG (Trustworthy Accountability Group) kayıt ID'sidir. Güvenliği doğrulamak için kullanılır.

DIRECT ve RESELLER Farkı Nedir?

• DIRECT: Uygulama sahibi olarak reklam ağı ile doğrudan bir sözleşmeniz olduğunu ve reklam alanını doğrudan sattığınızı gösterir. AdMob hesabınız için bu değer her zaman DIRECT olmalıdır.
• RESELLER: Reklam alanınızın satışı için üçüncü taraf bir aracıya veya reklam temsilcisine yetki verdiğinizi gösterir. Örneğin, bir Ad Mediation (Açık Artırma/Aracılık) platformu kullanıyorsanız, onların ortakları RESELLER olarak eklenir.

Örnek app-ads.txt Dosya İçeriği

Çoklu reklam ağı kullanan gelişmiş bir mobil uygulamanın app-ads.txt dosyası aşağıdaki gibi görünecektir:

# Google AdMob
google.com, pub-1029384756102938, DIRECT, f08c47fec0942fa0

# AppLovin
applovin.com, 9876543210fedcba, DIRECT, 0b12345678abcdef

# Unity Ads (Reseller Örneği)
unity3d.com, 1234567, RESELLER

Adım Adım app-ads.txt Dosyası Oluşturma ve Yayınlama

Sistemi uygulamanız için sıfırdan kurmak son derece basittir. Süreci aksatmadan tamamlamak için aşağıdaki adımları sırasıyla uygulayın:

1. AdMob Yayıncı Kodunuzu Alın

Google AdMob panelinize giriş yapın. Sol menüde yer alan Uygulamalar > Tüm Uygulamalar bölümüne geçin veya direkt olarak app-ads.txt sekmesini tıklayın. Ekranın üst kısmında sizin hesabınıza özel olarak üretilmiş doğrulama kodunu göreceksiniz. Bu kod genellikle şu şekildedir:

google.com, pub-xxxxxxxxxxxxxxxx, DIRECT, f08c47fec0942fa0

2. Metin Belgesini Oluşturun

Bilgisayarınızda Notepad, VS Code veya herhangi bir metin editörü açarak yeni bir dosya oluşturun. AdMob'dan aldığınız kodu (ve varsa diğer reklam ağlarının sağladığı satırları) yapıştırın. Dosyayı kaydederken karakter kodlamasının UTF-8 ve dosya adının tam olarak app-ads.txt olduğundan emin olun.

Önemli Not: Dosya uzantısının .txt.txt veya .txt.html şeklinde kalmadığından emin olun. Windows kullanıcıları "Bilinen dosya türleri için uzantıları gizle" seçeneğini kapatmalıdır.

3. Dosyayı Web Sitenizin Kök Dizinine Yükleyin

Oluşturduğunuz app-ads.txt dosyasını, geliştirici web sitenizin ana dizinine (public_html, wwwroot veya htdocs) yükleyin. Dosyanız şu URL üzerinden doğrudan erişilebilir olmalıdır:

https://siteniz.com/app-ads.txt

Eğer web altyapınızda statik dosyaları yapılandırmakta sorun yaşıyorsanız, dosya organizasyonu ve web manifest ilkeleri için Web App Manifest (manifest.json) Nedir? Yapılandırma ve PWA Entegrasyon Rehberi rehberimizdeki dizin mantığını inceleyebilirsiniz. Ayrıca mobil odaklı web platformlarında benzer durumları yönetmek adına Progressive Web App (PWA) Nedir? Web Siteleri İçin PWA Kurulum Rehberi yazımıza da göz atabilirsiniz.

4. Mağaza Kayıtlarındaki Geliştirici Web Sitesini Güncelleyin

app-ads.txt mekanizmasının çalışabilmesi için reklam ağlarının web sitenizi nereden bulacağını bilmesi gerekir. Bunun için uygulama mağazası panellerinizde doğru sitenin kayıtlı olduğundan emin olun:

#### Google Play Console Yapılandırması:

• Google Play Console hesabınıza girin.
• Uygulamanızı seçin ve sol menüden Mağaza varlığı > Ana mağaza girişi (veya Store presence > Main store listing) sekmesine gelin.
• İletişim bilgileri altında yer alan Web sitesi alanına geliştirici sitenizin tam adresini girin (Örn: https://siteniz.com).
• Değişiklikleri kaydedin ve incelemeye gönderin.

#### Apple App Store Connect Yapılandırması:

• App Store Connect hesabınıza oturum açın.
• Uygulamanızı seçin ve Uygulama Bilgileri (App Information) bölümüne gidin.
• Pazarlama URL'si (Marketing URL) veya Destek URL'si (Support URL) alanına web sitenizin adresini girin.
• Yapılan güncellemeleri kaydedin.

En Sık Yapılan app-ads.txt Hataları ve Çözüm Yolları

Uygulama geliştiricilerinin büyük çoğunluğu app-ads.txt dosyasını oluşturmalarına rağmen doğrulama aşamasında hatalarla karşılaşmaktadır. En sık yapılan hatalar şunlardır:

• Yanlış Alt Alan Adı (Subdomain) Kullanımı: Dosyanın https://subdomain.siteniz.com/app-ads.txt adresine konulması hatadır. Taramalar sadece ana kök etki alanından (siteniz.com) başlatılır.
• HTTP - HTTPS Yönlendirme Hataları: Web sitenizdeki SSL yönlendirmelerinde döngü (redirect loop) olması crawler botlarının içeriği okumasını engeller. HTTP talepleri sorunsuz bir şekilde HTTPS sürümüne 301 yönlendirmesi ile iletilmelidir.
• Hatalı İçerik Türü (Content-Type): Sunucunuz app-ads.txt dosyasını servis ederken HTTP yanıt başlığında text/plain dönmelidir. text/html veya application/json olarak dönen başlıklar geçersiz sayılır.
• Yayıncı Kimliği Yazım Yanlışları: AdMob kimliğindeki pub- ön ekini unutmak veya karakterleri eksik yazmak doğrulamanın başarısız olmasına neden olur.

curl -iL https://siteniz.com/app-ads.txt

Bu komut çıktısında HTTP/2 200 yanıtını ve content-type: text/plain ifadesini görmelisiniz.

app-ads.txt Test Etme ve Doğrulama Araçları

Dosyanızı yükledikten sonra tarayıcıların dosyanızı bulup bulamadığını ve içeriğin geçerliliğini test etmek için aşağıdaki araçları kullanabilirsiniz:

Sonuç

Mobil uygulamanızın reklam gelirlerini güvence altına almak, taklit envanterlerin önüne geçmek ve reklam verenlerin güvenini kazanmak için app-ads.txt entegrasyonunu tamamlamak zorunlu bir teknik gereksinimdir. Kurulumu birkaç adımda tamamlanabilen bu küçük metin dosyası, uzun vadede reklam kazançlarınızın düşmesini engeller ve AdMob başta olmak üzere tüm reklam ağlarında sorunsuz bir gelir akışı sağlar.

Sonraki Adım: Vakit kaybetmeden AdMob panelinize giriş yapın, size özel yayıncı kodunu alın ve web sitenizin kök dizinine app-ads.txt dosyanızı ekleyerek Google Play ve App Store mağaza URL'lerinizi güncelleyin.