Đo lường lượt Gỡ cài đặt
Tổng quan
Thiết lập đo lường lượt gỡ cài đặt trong ứng dụng Android bằng SDK AppsFlyer và Firebase Cloud Messaging.
Tích hợp tính năng đo lường lượt gỡ cài đặt trên Android
Tài liệu này đề cập về việc tích hợp tính năng đo lường lượt gỡ cài đặt cho các trường hợp sau:
- Các ứng dụng đã sử dụng FCM
- Các ứng dụng không sử dụng FCM.
Bạn có thể tìm thấy phiên bản máy khách FCM mới nhất tại đây.
Apps using FCM
Để thêm tính năng đo lường lượt gỡ cài đặt vào tích hợp FCM hiện có:
in the onNewToken()
ghi đè, hãy gọi ra updateServerUninstallToken
:
@Override
public void onNewToken(String s) {
super.onNewToken(s);
// Sending new token to AppsFlyer
AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), s);
// the rest of the code that makes use of the token goes in this method as well
}
Apps not using FCM
Để tích hợp tính năng đo lường lượt gỡ cài đặt:
- Tải xuống
google-services.json
from Firebase console. - Thêm
google-services.json
vào thư mục mô-đun ứng dụng - Thêm các phần phụ thuộc sau vào tệp tin cấp thư mục gốc
build.gradle
file:buildscript { // ... dependencies { // ... classpath 'com.google.gms:google-services:4.2.0' // google-services plugin } }
- Trong
build.gradle
cấp ứng dụng, hãy thêm các phần phụ thuộc sau:Lưu ý: Nếu bạn gặp lỗi "Could not find method implementation()..." (Không thể tìm thấy phương thức thực hiện ()...), hãy đảm bảo rằng bạn có Kho lưu trữ Google mới nhất trong Trình quản lý SDK Android.dependencies { // ... implementation 'com.google.firebase:firebase-messaging:23.0.3' implementation 'com.google.firebase:firebase-core:20.1.2' // ... }

- Nếu bạn chỉ sử dụng FCM để đo lường lượt gỡ cài đặt trong AppsFlyer, hãy sử dụng dịch vụ
appsFlyer.FirebaseMessagingServiceListener
, được nhúng trong SDK. Điều này mở rộng lớpFirebaseMessagingService
, được sử dụng để nhận Token Thiết bị FCM và gọi raupdateServerUninstallToken
. Để thêm dịch vụappsFlyer.FirebaseMessagingServiceListener
vào ứng dụng:Nếu không, ghi đè phương thức<application <!-- ... --> <service android:name="com.appsflyer.FirebaseMessagingServiceListener"> <intent-filter> <action android:name="com.google.firebase.MESSAGING_EVENT"/> </intent-filter> </service> <!-- ... --> </application>
FirebaseMessagingService.onNewToken()
và gọiupdateServerUninstallToken
:@Override public void onNewToken(String s) { super.onNewToken(s); // Sending new token to AppsFlyer AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), s); // the rest of the code that makes use of the token goes in this method as well }
Lưu ý
Nếu bạn sử dụng ProGuard, hãy đảm bảo thêm quy tắc sau:
-dontwarn com.appsflyer.** -keep public class com.google.firebase.messaging.FirebaseMessagingService { public *; }
Thử nghiệm đo lường lượt gỡ cài đặt trên Android
Quy trình thử nghiệm được mô tả có hiệu lực với các ứng dụng có sẵn thông qua Cửa hàng Google Play, đang chờ xử lý, tải xuống trực tiếp và thông qua các cửa hàng ứng dụng thay thế.
- Bạn có thể tìm thấy số liệu Lượt gỡ cài đặt trong bảng điều khiển Tổng quan.
- Danh sách người dùng gỡ cài đặt ứng dụng có sẵn trong phần gỡ cài đặt [báo cáo dữ liệu thô].(https://support.appsflyer.com/hc/en-us/articles/209680773-Raw-data-reporting-overview#user-journey-report-availability).
Để thử nghiệm đo lường lượt gỡ cài đặt trên Android:
- Cài đặt ứng dụng.
- Gỡ cài đặt ứng dụng. Bạn có thể gỡ cài đặt ứng dụng ngay sau khi cài đặt.
- Chờ lượt gỡ cài đặt xuất hiện trong bảng điều khiển. Quá trình này có thể mất đến 48 giờ.
Những điều cần lưu ý
- Sự kiện gỡ cài đặt sẽ được ghi nhận trong vòng 24 giờ vì việc đo lường lượt gỡ cài đặt được xử lý hàng ngày.
- Nếu ứng dụng được cài đặt lại trong khoảng thời gian này thì sẽ không có sự kiện gỡ cài đặt nào được ghi nhận.
Ghi đè onMessageReceived
onMessageReceived
Ghi đè onMessageReceived
và triển khai logic của riêng bạn
vào phương thức này có thể khiến thông báo đẩy lượt gỡ cài đặt không ở chế độ im lặng. Điều này có thể ảnh hưởng đến trải nghiệm người dùng. Để ngăn chặn tình trạng này, hãy xác nhận rằng thông báo có chứa af-uinstall-tracking
. Xem ví dụ sau:
@Override
public void onMessageReceived(RemoteMessage remoteMessage) {
if(remoteMessage.getData().containsKey("af-uinstall-tracking")){ // "uinstall" is not a typo
return;
} else {
// handleNotification(remoteMessage);
}
}
Đã cập nhật 8 ngày trước