Tiếng Việt
Tạo quảng cáo

Nhà phát triển

  1. Bắt đầu /
  2. Nhà phát triển /
  3. SDK sự kiện ứng dụng /

Cách tích hợp TikTok SDK cho Sự kiện ứng dụng

Lần cập nhật gần nhất: tháng 2 2025

Trước khi bắt đầu

Bạn sẽ cần Tài khoản quảng cáo TikTok và Mã ứng dụng TikTok để sử dụng TikTok SDK cho Sự kiện ứng dụng cho hệ điều hành Android và iOS. Bạn có thể dùng ứng dụng hiện tại (nếu có) hoặc có thể tạo ứng dụng mới.


Lưu ý: TikTok SDK cho Sự kiện ứng dụng không hỗ trợ thiết lập kép với MMP trong cùng một tài khoản quảng cáo. Vui lòng tạo tài khoản Quảng cáo TikTok mới để tích hợp SDK Sự kiện ứng dụng vào tài khoản quảng cáo mới mà không cần MMP.

Cách tích hợp TikTok SDK cho Sự kiện ứng dụng

Bước 1: Tạo Ứng dụng và tạo Mã ứng dụng TikTok trong Trình quản lý sự kiện TikTok.

App Event SDK - How to GIF
  1. Trong Trình quản lý quảng cáo TikTok, hãy đi đến Trình quản lý sự kiện bằng cách nhấp vào tab Công cụ rồi nhấp vào Sự kiện.

  2. Chọn Kết nối nguồn dữ liệu ở góc trên bên phải.

  3. Chọn Ứng dụng và tiếp tục.

  4. Cung cấp thông tin về Ứng dụng.

  5. Chọn Sử dụng SDK Sự kiện của TikTok và tiếp tục. Hiện giờ, hệ thống đã tạo xong ứng dụng.

  6. Tạo Mã ứng dụng TikTok.

Bước 2: Làm theo chỉ dẫn trong Hướng dẫn về Trung tâm dành cho nhà phát triển của TikTok để tích hợp TikTok SDK cho Sự kiện ứng dụng.

  1. Để nắm được danh sách đầy đủ về các sự kiện ứng dụng tiêu chuẩn mà bạn có thể lập nhật ký và các sự kiện được lập nhật ký tự động, hãy tham khảo: Sự kiện tiêu chuẩn.

  2. Sau đây là danh sách các sự kiện được lập nhật ký tự động. Lưu ý: Bạn có thể tắt sự kiện được lập nhật ký tự động. Để tìm hiểu thêm, hãy tham khảo Tài liệu dành cho nhà phát triển SDK sự kiện ứng dụng.

    1. LaunchApp: Khi ứng dụng đang được khởi chạy.

    2. InstallApp: Khi ứng dụng được khởi chạy lần đầu tiên.

    3. 2DRetention: Ứng dụng được mở lại vào ngày tiếp theo sau ngày mở đầu tiên.

    4. Purchase (chỉ dành cho iOS): Đã hoàn thành thanh toán cho mục tiêu hao/không tiêu hao/đăng ký.

  3. [Chỉ dành cho iOS] Định cấu hình lược đồ giá trị lượt chuyển đổi SKAN trên Trình quản lý sự kiện TikTok (TTEM).

    1. Để nhận được lượt chuyển đổi SKAN, bạn bắt buộc phải thiết lập lược đồ giá trị lượt chuyển đổi trên TTEM. TikTok hỗ trợ ánh xạ giá trị lượt chuyển đổi 64 bit trong SKAN 3.0 và ánh xạ lược đồ SKAN 4.0.

    2. [Phương pháp hay nhất] Trong môi trường SKAdNetwork (SKAN), bạn chỉ nên có một SDK báo cáo giá trị lượt chuyển đổi. Nếu bạn đang sử dụng MMP hoặc một SDK khác để cập nhật giá trị lượt chuyển đổi sang SKAdNetwork, bạn sẽ cần:

      1. Đặt cấu hình lược đồ TTEM CV với các giá trị giống như thiết lập trên MMP.

      2. Triển khai tính năng disableSKAdNetworkSupport() để tránh TikTok SDK cho Sự kiện ứng dụng cập nhật giá trị lượt chuyển đổi.

Bước 3: Xác minh thông tin thu thập được theo thời gian thực bằng chế độ Gỡ lỗi.

  1. Bạn có thể xác minh và gỡ lỗi các thông tin thu thập được về sự kiện và các thông số liên quan theo thời gian thực bằng cách bật chế độ Gỡ lỗi trong ứng dụng. Để xem sự kiện, hãy truy cập vào tab Thử nghiệm sự kiện trong ứng dụng thuộc Trình quản lý sự kiện TikTok.

Lưu ý:

  • Các sự kiện thử nghiệm hỗ trợ thử nghiệm nhiều Mã ứng dụng TikTok cùng một lúc. Tuy nhiên, nếu nhiều Mã ứng dụng TikTok đang được thử nghiệm cùng nhau, tất cả các sự kiện thử nghiệm từ nhiều Mã ứng dụng TikTok khác nhau sẽ hiển thị trong tab Thử nghiệm sự kiện trong tài khoản quảng cáo có Mã ứng dụng TikTok được liên kết đầu tiên.

  • Sau khi bạn đã xác minh thiết lập tín hiệu, hãy tắt chế độ Gỡ lỗi trước khi phát hành ứng dụng lên App Store/Cửa hàng Play. Sau khi tắt, bạn vẫn có thể nhìn thấy sự kiện thử nghiệm trong vòng tối đa 72 giờ. Nếu sự kiện vẫn hiển thị sau 72 giờ trong tab Thử nghiệm sự kiện, thì tức là chế độ Gỡ lỗi vẫn chưa tắt. Hãy xem ví dụ sau đây:

Chế độ gỡ lỗi: BẬT

App Event SDK - Debug Mode ON

Chế độ gỡ lỗi: TẮT

App Event SDK - Debug Mode OFF

Bước 4: Phát hành phiên bản mới của ứng dụng với TikTok SDK lên App Store (iOS) / Cửa hàng Play (Android).

Bước 5: Triển khai chiến dịch bằng TikTok SDK.


Để giải quyết bất kỳ vấn đề hoặc sự cố nào khi tích hợp SDK Sự kiện ứng dụng, bạn có thể gửi yêu cầu hỗ trợ tới bộ phận hỗ trợ khách hàng. Hãy nhớ chọn Đo lường rồi chọn SDK sự kiện ứng dụng làm danh mục vấn đề.