Cara menyepadukan SDK Peristiwa Aplikasi TikTok

Kemas kini terakhir: Disember 2025

Sebelum anda bermula

Anda akan memerlukan Akaun Iklan TikTok dan ID Aplikasi TikTok untuk menggunakan SDK Peristiwa Aplikasi TikTok bagi Android dan iOS. Anda boleh menggunakan aplikasi anda yang sedia ada jika anda mempunyai aplikasi atau anda boleh mencipta aplikasi yang baharu.


Nota: SDK Peristiwa Aplikasi TikTok kini menyokong persediaan hibrid dengan MMP dalam akaun yang sama. Anda boleh mencipta akaun Iklan TikTok baharu untuk menyepadukan SDK atau gunakan akaun MMP sedia ada anda untuk menyepadukan SDK.

Cara menyepadukan SDK Peristiwa Aplikasi TikTok

Langkah 1: Cipta Aplikasi atau gunakan aplikasi sedia ada dan janakan ID Aplikasi TikTok dan Rahsia Aplikasi

Pilihan 1: Tambah SDK kepada aplikasi yang disambungkan dengan MMP (persediaan hibrid)

  1. Log masuk ke Pengurus Iklan TikTok.

  2. Klik tab Alat, kemudian Pengurus Peristiwa.

  3. Pilih Sumber data dan pilih aplikasi yang ingin anda tambahkan sambungan SDK.

    App Events SDK - screenshot 1

  4. Pergi ke Tab Tetapan dan klik pilih rakan kongsi di bawah SDK Peristiwa Aplikasi TikTok.

    App Events SDK - screenshot 2

  5. Ikut proses dan tambahkan SDK kepada akaun. Janakan ID Aplikasi TikTok dan Rahsia Aplikasi anda.

    App Events SDK - screenshot 3

Pilihan 2: Tambah SDK kepada aplikasi yang baru dicipta

  1. Log masuk ke Pengurus Iklan TikTok.

  2. Klik tab Alat, kemudian Pengurus Peristiwa.

  3. Pilih Sambungkan sumber data pada navigasi sebelah kiri bahagian atas dan pilih Aplikasi.

    App Events SDK - screenshot 4

  4. Pilih SDK TikTok untuk menyambungkan aplikasi anda.

    App Events SDK - screenshot 5

  5. Berikan butiran aplikasi anda dan cipta aplikasi. Ikut proses dan janakan ID Aplikasi TikTok dan Rahsia Aplikasi anda.

    App Events SDK - screenshot 6

Langkah 2: Ikut arahan dalam Panduan Pusat Pembangun TikTok untuk menyepadukan SDK Peristiwa Aplikasi TikTok

  1. Untuk memulakan SDK, anda perlu mempunyai ID Aplikasi, ID Aplikasi TikTok dan Rahsia Aplikasi terlebih dahulu daripada langkah satu.

    1. Tunjuk cara ID Aplikasi dan ID Aplikasi TikTok:

      TikTok App ID - screenshot

    2. Tunjuk cara Rahsia Aplikasi:

      App secret - screenshot

  2. Muat turun SDK dalam GitHub. Pada masa ini, kami menyokong SDK iOS Natif, SDK Android Natif dan SDK Unity.

Langkah 3: Siaran semula peristiwa melalui SDK

  1. Untuk mendapatkan senarai lengkap bagi peristiwa aplikasi standard yang boleh anda log atau peristiwa yang dilog secara automatik, pergi ke: Peristiwa Standard.

  2. Peristiwa log automatik disenaraikan di bawah. Nota: Anda boleh mematikan peristiwa log automatik. Untuk mengetahui lebih lanjut, pergi ke Dokumen pembangun SDK peristiwa aplikasi.

    1. LaunchApp: Apabila aplikasi dilancarkan.

    2. InstallApp: Apabila aplikasi dilancarkan buat kali pertama.

    3. 2DRetention: Aplikasi dibuka lagi pada hari selepas hari pembukaan pertama.

    4. Pembelian: Berjaya melengkapkan pembayaran untuk barang guna habis/barang bukan guna habis/langganan.

      1. Pastikan siaran semula pembelian yang dilog secara automatik selaras dengan keperluan perniagaan anda sebelum mendayakan ciri tersebut. Lihat butiran lanjut tentang peristiwa Pembelian yang dilog secara automatik iOS dan peristiwa Pembelian yang dilog secara automatik Android.

Seruan khas untuk peristiwa pembelian yang dilog secara automatik: SDK boleh mengumpul secara automatik transaksi yang dibuat melalui StoreKit (iOS) atau Google Play Billing (Android). Untuk meluluskan lebih banyak sifat dan parameter atau jika anda tidak menggunakan get laluan pembayaran natif daripada Apple atau Google, kami mengesyorkan agar anda menggunakan siaran semula pembelian manual.

Langkah 4: [iOS] Ukur peristiwa SKAN

Dalam persekitaran SKAdNetwork (SKAN), kami mengesyorkan agar anda hanya mempunyai satu SDK yang melaporkan nilai penukaran. Jika anda menggunakan MMP atau SDK lain untuk mengemas kini nilai penukaran kepada SKAdNetwork, pastikan anda menambahkan disableSKAdNetworkSupport() kepada konfigurasi anda untuk mengelakkan konflik kemas kini.


Tentukan sama ada anda perlu mendayakan pengukuran SKAN SDK TikTok:


Jika anda mempunyai MMP:

  • SDK MMP mengemas kini nilai penukaran (CV) dan skema SKAN MMP yang ingin anda gunakan: Matikan sokongan SKAdNetwork dalam SDK TikTok dan jangan muat naik skema kepada Pengurus Peristiwa TikTok. (MMP anda kekal sebagai satu sumber kebenaran untuk kemas kini dan skema CV.)

Jika anda TIDAK mempunyai MMP:

Pastikan hanya satu SDK dalam aplikasi anda mengemas kini nilai penukaran SKAN.

  • SDK bukan MMP lain sedang mengemas kini CV: Matikan sokongan SKAdNetwork dalam SDK TikTok, tetapi muat naik skema kepada Pengurus Peristiwa TikTok. (TikTok akan menggunakan skema anda tetapi tidak akan melakukan kemas kini CV yang berulang.)

  • SDK TikTok bertanggungjawab untuk mengemas kini CV: Dayakan sokongan SKAdNetwork dalam SDK TikTok dan muat naik skema kepada Pengurus Peristiwa TikTok. (TikTok akan menjadi pengendali utama untuk kemas kini CV SKAN.)

Untuk mendapatkan butiran lanjut, rujuk Dokumen pembangun SDK peristiwa aplikasi.

Langkah 5: Sahkan siaran semula dalam masa nyata dengan mod Nyahpepijat

Daripada SDK versi 1.5.0, terdapat dua kaedah untuk pengguna mengesahkan penyepaduan SDK sebelum dikeluarkan:

  • (Disyorkan) Mod peristiwa ujian berasaskan token; mod ini dilakukan sepenuhnya di Pengurus Peristiwa TikTok dan tidak memerlukan pengubahsuaian kod.

  • Mod nyahpepijat manual, memerlukan pengubahsuaian. Ketika menggunakan nyahpepijat manual, sila ingat untuk mematikan mod nyahpepijat sebelum mengeluarkan aplikasi anda. Peristiwa yang dijanakan ketika menggunakan mana-mana alat ini akan melalui saluran ujian dan tidak boleh digunakan untuk pelaporan.

    • Mod nyahpepijat: DIHIDUPKAN

      App Event SDK - Debug Mode ON

      Mod nyahpepijat: DIMATIKAN

      App Event SDK - Debug Mode OFF

Langkah 6: Keluarkan versi aplikasi baharu dengan SDK TikTok ke App Store (iOS)/Play Store (Android)

Anda boleh melihat peristiwa SDK yang dipaparkan pada tab pelaporan di Pengurus Peristiwa, selepas TikTok mula menerima isyarat masa nyata anda daripada SDK. Isyarat di bawah mod ujian tidak akan dipaparkan di sini.

App Events SDK - screenshot 5

Langkah 7: Laksanakan kempen anda menggunakan SDK TikTok

Jika terdapat apa-apa isu atau masalah penyepaduan SDK Peristiwa Aplikasi, anda boleh memfailkan tiket dengan sokongan pelanggan. Pastikan anda memilih Pengukuran, kemudian SDK Peristiwa Aplikasi sebagai kategori isu.