API Konversi
Laporkan sasaran Anda ke Meta, LinkedIn, TikTok, dan Google Ads dari server kami, bukan browser — dicocokkan hanya melalui pengenal klik yang ditetapkan jaringan itu sendiri.
1. Mengapa Menggunakan Sisi Server?
Piksel browser harus melewati tiga hal sebelum dapat melaporkan konversi: pemblokir iklan, pengaturan pencegahan pelacakan, dan pengunjung yang menutup tab sebelum piksel dipicu. Pemanggilan sisi server melewati ketiganya karena sama sekali tidak terjadi di browser.
MousePlayer sudah mengetahui kapan salah satu sasaran Anda tercapai — itulah fungsi sasaran. API Konversi hanya meneruskan fakta tersebut ke jaringan iklan dari server kami.
Ini Bukan Pengganti Piksel Anda. Tetap gunakan piksel. Setiap jaringan menghapus duplikasi di antara keduanya, dan kami mengirim pengenal yang diperlukan untuk itu.
2. Yang Kami Kirim — dan yang Tidak Pernah Kami Kirim
Satu-satunya hal yang mengidentifikasi pengunjung dalam pemanggilan ini adalah cookie atau pengenal klik yang ditetapkan jaringan itu sendiri. Tidak ada informasi lain tentang orang tersebut yang meninggalkan server kami.
| Jaringan | Pengenal yang digunakan | Asalnya |
|---|---|---|
| Meta | _fbp, _fbc | Cookie pihak pertama yang dipasang piksel Meta |
li_fat_id | Cookie pihak pertama yang dipasang LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp adalah cookie, ttclid berasal dari URL klik iklan |
| Google Ads | gclid, wbraid, gbraid | Dari URL klik iklan, atau cookie _gcl_aw setelahnya |
| Microsoft Advertising | msclkid | Dari URL klik iklan, atau cookie _uetmsclkid yang ditulis tag UET |
Tidak pernah dikirim: alamat email, nomor telepon, nama, atau alamat IP — bahkan dalam bentuk hash. Jika pengunjung tidak memiliki pengenal klik, tidak ada yang dikirim sama sekali. Konversi tanpa sasaran pencocokan kurang bernilai bagi Anda daripada hitungan yang akurat.
Hanya dengan Persetujuan
Setiap pemanggilan ini melewati pemeriksaan persetujuan yang sama dengan perekaman itu sendiri. Sesi tanpa persetujuan tidak menghasilkan laporan konversi, apa pun pengaturan sakelar dalam proyek Anda.
3. Google Ads Memiliki Tiga Pengenal, Bukan Satu
Hal ini mengejutkan orang, jadi perlu dinyatakan dengan jelas. Google menggunakan gclid untuk satu klik iklan. Saat pencegahan pelacakan Apple membuat satu klik tidak dapat diatribusikan, Google mengirim wbraid atau gbraid sebagai gantinya, yang mewakili sekelompok klik.
Ketiganya saling eksklusif — Google menolak konversi yang membawa dua pengenal. Kami mengirim tepat satu, dan gclid diutamakan jika ada lebih dari satu, karena paling presisi.
Hanya Sekali Ada dalam URL
Pengenal muncul di alamat hanya pada halaman pertama setelah klik iklan. Tag Google kemudian menyimpannya dalam cookie _gcl_aw. Kami membaca cookie sebagai cadangan — tanpanya, konversi pada halaman ketiga kunjungan tidak akan menemukan pengenal sama sekali.
4. Penyiapan
Meta, LinkedIn, dan TikTok
Masing-masing dua kolom: ID piksel atau aturan konversi, dan token akses yang Anda buat di antarmuka jaringan itu sendiri. Keduanya disimpan dengan enkripsi AES-256-GCM dan tidak pernah ditampilkan lagi setelah disimpan.
Google Ads Memerlukan Enam
Google merupakan pengecualian, dan alasannya perlu diketahui sebelum mulai: berbeda dari tiga lainnya, Google tidak menerbitkan token akses sederhana. Akses menggunakan OAuth dengan token penyegaran, dan Ads API juga memerlukan token pengembang.
| Kolom | Tempat menemukannya |
|---|---|
| ID Pelanggan | Di kanan atas Google Ads. Hanya angka, tanpa tanda hubung. |
| ID tindakan konversi | Sasaran dan konversi, lalu tindakan tempat konversi ini ingin Anda catat. |
| Token pengembang | Akun pengelola Google Ads Anda, Pusat API. |
| ID klien dan rahasia OAuth | Google Cloud Console, Kredensial, klien OAuth bertipe “aplikasi desktop”. |
| Token penyegaran | Anda membuatnya sendiri sekali untuk cakupan adwords. |
LinkedIn Memiliki Dua Jalur, dan Anda Memerlukan yang Singkat
Di Campaign Manager: Data, Pengelola Sinyal, API Langsung, Buat token akses. Itulah jalur untuk pengiklan yang mengirim data sendiri — tanpa aplikasi pengembang, tanpa peninjauan. Token tidak kedaluwarsa, dan Campaign Manager tidak akan menampilkannya untuk kedua kali, jadi segera salin.
Jalur lainnya, aplikasi pengembang yang diajukan melalui Developer Portal LinkedIn, tersedia untuk platform yang mengirim atas nama banyak pengiklan. Memerlukan verifikasi halaman perusahaan dan kasus penggunaan yang disetujui; Anda tidak memerlukan semua itu di sini.
Microsoft Advertising Lebih Mudah
Setelah Google Ads, Anda mungkin mengharapkan kerumitan yang sama — OAuth, token pengembang, tahap persetujuan. Justru sebaliknya: dua kolom. ID tag UET yang sudah Anda gunakan di browser, dan token yang disalin dari Microsoft Advertising pada tag UET, “Gunakan API Konversi”, “Salin Token”. Tidak ada yang perlu diajukan.
Gunakan ID tag yang sama dengan tag browser Anda. Itulah yang memungkinkan Microsoft mengenali peristiwa sisi server dan peristiwa browser sebagai satu konversi, bukan dua.
Token Pengembang Memerlukan Persetujuan Google (“Akses dasar”), dan memerlukan beberapa hari. Inilah satu langkah yang tidak dapat diselesaikan dalam satu menit, jadi mulailah lebih dahulu. Kami tidak pernah melihat kata sandi Google Anda — hanya token penyegaran, yang dapat Anda cabut kapan saja.
5. Kapan Konversi Dilaporkan
Tepat sekali per sasaran dan sesi. MousePlayer mencegah duplikasi sebelum pemanggilan dikirim, dan payload juga membawa ID agar jaringan dapat mencegah duplikasi sekali lagi di sisinya. Pengunjung yang menambahkan lima barang ke keranjang menghasilkan satu konversi, bukan lima.
Yang Terlihat di Akun Iklan Anda
Konversi membawa nama sasaran, nilai dan mata uangnya jika Anda menetapkannya, serta waktu terjadinya. Dalam operasi normal, tiba dalam satu menit.
Jika Tidak Ada yang Masuk
- Tidak ada pengenal klik. Pengunjung tidak datang melalui iklan jaringan tersebut, atau tiba sebelum piksel memasang cookie. Tidak ada yang dikirim — ini sesuai harapan, bukan kesalahan.
- Tidak ada persetujuan. Pemeriksaan persetujuan dilakukan lebih dahulu.
- Jaringan menerima pemanggilan tetapi menolak konversi. Google, TikTok, dan beberapa lainnya menjawab dengan HTTP 200 serta kesalahan dalam isi respons. Kami membaca isinya, bukan hanya status, dan alasannya muncul di log pengiriman.
Semua merek dagang yang disebutkan di sini adalah milik pemiliknya masing-masing. MousePlayer tidak memiliki hubungan bisnis dengan penyedia ini.