Kiểm tra trạng thái SDK

Để bắt đầu sử dụng công cụ này để gỡ lỗi và theo dõi các sự kiện theo thời gian thực từ ứng dụng của bạn:

1. Di chuột đến mục “Chẩn đoán” ở góc trên bên trái của bảng điều khiển. Nhấp vào Thiết bị thử nghiệm để thêm thiết bị thử nghiệm của bạn.

2. Nhấp vào + Thiết bị thử nghiệm mới để thêm một thiết bị mà Tenjin sẽ phát hiện khi bạn gửi các sự kiện đến hệ thống Tenjin.

3. Chọn ứng dụng của bạn và nhập ID quảng cáo của thiết bị thử nghiệm. Chúng tôi sử dụng IDFA hoặc IDFV cho mô hình iOS và GAID (Google Advertising ID) cho mô hình Android; vui lòng tìm kiếm trên mạng để xác định ID quảng cáo của thiết bị thử nghiệm của bạn.

4. Quay lại công cụ Live Event và mở ứng dụng của bạn bằng Tenjin SDK đã được cài đặt trên thiết bị thử nghiệm mà bạn đã gửi ID quảng cáo của mình. Nếu các sự kiện của bạn được kích hoạt chính xác, bạn sẽ thấy kết quả tương tự như sự kiện dưới đây. Nếu bạn vừa đăng ký thiết bị thử nghiệm, vui lòng đợi tối đa 3 giờ trước khi kích hoạt sự kiện.

Bảng điều khiển Tenjin cho phép bạn kiểm tra xem SDK Tenjin đã được tích hợp đúng cách cho từng ứng dụng hay chưa, theo thời gian thực. Nếu bạn chọn ứng dụng mà bạn đang tích hợp từ tab “Ứng dụng”, bạn có thể xem tất cả các sự kiện liên quan để đảm bảo SDK Tenjin đã được thiết lập đúng cách trong quá trình thực hiện tích hợp.

Bạn có thể xem phiên bản ứng dụng, số phiên, lượt cài đặt từ Apple Search Ads, số lần hiển thị qua Ad Mediation (ILRD), giao dịch mua trong ứng dụng (IAP) có biên lai, cũng như bất kỳ sự kiện tùy chỉnh nào đang được kích hoạt đúng cách.

Việc tuân thủ danh sách kiểm tra bằng cách sử dụng công cụ gỡ lỗi trước khi gửi ứng dụng là rất quan trọng.

Nếu bạn đang sử dụng ứng dụng TestFlight, bạn sẽ không thấy sự kiện này trong công cụ SDK Live Event, ngay cả khi bạn đã đăng ký advertising_id. Điều này là do TestFlight sử dụng advertising_id mới mỗi khi người dùng mở ứng dụng, theo chính sách của Apple.

1. Sự kiện ra mắt ứng dụng

Hãy đảm bảo rằng bạn sẽ thấy sự kiện mở ứng dụng diễn ra đúng thời điểm dự kiến. Sự kiện mở ứng dụng sẽ diễn ra tự động khi SDK được khởi tạo, tùy thuộc vào vòng đời hoạt động của ứng dụng mà bạn đã chọn.

2. Số lượt cài đặt qua Apple Search (iOS)

Tenjin tự động lấy dữ liệu phân bổ quảng cáo Apple Ads thông qua SDK của chúng tôi. Bạn không cần thực hiện bất kỳ cài đặt chiến dịch bổ sung nào (liên kết theo dõi, callback, v.v.). Hướng dẫn tích hợp: Bộ công cụ phát triển phần mềm (SDK) Tenjin iOS

3. Cài đặt Android Referrer

Tham chiếu Android được sử dụng để theo dõi trong trường hợp không có ID quảng cáo. Hãy kiểm tra các nội dung sau:

• Hãy đảm bảo rằng bạn đã thêm Thư viện Install Referrer của Google.

dependencies {
	  implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
	  implementation 'com.android.installreferrer:installreferrer:{version}'
	}

dependencies {
	  implementation 'com.google.android.gms:play-services-ads-identifier:{version}'
	  implementation 'com.android.installreferrer:installreferrer:{version}'
	}

4. Mua qua IAP

Trong Tenjin có 6 trạng thái mua hàng (purchase_states). Các giao dịch IAP được thực hiện từ tài khoản sandbox sẽ có purchase_state = 4. Chỉ trạng thái mua hàng (purchase_state) 3 mới được hiển thị trên bảng điều khiển báo cáo, do đó việc kiểm thử bằng công cụ SDK Live Tool (nơi duy nhất bạn có thể xem các giao dịch IAP từ tài khoản sandbox) là rất quan trọng. Giá trị giao dịch IAP sẽ được tính theo số thập phân, ví dụ: 1.99.

Khi thực hiện giao dịch mua hàng, hãy đảm bảo rằng mã tiền tệ, giá cả, mã sản phẩm (product_ids) và số lượng được gửi chính xác bằng cách thử nhiều cách kết hợp khác nhau của các tham số mua hàng. Ví dụ: hãy thử mua hàng bằng Yên, USD hoặc CAD.

The different purchase states in Tenjin are:  
0 = UNKNOWABLE (there was no receipt and there is no way for tenjin to validate with the app store)
1 = UNVERIFIED (there was a receipt but there was an error with the app store validation)  
2 = FRAUDULENT (the purchase was fraudulent)  
3 = VERIFIED (the receipt was successfully validated with the app store)  
4 = SANDBOX (this was a test purchase)
5 = DUPLICATE (there are duplicate purchases sent for the same transaction_id)
6 = STALE (the purchase event happened 3 days ago and not in real time)

The different purchase states in Tenjin are:  
0 = UNKNOWABLE (there was no receipt and there is no way for tenjin to validate with the app store)
1 = UNVERIFIED (there was a receipt but there was an error with the app store validation)  
2 = FRAUDULENT (the purchase was fraudulent)  
3 = VERIFIED (the receipt was successfully validated with the app store)  
4 = SANDBOX (this was a test purchase)
5 = DUPLICATE (there are duplicate purchases sent for the same transaction_id)
6 = STALE (the purchase event happened 3 days ago and not in real time)

5. Doanh thu từ đăng ký (nếu có)
6. Sự kiện tùy chỉnh

Hãy đảm bảo rằng bạn đã kiểm tra tất cả các sự kiện tùy chỉnh mà bạn đã triển khai để đảm bảo giá trị và tên sự kiện đều chính xác.

7. Lượt hiển thị qua nền tảng trung gian quảng cáo

Tenjin hỗ trợ khả năng tích hợp với tính năng Doanh thu quảng cáo theo số lần hiển thị (ILRD) từ:

• AppLovin MAX
• Chơi các màn chơi trong Unity
• AdMob
• TopOn
• CAS
• Tradplus
  

Tính năng này cho phép bạn nhận các sự kiện tương ứng với doanh thu quảng cáo của bạn bị ảnh hưởng bởi từng quảng cáo được hiển thị cho người dùng.