AdBlockDetection

Perkenalan

Javascript untuk mendeteksi keberadaan perilaku yang terkait dengan pemblokiran iklan selama penayangan suatu halaman.

Operasi

JavaScript (adblockDetector.js) telah diuji untuk mendeteksi perilaku yang terkait dengan pemblokiran iklan di browser web berikut:

• Google Chrome
• Mozilla Firefox
• Internet Explorer (8+)
• Safari

Skrip melakukan ini dengan membuat sekumpulan DIV yang kemungkinan besar disembunyikan oleh alat pemblokiran iklan berbasis browser.

Taktik tambahan yang belum disertakan dalam skrip ini:

• Umpan URL. Izinkan deteksi pemblokiran iklan berbasis jaringan.
• Modifikasi umpan dinamis. Perbarui atribut DIV dan URL berdasarkan daftar pemblokiran yang ada (Easylist dan sebagainya) agar deteksi lebih kuat.

Instalasi

Unduh skrip deteksi yang diinginkan dan tambahkan ke situs web Anda. Ada beberapa cara berbeda untuk memasukkan JavaScript ke dalam HTML.

Nama Skrip	Keterangan
adblockDetector.js	Skrip deteksi pemblokir iklan tanpa modul Google Analytics
adblockDetectorWithGA.js	Skrip deteksi pemblokir iklan dengan modul Google Analytics

Dengan AdBlockDetectionWithGA.js Anda diminta untuk menyebutkan id pelacakan GA Anda ke dalam skrip di baris no 82. Saat Anda mereferensikan skrip ini, skrip ini melacak peristiwa tertentu terkait AdBlock di browser pengguna. Anda dapat melihat detailnya di dasbor Google Analytics. Berikut cara memeriksa apakah pengguna menggunakan adblock atau tidak.

Menyiapkan Google Analytics

Pertama, kami menyarankan Anda membuat id Pelacakan GA yang berbeda agar tidak mengganggu tayangan laman Anda. Ikuti langkah-langkah di bawah ini untuk GA tentang Penggunaan Adblock.

• Masuk ke akun Google Analytics Anda -> Buka situs Anda -> Buka tab “Pelaporan” -> klik “Penjelajah Pengguna” di bawah Audiens.
• Klik “Tambahkan segmen baru” -> “Segmen Baru” -> Beri nama Segmen (misal: 'Adblock Terdeteksi') -> Klik “kondisi” di bagian Lanjutan.
• Klik Sesi dan pilih Pengguna (Anda juga dapat membuat sesi lain.)
• Klik pada Drop Down pertama -> Klik “Behavior” -> Pilih “Event Label”.
• Klik Pada kotak Teks: Ketik label acara seperti di bawah ini.
• Label Acara- “div tersembunyi” – ini akan memberi Anda semua pengguna dengan blok Iklan diaktifkan/ditemukan. Sekarang satu segmen Anda dengan Pengguna yang menggunakan blok iklan sudah siap.
• Ulangi semua langkah di atas dengan label peristiwa di bawah ini untuk pengguna yang tidak menggunakan blok iklan.
• Label Acara- “div terlihat” –ini akan memberi Anda semua pengguna dengan blok iklan dinonaktifkan/tidak ditemukan.

Sayangnya kami belum menemukan cara untuk memasangnya ke dashboard. Jadi lain kali saat Anda membuka GA, Anda dapat membuka User Explorer -> klik Tambahkan segmen baru. Dan Anda akan menemukan segmen yang Anda buat sebelumnya (yaitu satu untuk pengguna adblock Terdeteksi dan satu lagi untuk pengguna blok iklan Tidak Terdeteksi.). Anda dapat memilihnya dan mengklik terapkan untuk melihat data yang dilaporkan.

Ini akan terlihat seperti gambar di bawah ini.

sebaris

Ini adalah metode penyertaan yang direkomendasikan. Fungsi yang terdapat dalam skrip deteksi yang dipilih harus dimasukkan langsung ke dalam HTML bingkai induk.

Lakukan ini dengan membungkus konten kode yang dipilih dalam tag skrip dalam HTML yang dikirimkan.

File Skrip Eksternal

Dimungkinkan untuk menghosting kode yang dipilih di server web Anda sebagai file independen, dan mereferensikan file ini dari HTML yang dikirimkan.

Jika Anda menggunakan file skrip eksternal, file tersebut dapat diblokir oleh pemblokir iklan. Menggunakan nama yang berbeda untuk file akan mengurangi kemungkinan file tersebut diblokir oleh filter umum.

Metode Lainnya

Dimungkinkan untuk mengintegrasikan fungsi dari kode yang dipilih ke dalam perpustakaan skrip yang ada, yang dihosting sebagai file skrip eksternal. Melakukan hal ini dapat mengakibatkan berkurangnya fungsionalitas situs bagi pengunjung yang menggunakan pemblokir iklan yang mencoba menghindari deteksi, jika pemblokir iklan memblokir seluruh file skrip eksternal.

Konfigurasi

@prop bendera

Pilihan	Jenis	Keterangan
men-debug	Boolean	Menunjukkan keluaran debug tambahan harus dicetak ke konsol
ditemukan	String (@fungsi)	Berfungsi untuk diaktifkan jika adblock terdeteksi
tidak ditemukan	String (@fungsi)	Berfungsi untuk diaktifkan jika adblock tidak terdeteksi. Perhatikan bahwa ini akan diaktifkan setiap kali adblock tidak terdeteksi, dan akan memberikan masukan untuk tindakan yang diambil hanya setelah "selesai" terdeteksi.
menyelesaikan	String (@fungsi)	Fungsi untuk diaktifkan setelah pengujian selesai.

Hasil pengujian (boolean) dimasukkan sebagai parameter ke contoh callback:

 window . adblockDetector . init (
        {
          found : function ( ) { ... } ,
          notFound : function ( ) { ... }
        }
      ) ;

Penggunaan

Tambahkan kode di bawah ini di halaman HTML.

 < script src = "./adblockDetector.js" > < / script >
	< script >
	// Configure the adblock detector
	( function ( ) {
		var enabledEl = document . getElementById ( 'adb-enabled' ) ;
		var disabledEl = document . getElementById ( 'adb-not-enabled' ) ;
		function adBlockDetected ( ) {
			enabledEl . style . display = 'block' ;
			disabledEl . style . display = 'none' ;
		}
		function adBlockNotDetected ( ) {
			disabledEl . style . display = 'block' ;
			enabledEl . style . display = 'none' ;
		}
		
		if ( typeof window . adblockDetector === 'undefined' ) {
			adBlockDetected ( ) ;
		} else {
			window . adblockDetector . init (
				{
					debug : true ,
					found : function ( ) {
						adBlockDetected ( ) ;
					} ,
					notFound : function ( ) {
						adBlockNotDetected ( ) ;
					}
				}
			) ;
		}
	} ( ) ) ;
	< / script >

Tambahkan kode di bawah ini di badan halaman HTML

 < div class =" center " >
< h5 class =" bg-success " id =" adb-not-enabled " style =" display: none; " > AdBlock is disabled </ h5 >
< h5 class =" bg-danger " id =" adb-enabled " style =" display: none; " > AdBlock is enabled </ h5 >
</ div >

Berkontribusi

Garpu! Buat cabang fitur Anda: git checkout -b my-new-feature Lakukan perubahan Anda: git commit -am 'Tambahkan beberapa fitur' Dorong ke cabang: git push origin my-new-feature Kirimkan permintaan penarikan

Pertanyaan Umum

• Skrip tidak akan berfungsi secara lokal. Halaman tersebut harus dilayani dari server melalui http
• Saat ini “umpan” atau “polong madu” yang digunakan dalam Javascript di-hardcode @ #218. Jika Anda ingin memperbarui file dengan umpan baru, perbarui baris #218
• Gunakan file contoh test.html yang ditemukan di repositori. Host file di server HTTP misalnya. server Apache dan minta file di browser melalui http dengan adblocker aktif/nonaktif.