app-ads.txt Nedir ve Nasıl Oluşturulur? Mobil ve Web Yayıncıları İçin Entegrasyon Rehberi

Mobil uygulama pazarında veya web ekosisteminde reklam geliri elde eden bir yayıncıysanız, dijital reklam dünyasının güvenliği ve şeffaflığı doğrudan gelirinize yansır. Reklam sahtekarlığı (ad fraud) ve alan adı taklidi (domain spoofing) gibi yanıltıcı yöntemler, reklamverenlerin bütçelerini boşa harcamasına ve yayıncıların hak ettiği eCPM oranlarını kaybetmesine neden olur. İşte bu noktada IAB Tech Lab tarafından geliştirilen Authorized Digital Sellers standardının mobil ve OTT uygulamalarına uyarlanmış hali devreye girer. Bu yazıda, app-ads.txt nedir, neden kritiktir ve uygulamanız için adım adım nasıl yapılandırılır sorularını tüm teknik detaylarıyla inceliyoruz.

app-ads.txt Nedir ve Neden Mobil Yayıncılar İçin Hayati Önem Taşır?

app-ads.txt nedir sorusuna en kısa yanıt; bir mobil uygulamanın reklam envanterini satmaya yetkili olan dijital reklam ağlarını ve aracıları kamuya açık bir şekilde listeleyen metin dosyasıdır. Web sitelerinde kullanılan ads.txt standardının mobil (iOS, Android), Akıllı TV ve OTT (Over-the-Top) platformlarına genişletilmiş halidir. IAB Tech Lab (Interactive Advertising Bureau) tarafından geliştirilen bu protokol, reklamverenlerin satın aldıkları reklam alanının gerçekten iddia edilen uygulamaya ait olduğunu doğrulamalarını sağlar.

Mobil reklam borsalarında (DSP - Demand Side Platform) işlem yapan büyük reklamverenler, 2026 standartlarında yetkisiz envanter satışından korunmak adına app-ads.txt doğrulaması bulunmayan uygulamaları doğrudan engellemekte veya bu uygulamalara çok daha düşük teklifler vermektedir. Dosyanın eksikliği ya da hatalı yapılandırılması, Google AdMob, AppLovin, Unity Ads veya IronSource gibi ağlardan elde ettiğiniz gelirlerin aniden düşmesine hatta tamamen kesilmesine yol açabilir.

Web ads.txt ile app-ads.txt Arasındaki Temel Farklar

Web ve mobil ekosistemlerin çalışma mimarisi farklı olduğundan, doğrulama mekanizmaları da birbirinden ayrılır:

• Erişim Yolu: Web ads.txt dosyasında crawler (örümcek) doğrudan example.com/ads.txt adresini ziyaret eder. Mobil app-ads.txt sürecinde ise crawler önce uygulamanın App Store veya Google Play Store sayfasındaki Geliştirici Web Sitesi (Developer Website) URL'sini okur, ardından o sitenin kök dizinindeki app-ads.txt dosyasını tarar.
• Doğrulama Zinciri: Uygulamalarda paket adı (Bundle ID veya Package Name) doğrudan uygulama mağazası kimliğiyle eşleştirilir. Bu nedenle mağaza panellerindeki web sitesi alanının doğruluğu hayati önem taşır.

app-ads.txt Dosyası Nasıl Çalışır? (Teknik Mimarı)

Reklam alım-satım platformları (DSP ve SSP'ler) envanter satın almadan önce otomatik sistemlerle bir doğrulama algoritması çalıştırır. Süreç şu adımlarla gerçekleşir:

• Uygulama Mağazası Taraması: Otomatik botlar (örneğin Google'ın AdMob Crawler'ı), mağazadaki uygulama sayfanızı tarayarak listelenen geliştirici web sitesini (Developer Website) bulur.
• Kök Dizin Sorgusu: Bot, tespit ettiği domain adresinin kök dizinine HTTP/HTTPS isteği gönderir: https://domaininiz.com/app-ads.txt.
• Veri Ayrıştırma ve Doğrulama: Dosya içerisindeki satırlar ayrıştırılır. Uygulama içerisinden gönderilen reklam isteğindeki Yayıncı Kimliği (Publisher ID) ile app-ads.txt içindeki kimlik eşleşirse işlem onaylanır ve yüksek değerli reklamlar sunulur.

Adım Adım app-ads.txt Oluşturma ve Yapılandırma Rehberi

Uygulamanız için eksiksiz bir doğrulama dosyası hazırlamak için aşağıdaki adımları sırasıyla uygulayabilirsiniz.

1. Sözdizimi (Syntax) Kurallarını Anlamak

Bir app-ads.txt dosyası düz metin (plain text) biçiminde olmalı ve her satırda virgülle ayrılmış 3 zorunlu, 1 isteğe bağlı alan içermelidir:

Sistem_Domaini, Yayıncı_Kimliği, İlişki_Türü, Sertifika_Yetkilisi_ID

• 1. Alan (Reklam Sistemi Domaini): Reklam ağının resmi domain adı (örn: google.com, applovin.com).
• 2. Alan (Yayıncı Hesap ID): Reklam ağındaki size özel yayıncı numarası (örn: pub-1234567890123456).
• 3. Alan (İlişki Türü): Hesabın mülkiyet durumunu gösterir. DIRECT (Doğrudan hesap sahibiyseniz) veya RESELLER (Reklam alanınız üçüncü tarafça yönetiliyorsa).
• 4. Alan (Sertifika ID - İsteğe Bağlı): Reklam ağının Trustworthy Accountability Group (TAG) ID değeridir.

Örnek geçerli kod yapısı:

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

# AppLovin
applovin.com, 1a2b3c4d5e6f, DIRECT

# Unity Ads
unity3d.com, 9876543, DIRECT

# IronSource
iskynd.com, 112233445, RESELLER, 1b046a74ab2e4b30

2. Reklam Ağlarından Satırları Toplama

Kullandığınız reklam mediasyon veya reklam ağı panellerine giriş yapın. Genellikle "Network Settings", "app-ads.txt Snippet" veya "Account Information" bölümlerinde size özel hazırlanmış satırlar bulunur. Bütün reklam ortaklarınızın verdiği satırları kopyalayın.

3. Dosyayı Oluşturma ve Sunucuya Yükleme

Bilgisayarınızda app-ads.txt adında bir metin dosyası oluşturun ve kopyaladığınız tüm satırları yapıştırın. Dosya kodlamasının UTF-8 (BOM'suz) olduğundan emin olun.

Hazırladığınız dosyayı web sitenizin ana dizinine (root directory, genellikle public_html, wwwroot veya statik hosting kök klasörü) yükleyin. Mobil uygulamanızın veri tabanı mimarisini kurarken Supabase vs Firebase: Modern Web me Mobil Uygulamalar İçin BaaS Seçim Rehberi içeriğimizdeki çözümlerden faydalansanız dahi, dosyanın statik olarak https://domaininiz.com/app-ads.txt adresi üzerinden doğrudan erişilebilir olması şarttır.

4. Mağaza Panellerinde Geliştirici Web Sitesini Güncelleme

Google Play Console ve Apple App Store Connect üzerinde kayıtlı web sitenizin doğru yapılandırıldığından emin olun.

• Google Play Console: Uygulamanızı seçin > Mağaza varlığı > Mağaza ayarları bölümüne gidin. "İletişim bilgileri" altındaki Web sitesi alanına domain adresinizi (https://domaininiz.com) ekleyin.
• App Store Connect: Uygulama bilgileri ekranında Destek URL'si (Support URL) veya Marketing URL alanlarına domain adresinizi tanımlayın.

Önemli Not: Mağaza kayıtlarına alt sayfalar (örn: domaininiz.com/uygulamam) değil, doğrudan kök domain (domaininiz.com) girilmelidir. Robotlar taramayı her zaman kök domain adresi üzerinden yürütür.

Eğer uygulamanız progressive bir mimariye sahipse veya web bileşenleri barındırıyorsa Web App Manifest (manifest.json) Nedir? Yapılandırma ve PWA Entegrasyon Rehberi rehberimizdeki yönlendirme standartlarına göz atarak mağaza ve domain bağlantılarını kusursuzlaştırabilirsiniz.

app-ads.txt Doğrulama ve Test Yöntemleri

Dosyanızı sunucuya yükleyip mağaza alanlarını güncelledikten sonra entegrasyonun doğruluğunu kontrol etmeniz gerekir.

cURL İle Sunucu Yanıtı Kontrolü

Terminal veya Komut İstemi (CMD) üzerinden dosyanızın doğru HTTP header yanıtı verip vermediğini test edin:

curl -I https://domaininiz.com/app-ads.txt

Dönen yanıtta şunlara dikkat edin:

• HTTP Durum Kodu: HTTP/1.1 200 OK olmalıdır.
• Content-Type: text/plain olmalıdır. HTML veya JSON formatında yanıt dönmemelidir.

CDN ve Önbellek (Cache) Ayarları

Web siteniz Cloudflare veya benzeri bir içerik dağıtım ağı arkasındaysa, güvenlik kurallarının botları engellemediğinden emin olmalısınız. CDN yapılandırmasında bot engelleyicilerin Google AdMob ve IAB tarayıcılarını engellemesini önlemek için uygun kuralları tanımlamalısınız. Detaylı CDN ve önbellek yönetimi için CDN Nedir, Nasıl Çalışır? Cloudflare ile Site Hızlandırma Rehberi başlıklı yazımızı inceleyebilirsiniz.

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

Entegrasyon sürecinde sıklıkla karşılaşılan teknik hatalar ve çözüm yöntemleri şunlardır:

• 1. Subdomain veya Alt Klasör Kullanımı: Dosyanın app.domaininiz.com/app-ads.txt veya domaininiz.com/apps/app-ads.txt konumuna konulması. Crawler'lar bu adresleri okumaz. Dosya mutlaka domaininiz.com/app-ads.txt adresinde bulunmalıdır.
• 2. Yanlış Yönlendirmeler (HTTP 301/302): app-ads.txt adresine gelen isteklerin bir ana sayfaya veya başka bir URL'ye yönlendirilmesi. Yönlendirme zincirleri crawler tarafından takip edilemeyebilir ve doğrulama başarısız olur.
• 3. Karakter Kodlaması Hataları (BOM): Dosya kaydedilirken UTF-8 BOM veya UTF-16 kullanılması durumunda görünmeyen karakterler sözdizimini bozar. Dosyayı standart UTF-8 without BOM olarak kaydedin.
• 4. Büyük/Küçük Harf Hassasiyeti: Dosya adının App-Ads.txt veya APP-ADS.TXT şeklinde yazılması. Unix tabanlı sunucularda bu durum 404 hatasına yol açar. Dosya adı tamamen küçük harflerle app-ads.txt olmalıdır.
• 5. Yanlış Yayıncı ID'si: AdMob veya diğer reklam ağlarındaki ID'lerin başında yer alan pub- ifadesinin veya tire işaretlerinin eksik yazılması.

Sonuç ve Sonraki Adımlar

Mobil uygulama yayıncılığında şeffaflık ve güvenlik, reklam gelirlerinin sürdürülebilirliği için vazgeçilmezdir. app-ads.txt entegrasyonu, uygulamanızı reklam sahtekarlığına karşı korurken premium reklamverenlerin envanterinize güvenle teklif vermesini sağlar.

Sonraki Adım: Reklam ağlarınızın panellerine girerek güncel app-ads.txt kodlarınızı toplayın, dosyanızı oluşturup web sunucunuza yükleyin ve Google Play Console ile App Store Connect üzerindeki web sitesi URL'lerinizi kontrol edin.