Cara Mengintegrasikan SDK Peristiwa Aplikasi TikTok

Sebelum memulai

Anda perlu akun iklan TikTok dan ID aplikasi TikTok untuk menggunakan SDK Peristiwa Aplikasi TikTok (TikTok App Events SDK) di Android dan iOS. Gunakan aplikasi yang sudah ada atau Anda dapat membuat aplikasi baru.

Catatan: SDK Peristiwa Aplikasi TikTok kini mendukung konfigurasi hybrid dengan MMP dalam akun yang sama. Anda dapat membuat akun iklan TikTok baru untuk mengintegrasikan SDK, atau menggunakan akun MMP yang ada untuk mengintegrasikan SDK.

Cara Mengintegrasikan SDK Peristiwa Aplikasi TikTok

Langkah 1: Buat aplikasi atau gunakan aplikasi yang ada dan buat ID aplikasi TikTok dan App Secret

Opsi 1: Tambahkan SDK ke aplikasi yang terhubung dengan MMP (konfigurasi hybrid)

1. Login ke TikTok Ads Manager.

2. Klik tab Alat, lalu klik Events Manager.

3. Pilih Sumber data, lalu pilih aplikasi yang ingin ditambahkan koneksi SDK.

   
   
   

4. Buka tab Pengaturan, lalu klik pilih mitra di bagian SDK Peristiwa Aplikasi TikTok.

   
   
   

5. Ikuti prosesnya dan tambahkan SDK ke akun. Buat ID aplikasi TikTok dan App Secret.

   

Opsi 2: Tambahkan SDK ke aplikasi yang baru dibuat

1. Login ke TikTok Ads Manager.

2. Klik tab Alat, lalu klik Events Manager.

3. Pilih Sambungkan sumber data di bar navigasi kiri atas, lalu pilih Aplikasi.

   
   
   

4. Pilih SDK TikTok untuk menyambungkan aplikasi Anda.

   
   
   

5. Masukkan detail aplikasi Anda, lalu buat aplikasi. Ikuti prosesnya dan buat ID aplikasi TikTok dan App Secret.

   
   
   

Langkah 2: Ikuti instruksi di panduan TikTok Developer Center untuk mengintegrasikan SDK peristiwa aplikasi TikTok

1. Untuk dapat menginisialisasi SDK, Anda harus memiliki ID aplikasi, ID aplikasi TikTok, dan App Secret terlebih dulu dari langkah 1.

   1. Demo ID aplikasi dan ID aplikasi TikTok:

      
      
      

   2. Demo App Secret:

      
      
      

2. Unduh SDK di GitHub. Saat ini, TikTok mendukung SDK iOS Native, SDK Android Native, dan SDK Unity.

Langkah 3: Postback peristiwa melalui SDK

1. Untuk daftar lengkap peristiwa aplikasi standar yang dapat Anda catat dan peristiwa yang dicatat otomatis, baca artikel tentang peristiwa standar.

2. Di bawah ini daftar peristiwa yang dicatat otomatis. Catatan: Anda dapat menonaktifkan peristiwa yang dicatat otomatis. Untuk mempelajari selengkapnya, lihat dokumen developer SDK peristiwa aplikasi.

   1. LaunchApp: Saat aplikasi diluncurkan.

   2. InstallApp: Saat aplikasi diluncurkan untuk pertama kalinya.

   3. 2DRetention: Aplikasi dibuka kembali pada hari berikutnya sejak hari pertama dibuka.

   4. Pembelian: Pembayaran yang berhasil diselesaikan untuk produk habis pakai/produk tidak habis pakai/langganan.

      1. Pastikan postback pembelian yang dicatat otomatis sesuai dengan kebutuhan bisnis Anda sebelum diaktifkan. Lihat detail selengkapnya tentang peristiwa pembelian yang dicatat otomatis di iOS dan peristiwa pembelian yang dicatat otomatis di Android.

Catatan khusus untuk peristiwa pembelian yang dicatat otomatis: SDK dapat secara otomatis menangkap transaksi yang dilakukan melalui StoreKit (iOS) atau Google Play Billing (Android). Agar dapat memasukkan lebih banyak properti dan parameter, atau jika Anda tidak menggunakan payment gateway native dari Apple atau Google, sebaiknya gunakan postback pembelian manual.

Langkah 4: [iOS] Ukur peristiwa SKAN

Di SKAdNetwork (SKAN), sebaiknya Anda hanya memiliki satu SDK yang melaporkan nilai konversi. Jika Anda menggunakan MMP atau SDK lain untuk memperbarui nilai konversi ke SKAdNetwork, pastikan untuk menambahkan disableSKAdNetworkSupport() ke konfigurasi guna menghindari konflik pembaruan.

Tentukan apakah Anda perlu mengaktifkan pengukuran SKAN SDK TikTok:

Jika Anda memiliki MMP:

• SDK MMP memperbarui nilai konversi (conversion value/CV) dan Anda bermaksud menggunakan skema SKAN MMP: Nonaktifkan dukungan SKAdNetwork di SDK TikTok dan jangan unggah skema ke TikTok Events Manager. (MMP Anda tetap menjadi satu-satunya sumber kebenaran untuk skema dan pembaruan CV.)

Jika Anda tidak memiliki MMP:

Pastikan hanya satu SDK di aplikasi Anda yang memperbarui nilai konversi SKAN.

• SDK non-MMP lain yang memperbarui CV: Nonaktifkan dukungan SKAdNetwork di SDK TikTok, tetapi unggah skema ke TikTok Events Manager. (TikTok akan menggunakan skema Anda, tetapi tidak akan melakukan pembaruan CV berulang.)

• SDK TikTok yang bertanggung jawab memperbarui CV: Aktifkan dukungan SKAdNetwork di SDK TikTok dan unggah skema ke TikTok Events Manager. (TikTok menjadi pihak utama yang menangani pembaruan CV SKAN.)

Untuk detail selengkapnya, lihat dokumen developer SDK peristiwa aplikasi.

Langkah 5: Verifikasi postback secara real-time dengan mode debug

Mulai SDK versi 1.5.0, terdapat dua metode bagi pengguna untuk memverifikasi integrasi SDK sebelum rilis:

• (Direkomendasikan) Mode uji peristiwa berbasis token yang sepenuhnya dilakukan di TikTok Events Manager dan tidak memerlukan modifikasi kode.

• Mode debug manual yang membutuhkan modifikasi. Saat menggunakan debug manual, jangan lupa untuk menonaktifkan mode debug sebelum merilis aplikasi Anda. Peristiwa yang dihasilkan saat menggunakan salah satu dari alat ini akan melalui pipeline pengujian dan tidak dapat digunakan untuk pelaporan.

  • Mode debug: AKTIF

    

    Mode debug: NONAKTIF

    

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

Anda dapat melihat peristiwa SDK muncul di tab pelaporan events manager setelah TikTok mulai menerima sinyal real-time dari SDK. Sinyal dalam mode uji tidak akan muncul di sini.

Langkah 7: Jalankan kampanye Anda menggunakan SDK TikTok

Jika ada masalah atau kendala saat mengintegrasikan SDK Peristiwa Aplikasi, Anda dapat mengajukan tiket ke customer support. Pastikan Anda memilih Pengukuran dan kemudian SDK Peristiwa Aplikasi sebagai kategori masalah.