Satu kesalahan format pada file ads.txt Anda dapat memicu penekanan bid oleh DSP dan menghapus persentase signifikan dari pendapatan iklan programatik Anda - secara senyap, tanpa pesan error apa pun di situs Anda. ads.txt adalah file teks biasa dengan aturan parsing yang ketat, dan kebanyakan penerbit baru menyadari masalah melalui penurunan CPM yang tak terjelaskan di dashboard iklan mereka. Panduan ini mencakup semua metode pemeriksaan file ads.txt, kesalahan yang paling berpengaruh, dan cara menjaga file tetap sehat dalam jangka panjang.
Apa itu ads.txt?
ads.txt adalah singkatan dari Authorized Digital Sellers. Ini adalah file teks biasa yang dihosting di root domain Anda - `domainanda.com/ads.txt` - yang mencantumkan setiap ad exchange, jaringan, dan platform sisi suplai (SSP) yang diizinkan menjual inventaris iklan di situs web Anda. IAB Tech Lab memperkenalkan standar ini pada 2017 khusus untuk memerangi domain spoofing: bentuk penipuan iklan di mana pihak jahat menjual inventaris dengan mengaku berasal dari domain penerbit premium yang bukan milik mereka.
Ketika platform sisi permintaan (DSP) atau pengiklan menempatkan bid programatik, sistem mereka memeriksa file ads.txt penerbit sebelum membelanjakan uang. Jika entitas penjual yang tercantum dalam permintaan bid tidak muncul di file ads.txt, pembeli melewatkan bid sepenuhnya atau memberlakukan diskon signifikan. File yang hilang, entri yang salah konfigurasi, atau catatan yang usang langsung berujung pada fill rate yang lebih rendah dan CPM efektif yang menurun.
Format baris ads.txt
Setiap baris dalam file ads.txt yang valid mengikuti format empat field yang presisi. Memahami strukturnya penting untuk menemukan kesalahan - sebagian besar masalah validasi berasal dari baris yang menyimpang dari pola persis ini.
# Format: domain, publisher-account-id, account-type, authority-id
# account-type must be DIRECT or RESELLER
# authority-id (TAG-ID) is optional but strongly recommended
google.com, pub-0000000000000000, DIRECT, f08c47fec0942fa0
appnexus.com, 1234, RESELLER, f5ab79cb980f11d1
openx.com, 540191398, RESELLER, 6a698e965929
# Lines starting with # are comments - ignored by parsers
# [email protected]
# SUBDOMAIN=sub.domainanda.com- domain: Domain root dari sistem periklanan (mis. `google.com`, bukan `ads.google.com`).
- publisher-account-id: ID akun atau penerbit Anda di jaringan iklan tersebut.
- account-type: `DIRECT` (Anda punya kontrak langsung) atau `RESELLER` (dijual melalui perantara).
- authority-id: TAG-ID atau Seller Account ID yang bersifat opsional tetapi dianjurkan dari Trustworthy Accountability Group. Mengabaikannya menurunkan kepercayaan pembeli.
Note
Mengapa error ads.txt merugikan pendapatan
Penegakan ads.txt dalam ekosistem programatik tidak seragam - DSP yang berbeda menangani file tidak valid dengan cara berbeda, sehingga dampaknya pada pendapatan sulit diprediksi dan mudah terlewat sampai CPM turun mencolok. Memahami bagaimana pembeli merespons kesalahan menjelaskan mengapa memeriksa ads.txt secara rutin itu berharga.
Bagaimana DSP merespons masalah ads.txt
- File hilang (404): Sebagian besar DSP besar menganggap ads.txt yang hilang sebagai "inventaris tak terverifikasi". Beberapa melewatkan bid sepenuhnya; yang lain menawar pada harga lantai yang didiskon berat.
- Format baris tidak valid: Baris dengan jumlah field salah atau nilai tipe akun tidak valid dilewati secara diam-diam - entri diperlakukan seolah tidak ada.
- Ketidakcocokan DIRECT vs RESELLER: Jika sebuah jaringan menjual sebagai DIRECT tetapi file Anda mencantumkannya sebagai RESELLER (atau sebaliknya), pembeli menandai ketidakcocokan dan mengurangi kepercayaan pada inventaris.
- authority-id hilang: Program TAG Certified Channels mewajibkan authority-id. Pembeli yang menegakkan sertifikasi TAG melewatkan entri tanpa authority-id.
- Redirect ke beranda: Redirect 301 atau 302 dari /ads.txt ke beranda diperlakukan sebagai file yang hilang oleh sebagian besar crawler.
Pembeli periklanan digital dapat menggunakan ads.txt untuk menentukan apakah peluang pembelian media digital telah diizinkan oleh penerbit dan apakah reseller diizinkan menjual inventaris penerbit.
Google AdSense dan peringatan ads.txt
Google AdSense sangat ketat dalam menegakkan ads.txt. Jika ID penerbit AdSense Anda tidak tercantum dengan benar di file ads.txt Anda, AdSense menampilkan peringatan di dashboard dan dapat mengurangi penayangan pada slot iklan yang telah disetujui. Entri AdSense yang wajib mengikuti format persis ini: `google.com, pub-XXXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0`. Authority-id `f08c47fec0942fa0` adalah TAG-ID tetap milik Google - harus muncul persis seperti tertulis.
Warning
Cara memeriksa file ads.txt Anda
Memeriksa ads.txt memerlukan dua verifikasi terpisah: aksesibilitas (apakah file dapat dijangkau di URL yang benar?) dan validitas (apakah setiap baris terformat dengan benar?). Kedua pemeriksaan cepat dan dapat diselesaikan dalam waktu kurang dari dua menit dengan alat yang tepat.
Pastikan file dapat diakses di domain root
Buka browser dalam mode incognito dan kunjungi `domainanda.com/ads.txt`. File harus dimuat sebagai teks biasa tanpa pembungkus HTML, tanpa permintaan login, dan tanpa redirect. Jika Anda melihat 404 atau file mengalihkan ke beranda Anda, ads.txt tidak dapat diakses oleh crawler platform iklan, terlepas dari apakah file ada di server Anda. Periksa konfigurasi server web Anda - banyak situs WordPress secara tidak sengaja mengalihkan semua path yang tidak terdefinisi ke beranda melalui aturan `.htaccess`.
Tempelkan file ke Ads.txt Validator Aback Tools
Salin seluruh isi file ads.txt Anda - dari browser atau langsung dari server Anda - dan tempelkan ke Ads.txt Validator. Alat ini mem-parsing setiap baris terhadap spesifikasi IAB, menandai jumlah field yang salah, nilai tipe akun tidak valid, dan entri duplikat, serta melaporkan setiap error dengan nomor barisnya. Data Anda diproses sepenuhnya di browser - tidak ada yang diunggah ke server.
Silangkan dengan daftar mitra jaringan iklan Anda
Bandingkan entri yang telah divalidasi dengan baris ads.txt terkini yang disediakan oleh setiap jaringan iklan yang Anda gunakan. Sebagian besar jaringan memublikasikan entri ads.txt yang diminta dalam dokumentasi penerbit atau dashboard mereka. Jaringan kadang memperbarui entri yang diminta - perubahan domain atau authority-id baru - dan penerbit melewatkan pembaruan itu. Ketidakcocokan antara yang tercantum di file Anda dan yang diharuskan jaringan saat ini menimbulkan penekanan bid yang sama seperti entri yang hilang.
Perbaiki kesalahan dan verifikasi ulang aksesibilitas
Perbaiki setiap kesalahan yang dilaporkan, unggah kembali file ke direktori root server Anda, dan kunjungi lagi `domainanda.com/ads.txt` untuk memastikan file yang diperbarui sudah tayang. Beri waktu 24-48 jam bagi platform iklan besar untuk melakukan crawl ulang file sebelum mengharapkan pemulihan pendapatan. Gunakan validator untuk kedua kalinya pada file yang tayang guna memastikan tidak ada kesalahan unggahan yang menimbulkan masalah baru.
Ads.txt Validator
Validasi file ads.txt untuk kesalahan format, tipe akun tidak valid, entri duplikat, dan field wajib yang hilang - lokal di browser, tanpa unggahan.
Kesalahan umum dan cara memperbaikinya
Sebagian besar masalah ads.txt masuk dalam sejumlah kecil pola yang berulang. Masing-masing punya penyebab spesifik dan perbaikan spesifik - begitu Anda tahu apa yang harus dicari, semuanya bisa diselesaikan dalam beberapa menit.
Jumlah field salah
Kesalahan paling umum adalah baris dengan jumlah field yang dipisah koma tidak tepat. Setiap baris harus memiliki tepat tiga field wajib (domain, account-id, account-type) dan satu field opsional (authority-id). Baris dua field (hanya domain dan account-id) maupun baris lima field (field ekstra akibat kesalahan copas) sama-sama gagal validasi. Periksa setiap baris yang ditandai validator Anda - sering kali masalahnya adalah koma nyasar atau koma yang hilang akibat penyuntingan manual.
Nilai tipe akun tidak valid
Field account-type hanya menerima dua nilai: `DIRECT` dan `RESELLER`. Parser yang tidak sensitif huruf besar-kecil menerima `direct` dan `reseller`, tetapi spesifikasi IAB merekomendasikan huruf besar. Nilai lain - `DIRECT/RESELLER`, `Partner`, `Network`, atau kosong - gagal validasi dan barisnya dilewati sepenuhnya oleh parser yang patuh. Tinjau setiap baris yang ditandai dan koreksi nilainya tepat menjadi `DIRECT` atau `RESELLER` sesuai hubungan kontraktual Anda dengan jaringan tersebut.
File dilayani dari path yang salah atau dengan Content-Type yang salah
File ads.txt harus dapat diakses tepat di `domainanda.com/ads.txt` - bukan `/ads.txt.php`, bukan `/ads-txt`, bukan di path subdirektori. Server seharusnya mengembalikan status `200 OK` dengan `Content-Type` `text/plain`. Beberapa platform hosting menyajikan file `.txt` dengan `application/octet-stream`, yang ditolak sebagian crawler. Gunakan Robots Validator bersamaan dengan pemeriksaan ads.txt Anda - jika robots.txt punya masalah aksesibilitas serupa, kemungkinan Anda memiliki masalah konfigurasi server yang memengaruhi semua file `.txt` di root.
| Kesalahan | Yang dilaporkan validator | Perbaikan |
|---|---|---|
| Jumlah field salah | Baris memiliki 2 field, diharapkan 3-4 | Tambahkan domain, account-id, atau tipe yang hilang |
| Tipe akun tidak valid | "partner" bukan DIRECT atau RESELLER | Ubah menjadi DIRECT atau RESELLER |
| Entri duplikat | Duplikat dari baris 12 | Hapus baris duplikat |
| Redirect / 404 | File tidak dapat diakses di /ads.txt | Perbaiki routing server atau .htaccess |
| Karakter Unicode tersembunyi | Karakter tak terduga di posisi 8 | Ketik ulang barisnya - jangan salin dari PDF |
| Entri subdomain salah | Gunakan direktif SUBDOMAIN= sebagai gantinya | Tambahkan komentar SUBDOMAIN=sub.domain.com |
| TAG authority-id hilang | Authority-id dianjurkan | Tambahkan TAG-ID dari dokumentasi jaringan |
Karakter tersembunyi dan masalah pengodean
Masalah ads.txt yang khusus sulit adalah baris yang tampak benar secara visual tetapi gagal diparsing karena mengandung karakter Unicode tersembunyi - spasi tanpa putus, spasi lebar nol, atau tanda kutip pintar - yang masuk saat menyalin-tempel dari PDF, dokumen Word, atau surel rich-text. Kebanyakan editor teks tidak menampilkan karakter-karakter ini. Jika sebuah baris gagal validasi tanpa kesalahan format yang jelas, ketik ulang secara manual alih-alih menyalin-tempel. Alat Perbaikan Unicode dan Encoding dapat menghapus karakter Unicode tak terlihat dari teks tempelan sebelum Anda memasukkannya ke file ads.txt.
app-ads.txt dan sellers.json
ads.txt dirancang untuk penerbit web. Ekosistem iklan programatik memperluas standar ke dua spesifikasi terkait: app-ads.txt untuk inventaris aplikasi mobile, dan sellers.json untuk transparansi rantai pasokan. Memahami ketiga format membantu Anda membangun gambaran otorisasi yang lengkap.
app-ads.txt untuk penerbit aplikasi mobile
Pengembang aplikasi mobile menggunakan app-ads.txt alih-alih ads.txt. Format filenya identik - struktur baris empat field yang sama, tipe akun DIRECT/RESELLER yang sama, field authority-id yang sama. Perbedaannya ada pada penemuan: untuk aplikasi, platform iklan mencari URL situs web pengembang dari listingan App Store atau Google Play dan memeriksa app-ads.txt di root domain tersebut. Anda menghosting app-ads.txt di situs web pengembang Anda, bukan di dalam aplikasi. Gunakan App-ads.txt Validator untuk memeriksa otorisasi inventaris aplikasi mobile dengan aturan validasi yang sama.
sellers.json - pelengkap rantai pasokan
sellers.json adalah pelengkap ads.txt dari arah sebaliknya: jaringan iklan dan SSP memublikasikan file sellers.json di domain mereka sendiri yang mencantumkan semua penerbit (penjual) yang mereka wakili. Pembeli dapat menyilangkan entri RESELLER ads.txt Anda dengan sellers.json milik SSP untuk memverifikasi rantai pasokan yang sah. Meskipun Anda tidak membuat sellers.json sebagai penerbit, memahaminya menjelaskan mengapa authority-id yang benar di ads.txt Anda penting - digunakan untuk mencocokkan entri Anda dengan catatan sellers.json.
Note
Memantau kesehatan ads.txt
Pemeriksaan ads.txt sekali saja tidak cukup - entri jaringan berubah, mitra baru di-onboard, dan aksesibilitas file bisa rusak setelah pembaruan server atau CMS. Membangun rutinitas pemantauan yang ringan mencegah kerugian pendapatan senyap di antara audit manual.
Peringatan dashboard Google AdSense
Dashboard AdSense menampilkan spanduk peringatan ads.txt jika ID penerbit Anda hilang dari file ads.txt Anda atau file tidak dapat diakses. Periksa dashboard AdSense setelah setiap migrasi server, pembaruan CMS, atau perubahan `.htaccess` - tiga peristiwa paling umum yang merusak aksesibilitas ads.txt tanpa disadari penerbit. Peringatan muncul di bagian "Akun" pada pengaturan AdSense.
Notifikasi mitra programatik
Sebagian besar SSP dan jaringan iklan besar mengirim notifikasi email ketika entri ads.txt yang mereka minta berubah. Berlanggananlah notifikasi pembaruan dari portal penerbit setiap mitra jika tersedia. Ketika mitra memperbarui domain atau authority-id mereka, biasanya diberi jendela migrasi 30-90 hari sebelum entri lama berhenti dihormati - tetapi hanya penerbit yang aktif memantau yang akan menangkap perubahan tepat waktu.
Alur audit teknis
Sertakan validasi ads.txt dalam audit SEO teknis kuartalan Anda bersama robots.txt, validasi sitemap, dan pemeriksaan tag kanonik. Gunakan Penjelas Konflik Aturan Robots.txt untuk memastikan tidak ada aturan robots.txt yang secara tidak sengaja memblokir crawler platform iklan, dan Sitemap Validator untuk memeriksa kesehatan sitemap dalam sesi yang sama. File-file ini berada di level root server yang sama dan sering terdampak peristiwa salah konfigurasi yang sama.
Tip
Praktik terbaik ads.txt
Mengikuti praktik-praktik ini menjaga file ads.txt Anda akurat, dapat diakses, dan efektif - memaksimalkan kelayakan bid sambil melindungi inventaris Anda dari reseller tak resmi.
Jaga file tetap ramping dan mutakhir
Hapus entri untuk jaringan iklan yang sudah tidak bekerja sama dengan Anda. ads.txt yang membengkak dengan lusinan entri tidak aktif tidak langsung merugikan pendapatan, tetapi memperluas area rawan kesalahan dan menyulitkan audit file. Saat berhenti bekerja sama dengan sebuah jaringan, hapus entrinya pada saat yang sama ketika Anda melepas tag iklan mereka dari halaman Anda - perlakukan keduanya sebagai bagian dari proses offboarding yang sama.
Selalu gunakan authority-id bila tersedia
TAG authority-id (juga disebut TAG-ID atau Seller Account ID) secara teknis opsional dalam spesifikasi ads.txt, tetapi DSP besar lebih menyukai entri yang mencantumkannya. Ini memungkinkan pembeli memverifikasi seluruh rantai pasokan dari penerbit hingga exchange melalui penyilangan sellers.json. Setiap jaringan iklan besar memublikasikan authority-id mereka dalam dokumentasi penerbit - sertakan di setiap entri tempat authority-id tersedia.
- Satu entri per baris: Jangan pernah menggabungkan beberapa jaringan dalam satu baris - setiap relasi penjual resmi mendapatkan barisnya sendiri.
- Validasi sebelum setiap unggahan: Jalankan Ads.txt Validator pada file sebelum mengunggah untuk menangkap kesalahan yang Anda timbulkan saat menyunting.
- Gunakan pengodean UTF-8 tanpa BOM: Simpan file sebagai UTF-8 murni. BOM (Byte Order Mark) di awal file dapat merusak parsing pada sebagian crawler platform iklan.
- Jangan gunakan spasi di akhir baris: Banyak editor teks menambahkan spasi akhir yang tak terlihat. Ini dapat menyebabkan kegagalan parsing per baris pada validator yang ketat.
- Kelola versi ads.txt Anda: Simpan ads.txt di repositori kontrol versi situs Anda. Riwayat git memungkinkan Anda menelusuri persis kapan sebuah entri ditambahkan atau dihapus jika pendapatan tiba-tiba menurun.
App-ads.txt Validator
Validasi file app-ads.txt untuk inventaris iklan aplikasi mobile - aturan format sama dengan ads.txt, dioptimalkan untuk konteks penerbit aplikasi mobile.
Key takeaways
- ads.txt mencantumkan semua penjual resmi dari inventaris iklan Anda - entri yang hilang atau tidak valid membuat DSP melewatkan bid atau mendiskon CPM Anda.
- Verifikasi aksesibilitas lebih dulu: kunjungi `domainanda.com/ads.txt` dan pastikan file dimuat sebagai teks biasa dengan status 200, tanpa redirect dan tanpa pembungkus HTML.
- Gunakan Ads.txt Validator untuk memeriksa setiap baris atas kesalahan format, tipe akun tidak valid, dan duplikat - semua pemrosesan terjadi di browser Anda.
- Lima kesalahan paling umum adalah jumlah field yang salah, nilai tipe akun tidak valid, file dilayani di path yang salah, karakter Unicode tersembunyi, dan authority-id yang hilang.
- Google AdSense mengharuskan entri persis `google.com, pub-XXXXXXXXXXXXXXXXX, DIRECT, f08c47fec0942fa0` - authority-id `f08c47fec0942fa0` bersifat tetap dan harus cocok sepenuhnya.
- Untuk aplikasi mobile, gunakan app-ads.txt dengan format yang sama, dihosting di root situs web pengembang Anda, ditemukan melalui listingan app store Anda.
- Validasi ulang ads.txt setelah setiap migrasi server, pembaruan CMS, atau pergantian hosting - inilah peristiwa paling umum yang merusak aksesibilitas file secara senyap.