Đ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ợ 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 thực hiện) hoặc di chuyển dự án của bạn từ Giao diện 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 liên kết sau: https://firebase.google.com/docs/cloud-messaging/android/client.
2. Mở Giao diện Điều khiển Firebase https://console.firebase.google.com
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 Khóa máy chủ của mình (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>

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.iid.FirebaseInstanceId {
  public *;
}

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

Thử nghiệm đo lường lượt gỡ cài đặt của Android rất đơn giả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, việc thử nghiệm đều giống nhau - chỉ cần gỡ cài đặt ứng dụng khỏi thiết bị.

Hãy chờ tối đa 24 giờ để sự kiện gỡ cài đặt ứng dụng mới được hiển thị trên bảng báo cáo hoạt động tổng hợp của bảng điều khiển và trên báo cáo dữ liệu thô các lượt gỡ cài đặt.

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

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

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ôi chư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 Chọn tệp tin để chọn tệp tin .p12 của bạn.

8.  Nhập mật khẩu cho tệp tin .p12 (không phải mật khẩu chứng chỉ).

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

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // The userNotificationTypes below is just an example and may be changed depending on the app
    UIUserNotificationType userNotificationTypes = (UIUserNotificationTypeAlert |
                          UIUserNotificationTypeBadge |
                          UIUserNotificationTypeSound);
    UIUserNotificationSettings *settings = [UIUserNotificationSettings settingsForTypes:userNotificationTypes
                                       categories:nil];
    [application registerUserNotificationSettings:settings];
    [application 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];
  }

Quyền người dùng cho thông báo đẩy 

Đ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 để thống kê lượt gỡ cài đặt, không cần có phê duyệt người dùng. Điều này là bởi các thông báo đẩy này là các thông báo đẩy im lặng mà không đòi hỏi bạn yêu cầu quyền từ người dùng.

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

Điều quan trọng cần nhớ là thử nghiệm một bản dựng cục bộ, bạn phải dùng TestFlight và giả lập bài thử nghiệm trên thiết bị thử nghiệm của bạn. Thử nghiệm từ Xcode chỉ hoạt động khi kiểm tra lượt gỡ cài đặt bằng thiết bị vật lý.

Khi kiểm tra gỡ cài đặt, đ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;

Không cần phải chờ đợi giữa lượt cài đặt và gỡ cài đặt. Bạn có thể cài đặt ứng dụng và gỡ cài đặt nó ngay lập tức.

Tuy nhiên, việc xem gỡ cài đặt thực tế trên bảng điều khiển của bạn có thể mất tới 9 ngày kể từ khi cài đặt. Ngoài ra, ngày gỡ cài đặt là 9 ngày sau ngày gỡ cài đặt thực tế. Xem phần bên dưới để 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.

Để 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.

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

AppsFlyer cho phép bạn gửi gỡ cài đặt postback sự kiện, 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

Mặc dù các postback cho các sự kiện trong ứng dụng thông thường được gửi theo thời gian thực, nhưng sự kiện af_uninstall thì không.

Thời gian sự kiện được ghi lại af_uninstall , trong dữ liệu thô của AppsFlyer và các postback đối tác, là thời điểm khi AppsFlyer biết về việc gỡ cài đặt. Điều này xảy ra trong vòng 24 giờ sau khi gỡ cài đặt ứng dụng thực tế.

Điểm hạn chế

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.