Pasang dan Verifikasi Script Tracking

Script tracking menghubungkan kunjungan website dengan event di Konektor. Ikuti urutan ini: salin kode milik workspace, pasang di semua halaman, buka website, lalu pastikan Konektor menerima event nyata. Pengiriman ke platform iklan adalah langkah opsional yang terpisah.

Sebelum mulai

Anda memerlukan:

• akses owner atau admin ke workspace Konektor;
• izin untuk mengubah header website atau container Google Tag Manager;
• satu halaman website yang dapat dibuka untuk pengujian;
• kredensial platform iklan jika Anda juga ingin mengirim event ke Meta, Google, atau TikTok.

1. Salin kode dari workspace yang benar

1. Masuk ke workspace yang ingin dilacak.
2. Buka Tracking Website.
3. Cari kartu Kode tracking.
4. Jika belum ada ID, klik Buat kode tracking.
5. Klik Lihat kode. Di tab Pasang sendiri, klik Salin Kode.

Selalu gunakan seluruh kode yang dibuat dashboard. Jangan menyalin contoh ID dari dokumentasi dan jangan mengganti ID workspace secara manual.

2. Pilih satu cara pemasangan

Script harus dimuat pada setiap halaman yang ingin dilacak. Pasang satu kali saja melalui metode yang mengatur seluruh website.

HTML manual

1. Buka template layout utama website.
2. Tempel seluruh kode sebelum penutup </head>.
3. Simpan, build, dan publikasikan website.

Jika website memakai navigasi tanpa memuat ulang halaman, pastikan aplikasi juga mencatat PageView setelah perubahan rute. Minta developer memeriksa hal ini jika URL berubah tetapi halaman tidak melakukan reload penuh.

Google Tag Manager

1. Buka container website di Google Tag Manager.
2. Pilih Tags > New.
3. Pilih Tag Configuration > Custom HTML.
4. Tempel seluruh kode Konektor.
5. Pada Triggering, pilih Initialization - All Pages.
6. Simpan, gunakan Preview untuk menguji, lalu Submit untuk memublikasikan container.

Pastikan container Google Tag Manager sendiri sudah terpasang pada website. Tag yang hanya disimpan tetapi belum dipublikasikan tidak berjalan untuk pengunjung.

WordPress

Konektor tidak punya plugin WordPress sendiri. Gunakan fitur atau plugin tepercaya yang memasukkan kode ke header seluruh website.

1. Buka pengaturan kode header pada WordPress.
2. Tempel seluruh kode Konektor pada bagian Header.
3. Simpan perubahan.
4. Bersihkan cache WordPress, plugin cache, dan CDN jika digunakan.

Pada WordPress.com, kemampuan memasang JavaScript bergantung pada paket situs. Lihat panduan header WordPress jika menu pemasangan kode tidak tersedia.

Shopify

Cadangkan atau duplikasi tema sebelum mengubah kode.

1. Buka Online Store > Themes.
2. Pada tema yang aktif, buka menu tindakan lalu pilih Edit code.
3. Buka file layout utama, biasanya theme.liquid.
4. Tempel seluruh kode Konektor sebelum </head>.
5. Klik Save, lalu buka storefront yang sudah dipublikasikan.

Lihat panduan edit kode tema Shopify jika struktur tema Anda berbeda.

Landing-page builder

Cari pengaturan bernama Custom Code, Tracking Script, Header Script, atau istilah serupa. Tempel kode pada bagian header global, bukan hanya pada satu elemen halaman.

Jika platform menyediakan halaman publik dan halaman checkout yang terpisah, periksa apakah kode perlu dipasang pada kedua bagian. Gunakan bantuan resmi platform karena nama menu dapat berbeda.

Aplikasi backend custom (PHP, Laravel, Node.js, dan sejenisnya)

Kode tracking Konektor adalah tag <script> HTML biasa. Kode ini tidak bergantung pada bahasa backend, jadi berlaku sama untuk website yang dirender PHP, Laravel, Node.js, atau framework lain.

1. Buka template layout utama yang dipakai bersama oleh semua halaman, misalnya header.php atau file layout Blade.
2. Tempel seluruh kode sebelum penutup </head>.
3. Pastikan template tersebut dipakai oleh semua rute/halaman yang ingin dilacak, termasuk halaman yang dirender dari controller berbeda.

Ikuti langkah verifikasi yang sama pada bagian 3. Kirim dan verifikasi event website di bawah.

3. Kirim dan verifikasi event website

Lakukan pengujian pada website yang sudah dipublikasikan, bukan hanya pada editor.

1. Buka website di jendela privat atau incognito.
2. Buka satu halaman yang sudah memuat kode Konektor.
3. Kembali ke dashboard member Konektor.
4. Pada panel Aktifkan satu hal dulu, klik Periksa lagi.
5. Pastikan langkah website menyatakan event, seperti PageView, sudah diterima.

Langkah website di panel berubah menjadi selesai setelah event pertama diterima. Jika status belum berubah, tunggu sebentar lalu klik Periksa lagi.

4. Opsional: tambahkan platform iklan

Lewati bagian ini jika Anda hanya ingin memastikan tracking website bekerja. Platform iklan dapat ditambahkan setelah langkah website di panel selesai.

1. Buka Tracking Website. Jika kode belum ada, klik Buat kode tracking.
2. Klik Tambah platform iklan. Pilihan Platform iklan mencakup Meta, Google, dan TikTok.
3. Pilih platform.
4. Isi kolom yang diminta dari akun platform tersebut.
5. Klik Simpan.

Gunakan panduan berikut untuk menyiapkan kredensial dan pemetaan event:

• Meta Conversions API
• Google Ads
• TikTok Events API

Secara default, script Konektor tidak otomatis memuat browser tag milik platform iklan. Jika Anda sudah memakai Meta Pixel, Google tag, atau TikTok Pixel melalui Google Tag Manager atau kode website, biarkan pengelolaan browser tag tersebut tetap di sana agar tidak terjadi pemasangan ganda.

5. Opsional: uji pengiriman platform

1. Pada tabel Platform iklan terhubung, buka menu baris platform, lalu pilih Uji kirim.
2. Isi Nama Event dan data uji yang dibutuhkan.
3. Untuk Meta, isi Kode event uji (Test Event Code) dari Meta Events Manager > Test events. Kode ini wajib untuk Meta.
4. Klik Kirim uji.
5. Periksa hasil di Konektor dan alat test milik platform.

Status Uji berhasil berbeda dari Sehat. Sehat muncul setelah platform menerima event nyata. Konfigurasi yang tersimpan belum membuktikan pengiriman berhasil. Hasil uji tidak mengubah bukti wajib tracking website.

Pindahkan atau hapus pixel dari workspace lama

Satu ID pixel hanya bisa terpasang di satu workspace. Jika ID itu masih terpasang di workspace lama, Konektor menawarkan cara memindahkannya ke workspace baru.

1. Buka workspace baru, lalu buka Tracking Website.
2. Klik Tambah platform iklan, lalu isi platform dan ID pixel yang sama dengan yang ada di workspace lama.
3. Klik Simpan.
4. Jika akun Anda adalah owner atau admin di workspace lama, Konektor menampilkan pesan Pixel ini masih ada di workspace {nama workspace lama}. Klik Pindahkan ke workspace ini. Cara ini tetap berfungsi walau masa aktif workspace lama sudah berakhir.
5. Jika akun Anda bukan owner atau admin di workspace lama, Konektor menampilkan pesan bahwa pixel ini sudah dipakai di workspace lain. Minta owner atau admin workspace lama melakukan langkah di atas, atau minta mereka mengundang akun Anda sebagai admin di workspace baru ini.
6. Setelah pixel pindah, ganti kode tracking di website Anda dengan kode dari workspace baru ini.

Catatan:

• Hanya owner atau admin yang dapat memindahkan atau menghapus pixel.
• Memindahkan pixel tidak menghapus lead di workspace lama.
• Anda juga dapat menghapus pixel langsung di workspace lama. Buka menu baris pada tabel Platform iklan terhubung, lalu pilih Hapus. Lakukan ini jika Anda tidak ingin memindahkannya.

Pengaturan opsional

Domain yang diizinkan

Gunakan daftar domain jika hanya domain tertentu yang boleh mengirim event.

1. Di halaman Tracking Website, buka bagian Domain yang diizinkan.
2. Masukkan satu host per baris, misalnya example.com dan www.example.com.
3. Klik Simpan domain.
4. Uji kembali website.

Jika daftar kosong, semua host diizinkan. Jika daftar diisi, domain website yang tidak tercantum akan ditolak.

Custom domain

Setelah menambah atau mengubah custom domain di Konektor, buka kembali Kode tracking dan salin kode terbaru. Cara ini lebih aman daripada mengedit opsi domain di dalam script secara manual.

Pemecahan masalah

Jika masih gagal, catat URL halaman uji, waktu pengujian, dan pesan error. Tutupi access token, API secret, identitas pelanggan, serta data pribadi sebelum membagikan tangkapan layar.

Langkah berikutnya

• Buat Link WhatsApp.
• Atur strategi konversi.
• Periksa Analytics.
• Pasang lewat Google Tag Manager.
• Pelajari alur LPWA dari klik iklan sampai chat WhatsApp.