API penukaran
Laporkan matlamat anda kepada Meta, LinkedIn, TikTok dan Google Ads daripada pelayan kami, bukan pelayar - dipadankan hanya melalui pengecam klik yang ditetapkan rangkaian itu sendiri.
1. Mengapa bahagian pelayan?
Piksel pelayar perlu melepasi tiga perkara sebelum dapat melaporkan penukaran: penyekat iklan, tetapan pencegahan penjejakan dan pelawat menutup tab sebelum piksel dicetuskan. Panggilan bahagian pelayan melepasi ketiga-tiganya kerana langsung tidak berlaku dalam pelayar.
MousePlayer sudah mengetahui apabila salah satu matlamat anda tercapai - itulah tujuan matlamat. API Penukaran hanya memajukan fakta itu kepada rangkaian iklan daripada pelayan kami.
Ini bukan pengganti piksel anda. Kekalkannya. Setiap rangkaian menyahduplikasi kedua-duanya, dan kami menghantar pengecam yang diperlukan untuk itu.
2. Perkara yang kami hantar - dan yang tidak pernah kami hantar
Satu-satunya perkara yang mengenal pasti pelawat dalam panggilan ini ialah kuki atau pengecam klik yang ditetapkan rangkaian itu sendiri. Tiada maklumat lain tentang individu itu meninggalkan pelayan kami.
| Rangkaian | Pengecam digunakan | Asalnya |
|---|---|---|
| Meta | _fbp, _fbc | Kuki pihak pertama yang ditetapkan piksel Meta |
li_fat_id | Kuki pihak pertama yang ditetapkan LinkedIn Insight Tag | |
| TikTok | _ttp, ttclid | _ttp ialah kuki, ttclid berasal daripada URL klik iklan |
| Google Ads | gclid, wbraid, gbraid | Daripada URL klik iklan, atau kuki _gcl_aw selepas itu |
| Microsoft Advertising | msclkid | Daripada URL klik iklan, atau kuki _uetmsclkid yang ditulis tag UET |
Tidak pernah dihantar: alamat e-mel, nombor telefon, nama atau alamat IP - walaupun dihash. Jika pelawat tiada pengecam klik, tiada apa-apa dihantar langsung. Penukaran tanpa sasaran kurang bernilai kepada anda berbanding kiraan tepat.
Hanya dengan persetujuan
Setiap panggilan ini berada di sebalik pintu persetujuan yang sama seperti rakaman itu sendiri. Sesi tanpa persetujuan tidak menghasilkan laporan penukaran, tanpa mengira suis dalam tetapan projek anda.
3. Google Ads mempunyai tiga pengecam, bukan satu
Ini mengejutkan orang, jadi wajar dinyatakan dengan jelas. Google menggunakan gclid untuk satu klik iklan. Apabila pencegahan penjejakan Apple menjadikan satu klik tidak boleh diatributkan, Google menghantar wbraid atau gbraid sebagai ganti, yang mewakili sekumpulan klik.
Ketiga-tiganya saling eksklusif - Google menolak penukaran yang membawa dua. Kami menghantar tepat satu, dan gclid diutamakan apabila lebih daripada satu tersedia kerana paling tepat.
Ia hanya berada dalam URL sekali
Pengecam muncul dalam alamat hanya pada halaman pertama selepas klik iklan. Tag Google kemudian menyimpannya dalam kuki _gcl_aw . Kami membaca kuki sebagai sandaran - tanpanya, penukaran pada halaman ketiga lawatan tidak akan menemui pengecam langsung.
4. Persediaan
Meta, LinkedIn dan TikTok
Dua medan setiap satu: ID piksel atau peraturan penukaran, dan token akses yang anda cipta dalam antara muka rangkaian itu sendiri. Kedua-duanya disimpan dengan penyulitan AES-256-GCM dan tidak pernah ditunjukkan semula selepas disimpan.
Google Ads memerlukan enam
Google ialah pengecualian, dan sebabnya wajar diketahui sebelum bermula: berbeza daripada tiga yang lain, Google tidak mengeluarkan token akses ringkas. Akses melalui OAuth dengan token muat semula, dan Ads API turut memerlukan token pembangun.
| Medan | Tempat menemuinya |
|---|---|
| ID pelanggan | Di kanan atas dalam Google Ads. Digit sahaja, tanpa sempang. |
| ID tindakan penukaran | Goals and conversions, kemudian tindakan yang ingin anda rekodkan. |
| Token pembangun | Akaun pengurus Google Ads anda, API Center. |
| ID dan rahsia klien OAuth | Google Cloud Console, Credentials, klien OAuth jenis “desktop app”. |
| Token muat semula | Anda menjana ini sendiri sekali untuk skop adwords. |
LinkedIn mempunyai dua laluan, dan anda mahukan yang pendek
Dalam Campaign Manager: Data, Signals Manager, Direct API, Generate access token. Itulah laluan untuk pengiklan yang menghantar data sendiri - tanpa aplikasi pembangun atau semakan. Token tidak luput, dan Campaign Manager tidak akan menunjukkannya kali kedua, jadi salin terus.
Laluan lain, aplikasi pembangun yang diminta melalui Developer Portal LinkedIn, wujud untuk platform yang menghantar bagi pihak ramai pengiklan. Memerlukan pengesahan halaman syarikat dan kes penggunaan diluluskan, dan anda tidak memerlukan semua itu di sini.
Microsoft Advertising paling mudah
Selepas Google Ads, anda menjangka beban sama - OAuth, token pembangun, langkah kelulusan. Sebaliknya: dua medan. ID tag UET yang sudah anda gunakan dalam pelayar, dan token yang disalin daripada Microsoft Advertising di bawah tag UET, “Use Conversions API”, “Copy Token”. Tiada permohonan diperlukan.
Gunakan ID tag yang sama seperti tag pelayar anda. Itulah yang membolehkan Microsoft mengenali peristiwa bahagian pelayan dan peristiwa pelayar sebagai satu penukaran, bukan dua.
Token pembangun memerlukan kelulusan Google (“Basic access”), dan mengambil masa beberapa hari. Inilah satu langkah yang tidak dapat anda selesaikan dalam seminit, jadi mulakannya dahulu. Kami tidak pernah melihat kata laluan Google anda - hanya token muat semula, dan anda boleh membatalkannya pada bila-bila masa.
5. Masa penukaran dilaporkan
Tepat sekali setiap matlamat dan sesi. MousePlayer menyahgandakan ini sebelum panggilan dihantar, dan muatan turut membawa ID supaya rangkaian boleh menyahgandakannya sekali lagi di pihaknya. Pelawat yang menambah lima item ke troli menghasilkan satu penukaran, bukan lima.
Perkara yang akan anda lihat dalam akaun iklan
Penukaran membawa nama matlamat anda, nilai dan mata wangnya jika ditetapkan, serta masa ia berlaku. Ia tiba dalam seminit semasa operasi biasa.
Jika tiada apa-apa diterima
- Tiada pengecam klik. Pelawat tidak datang melalui iklan rangkaian itu, atau tiba sebelum piksel menetapkan kukinya. Tiada apa-apa dihantar - ini dijangka, bukan ralat.
- Tiada persetujuan. Pintu persetujuan didahulukan.
- Rangkaian menerima panggilan tetapi menolak penukaran. Google, TikTok dan beberapa yang lain membalas dengan HTTP 200 dan ralat dalam badan respons. Kami membaca badan, bukan status sahaja, dan sebabnya muncul dalam log penghantaran.
Semua tanda dagangan yang disebut di sini milik pemilik masing-masing. MousePlayer tidak mempunyai hubungan perniagaan dengan penyedia ini.