Đo lường lượt Gỡ cài đặt

Đo lường lượt Gỡ cài đặt Android

Đo lường lượt gỡ cài đặt bằng Firebase Messaging được hỗ trợ kể từ Android SDK phiên bản 4.7.0.

1. Lấy Khóa Máy chủ Firebase

1. Tạo một dự án Ứng dụng Android Firebase (nếu bạn chưa tạo) hoặc di chuyển dự án của bạn từ Bảng điều khiển dành cho Nhà phát triển Google (theo hướng dẫn tại đó). Để biết thêm thông tin, hãy truy cập Firebase. 
2. Mở Bảng điều khiển Firebase.
3. Trong trang Giao diện điều khiển Firebase, điều hướng tới Cài đặt Dự án (nhấp vào bánh răng kế bên Tổng quan ở ổ vuông bên trái của trang).
4. Trong tab Cloud Messaging, bạn có thể thấy hai Mã khóa Máy chủ (xem ảnh chụp màn hình bên dưới):
   
   
5. Sao chép Khóa máy chủ.

2. Nhập Khóa Máy chủ trên Bảng điều khiển AppsFlyer

1. Truy cập bảng điều khiển của ứng dụng trên nền tảng AppsFlyer.
2. Chọn Thiết lập Ứng dụng từ menu bên trái.

   

3. Thiết lập Khóa Máy chủ Firebase với Khóa máy chủ bạn vừa sao chép.

3. Cấu hình Firebase-Messaging trên Ứng dụng của bạn

1. Tải xuống google-services.json từ giao diện điều khiển Firebase.
2. Thêm google-services.json vào thư mục mô-đun ứng dụng của bạn,
3. Thêm quy tắc vào tệp tin build.gradle cấp độ root của bạn để bao gồm trình cắm google-services:

   buildscript { 
       // ... 
       dependencies { 
         // ... 
         classpath 'com.google.gms:google-services:4.2.0' // google-services plugin 
       } 
     }
   

4. Thêm thuộc tính phụ thuộc FCM vào build.gradle trong ứng dụng của bạn

   dependencies {
      implementation 'com.google.firebase:firebase-messaging:17.3.4'
   }
   
   // ADD THIS AT THE BOTTOM 
   apply plugin: 'com.google.gms.google-services
   

Có thể tải phiên bản Firebase mới nhất tại đây: Tài liệu chính thức của Firebase.

Nếu bạn nhận được lỗi "Không tìm được..", hãy bảo đảm rằng bạn đã có Google Repository mới nhất trong Trình quản lý Android SDK. 

4. Triển khai Dịch vụ Đo lường lượt Gỡ cài đặt của AppsFlyer

<application
   <!-- ... -->
      <service
        android:name="com.appsflyer.FirebaseMessagingServiceListener">
        <intent-filter>
          <action android:name="com.google.firebase.MESSAGING_EVENT"/>
        </intent-filter>
      </service>
   <!-- ... -->
</application>

import com.appsflyer.AppsFlyerLib;
import com.google.firebase.messaging.FirebaseMessagingService;

public class MyNewFirebaseManager extends FirebaseMessagingService {

    @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
    }
}

AppsFlyerLib.getInstance().updateServerUninstallToken(getApplicationContext(), refreshedToken); 

<service
    android:name=".MyNewFirebaseManager">
    <intent-filter>
        <action android:name="com.google.firebase.MESSAGING_EVENT" />
    </intent-filter>
</service>

@Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        
        if(remoteMessage.getData().containsKey("af-uinstall-tracking")){
            return;
        } else {
           // handleNotification(remoteMessage);
        }
    }

5. Sử dụng ProGuard với Đo lường lượt Gỡ cài đặt

Nếu bạn đang sử dụng ProGuard, hãy thêm quy tắc sau:

-dontwarn com.appsflyer.**
-keep public class com.google.firebase.messaging.FirebaseMessagingService {
  public *;
}

6. Thử nghiệm Đo lường lượt Gỡ cài đặt cho Android

Số liệu Lượt gỡ cài đặt có sẵn 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 báo cáo dữ liệu thô về lượt gỡ cài đặt.

Để thử nghiệm đo lường lượt gỡ cài đặt trên Android:

1. Cài đặt ứng dụng.
2. Gỡ cài đặt ứng dụng.  Lưu ý! Bạn có thể gỡ cài đặt ứng dụng ngay sau khi cài đặt.
   Sự kiện gỡ cài đặt đăng ký trong vòng 24 giờ vì quá trình đ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 thời gian này - thì sẽ không có sự kiện gỡ cài đặt nào được ghi nhận.

Sự kiện gỡ cài đặt ứng dụng mất tới 48 giờ để hiển thị trong báo cáo dữ liệu thô và trong Báo cáo Hiệu suất Hợp nhất trong bảng điều khiển AppsFlyer của bạn.

Dù ứng dụng Android đang có trên Google Play, đang chờ gửi hoặc thậm chí không có trên cửa hàng - thì quy trình thử nghiệm đều giống nhau.

7. Tắt đo lường lượt gỡ cài đặt

Nếu bạn cung cấp Mã khóa Máy chủ GCM/Firebase, thì tính năng đo lường lượt gỡ cài đặt ứng dụng được bật theo mặc định. Chủ sở hữu ứng dụng có thể tắt tính năng này thông qua bảng điều khiển.

Lưu ý! Để báo cáo lượt gỡ cài đặt, bạn phải bật tính năng Enable uninstalls measurement (Bật đo lường lượt gỡ cài đặt) ở thời điểm cài đặt ứng dụng. Lượt cài đặt xảy ra khi tính năng Enable uninstalls measurement (Bật đo lường lượt gỡ cài đặt) đang tắt sẽ không được báo cáo. 

Để tắt đo lường lượt gỡ cài đặt:

1. Trong AppsFlyer, đi tới App settings (Cài đặt ứng dụng).
2. Cuộn đến Attribution (Phân bổ) > Uninstalls (Lượt gỡ cài đặt) và tắt tùy chọn Enable uninstall measurement (Bật đo lường lượt gỡ cài đặt).
   

   

Đo lường lượt Gỡ cài đặt iOS

Việc đo lường lượt gỡ cài đặt trên iOS được thực hiện bằng cách sử dụng dịch vụ Thông báo Đẩy của Apple HTTP/2 (APN).

1. Tìm ứng dụng của bạn

2.  Nếu bạn chưa đăng ký ID ứng dụng, hãy nhấp vào biểu tượng + và hoàn thành biểu mẫu.

3.  Đánh dấu chọn ô Thông báo đẩy.

4.  Khi bạn mở rộng ứng dụng, có hai cài đặt cho thông báo đẩy với biểu tượng trạng thái màu vàng và xanh lá:

5.  Nhấp vào Cài đặt để tiếp tục.

2. Tạo chứng chỉ của bạn

3. Gia hạn chứng chỉ của bạn

Nếu bạn gia hạn Chứng chỉ Push SSL Sản xuất hoặc Phát triển, hãy làm theo các bước được chỉ ra bên trên giống như khi tải chứng chỉ lên lần đầu tiên. Không cần thu hồi chứng chỉ trước đó để thực hiện thay đổi này. Có thể có hai chứng chỉ sản xuất cùng một lúc, cho phép bạn tiếp tục sử dụng chứng chỉ cũ trong khi tải lên chứng chỉ mới.

4. Xuất tập tin P12

Bước cuối cùng trước khi chuyển qua bảng điều khiển của AppsFlyer là lưu chứng chí ký tên thành một tệp tin .p12.

1.  Chọn chứng chỉ vừa được thêm vào Truy cập Chuỗi khóa 

2. Truy cập Tập tin > Xuất Khoản mục .

3.  Chọn Chứng chỉ của tôi dưới menu Danh mục ở phía dưới cạnh bên trái.

Nếu Chứng chỉ của tôichưa được tô sáng, bạn không thể xuất chứng chỉ thành tệp tin .p12. build.gradle.

3.  Khi lưu tệp tin, hãy dùng định dạng  Trao đổi Thông tin Cá nhân (.p12)  .

4.  Bảo đảm rằng nội dung ghi Dịch vụ Đẩy của Apple và hiển thị như sau:

5.  Truy cập bảng điều khiển của ứng dụng trên nền tảng AppsFlyer.

6. Chọn Cài đặt Ứng dụng ở menu bên trái.

7. Nhấp vào biểu tượng tải lên, chọn tập tin P12 để tải lên. 

8. (tùy chọn) Nếu chứng chỉ P12 được bảo vệ bằng mật khẩu, hãy điền mật khẩu vào phần Mật khẩu chứng chỉ P12. 

9.  Nhấp vào Xác thực để gửi chứng chỉ tới AppsFlyer cho mục đích kiểm tra tính hợp lệ. 

10.  Nhấp vào Lưu cài đặt.

5. Tích hợp với SDK

Thông báo đẩy phải được đăng ký ở cấp độ mã nguồn của ứng dụng để bật thu thập dữ liệu gỡ cài đặt.

	//add UserNotifications.framework
	import UserNotifications
	func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool {
    //...
    // iOS 10 support
    if #available(iOS 10, *) {
      UNUserNotificationCenter.current().requestAuthorization(options:[.badge, .alert, .sound]){ (granted, error) in }
      application.registerForRemoteNotifications()
    }
    // iOS 9 and iOS 8 support
    else if #available(iOS 8, *), #available(iOS 9, *) {
      UIApplication.shared.registerUserNotificationSettings(UIUserNotificationSettings(types: [.badge, .sound, .alert], categories: nil))
      UIApplication.shared.registerForRemoteNotifications()
    }

    // iOS 7 support
    else {
      application.registerForRemoteNotifications(matching: [.badge, .sound, .alert])
    }
    
    return true
  }

 // Called when the application sucessfuly registers for push notifications
  func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
    AppsFlyerTracker.shared().registerUninstall(deviceToken)
  }

- #import <UserNotifications/UserNotifications.h>
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The userNotificationTypes below is just an example and may be changed depending on the app
 UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
          center.delegate = self;
          [center requestAuthorizationWithOptions:(UNAuthorizationOptionSound | UNAuthorizationOptionAlert | UNAuthorizationOptionBadge) completionHandler:^(BOOL granted, NSError * _Nullable error) {
          }];
   [[UIApplication sharedApplication] registerForRemoteNotifications];
    // if you do not use push notificaiton in your app, uncomment the following line
    //application.applicationIconBadgeNumber = 0;
  }
  - (void)application:(UIApplication *)application didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
    [[AppsFlyerTracker sharedTracker] registerUninstall:deviceToken];
  }
  }

#import <AppsFlyerLib/AppsFlyerTracker.h>
@interface AppDelegate : UIResponder <UIApplicationDelegate, AppsFlyerTrackerDelegate>

Đoạn mã ở trên yêu cầu quyền từ người dùng để gửi các thông báo đẩy. Tuy nhiên, nếu bạn chỉ dùng thông báo đẩy trong chế độ nền để đo lường lượt gỡ cài đặt thì không cần yêu cầu người dùng phê duyệt. Điều này là vì các thông báo đẩy này là các thông báo đẩy im lặng mà không bắt buộc bạn yêu cầu quyền từ người dùng.

Quyền của người dùng cho thông báo đẩy ở chế độ nền 

Nếu bạn chỉ đang dùng thông báo đẩy im lặng, hãy đảm bảo bật Thông báo từ xa trong Chế độ nền trong Tính năng của ứng dụng:

1. Trong XCode, hãy chọn dự án của bạn
2. Chọn mục tiêu của bạn
3. Đổi sang tab Tính năng
4. Bật Chế độ nền
5. Chọn Thông báo từ xa
   
   

6. Thông báo đẩy

Hãy chắc chắn rằng bạn đã thêm Thông báo đẩy trong tab năng lực XCode của bạn. Nếu không, deviceToken sẽ không được thu thập.

7. Thử nghiệm Gỡ cài đặt

Để thử nghiệm đo lường lượt gỡ cài đặt trên iOS:

1. Cài đặt ứng dụng.
2. Gỡ cài đặt ứng dụng.  Lưu ý! Bạn có thể gỡ cài đặt ứng dụng ngay sau khi cài đặt. 

Khi thử nghiệm lượt gỡ cài đặt từ Xcode hoặc TestFlight, điều quan trọng là phải cho SDK của chúng tôi biết rằng mã thông báo được tạo từ môi trường Sandbox. Sử dụng những API dưới đây:

AppsFlyerTracker.shared().useUninstallSandbox = true

[AppsFlyerTracker sharedTracker].useUninstallSandbox = true;

Lưu ý! Số lượt gỡ cài đặt không xuất hiện ngay trong bảng điều khiển AppsFlyer:

• Trung bình mất 9 ngày để lượt gỡ cài đặt xuất hiện trong báo cáo
• Có thể mất hơn một tháng để lượt gỡ cài đặt bắt nguồn từ môi trường sandbox xuất hiện trong báo cáo

Ngoài ra, ngày gỡ cài đặt là ngày lượt gỡ cài đặt được báo cáo. Xem phần tiếp theo để tìm hiểu thêm.

8. Xem Dữ liệu Gỡ cài đặt trong Bảng điều khiển AppsFlyer

Đo lường lượt gỡ cài đặt được hiển thị trên bảng điều khiển chính trong bảng Hoạt động Tổng hợp.

Do có  thay đổi gần đây trong dịch vụ Thông báo Đẩy của Apple, thời gian cần gỡ cài đặt để xuất hiện trên bảng điều khiển là tối thiểu 9 ngày. AppsFlyer cập nhật và tổng hợp số liệu gỡ cài đặt sau mỗi 24 tiếng

Để biết thêm chi tiết, vui lòng tham khảo phần iOS Đo lường lượt Gỡ cài đặt Ứng dụng của Hướng dẫn Tích hợp SDK.

9. Tắt đo lường lượt gỡ cài đặt

Nếu chứng chỉ P12 được cung cấp và xác thực, tính năng đo lường lượt gỡ cài đặt ứng dụng được bật theo mặc định. Chủ sở hữu ứng dụng có thể tắt tính năng này thông qua bảng điều khiển.

Lưu ý! Để báo cáo lượt gỡ cài đặt, bạn phải bật tính năng Enable uninstalls measurement (Bật đo lường lượt gỡ cài đặt) ở thời điểm cài đặt ứng dụng. Lượt cài đặt xảy ra khi tính năng Enable uninstalls measurement (Bật đo lường lượt gỡ cài đặt) đang tắt sẽ không được báo cáo. 

Để tắt đo lường lượt gỡ cài đặt:

1. Trong AppsFlyer, đi tới App settings (Cài đặt ứng dụng).
2. Cuộn đến Attribution (Phân bổ) > Uninstalls (Lượt gỡ cài đặt) và tắt tùy chọn Enable uninstall measurement (Bật đo lường lượt gỡ cài đặt).
   

   

Gỡ cài đặt các Postback Sự kiện

AppsFlyer cho phép bạn gửi đăng lại sự kiện gỡ cài đặt, cho mọi người dùng gỡ cài đặt đã biết, đến các đối tác bạn làm việc cùng. Sự kiện gỡ cài đặt được gọi là af_uninstall trong bảng điều khiển của AppsFlyer.

Ánh xạ Sự kiện Gỡ cài đặt

Bạn có thể ánh xạ sự kiện af_uninstall giống như ánh xạ bất kỳ sự kiện trong ứng dụng nào của ứng dụng của bạn.

Như với bất kỳ sự kiện trong ứng dụng nào, AppsFlyer chỉ có thể gửi postback nếu sự kiện thực sự xảy ra và được AppsFlyer ghi lại. Do đó,ánh xạ af_uninstall chỉ hoạt động khi việc thực hiện gỡ cài đặt được hoàn thành. Nếu bạn không thấy các lượt gỡ cài đặt trong trang tổng quan hoặc trong báo cáo dữ liệu thô lượt gỡ cài đặt, sẽ không có postback gỡ cài đặt nào được gửi cho đối tác, ngay cả khi bạn đã ánh xạ sự kiện af_uninstall.

Tính thời gian af_uninstall

Không giống như đăng lại dành cho các sự kiện trong ứng dụng thông thường, sự kiện af_uninstall không được gửi đi theo thời gian thực.

Trong dữ liệu thô của AppsFlyer và các đăng lại của đối tác, thời gian ghi lại sự kiện af_uninstall là thời điểm AppsFlyer biết về sự kiện gỡ cài đặt.

• Đối với thiết bị Android: 24-48 giờ sau khi gỡ cài đặt ứng dụng thực tế
• Đối với thiết bị iOS: 9-11 ngày sau khi gỡ cài đặt ứng dụng thực tế

Điểm hạn chế

Các sự kiện af_uninstall không được đưa vào báo cáo postback sự kiện trong ứng dụng.

Sự kiện af_uninstall hiện không khả dụng cho tất cả các đối tác.

Nếu bạn muốn lập bản đồ với một đối tác, nhưng thấy sự kiện không khả dụng cho đối tác, hãy liên hệ với CSM của bạn hoặc viết thư tới hello@appsflyer.com.

Nếu bạn là đối tác và muốn nhận được các sự kiện af_uninstall, hãy liên hệ với PDM của bạn hoặc liên hệ với partners@appsflyer.com.