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

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 hiện hỗ trợ thiết lập kết hợp với MMP trong cùng một tài khoản. Bạn có thể tạo một tài khoản Quảng cáo TikTok mới để tích hợp SDK hoặc sử dụng tài khoản MMP hiện có để tích hợp SDK.

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

Bước 1: Tạo Ứng dụng hoặc sử dụng ứng dụng hiện có, rồi tạo Mã ứng dụng TikTok và Mã bí mật ứng dụng

Tùy chọn 1: Thêm SDK vào một ứng dụng đã kết nối với MMP (thiết lập kết hợp)

1. Đăng nhập vào Trình quản lý quảng cáo TikTok.

2. Nhấp vào tab Công cụ, sau đó chọn Trình quản lý sự kiện.

3. Chọn Nguồn dữ liệu rồi chọn ứng dụng mà bạn muốn thêm kết nối SDK.

   
   
   

4. Đi tới tab Cài đặt rồi nhấp vào Chọn đối tác trong mục TikTok SDK cho Sự kiện ứng dụng.

   
   
   

5. Thực hiện theo quy trình và thêm SDK vào tài khoản. Tạo Mã ứng dụng TikTok và Bí mật ứng dụng của bạn.

   

Tùy chọn 2: Thêm SDK vào ứng dụng mới tạo

1. Đăng nhập vào Trình quản lý quảng cáo TikTok.

2. Nhấp vào tab Công cụ, sau đó chọn Trình quản lý sự kiện.

3. Chọn Kết nối nguồn dữ liệu ở thanh điều hướng phía trên bên trái và chọn Ứng dụng.

   
   
   

4. Chọn TikTok SDK để kết nối ứng dụng của bạn.

   
   
   

5. Cung cấp thông tin chi tiết về ứng dụng và tạo ứng dụng. Thực hiện theo quy trình rồi tạo Mã ứng dụng TikTok và Bí mật ứng dụng của bạn.

   
   
   

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

1. Để khởi tạo SDK, bạn cần chuẩn bị sẵn Mã ứng dụng, Mã ứng dụng TikTok và Bí mật ứng dụng từ bước 1.

   1. Minh họa về Mã ứng dụng và Mã ứng dụng TikTok:

      
      
      

   2. Minh họa về Bí mật ứng dụng:

      
      
      

2. Tải SDK trên GitHub. Hiện tại, chúng tôi hỗ trợ Native iOS SDK (SDK iOS gốc), Native Android SDK (SDK Android gốc) và Unity SDK (SDK Unity).

Bước 3: Đăng lại sự kiện qua SDK

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

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

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

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

   3. Tỷ lệ giữ chân ngày 2: Ứng dụng được mở lại vào ngày kế tiếp sau ngày mở đầu tiên.

   4. Mua hàng: Đã hoàn thành thanh toán thành công cho sản phẩm tiêu hao/không tiêu hao/gói đăng ký.

      1. Đảm bảo tính năng đăng lại lượt mua hàng tự động ghi nhật ký phù hợp với yêu cầu kinh doanh của bạn trước khi bật tính năng này. Xem thêm thông tin chi tiết về sự kiện lượt mua hàng tự động ghi nhật ký trên iOS và sự kiện lượt mua hàng tự động ghi nhật ký trên Android.

Lưu ý đặc biệt về sự kiện lượt mua hàng tự động ghi nhật ký: SDK có thể tự động ghi nhận các giao dịch được thực hiện thông qua StoreKit (iOS) hoặc Google Play Billing (Android). Để truyền thêm các thuộc tính và tham số hoặc nếu bạn không sử dụng cổng thanh toán gốc của Apple hoặc Google, chúng tôi khuyến nghị bạn sử dụng đăng lại lượt mua hàng thủ công.

Bước 4: [iOS] Đo lường sự kiện SKAN

Trong môi trường SKAdNetwork (SKAN), chúng tôi khuyến nghị 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 cho SKAdNetwork, hãy đảm bảo thêm disableSKAdNetworkSupport() vào cấu hình của bạn để tránh xung đột khi cập nhật.

Xác định xem bạn có cần bật đo lường SKAN của TikTok SDK hay không:

Nếu bạn có MMP:

• SDK MMP cập nhật giá trị lượt chuyển đổi (CV) và bạn dự định sử dụng lược đồ SKAN của MMP: Tắt hỗ trợ SKAdNetwork trong TikTok SDK và không tải lược đồ lên Trình quản lý sự kiện TikTok. (MMP của bạn sẽ tiếp tục là nguồn đáng tin cậy duy nhất cho việc cập nhật CV và lược đồ.)

Nếu bạn KHÔNG có MMP:

Đảm bảo rằng chỉ có một SDK trong ứng dụng của bạn cập nhật giá trị lượt chuyển đổi SKAN.

• Một SDK không phải MMP khác đang cập nhật CV: Tắt hỗ trợ SKAdNetwork trong TikTok SDK nhưng tải lược đồ lên Trình quản lý sự kiện TikTok. (TikTok sẽ sử dụng lược đồ của bạn nhưng sẽ không thực hiện các cập nhật CV trùng lặp.)

• TikTok SDK chịu trách nhiệm cập nhật CV: Bật hỗ trợ SKAdNetwork trong TikTok SDK và tải lược đồ lên Trình quản lý sự kiện TikTok. (TikTok trở thành bên xử lý chính cho việc cập nhật CV SKAN.)

Để biết thêm chi tiết, hãy tham khảo tài liệu dành cho nhà phát triển về SDK sự kiện ứng dụng.

Bước 5: Xác minh đăng lại theo thời gian thực bằng chế độ gỡ lỗi

Từ phiên bản SDK 1.5.0, có hai phương thức để người dùng xác minh việc tích hợp SDK trước khi phát hành:

• (Khuyến nghị) Chế độ thử nghiệm sự kiện dựa trên mã truy cập; việc này được thực hiện hoàn toàn trong Trình quản lý sự kiện TikTok và không yêu cầu sửa đổi mã.

• Chế độ gỡ lỗi thủ công, yêu cầu sửa đổi. Khi sử dụng gỡ lỗi thủ công, hãy nhớ tắt chế độ gỡ lỗi trước khi phát hành ứng dụng. Các sự kiện được tạo khi sử dụng một trong các công cụ này sẽ trải qua quy trình thử nghiệm và không thể dùng cho báo cáo.

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

    

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

    

Bước 6: Phát hành phiên bản ứng dụng mới có TikTok SDK lên App Store (iOS) / Play Store (Android)

Bạn có thể thấy sự kiện SDK xuất hiện trên tab Báo cáo trong Trình quản lý sự kiện khi TikTok bắt đầu nhận tín hiệu theo thời gian thực từ SDK của bạn. Các tín hiệu ở chế độ thử nghiệm sẽ không hiển thị tại đây.

Bước 7: 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 cho 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 cho Sự kiện ứng dụng làm danh mục vấn đề.