Apa Itu TikTok Events API?

🧠 Apa Itu TikTok Events API?

TikTok Events API (juga dikenali sebagai “Server-to-Server API”) membolehkan perniagaan menghantar data peristiwa pengguna (seperti pembelian, pendaftaran, dan lawatan laman) terus dari pelayan mereka ke TikTok, tanpa bergantung sepenuhnya pada Pixel.

Ia sangat berguna apabila:

Penjejakan penyemak imbas disekat (seperti ad blocker atau sekatan privasi iOS14)
Anda mahu data penukaran yang lebih tepat dan boleh dipercayai
Anda menggunakan sistem seperti CRM atau platform e-dagang

Events API membantu mengelakkan kehilangan data kritikal akibat batasan penyemak imbas.

🚀 Kelebihan Menggunakan TikTok Events API

✅ Melepasi sekatan penyemak imbas (cookies, ad blockers, dll.)
✅ Berfungsi dari sisi pelayan (server-side) untuk kawalan yang lebih baik dan lebih selamat
✅ Meningkatkan ketepatan atribusi penukaran
✅ Boleh digabungkan dengan TikTok Pixel menggunakan ‘Advanced Matching’
✅ Menjejak tindakan penuh corong penukaran, termasuk penukaran luar talian

⚙️ Bagaimana Ia Berfungsi?

Events API menghantar permintaan POST (HTTP) dari pelayan anda ke TikTok, termasuk:

Jenis peristiwa (contoh: CompletePayment, PageView)
Maklumat pengguna (emel, telefon, IP, ejen pengguna)
Cap masa (timestamp)
ID acara (event_id)
Sumber laman atau aplikasi

🛠️ Cara Menyediakan TikTok Events API

✅ Langkah 1: Cipta TikTok Pixel

Walaupun ini penjejakan sisi pelayan, anda masih perlu cipta Pixel:

Log masuk ke TikTok Ads Manager
Pergi ke menu Assets > Events
Pilih Web Events dan cipta Pixel baharu
Salin dan simpan Pixel ID anda

✅ Langkah 2: Dapatkan Access Token

Log masuk ke TikTok Business Center
Pilih Assets > Events API
Klik pada Pixel anda
Tekan Generate Access Token
Simpan token ini dengan selamat untuk digunakan semasa menghantar permintaan

✅ Langkah 3: Hantar Data ke TikTok API

Endpoint TikTok:

https://business-api.tiktok.com/open_api/v1.3/event/track/

Header permintaan:

Content-Type: application/json  
Access-Token: YOUR_ACCESS_TOKEN

Contoh payload:

{
  "pixel_code": "PIXEL_ID_ANDA",
  "event": "CompletePayment",
  "timestamp": 1713115432000,
  "event_id": "ORDER12345",
  "context": {
    "ip": "192.0.2.1",
    "user_agent": "Mozilla/5.0",
    "page": {
      "url": "https://lamananda.com/terima-kasih"
    }
  },
  "properties": {
    "value": 129.99,
    "currency": "MYR"
  },
  "user": {
    "external_id": "emel_or_telefon_yang_dihash"
  }
}

✅ Langkah 4: Hash Maklumat Peribadi (PII)

Untuk privasi, TikTok memerlukan maklumat seperti emel dan nombor telefon dihash menggunakan SHA256:

Contoh dalam Python:

import hashlib

email = "test@example.com".strip().lower()
hashed_email = hashlib.sha256(email.encode()).hexdigest()

Gunakan nilai yang telah di-hash dalam "external_id".

✅ Langkah 5: Uji Data Anda

TikTok menyediakan Test Event Tool:

Pergi ke Pixel anda dalam TikTok Ads Manager
Buka tab Test Events
Dalam permintaan API, tambah test_event_code:

{
  ...
  "test_event_code": "TEST1234"
}

Lihat sama ada peristiwa berjaya diterima

🔁 Jenis Peristiwa Yang Disokong

Acara	Keterangan
`PageView`	Lawatan halaman
`AddToCart`	Tambah ke troli
`CompletePayment`	Pembelian lengkap
`Lead`	Penjanaan prospek
`InitiateCheckout`	Mula semak keluar
`Search`	Carian laman
`SignUp`	Daftar akaun

🧪 Pencocokan Lanjutan & Nyahpendua (Deduplication)

Jika anda menggunakan TikTok Pixel dan Events API serentak, anda mesti guna event_id yang sama untuk mengelakkan pengiraan dua kali:

Pixel: event_id = abc123
API: event_id = abc123

TikTok hanya akan kira satu penukaran sahaja.

🔐 Amalan Keselamatan Terbaik

Simpan token anda secara selamat
Tukar token secara berkala
Jangan panggil API dari sisi klien
Guna HTTPS dan kawalan keselamatan pelayan

🧩 Platform Yang Boleh Diintegrasi

Shopify / WooCommerce (plugin server-to-server)
CRM (Salesforce, HubSpot, dsb.)
Backend (Node.js, PHP, Python)
Zapier / Make.com untuk automasi mudah

✅ Kesimpulan: Perlukah Anda Guna Events API?

Jika anda mahu:

Meningkatkan ketepatan data penukaran TikTok
Menjejak tindakan pengguna secara lebih menyeluruh
Mengurangkan kehilangan data akibat batasan pelayar

Maka TikTok Events API adalah alat penting. Ia melengkapi TikTok Pixel dan membantu anda kekal relevan dalam dunia pengiklanan berorientasikan privasi.