Makro untuk materi iklan kustom

Keahlian teknis

Artikel ini ditujukan kepada pengguna yang mengembangkan materi iklan kustom dan memerlukan keahlian teknis.

Jika Anda merupakan pemroses iklan yang diharapkan untuk mengaitkan materi iklan kustom dengan item baris, tetapi tidak memiliki keahlian teknis untuk memecahkan masalah materi iklan kustom, temukan sumber daya yang memiliki keahlian tersebut. Sumber daya ini mungkin merupakan orang di organisasi Anda yang membuat materi iklan kustom di Ad Manager, atau sumber daya di agensi kreatif yang menyediakan kode dalam materi iklan kustom kepada organisasi Anda.

Makro digunakan dalam materi iklan kustom untuk berbagai tujuan. Dua tujuan yang penting adalah sebagai placeholder untuk URL tujuan (URL klik-tayang) dan URL pelacakan klik. Jenisnya dapat berupa makro yang tidak di-escape, yang di-escape, atau yang di-escape dua kali.

Escape merupakan praktik penggunaan satu karakter (atau sekumpulan karakter) untuk merepresentasikan karakter lain. URL hanya dapat ditransmisikan di internet melalui himpunan karakter ASCII. Namun, karakter di luar himpunan ini dapat digunakan di URL, sehingga karakter tersebut harus dienkode selama transmisi agar dapat diinterpretasikan dengan benar.

Dalam mengembangkan materi iklan kustom, Anda perlu menggunakan satu atau beberapa kode materi iklan berikut ini:

• URL pelacakan klik yang tidak di-escape: %%CLICK_URL_UNESC%%
• URL pelacakan klik yang di-escape: %%CLICK_URL_ESC%%
• URL tujuan yang tidak di-escape: %%DEST_URL%%
• URL tujuan yang di-escape: %%DEST_URL_ESC%%
• Makro URL tujuan yang di-escape dua kali: %%DEST_URL_ESC_ESC%%

Untuk memastikan bahwa klik dilacak atau bahwa pengguna sampai di URL tujuan, Anda perlu menggunakan varian yang tepat. Penggunaan varian yang salah dapat menyebabkan pelacakan klik gagal mencatat atau pengguna tersebut tidak sampai di URL tujuan. 

Jika URL pelacakan klik dan klik-tayang diperlukan, Anda juga perlu memastikan bahwa makro diurutkan atau "dikaitkan" menjadi satu dengan benar menggunakan varian yang tepat.

Dalam artikel ini, Anda dapat meninjau contoh yang benar dan salah terkait cara menggunakan makro URL pelacakan klik dan tujuan, serta cara mengaitkannya menjadi satu.

Contoh penyisipan makro

Berikut adalah contoh URL pelacakan klik yang tidak di-escape dari Campaign Manager 360. Parameter telah dihapus atau dipersingkat supaya lebih jelas:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=

Bandingkan URL ini dengan versi yang di-escape dari URL yang sama:

http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253D

Di sini, karakter khusus telah di-escape dua kali menggunakan encoding persen. Misalnya, tanda tanya (?) selalu direpresentasikan dengan urutan karakter %253F, sedangkan tanda sama dengan (=) selalu direpresentasikan dengan urutan karakter %253D.

Contoh 1A—Benar: Pelacakan klik Ad Manager di materi iklan kustom

Untuk contoh ini, anggaplah kita memiliki materi iklan kustom yang harus mengklik ke:

http://www.google.com/page.html?param1=red&param2=blue

Materi iklan gambar dapat melacak klik seperti berikut:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Dalam contoh ini, materi iklan yang dirender di browser pengguna akan menjadi:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Ini adalah URL klik yang valid dan benar, karena URL klik Ad Manager tidak di-escape dan URL tujuan di-escape dengan tepat.

Contoh 1B—Salah: Pelacakan klik Ad Manager di materi iklan kustom

Suatu kesalahan umum yang dapat merusak kode materi iklan pada contoh di atas adalah penggunaan makro URL klik yang di-escape. Pada kode materi iklan, hal ini akan terlihat seperti berikut:

<a href='%%CLICK_URL_ESC%%%%DEST_URL_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Materi iklan yang dirender di browser pengguna akan menjadi:

<a href='http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Ini tidak benar—karena semua parameter telah di-escape, server klik iklan tidak dapat menguraikannya dengan benar. Sebagai gantinya, server akan menafsirkan hal ini sebagai permintaan untuk halaman yang bernama /aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/img.gif%3Fparam1%3Dred%26param2%3Dblue

Karena halaman ini tidak ada, error HTTP 404 (Tidak ditemukan) ditampilkan oleh server klik iklan, dan pengguna tidak diarahkan ke halaman landing iklan.

Contoh 1C— Salah: Pelacakan klik Ad Manager di materi iklan kustom

Kesalahan umum lainnya adalah penggunaan makro URL tujuan yang tidak di-escape. Pada kode materi iklan, hal ini akan terlihat seperti berikut:

<a href='%%CLICK_URL_UNESC%%%%DEST_URL_UNESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Materi iklan yang dirender di browser pengguna akan menjadi:

<a href='http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Perhatikan bahwa contoh khusus ini mungkin berfungsi dengan benar jika server klik pertama cukup canggih untuk menafsirkan parameter yang tersisa sebagai URL dan meng-escape parameter tersebut. Dalam kasus ini, Ad Manager akan menulis ulang URL, sehingga memungkinkan klik-tayang berfungsi dengan benar. Namun, sebaiknya Anda tidak mengasumsikan bahwa server dapat menangani URL klik yang diformat dengan tidak benar. Sebaiknya gunakan URL klik yang diformat dengan benar, daripada mengandalkan Ad Manager atau server analisis pihak ketiga untuk menangani URL dengan format yang salah.

Jika server tidak menulis ulang URL yang diformat dengan tidak benar, URL akan ditafsirkan sebagai berikut:

http://adclick.g.doubleclick.net/aclk?sa=l&ai=C8qeK&adurl=http://www.google.com/page.html?param1=red&param2=blue

Dalam kasus ini, karakter '&' terakhir ditafsirkan sebagai pembatas parameter baru untuk permintaan server PERTAMA, bukan parameter yang ditujukan untuk diteruskan ke server yang menghosting halaman landing iklan. Hal ini mungkin mengganggu pemrosesan URL klik pada server klik, yang mungkin menyebabkan pengguna tidak dialihkan ke halaman landing. Meskipun pengguna berhasil dialihkan, ada kemungkinan parameter kedua (param2) tidak diteruskan ke halaman landing.

Contoh 2A—Benar: makro dan pelacak klik pihak ketiga

Pengiklan dapat meminta Anda untuk menyertakan pelacak klik pihak ketiga untuk materi iklan mereka. Pelacak menghitung sendiri jumlah klik untuk materi iklan dan nantinya akan membantu saat pengauditan atau rekonsiliasi oleh pengiklan.

Biasanya, pelacak klik memiliki format URL. Berikut contoh Campaign Manager 360:

http://ad.doubleclick.net/clk;a;b;c?[URL klik-tayang][URL tujuan]

URL (ad.doubleclick.net) merupakan referensi pada server yang mencatat tayangan atau klik. URL pihak ketiga lain juga serupa. URL klik-tayang harus direpresentasikan dengan dua makro:

• Makro klik yang di-escape: %%CLICK_URL_ESC%%
• Makro URL tujuan yang di-escape dua kali: %%DEST_URL_ESC_ESC%%

Keduanya mewakili URL klik-tayang yang sama dan harus disertakan setelah tanda tanya (?). Berikut contoh materi iklan gambar dengan URL pelacakan klik Campaign Manager 360:

<a href='http://ad.doubleclick.net/clk;a;b;c?%%CLICK_URL_ESC%%%%DEST_URL_ESC_ESC%%' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Saat menggunakan template materi iklan, pelacak klik pihak ketiga biasanya direpresentasikan dalam kode materi iklan sebagai ID placeholder URL. Materi iklan yang dirender di browser pengguna akan memperluas makro ke nilai yang diinginkan. Berikut contohnya:

<a href='http://ad.doubleclick.net/clk;a;b;c?http://adclick.g.doubleclick.net/aclk%253Fsa%253Dl%2526ai%253DC8qeK%2526adurl%253Dhttp://www.google.com/page.html%253Fparam1%253Dred%2526param2%253Dblue' target="_blank"> <img src='//www.google.com/img.gif'> </a>

Melihat pratinjau materi iklan dan menguji makro

Pengujian materi iklan memastikan bahwa materi iklan tersebut berperilaku sebagaimana mestinya. Karena makro merupakan placeholder, dan karena terkadang ada kode rumit yang digunakan, cara terbaik untuk menguji materi iklan kustom adalah dengan melihat pratinjau materi iklan dari item baris. Untuk melakukannya:

1. Buka materi iklan di jendela baru.

   JavaScript tidak berfungsi dalam pratinjau yang tersedia langsung di Ad Manager. Selain itu, makro tidak dapat dilihat pada versinya yang diperluas.

2. Gunakan alat developer browser Anda ("alat pengembang") untuk memeriksa elemen dan DOM.

Memvalidasi makro pelacakan klik

Jika makro disisipkan dengan benar, mengklik materi iklan dari pratinjau akan mengarahkan ke halaman landing Ad Manager. Halaman ini mengonfirmasi bahwa klik telah dilacak. Kemudian Anda akan dialihkan ke halaman URL tujuan yang dikaitkan dengan materi iklan.

Jika salah satu dari hal ini tidak terjadi, berarti ada masalah dengan makro atau cara makro dikaitkan menjadi satu. 

Memvalidasi makro tampilan

Memvalidasi makro pelacakan tayangan memerlukan penggunaan penganalisis traffic. Penganalisis traffic memungkinkan permintaan HTTP untuk dilihat dan dicatat. Beberapa alat developer di browser menyertakan alat semacam ini. Tersedia juga software penganalisis traffic pihak ketiga.

Dengan penganalisis traffic, periksa permintaan HTTP saat materi iklan dimuat. Carilah permintaan yang berhasil atau "ping" ke server yang mencatat tayangan. Perhatikan apakah ada error HTTP selama permintaan HTTP.

• Jika Anda tidak menemukan error apa pun, dan Anda melihat ping server yang mencatat tayangan yang berhasil, berarti makro telah dikonfigurasi dengan benar.
• Jika Anda menemukan error apa pun, kembalilah ke kode sumber materi iklan kustom Anda untuk memecahkan masalah. HTTP 204 adalah kode error yang umum saat makro diletakkan dengan tidak benar.