Memuat kode materi iklan dengan permintaan tanpa tag

Permintaan tanpa tag dapat digunakan sebagai pengganti tag iklan untuk meminta kode materi iklan mentah yang diproses di Google Ad Manager. Permintaan tanpa tag umumnya digunakan saat tampilan dan penguraian kustom diperlukan, seperti decoder atau lingkungan lainnya tanpa dukungan SDK atau pemberian tag Google.

Saat Anda membuat permintaan tanpa tag, Ad Manager hanya akan menampilkan kode materi iklan mentah, persis seperti yang diproses, tanpa menjalankan dan menampilkan iklan. Jika iklan tidak ditemukan, status 200/OK akan ditampilkan dengan respons kosong.

Aplikasi, pemutar, atau situs Anda harus menjalankan kode tersebut untuk menampilkan iklan, dan mengaktifkan pelacakan tayangan.

Membuat permintaan tanpa tag secara manual

Untuk membuat permintaan tanpa tag, mulailah dengan URL dasar, sertakan semua parameter yang diperlukan, dan parameter opsional tambahan apa pun. Parameter ini menentukan berbagai hal seperti unit iklan, ukuran materi iklan, nilai kunci, dan informasi lainnya tentang permintaan.

Permintaan tanpa tag harus dibuat dengan aman menggunakan SSL (https://).

Memulai dengan URL dasar

Gunakan URL dasar ini:  https://securepubads.g.doubleclick.net/gampad/adx?

Menetapkan parameter panggilan iklan

Untuk mengetahui detail tentang parameter wajib dan opsional, tinjau tabel berikut. Untuk mengetahui detail tambahan tentang parameter GDPR, buka Integrasi penayang dengan TCF IAB Eropa.

Parameter wajib

Parameter	Deskripsi
iu	Kode unit iklan Google Ad Manager, termasuk kode jaringan Google Ad Manager Anda. Untuk menyertakan beberapa tingkat, gunakan karakter garis miring (/) sebagai pemisah. Contoh iu=/123/homepage iu=/456/sports/baseball Saat menggunakan Pengelolaan Banyak Pelanggan (MCM) dengan permintaan tanpa tag, gunakan struktur parent,child untuk kode jaringan. Contoh (MCM) iu=/123,456/homepage
sz	Ukuran materi iklan. Untuk menyertakan beberapa ukuran, gunakan karakter pipa (|) sebagai pemisah di antara ukuran. Contoh sz=320x50 untuk ukuran tunggal sz=320x50|300x50 untuk beberapa ukuran Sebaiknya Anda mengenkode karakter pipa (|) dalam permintaan tanpa tag dengan %7c. Contoh &sz=216x36|300x50|320x50 menjadi &sz=216x36%7c300x50%7c320x50.
url	URL domain yang menghosting panggilan iklan awal. Hanya diperlukan untuk permintaan MCM. Contoh url=www.example.com
c	Nilai korelator (atau, cache-busting). Angka acak ini (huruf tidak diizinkan) harus dihasilkan oleh penayang untuk memastikan panggilan baru ke server iklan terjadi setiap kali pemuatan halaman, agar terhindar dari perbedaan penghitungan tayangan. Contoh c=8362527364
tile	Posisi tag pada halaman. Nilai tersebut sebaiknya berupa bilangan bulat yang unik. Agar lebih mudah penerapannya, sebaiknya nilai menghitung ke atas. Tindakan ini hanya diperlukan jika beberapa tag iklan menggunakan kode unit iklan (iu=) dan nilai korelator (c=) yang sama pada halaman yang sama. Contoh https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=1 https://securepubads.g.doubleclick.net/gampad/adx?iu=/1234/homepage&sz=320x50&c=54631&tile=2 Semua permintaan dengan nilai kartu yang bertambah (til=) harus dipicu dalam waktu 30 detik untuk memastikan materi iklan yang sama tidak dipilih lagi untuk korelator yang sama (c=).

Parameter opsional

Parameter	Deskripsi
d_imp	Pengalih tayangan tertunda. Jika disertakan, penghitungan tayangan berdasarkan permintaan akan dinonaktifkan dan makro tayangan yang dilihat pada materi iklan yang ditampilkan atau informasi dari parameter d_imp_hdr akan digunakan untuk merekam tayangan. Contoh d_imp=1 d_imp=0 (Ini adalah nilai default untuk penghitungan tayangan Google Ad Manager.)
d_imp_hdr	Pengalih informasi header untuk tayangan tertunda. Jika disertakan, URL tampilan yang akan digunakan untuk penghitungan tayangan akan ditampilkan di header HTTP. Secara default, informasi header ini tidak ditetapkan. Kemudian, penayang perlu melakukan ping pada URL tampilan untuk menghitung tayangan iklan. Pelajari lebih lanjut penghitungan jumlah tayangan iklan dan permintaan tanpa tag. Header Google-Delayed-Impression berisi URL tayangan Google Ad Manager. Header Google-3rdParty-Delayed-Impression berisi URL tayangan pihak ketiga jika ada dalam materi iklan. Contoh d_imp_hdr=1 d_imp_hdr=0 (Menonaktifkan informasi header untuk tayangan tertunda secara eksplisit.)
t	Pasangan nilai kunci tingkat slot. Setiap kunci dan nilai dipisahkan oleh karakter sama dengan =; pasangan kunci-nilai dipisahkan oleh karakter ampersand &. Setiap kunci dan nilai harus berupa URL yang dienkode satu per satu, lalu seluruh string juga harus berupa URL yang dienkode. Setiap kunci dalam satu rangkaian nilai kunci harus bersifat unik; jika Anda memberikan kunci yang sama lebih dari satu kali, hanya satu nilai terkait yang akan dipertimbangkan. Contoh Parameter t=genre%3Daction%26movie%3DMr+%2526+Mrs+Smith menetapkan kunci "genre" ke nilai "action" dan kunci "movie" ke nilai "Mr & Mrs Smith". Perlu diperhatikan bahwa "&" yang berada di antara penugasan nilai kunci dienkode satu kali menjadi (%26), tetapi dienkodekan dua kali menjadi (%2526) ketika muncul dalam nilai. Gunakan excl_cat sebagai kunci khusus untuk pengecualian kompetitif. Contoh t=excl_cat%3Dairlines t=interest%3Dsports%2Cnews%26excl_cat%3Dairlines Karakter berikut tidak diizinkan dalam kunci atau nilai: " ' ! + # * ~ ; ^ ( ) < > [ ] = . Spasi diperbolehkan dalam nilai, dikonversikan sebagai %20 atau +, namun tidak dalam kunci. Contoh Menetapkan kunci "a" menjadi nilai "b+c" dengan t=a%3Db%252Bc tidak akan berfungsi.
m	Nilai jenis mime pada header HTTP. Contoh m=text/wml
mob	Indikator panggilan iklan seluler. Contoh mob=js (Ini adalah satu-satunya nilai yang diterima).
ppid	Parameter ID yang diberikan penayang (PPID) memungkinkan Anda mengirimkan ID kepada Google Ad Manager untuk digunakan dalam pembatasan frekuensi, penargetan audiens dan segmentasi audiens, rotasi iklan berurutan, dan kontrol penayangan iklan berbasis audiens lainnya di berbagai perangkat. Contoh ppid=12JD92JD8078S8J29SDOAKC0EF230337
u_w	Lebar layar perangkat seluler, yang menggantikan deteksi otomatis oleh server iklan. Contoh u_w=1024
u_h	Tinggi layar perangkat seluler, yang menggantikan deteksi otomatis oleh server iklan. Contoh u_h=768
submodel	Informasi hardware perangkat seluler, yang menggantikan deteksi otomatis oleh server iklan. Contoh submodel=iPhone4%2C1 (Koma yang digunakan untuk menetapkan batas nilai submodel dienkode). Nilai submodel: iPhone (generasi pertama): iphone1,1 iPhone 3G: iphone1,2 iPhone 3GS: iphone2,1 iPhone 4 (GSM): iphone3,1 iPhone 4 (GSM): iphone3,2 iPhone 4 (CDMA): iphone3,3 iPhone 4S: iPhone4,1 iPhone 5 (GSM dan LTE): iPhone5,1 iPhone 5 (CDMA dan LTE): iPhone5,2 iPhone 5c (GSM dan CDMA): iPhone5,3 iPhone 5c (GSM dan CDMA): iPhone5,4 iPhone 5s (GSM dan CDMA): iPhone6,1 iPhone 5s (GSM dan CDMA): iPhone6,2 iPhone 6: iPhone7,2 iPhone 6 Plus: iPhone7,1 iPhone 6s: iPhone8,1 iPhone 6s Plus: iPhone8,2 iPhone SE: iPhone8,4 iPhone 7: iPhone9,1 iPhone 7 Plus: iPhone9,2  iPod Gen ke-1: iPod1,1 iPod Gen ke-2: iPod2,1 iPod Gen ke-3: iPod3,1 iPod Gen ke-4: iPod4,1 iPod Gen ke-5: iPod5,1 iPad (Wi-Fi) Gen ke-1: iPad1,1 iPad (AT&T) Gen ke-1: iPad1,2 iPad (Wi-Fi) Gen ke-2: iPad2,1 iPad (AT&T) Gen ke-2: iPad2,2 iPad (Verizon) Gen ke-2: iPad2,3 iPad (Wi-Fi) Gen ke-2: iPad2,4 iPad (Wi-Fi) Gen ke-3: iPad3,1 iPad (Verizon) Gen ke-3: iPad3,2 iPad (AT&T) Gen ke-3: iPad3,3 iPad (Wi-Fi) Gen ke-4: iPad3,4 iPad (AT&T) Gen ke-4: iPad3,5 iPad (Verizon) Gen ke 4: iPad3,6 iPad Mini (Wi-Fi): iPad2,5 iPad Mini (AT&T-US; GSM & LTE 4, 17): iPad2,6 iPad Mini (Verizon-World; GSM, DMA & LTE 1,3,5,13,25): iPad2,7 iPad Mini Retina (Wi-Fi): iPad4,4 iPad Mini Retina (LTE): iPad4,5 iPad Air (Wi-Fi): iPad4,1 iPad Air (LTE): iPad4,2

 

Anda dapat menggunakan ID perangkat yang dapat direset (RDID) untuk pembatasan frekuensi dan penargetan audiens. Pelajari lebih lanjut cara mengonfigurasi RDID untuk permintaan tanpa tag.

Mengaktifkan pelacakan tayangan iklan

Permintaan tanpa tag hanya mendukung satu piksel pelacakan tayangan iklan pihak ketiga. Jika lebih dari satu dikonfigurasi dalam materi iklan, hanya piksel yang dirender pertama yang digunakan.

Google Ad Manager dapat melacak tayangan iklan, juga disebut sebagai tayangan iklan “tertunda”, untuk permintaan tanpa tag. Gunakan salah satu opsi di bawah ini, tetapi tidak secara bersamaan. Menggunakan semua opsi secara bersamaan dapat menyebabkan tayangan dihitung dua kali (atau tiga kali).

Sebaiknya pilih Opsi 1, tetapi Anda harus memiliki akses ke header respons HTTP dan dapat menerapkan protokol berbasis header.

Opsi 1: Baca header respons HTTP untuk mengontrol penghitungan tayangan

Tambahkan parameter d_imp=1 dan d_imp_hdr=1 ke permintaan tanpa tag agar Google Ad Manager tidak merekam tayangan iklan hingga Anda memicu ping tayangan iklan secara manual menggunakan URL header HTTP Google-Delayed-Impression. Saat ping tayangan iklan dipicu, "Tayangan iklan server iklan" dan "Tayangan iklan mulai dirender server iklan" akan direkam oleh Google Ad Manager.

Jangan sertakan makro tayangan iklan yang dilihat untuk materi iklan yang ditampilkan oleh permintaan tanpa tag agar tayangan iklan tidak dihitung dua kali.

Opsi 2: Gunakan makro tayangan iklan yang dilihat

Jika Anda tidak dapat mengakses header respons HTTP, tambahkan makro tayangan iklan yang dilihat ke cuplikan kode dari setiap materi iklan yang ditampilkan oleh permintaan tanpa tag. Makro ini diperluas ke URL yang akan dikirim oleh materi iklan saat merender.

Membuat permintaan tanpa tag untuk mengambil kode materi iklan

Konten web

Permintaan tanpa tag umumnya digunakan di lingkungan tanpa dukungan SDK atau pemberian tag Google. Jika Anda membuat permintaan tanpa tag di web, Anda harus memuatnya dalam <iframe> agar dapat menjalankan kode raw yang ditampilkan.

Lingkungan kustom tanpa SDK Google

Untuk mengambil kode materi iklan raw di lingkungan tanpa dukungan SDK atau pemberian tag Google (misalnya, decoder non-Google), lihat panduan berikut:

• Tetapkan agen pengguna yang valid dalam header permintaan User-Agent untuk memastikan bahwa penargetan berfungsi dengan baik.
• Pastikan lingkungan Anda dapat menangani perilaku multimedia, termasuk perluasan materi iklan dan JavaScript.
• Buat permintaan HTTPS ke Google Ad Manager.
• Periksa status respons untuk menemukan "HTTP 200/OK", yang menunjukkan bahwa permintaannya benar.

Fitur yang tidak didukung oleh permintaan tanpa tag

• Tampilan Aktif
• Ad Exchange
• ID aplikasi seluler atau cookie yang digunakan untuk melacak
• Kode wrapper materi iklan
• Alokasi dinamis dengan AdSense, Ad Exchange, atau AdMob
• Inventaris native
• Transaksi Pilihan
• Pratinjau materi iklan
• AdChoices

Permintaan tanpa tag yang menggunakan gampad/ad di tag gambar HTML (<img>) tidak mendukung kode pelacakan JavaScript dan tidak didukung untuk penghitungan tayangan iklan.

Untuk melaporkan iklan ini, gunakan metrik "Jumlah total kode yang ditayangkan" di pelaporan Google Ad Manager.

Badge iklan tidak didukung untuk materi iklan yang ditayangkan pada permintaan tanpa tag. Iklan Anda harus mematuhi persyaratan peraturan yang berlaku untuk iklan yang ditayangkan di Wilayah Ekonomi Eropa (EEA). Hal ini mencakup mekanisme bagi pengguna untuk melaporkan konten ilegal. Penayang harus memberitahukan laporan konten ilegal apa pun kepada Google menggunakan formulir yang sesuai.