Tích hợp SDK Android cho những nhà phát triển

Sử dụng một trong các phương thức sau để thêm SDK vào ứng dụng của bạn:

• [Phương thức tốt nhất] Sử dụng Gradle
• Thêm SDK theo cách thủ công

Liên kết giới thiệu cài đặt Android cải thiện độ chính xác phân bổ, bảo vệ khỏi gian lận cài đặt và hơn thế nữa. Liên kết này được hỗ trợ từ Android SDK của AppsFlyer phiên bản 4.8.6.

Có hai cách để thêm người giới thiệu cài đặt vào ứng dụng của bạn:

• Sử dụng Gradle (khuyến nghị)
• Thêm người giới thiệu cài đặt theo cách thủ công

Thêm quyền truy cập giúp tăng tỷ lệ Phân bổ mô hình xác suất. Nó cũng cho phép SDK gửi thêm dữ liệu như Wifi và dữ liệu mạng của nhà mạng. Bạn có thể tìm thấy dữ liệu này trong báo cáo dữ liệu thô và sử dụng nó để phân tích và tối ưu hóa các chiến dịch.

Thêm quyền truy cập bắt buộc

1. Thêm các quyền truy cập sau vào AndroidManifest.xml:
   

   <uses-permission android:name="android.permission.INTERNET" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   

BroadcastReceiver lấy thông tin từ Google Play AppsFlyer sử dụng để phân bổ. Sử dụng BroadcastReceiver làm tăng tỷ lệ phân bổ.

Hai lựa chọn sau đây khả dụng cho việc thực hiện bộ phận thu nhận truyền phát tham chiếu cài đặt (Broadcast Receiver):

<application>
	<receiver android:name="com.appsflyer.SingleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			 <action android:name="com.android.vending.INSTALL_REFERRER" />
		 </intent-filter>
	</receiver>
</application>

<application>
	<receiver android:name="com.appsflyer.MultipleInstallBroadcastReceiver" android:exported="true">
		<intent-filter>
			<action android:name="com.android.vending.INSTALL_REFERRER" />
		</intent-filter>
	</receiver>
</application>

AppsFlyer sử dụng khóa dev để xác định duy nhất tài khoản của bạn. Khóa dev là bắt buộc vì khóa cho phép SDK gửi và truy xuất dữ liệu một cách an toàn thuộc tài khoản AppsFlyer của bạn.

Cảnh báo! Việc sử dụng sai dev key hoặc dev key không chính xác sẽ ảnh hưởng đến tất cả lưu lượng truy cập được gửi từ SDK và gây sự cố phân bổ và báo cáo.

Để lấy khóa dev của bạn:

1. Đi tới bảng điều khiển ứng dụng của bạn 
2. Trong bảng điều khiển, trong phần Configuration (Cấu hình), nhấp vào App Settings (Cài đặt Ứng dụng).
3. Sao chép khóa dev của bạn.
   

   

Đăng ký lớp ứng dụng toàn cầu

Trong tệp tin AndroidManifest.xml, bên trong thẻ application (ứng dụng), hãy thêm dòng sau:

android:name="<APP.PACKAGE.NAME>.<AFApplication>"

• <APP.PACKAGE.NAME> - thay thế tên này bằng tên gói ứng dụng.
• <AFApplication> - thay thế tên này bằng tên mà bạn đặt cho lớp ứng dụng toàn cầu.

Dòng này trong tệp manifest.xml cho ứng dụng biết ứng dụng toàn cầu là gì. Như đã đề cập ở trên, thao tác như vậy giúp cho SDK AppsFlyer có thể được truy cập toàn cầu trong toàn bộ ứng dụng.

Khởi tạo SDK

Chúng tôi khuyên bạn nên khởi tạo SDK bên trong lớp ứng dụng toàn cầu của ứng dụng. Điều này cho phép SDK khởi tạo trong tất cả các tình huống, bao gồm cả liên kết sâu.

Các bước được liệt kê dưới đây diễn ra bên trong lớp ứng dụng toàn cầu của ứng dụng.

1. Trong lớp toàn cầu của ứng dụng, nhập các thư viện sau
   

   import com.appsflyer.AppsFlyerLib;
   import com.appsflyer.AppsFlyerConversionListener;

2. Trong lớp chung, hãy gán dev key của bạn vào một biến, tốt nhất tên là AF_DEV_KEY.
   
   Java Kotlin

   public class AFApplication extends Application {
       private static final String AF_DEV_KEY = "qrdZGj123456789";
       
       //...
       
   }
   

   class AFApplication : Application() {
       private val devKey = "qrdZGj123456789";
   
       //...
       
   }
   

3. Bên trong lớp toàn cầu, sau lệnh gọi super.onCreate () , triển khai AppsFlyerConversionListener . Xem mã dưới đây trong bước 4.
4. Bên trong lớp chung, sau ConversionListener, hãy khởi tạo SDK bằng phương thức init(). 
   
   Java Kotlin

   public class AFApplication extends Application {
       private static final String AF_DEV_KEY = "qrdZGj123456789";
       
       @Override
       public void onCreate() {
           super.onCreate();
           AppsFlyerConversionListener conversionListener = new AppsFlyerConversionListener() {
               @Override
               public void onConversionDataSuccess(Map<String, Object> conversionData) {
               
                       for (String attrName : conversionData.keySet()) {
                       Log.d("LOG_TAG", "attribute: " + attrName + " = " + conversionData.get(attrName));
                   }
               }
   
               @Override
               public void onConversionDataFail(String errorMessage) {
   		   Log.d("LOG_TAG", "error getting conversion data: " + errorMessage);
               }
   
               @Override
               public void onAppOpenAttribution(Map<String, String> attributionData) {
                   for (String attrName : attributionData.keySet()) {
                       Log.d("LOG_TAG", "attribute: " + attrName + " = " + attributionData.get(attrName));
                   }
               }
   
               @Override
               public void onAttributionFailure(String errorMessage) {
                   Log.d("LOG_TAG", "error onAttributionFailure : " + errorMessage);
               }
           };
           
           AppsFlyerLib.getInstance().init(AF_DEV_KEY, conversionListener, this);
   
       }
   }
                 

   class AFApplication : Application() {
       private val devKey = "qrdZGj123456789";
   
       override fun onCreate() {
           super.onCreate()
           val conversionDataListener  = object : AppsFlyerConversionListener{
               override fun onConversionDataSuccess(data: MutableMap<String, Any>?) {
                   data?.let { cvData ->
                       cvData.map {
                           Log.i(LOG_TAG, "conversion_attribute:  ${it.key} = ${it.value}")
                       }
                   }
               }
   
               override fun onConversionDataFail(error: String?) {
                   Log.e(LOG_TAG, "error onAttributionFailure :  $error")
               }
   
               override fun onAppOpenAttribution(data: MutableMap<String, String>?) {
                   data?.map {
                       Log.d(LOG_TAG, "onAppOpen_attribute: ${it.key} = ${it.value}")
                   }
               }
   
               override fun onAttributionFailure(error: String?) {
                   Log.e(LOG_TAG, "error onAttributionFailure :  $error")
               }
           }
   
           AppsFlyerLib.getInstance().init(devKey, conversionDataListener, this)
       }
   }
   

5. Bên trong lớp toàn cục của ứng dụng, hãy gọi lệnh start().
   
   Java Kotlin

   AppsFlyerLib.getInstance().start(this);
   

   AppsFlyerLib.getInstance().start(this)

Để trì hoãn việc khởi tạo SDK, bạn có thể gọi start từ lớp Hoạt động.

Bạn có thể sử dụng tùy chọn này, ví dụ như nếu bạn cần trì hoãn start cho đến khi nhận được sự đồng ý của người dùng do các yêu cầu GDPR hoặc CCPA, v.v.

Khi gọi start trong lớp Hoạt động:

• Đảm bảo duyệt phiên bản Hoạt động làm đối số chứ không phải Ứng dụng.
• Nếu bạn định sử dụng các tính năng liên kết sâu, hãy thêm API start() vào bất kỳ Hoạt động nào khác mà bạn có thể liên kết sâu mà không có start ở trong đó.

Trước khi bắt đầu thử nghiệm lượt cài đặt, hãy đăng ký thiết bị thử nghiệm.

Các lượt cài đặt tự nhiên là cài đặt không phân bổ, thường cài đặt trực tiếp từ các cửa hàng ứng dụng.

Để mô phỏng cài đặt tự nhiên:

1. Đảm bảo bạn có thiết bị di động được kết nối với máy tính của mình
2. Trong Android Studio, mở Logcat.
3. Từ Android Studio, cài đặt ứng dụng trên thiết bị hoặc trình giả lập.
4. Đợi ứng dụng khởi chạy.
5. Trong Logcat, hãy tìm tên gói ứng dụng của bạn.

Bạn nên xem những nội dung sau:

Phần được tô sáng trong ảnh chụp màn hình chỉ ra rằng SDK báo cáo một cài đặt tự nhiên. Dữ liệu này xuất phát từ phương thức onConversionDataSuccess trong lớp AFApplication. Nhận dữ liệu chuyển đổi sẽ được thảo luận sau trong hướng dẫn này .

Lưu ý: Bắt đầu SDK V5, onConversionDataSuccess là tên của phương thức để nhận dữ liệu chuyển đổi. Nếu bạn đang sử dụng phiên bản SDK thấp hơn 5.0.0, tên của phương thức này là onInstallConversionDataLoaded . Chúng tôi khuyên bạn nên nâng cấp lên SDK 5.0.0. Để tìm hiểu thêm, hãy nhấp tại đây .

Cài đặt tự nhiên sẽ xuất hiện trên trang Tổng quan của bảng điều khiển của ứng dụng ngây bây giờ .

Nếu bạn không thấy cài đặt trong bảng điều khiển của ứng dụng, hãy xem hướng dẫn khắc phục sự cố SDK của chúng tôi.

Cài đặt không tự nhiên là lượt cài đặt được phân bổ thường theo sau quảng cáo. Bạn có thể mô phỏng cài đặt không tự nhiên bằng cách sử dụng các liên kết phân bổ.

Để mô phỏng cài đặt không tự nhiên:

1. Trong bảng kê khai, hãy tìm hiểu tên gói của ứng dụng của bạn là gì, ví dụ: com.company.app.
   • Trong URL bên dưới, thay thế <app_package_name> bằng tên gói ứng dụng của bạn:
     

     https://app.appsflyer.com/<app_package_name>?pid=Test&c=Test

     Ví dụ:

     https://app.appsflyer.com/com.company.app?pid=Test&c=Test

   • Các thông số c chỉ định tên của chiến dịch.
   • Thông số pid chỉ định tên của nguồn truyền thông mà lượt cài đặt được phân bổ.
   • ID quảng cáo (GAID) phải được thêm vào nếu thử nghiệm lượt nhấp từ máy tính (bằng cách thêm &advertising_id=<GAID> vào cuối liên kết ở bước 1).
2. Gửi URL này đến thiết bị.  Bạn có thể gửi qua email hoặc WhatsApp. 
3. Trên thiết bị, nhấp vào URL.
   • Nếu ứng dụng được liệt kê trong cửa hàng ứng dụng, bạn sẽ được chuyển hướng đến cửa hàng ứng dụng. Vui lòng không tải xuống và cài đặt ứng dụng từ cửa hàng ứng dụng. Tiếp tục với bước 5.
   • Nếu ứng dụng không được liệt kê trong cửa hàng ứng dụng và vẫn đang được phát triển, màn hình sẽ hiển thị thông báo rằng ứng dụng không có sẵn trong cửa hàng ứng dụng. Bạn chỉ cần tiếp tục với bước 5.
4. Trong Android Studio, mở Logcat.
5. Kết nối thiết bị với máy tính của bạn bằng cáp USB.
6. Từ Android Studio, Cài đặt ứng dụng trên thiết bị.
7. Trong Logcat, hãy tìm tên gói ứng dụng của bạn.

Bạn nên xem những nội dung sau:

Cài đặt không tự nhiên sẽ xuất hiện trên trang Tổng quan của bảng điều khiển của ứng dụng ngay bây giờ.

SDK có hai giao diện liên quan đến sự kiện trong ứng dụng:

• AFInAppEventType - hằng số cho tên sự kiện trong ứng dụng
• AFInAppEventParameterName - hằng số cho tên thông số sự kiện trong ứng dụng

Chúng tôi đặc biệt khuyên bạn nên sử dụng hai giao diện này vì những lý do sau:

• Việc đặt tên theo tiêu chuẩn cho phép AppsFlyer tự động ánh xạ các sự kiện tới các SRN như Facebook, Google, Twitter và Snapchat.
• Khả năng tương thích ngược - nếu AppsFlyer quyết định thay đổi tên của bất kỳ tham số sự kiện hoặc sự kiện nào, thì việc triển khai của bạn là tương thích ngược.

Để sử dụng hai giao diện này, vui lòng nhập chúng:

import com.appsflyer.AFInAppEventParameterName;
import com.appsflyer.AFInAppEventType;

Dưới đây là danh sách các tên và cấu trúc sự kiện được đề xuất .

Bạn có thể gửi doanh thu với bất kỳ sự kiện trong ứng dụng. Sử dụng thông số sự kiện af_revenue (AFInAppEventParameterName.REVENUE) để bao gồm doanh thu trong sự kiện trong ứng dụng. Bạn có thể điền giá trị số bất kỳ, âm hoặc dương.

af_revenue là tham số sự kiện duy nhất được đếm trên AppsFlyer như doanh thu thực trên dữ liệu thô và bảng điều khiển. Để biết thêm thông tin chi tiết, nhấp vào đây.

Khi gửi sự kiện có doanh thu, hãy ghi nhớ những điều sau:

• Nếu bạn thiết lập mã tiền tệ (xem ví dụ bên dưới), mã đó phải là mã ISO 4217 có 3 ký tự. (mặc định là USD).
• Bạn có thể thiết lập mã tiền tệ cho tất cả các sự kiện bằng cách gọi phương thức sau: AppsFlyer.setCurrencyCode ( "ZZZ" ). Để tìm hiểu về cài đặt tiền tệ, hiển thị và chuyển đổi tiền tệ, hãy xem hướng dẫn về tiền tệ doanh thu của chúng tôi.
• Giá trị doanh thu không được chứa dấu tách dấu phẩy, ký hiệu tiền tệ hoặc văn bản. Ví dụ một sự kiện doanh thu nên tương tự như 1234.56.

Ví dụ: Sự kiện mua sự kiện trong ứng dụng có doanh thu

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,1234.56);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"Shirt");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue);

val eventValue = HashMap<String, Any>() 
eventValue.put(AFInAppEventParameterName.REVENUE,1234.56)
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"Shirt")
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"1234567")
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD")
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue)

Sự kiện mua hàng trên có doanh thu $1.234,56 được liên kết với sự kiện đó, xuất hiện dưới dạng doanh thu trong bảng điều khiển.

Ghi nhận doanh thu âm

Có thể có những tình huống mà bạn muốn ghi nhận doanh thu âm.

Ví dụ: người dùng nhận được tiền hoàn lại cho đôi giày họ đã mua từ bạn.

Map<String, Object> eventValue = new HashMap<String, Object>();
eventValue.put(AFInAppEventParameterName.REVENUE,-200);
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE,"shoes");
eventValue.put(AFInAppEventParameterName.CONTENT_ID,"4875");
eventValue.put(AFInAppEventParameterName.CURRENCY,"USD");
AppsFlyerLib.getInstance().logEvent(getApplicationContext() , "cancel_purchase" , eventValue);

val eventValue = HashMap<String, Any>()
eventValue.put(AFInAppEventParameterName.REVENUE, -200)
eventValue.put(AFInAppEventParameterName.CONTENT_TYPE, "category_a")
eventValue.put(AFInAppEventParameterName.CONTENT_ID, "1234567")
eventValue.put(AFInAppEventParameterName.CURRENCY, "USD")
AppsFlyerLib.getInstance().logEvent(applicationContext,  "cancel_purchase", eventValue)

SDK của AppsFlyer cung cấp xác thực biên lai máy chủ cho các giao dịch mua trong ứng dụng. Để xác thực việc mua hàng, hãy gọi validateAndLogInAppPurchase.

Cuộc gọi này sẽ tự động tạo ra một sự kiện trong ứng dụng af_purchase, với điều kiện là giao dịch mua được xác nhận.

public static void validateAndLogInAppPurchase(Context context, 
String publicKey, String signature, String purchaseData, 
String price, String currency, HashMap<String, String> additionalParameters);

Các tham số phương thức

• Chuỗi publicKey – khóa chung từ Giao diện điều khiển dành cho Nhà phát triển của Google
• Chữ ký chuỗi – chữ ký giao dịch (được trả về từ API Google khi hoàn tất giao dịch mua)
• Chuỗi purchaseData – sản phẩm được mua ở định dạng JSON (được trả về từ API Google khi hoàn tất giao dịch mua)
• Chuỗi giá – doanh thu sự kiện trong ứng dụng sẽ được báo cáo cho AppsFlyer.
• Chuỗi tiền tệ – tiền tệ sự kiện trong ứng dụng sẽ được báo cáo cho AppsFlyer
• HashMap<String, String> additionalParameters – tham số bổ sung của sự kiện trong ứng dụng xuất hiện trong trường event_value trong dữ liệu thô của sự kiện trong ứng dụng.

Xác thực mua thành công và gọi lại thất bại

Nếu bạn muốn biết liệu nỗ lực xác thực mua hàng có thành công hay không, hãy triển khai registerValidatorListener trong lớp ứng dụng của bạn. Trình nghe này có hai khối gọi lại, một khối dành cho 'Thành công' và một khối dành cho 'Thất bại' (vì bất kỳ lý do nào, bao gồm cả xác nhận thất bại).

AppsFlyerLib.getInstance().registerValidatorListener(this,new
   AppsFlyerInAppPurchaseValidatorListener() {
     public void onValidateInApp() {
       Log.d(TAG, "Purchase validated successfully");
     }
     public void onValidateInAppFailure(String error) {
       Log.d(TAG, "onValidateInAppFailure called: " + error);
     }
});

AppsFlyerLib.getInstance().registerValidatorListener(this, object : AppsFlyerInAppPurchaseValidatorListener {
    override fun onValidateInApp() {
       	Log.d(LOG_TAG, "Purchase validated successfully")
    }

    override fun onValidateInAppFailure(error: String) {
        Log.d(LOG_TAG, "onValidateInAppFailure called: $error")
   }
})

Ví dụ sử dụng để xác nhận mua hàng:

// Purchase object is returned by Google API in onPurchasesUpdated() callback
private void handlePurchase(Purchase purchase) {
    Log.d(LOG_TAG, "Purchase successful!");
    Map<String, String> additional_event_values = new HashMap<>();
    additional_event_values.put("some_parameter", "some_value");
    String price= "10";
    String currency = "USD";
    AppsFlyerLib.getInstance().validateAndLogInAppPurchase(getApplicationContext(), PUBLIC_KEY, purchase.getSignature(), purchase.getOriginalJson(), revenue, currency, additional_event_values);
}

// Purchase object is returned by Google API in onPurchasesUpdated() callback
private fun handlePurchase(Purchase purchase) {
   Log.d(LOG_TAG, "Purchase successful!");
   val additional_event_values = HashMap<String, String>()
   additional_event_values.put("some_parameter", "some_value");
   val price= "10";
   val currency = "USD";
   AppsFlyerLib.getInstance().validateAndLogInAppPurchase(this, PUBLIC_KEY, purchase.getSignature(), purchase.getOriginalJson(), revenue, currency, additional_event_values);
}

Xác thực mua hàng trong ứng dụng sẽ tự động gửi một sự kiện mua trong ứng dụng tới AppsFlyer. Vui lòng xem bên dưới dữ liệu mẫu được truyền trong tham số event_value:

{
   "some_parameter":"some_value", // from additional_event_values
   "af_currency":"USD", // from currency
   "af_content_id":"test_id", // from purchase
   "af_revenue":"10", // from revenue
   "af_quantity":"1", // from purchase
   "af_validated":true // flag that AF verified the purchase
}

• Tên sự kiện: tối đa 45 ký tự
• Giá trị sự kiện: không được vượt quá 1000 ký tự - nếu dài hơn chúng tôi có thể cắt bớt nó
• Định giá và doanh thu: chỉ sử dụng các chữ số và số thập phân, ví dụ 5 hoặc 5.2.
• Giá trị định giá và doanh thu có thể có tối đa 5 chữ số sau dấu chấm, ví dụ: 5.12345
• Có hỗ trợ các ký tự không phải tiếng Anh, trong các sự kiện trong ứng dụng, các SDK API khác, bắt đầu từ Android SDK V4.8.1.

Bạn có thể ghi lại các sự kiện trong ứng dụng bằng cách gọi trackEvent với các tham số giá trị và tên sự kiện. Xem tài liệu về Sự kiện trong ứng dụng để biết thêm chi tiết.

Dưới đây là một ví dụ đơn giản về cách ghi lại một sự kiện mua hàng. Để biết danh sách đầy đủ các đoạn mã được tạo sẵn cho mỗi cấu trúc dọc, vui lòng xem hướng dẫn của chúng tôi về sự kiện phong phú trong ứng dụng cho mỗi cấu trúc dọc.

Ví dụ: Sự kiện mua trong ứng dụng

Map<String,Object> eventValues = new HashMap<>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200);
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY");
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes");
AppsFlyerLib.getInstance().logEvent(this, AFInAppEventType.PURCHASE, eventValues);

val eventValues = HashMap<String, Any>();
eventValues.put(AFInAppEventParameterName.REVENUE, 1200)
eventValues.put(AFInAppEventParameterName.CURRENCY, "JPY")
eventValues.put(AFInAppEventParameterName.CONTENT_TYPE, "Shoes")
AppsFlyerLib.getInstance().logEvent(this, AFInAppEventType.PURCHASE, eventValues)

Nếu người dùng bắt đầu một sự kiện khi không có kết nối internet, Appsflyer vẫn có thể ghi nhận nó. Đây là cách thức hoạt động:

1. SDK gửi các sự kiện tới máy chủ của AppsFlyer và chờ đợi phản hồi.
2. Nếu SDK không nhận được phản hồi mã 200, sự kiện được lưu trữ trong bộ nhớ cache.
3. Khi nhận được phản hồi mã 200 tiếp theo, sự kiện được lưu trữ được gửi lại cho máy chủ.
4. Nếu có nhiều sự kiện trong bộ nhớ cache, chúng được gửi đến máy chủ một cách lần lượt và nhanh chóng.

Bạn có thể đặt trình nghe khi ghi nhận sự kiện trong ứng dụng. Trình nghe cho phép bạn xác định logic cho hai tình huống:

• Đã ghi nhận thành công sự kiện trong ứng dụng.
• Có lỗi xảy ra khi ghi nhận sự kiện trong ứng dụng.

AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.PURCHASE, eventValue, new AppsFlyerRequestListener() {
                    @Override
                    public void onSuccess() {
                        Log.d(LOG_TAG, "Event sent successfully");
                    }
                    @Override
                    public void onError(int i, @NonNull String s) {
                        Log.d(LOG_TAG, "Event failed to be sent:\n" +
                                "Error code: " + i + "\n"
                                + "Error description: " + s);
                    }
                });

AppsFlyerLib.getInstance().logEvent(getApplicationContext(), AFInAppEventType.PURCHASE, eventValue, object : AppsFlyerRequestListener {
            override fun onSuccess() {
                Log.d(LOG_TAG, "Event sent successfully")
            }
            override fun onError(errorCode: Int, errorDesc: String) {
                Log.d(LOG_TAG, "Event failed to be sent:\n" +
                        "Error code: " + errorCode + "\n"
                        + "Error description: " + errorDesc)
            }
        })

Trong trường hợp xảy ra lỗi khi ghi sự kiện trong ứng dụng, mã lỗi và mô tả chuỗi sẽ được cung cấp, như được chỉ ra trong bảng sau.

OneLink có thể phát hiện loại thiết bị khi nhấp và chuyển hướng người dùng tới đích phù hợp, ví dụ: Google Play, cửa hàng ứng dụng iOS, thị trường ngoài cửa hàng hoặc các trang web.

Hướng dẫn Chuyển hướng OneLink thảo luận về việc triển khai các liên kết phân bổ đa nền tảng (không yêu cầu mã hóa SDK). Đây cũng là cơ sở cho các liên kết sâu.

Đối với người dùng đã cài đặt ứng dụng của bạn, OneLink sẽ mở ứng dụng. Ngoài việc mở ứng dụng, bạn cũng có thể liên kết sâu người dùng với một hoạt động hoặc trang cụ thể trong ứng dụng. Điều này yêu cầu nhà phát triển của bạn triển khai Liên kết sâu hợp nhất (UDL).

Xem hướng dẫn của chúng tôi về thiết lập liên kết sâu với OneLink.

Lưu ý:

• UDL yêu cầu SDK V6.1 trở lên
• Những khách hàng đã sử dụng OneLink để liên kết sâu có thể đang sử dụng phương thức kế thừa, thay vì UDL

Đối với người dùng chưa cài đặt ứng dụng của bạn, OneLink sẽ nhận diện loại thiết bị và chuyển hướng họ đến điểm đích chính xác: Google Play, Apple App Store, cửa hàng ứng dụng của bên thứ ba hoặc trang web. Sau khi người dùng khởi chạy ứng dụng, bạn có thể sử dụng liên kết sâu gián tiếp để chuyển hướng họ đến một hoạt động hoặc trang cụ thể trong ứng dụng.

Điều này yêu cầu nhà phát triển của bạn triển khai Liên kết sâu hợp nhất (UDL).

Xem hướng dẫn của chúng tôi về liên kết sâu bị trì hoãn để tìm hiểu thêm.

Lưu ý:

• UDL yêu cầu SDK V6.1 trở lên
• Những khách hàng đã sử dụng OneLink để liên kết sâu gián tiếp có thể đang sử dụng phương thức kế thừa, thay vì UDL

SDK cung cấp cho bạn dữ liệu chuyển đổi và tương tác sau mỗi lần cài đặt hoặc sự kiện liên kết sâu. Bạn có thể sử dụng dữ liệu này để tùy chỉnh nội dung và hành vi của ứng dụng theo chương trình.

Để có được dữ liệu liên kết sâu khi sử dụng liên kết sâu trực tiếp và đang mở ứng dụng, hãy thực hiện phương thức onAppOpenAttribution.

Để có được dữ liệu tái tương tác liên kết sâu theo cách thủ công bất cứ lúc nào, hãy thực hiện phương thức performOnAppAttribution.Điều này cho phép truy cập vào dữ liệu tái tương tác mà không ghi nhận lượt tái tương tác mới.

Xem hướng dẫn của chúng tôi về dữ liệu liên kết sâu để tìm hiểu thêm.

Phương thức addPushNotificationDeepLinkPath cung cấp cho chủ sở hữu ứng dụng một giao diện linh hoạt để cấu hình cách các liên kết sâu được trích xuất từ các tải trọng thông báo đẩy.

Theo mặc định, SDK tìm kiếm giá trị liên kết sâu trong mã khóa af của tải trọng JSON của thông báo đẩy. Tuy nhiên, nhiều nhà cung cấp dịch vụ thông báo đẩy sử dụng các lược đồ JSON độc quyền mà SDK sẽ không thể giải quyết nếu không được cấu hình bổ sung.

addPushNotificationDeepLinkPath cho phép bạn cấu hình mã khóa nào trong tải trọng của thông báo đẩy mà SDK sử dụng cho giá trị liên kết sâu.

Sử dụng phương thức này nếu bạn đang tích hợp ứng dụng của mình với các nhà cung cấp dịch vụ thông báo đẩy không sử dụng lược đồ JSON thông báo đẩy mặc định mà SDK mong đợi.

Khi gọi ra addPushNotificationDeepLinkPath, SDK sẽ xác minh rằng:

• Mã khóa được yêu cầu tồn tại trong tải trọng.
• Mã khóa chứa một URL OneLink hợp lệ.

Phải gọi ra addPushNotificationDeepLinkPath trước khi gọi start().

Cấu hình cơ bản

Hãy xem xét lệnh gọi sau tới addPushNotificationDeepLinkPath

AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("deeply", "nested", "deep_link");                       

AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("deeply", "nested", "deep_link");

và các tình huống này.

Tình huống 1

Ứng dụng của bạn được gọi qua thông báo đẩy. Thông báo đẩy đó chứa một tải trọng có cấu trúc như sau.

{
    ...
    "deeply": {
        "nested": {
            "deep_link": "https://yourdeeplink2.onelink.me"
        }
    }
    ...
}

Trong trường hợp này, SDK trích xuất giá trị của deep_link và tiếp tục với luồng liên kết sâu.

Tình huống 2

Ứng dụng của bạn được gọi qua thông báo đẩy. Thông báo đẩy đó chứa một tải trọng có cấu trúc như sau.

{
    ...
    "deeply": {
        "nested": {
            "banana": "https://yourdeeplink2.onelink.me"
        }
    },
    ...
}

Trong trường hợp này, khi lệnh gọi thực thi SDK không thể tìm thấy mã khóa deep_link trong tải trọng. Do đó, không có gì xảy ra.

Tình huống 3

Ứng dụng của bạn được gọi qua thông báo đẩy. Thông báo đẩy đó chứa một tải trọng có cấu trúc như sau.

{
    ...
    "deeply": {
        "nested": {
            "deep_link": "Corrupted url or regular string"
        }
    },
    ...
}

Trong trường hợp này, mặc dù SDK tìm thấy mã khóa deep_link nhưng giá trị liên kết sâu của SDK lại không hợp lệ. Do đó, khi thực thi lệnh gọi trên thì không có gì xảy ra.

Cấu hình nâng cao

Để cấu hình nhiều cấu trúc tải trọng có thể có, hãy gọi addPushNotificationDeepLinkPath nhiều lần:

• Lệnh gọi đầu tiên mang lại giá trị liên kết sâu hợp lệ sẽ được sử dụng
• Các lệnh gọi khác bị bỏ qua

Nếu không có cấu trúc tải trọng nào khớp hoặc không tìm thấy URL OneLink hợp lệ nào trong tải trọng, thì không có gì xảy ra.

Ví dụ: hãy xem xét tải trọng sau:

{
    ...
    "deeply": {
        "nested": {
            “deep_link”: “https://yourdeeplink2.onelink.me”
        }
    },
    “this”: {
        “is”: {
            "banana": "phone"
        }
    }
    ...
}

và các lệnh gọi sau tới addPushNotificationDeepLinkPath.

// this.is.deep_link key isn’t found - nothing happens
AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("this", "is", "deep_link");
// this.is.banana key found, but contains invalid OneLink URL - nothing happens
AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("this", "is", "banana");
// deeply.nested.deep_link key found and contains valid OneLink URL - proceed deep linking flow
AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("deeply", "nested", "deep_link");

// this.is.deep_link key isn’t found - nothing happens
AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("this", "is", "deep_link");
// this.is.banana key found, but contains invalid OneLink URL - nothing happens
AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("this", "is", "banana");
// deeply.nested.deep_link key found and contains valid OneLink URL - proceed deep linking flow
AppsFlyerLib.getInstance().addPushNotificationDeepLinkPath("deeply", "nested", "deep_link");

Với AppsFlyer, bạn có thể phân bổ lượt cài đặt cho các ứng dụng Android không có trong cửa hàng. Điều này cho phép bạn quảng bá ứng dụng của mình và tiếp cận đối tượng lớn hơn ở các thị trường không có Google Play. 

Để biết thêm chi tiết về cách phân bổ lượt cài đặt cho các ứng dụng không có trong cửa hàng, hãy đọc tại đây.

Trong các chiến dịch cài đặt sẵn, chủ sở hữu ứng dụng có thể yêu cầu các nhà sản xuất thiết bị cài đặt sẵn ứng dụng của họ trên thiết bị trước khi thiết bị rời khỏi nhà máy.

Với AppsFlyer, bạn có thể dễ dàng phân bổ lượt cài đặt các ứng dụng được cài đặt sẵn. Khi người dùng khởi chạy ứng dụng của bạn lần đầu tiên, AppsFlyer phân bổ lượt cài đặt cho nhà sản xuất dưới dạng nguồn truyền thông.

Để biết chi tiết, nhấp vào đây.

Để tìm hiểu cách thiết lập đo lường lượt gỡ cài đặt, hãy đọc tại đây.

Nếu bạn muốn nhận xác nhận rằng yêu cầu đã được máy chủ AppsFlyer nhận thành công, hãy triển khai trình nghe AppsFlyerRequestListener.

Phương thức gọi lại onRequestSuccess() được gọi cho mỗi 200 phản hồi đối với yêu cầu phân bổ thực hiện bởi SDK.

Phương thức gọi lại onRequestFailure(String error) được gọi cho bất kỳ phản hồi nào khác và trả về phản hồi như một chuỗi lỗi.

Ví dụ

AppsFlyerLib.getInstance().start(getApplicationContext(), "devKey", new AppsFlyerRequestListener() {
            @Override
            public void onSuccess() {
                Log.d(LOG_TAG, "Launch sent successfully, got 200 response code from server");
            }
            @Override
            public void onError(int i, @NonNull String s) {
                Log.d(LOG_TAG, "Launch failed to be sent:\n" +
                                "Error code: " + i + "\n"
                                + "Error description: " + s);
            }
        });

AppsFlyerLib.getInstance().start(this, "devKey", object : AppsFlyerRequestListener {
            override fun onSuccess() {
                Log.d(LOG_TAG, "Launch sent successfully")
            }
            override fun onError(errorCode: Int, errorDesc: String) {
                Log.d(LOG_TAG, "Launch failed to be sent:\n" +
                        "Error code: " + errorCode + "\n"
                        + "Error description: " + errorDesc)
            }
        })

Trong trường hợp xảy ra lỗi trong trình theo dõi yêu cầu, mã lỗi và mô tả chuỗi sẽ được cung cấp, như được chỉ ra trong bảng sau.

Phải có API setAdditionalData để tích hợp ở cấp SDK với một số nền tảng đối tác bên ngoài, bao gồm Segment, Adobe và Urban Airship.
Chỉsử dụng API này nếu bài viết tích hợp của nền tảng nêu rõ rằng bắt buộc phải có setAdditionalData API.

Ví dụ về mã setAdditableData:

HashMap<String,Object> CustomDataMap = new HashMap<>();
CustomDataMap.put("custom_param_1","value_of_param_1");
AppsFlyerLib.getInstance().setAdditionalData(CustomDataMap);

val customDataMap = HashMap<String, Any>()
customDataMap.put("custom_param_1","value_of_param_1")
AppsFlyerLib.getInstance().setAdditionalData(customDataMap)

Chủ sở hữu ứng dụng sử dụng Liên kết Ứng dụng để liên kết sâu (không có OneLink) và có miền được liên kết với ứng dụng của họ có thể phân bổ các phiên được khởi tạo thông qua miền này bằng phương thức appendParametersToDeepLinkingURL.

Ví dụ: một người dùng tìm kiếm trên Google và nhấp vào miền của bạn, www.example.com:

• Nếu người dùng chưa cài đặt ứng dụng, họ sẽ được chuyển hướng đến trang web (www.example.com).
• Nếu người dùng đã cài đặt ứng dụng trên thiết bị của họ, họ sẽ được liên kết sâu vào ứng dụng được liên kết với www.example.com. Phiên này được phân bổ cho nguồn truyền thông (thông số pid) được chỉ định trong appendParametersToDeepLinkingURL.

Xem tài liệu tham khảo về SDK Android để biết thêm thông tin.

Lưu ý: Biểu ngữ Thông minh giúp chủ sở hữu ứng dụng chuyển đổi khách truy cập trang web thành người dùng ứng dụng.

Theo mặc định, phải mất ít nhất 5 giây giữa hai lần khởi chạy ứng dụng để được tính là hai phiên riêng biệt (tìm hiểu thêm về tính các phiên).

Sử dụng API sau để đặt thời gian tối thiểu giữa các phiên:

AppsFlyerLib.setMinTimeBetweenSessions(int giây);

Đặt một giá trị cao  cho thời gian tùy chỉnh giữa các phiên khởi chạy có thể ảnh hưởng xấu tới API dựa trên dữ liệu các phiên, chẳng hạn như liên kết sâu.

Bạn có thể báo cáo về các phiên người dùng mới bằng phương pháp SDK này. Ví dụ: phương pháp này có thể hữu ích cho các ứng dụng tiện ích chạy trong nền.

Sử dụng API này trong onCreate () của hoạt động của bạn:

public void logSession(Context context);

Ví dụ cách dùng:

AppsFlyerLib.getInstance().logSession(context);

Một số dịch vụ của bên thứ 3 như nhà cung cấp dịch vụ email gói liên kết trong email với tên miền ghi nhận click của riêng họ. Một số dịch vụ thậm chí cho phép bạn thiết lập các miền ghi nhận nhấp chuột của riêng bạn. Nếu OneLink được gói trong các miền như vậy, điều này có thể giới hạn chức năng của nó.

Để khắc phục vấn đề này, bạn có thể sử dụng API setResolveDeepLinkURLs. Sử dụng API này để nhận OneLink từ các miền nhấp chuột khởi chạy ứng dụng.  Đảm bảo gọi API này trước khi khởi tạo SDK.

Ví dụ: bạn có 3 miền nhấp chuột chuyển hướng đến OneLink của bạn, đó là https://mysubdomain.onelink.me/abCD. Sử dụng API này để nhận OneLink mà miền nhấp chuột của bạn chuyển hướng đến. Phương thức API này nhận được danh sách các miền mà SDK giải quyết. Thêm mã sau đây trước khi khởi tạo SDK.

AppsFlyerLib.getInstance().setResolveDeepLinkURLs("clickdomain.com", "myclickdomain.com", "anotherclickdomain.com");

Mã ở trên cho phép bạn sử dụng miền nhấp chuột của mình trong khi vẫn duy trì chức năng OneLink. Các miền nhấp chuột có trách nhiệm khởi chạy ứng dụng. Còn API sẽ nhận được OneLink từ những miền nhấp chuột này và sau đó bạn có thể sử dụng dữ liệu từ OneLink này để liên kết sâu và tùy chỉnh nội dung người dùng.

Với AppsFlyer, bạn có thể ghi nhận thông báo đẩy như một phần của chiến dịch nhắm mục tiêu lại.

Để bật tính năng này, hãy gọi phương thức sendPushNotificationData bên trong phương thức onCreate của mọi hoạt động được khởi chạy sau khi nhấp vào thông báo:

AppsFlyerLib.getInstance().sendPushNotificationData(this);

Để biết thêm thông tin về đo số lượng thông báo đẩy, hãy đọc tại đây.

Việc cho phép người dùng hiện tại mời bạn bè và những mối liên hệ của họ sử dụng ứng dụng có thể là một yếu tố tăng trưởng then chốt với ứng dụng của bạn. Với AppsFlyer, bạn có thể phân bổ và ghi nhận lượt cài đặt bắt nguồn từ lời mời của người dùng trong ứng dụng của bạn.

Để biết thêm chi tiết, hãy xem bài viết Phân bổ mời người dùng.

ID AppsFlyer được tạo cho mỗi lần cài đặt mới ứng dụng. Bạn có thể sử dụng ID AppsFlyer cho nhiều mục đích khác nhau:

• Gửi các sự kiện trong ứng dụng server-to-server .
• Khớp ID AppsFlyer với hồ sơ người dùng trong các hệ thống backend của bạn.
• Ánh xạ các mục khi hợp nhất dữ liệu từ API kéo và đẩy.

Sử dụng API sau để lấy ID AppsFlyer:

public String getAppsFlyerUID(Context context);

Ví dụ cách dùng:

String appsFlyerId = AppsFlyerLib.getInstance().getAppsFlyerUID(this);

Để thiết lập ID người dùng Customer User ID:

public void setCustomerUserId(String id);

Ví dụ cách dùng:

AppsFlyerLib.getInstance().setCustomerUserId("myId");

Chúng tôi khuyên bạn nên đặt Customer User ID sớm trong luồng của ứng dụng, vì nó chỉ được liên kết với các sự kiện được báo cáo sau khi thiết lập:

• Nếu setCustomerUserId được gọi trước khi gọi start, Customer User ID sẽ xuất hiện trong các báo cáo dữ liệu thô cho các lượt cài đặt và sự kiện.
• Nếu được đặt sau, Customer User ID chỉ được liên kết với các sự kiện được ghi nhận sau khi cài đặt Customer User ID.

Lấy Customer User ID:

Để tránh thiết lập lại giá trị ID Người dùng Khách hàng sau lần khởi chạy đầu tiên và để giảm các cuộc gọi đến máy chủ của bạn để lấy Customer User ID, bạn có thể kiểm tra xem giá trị của nó có trống hay không bằng cách:

AppsFlyerProperties.getInstance().getString(AppsFlyerProperties.APP_USER_ID)

Để biết thêm thông tin về Customer User ID, nhấp vào đây.

Trì hoãn Khởi tạo SDK cho customerUserID

Bạn có thể trì hoãn Khởi tạo SDK cho đến khi customerUserID được thiết lập.

Để chỉ ra rằng SDK sẽ trì hoãn việc khởi tạo cho cuộc gọi Customer User ID:

AppsFlyerLib.getInstance().waitForCustomerUserId(true);

ngay trước khi thực hiện phương pháp init(). Phần còn lại của Khởi tạo SDK nên được giữ nguyên.

Khi đã được cung cấp customerUserID, hãy gọi

AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);

để cung cấp cho SDK customer user id liên quan và bắt đầu SDK.

Đoạn mã sẽ xuất hiện như sau:

public class AFApplication extends Application {
  private static final String AF_DEV_KEY = "qrdZGj123456789";
  @Override
  public void onCreate() {
    super.onCreate();
    AppsFlyerConversionListener conversionDataListener = 
    new AppsFlyerConversionListener() {
      ...
    };
    AppsFlyerLib.getInstance().waitForCustomerUserId(true);
    //WARNING! Removing above line doesn't cancel its effect.
    // Replace with this to stop waiting for CUID:
    // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
    AppsFlyerLib.getInstance().init(AF_DEV_KEY, getConversionListener(), getApplicationContext());
    AppsFlyerLib.getInstance().start(this);
    // Do your magic to get the customerUserID
    // ...
    // any AppsFlyer SDK code invoked here will be discarded
   //Call the following API once the customerUserID is available:
 AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this);
  }
}

class AFApplication: Application() {
 private val afDevKey = ""

 override fun onCreate() {
  super.onCreate()
  val conversionDataListener = object: AppsFlyerConversionListener {
   ...
  }
  AppsFlyerLib.getInstance().waitForCustomerUserId(true);
  //WARNING! Removing above line doesn't cancel its effect.
  // Replace with this to stop waiting for CUID:
  // AppsFlyerLib.getInstance().waitForCustomerUserId(false);
  AppsFlyerLib.getInstance().init(afDevKey, conversionDataListener, this)
  AppsFlyerLib.getInstance().start(this)
  // Do your magic to get the customerUserID
  // ...
  // any AppsFlyer SDK code invoked here will be discarded
  // Call the following API once the customerUserID is available:
  AppsFlyerLib.getInstance().setCustomerIdAndLogSession("customer_id", this)
 }
}

Để tìm hiểu thêm về việc trì hoãn khởi tạo SDK cho đến khi Customer User ID khả dụng, hãy truy cập tại đây .

Kể từ SDK phiên bản 4.8.0, AppsFlyer tự động thu thập google_advertising_id.

Yêu cầu thu thập ID Quảng cáo Google chỉ tương thích với SDK phiên bản 4.7.X trở xuống.

Phải thu thập ít nhất một mã định danh thiết bị duy nhất để có thể phân bổ. Các mã định danh sau đây khả dụng: GAID, ID Android, IMEI và OAID.

GAID - ID quảng cáo Google

Được thu thập tự động từ các ứng dụng có chứa Dịch vụ Google Play. Nếu GAID có sẵn ứng dụng KHÔNG nên thu thập IMEI và ID Android để tránh vi phạm chính sách của Google Play.

IMEI và Android ID

Bị tắt theo mặc định. Có thể được thu thập CHỈ đối với các ứng dụng KHÔNG chứa Dịch vụ Google Play.
Lưu ý: Bắt đầu với Android 10 (API cấp 29) , được phát hành vào cuối năm 2019, hạn chế quyền truy cập vào tham số IMEI.

Để gửi các ID này đến AppsFlyer:

1. Trên ứng dụng, mở thu thập IMEI và/hoặc ID Android của thiết bị.
2. Hãy gọi các API sau TRƯỚC KHI gọi phương thức start:
   

   AppsFlyerLib.getInstance().setImeiData("IMEI_HERE");
   AppsFlyerLib.getInstance().setAndroidIdData("ANDROID_ID_HERE");

OAID - Mã định danh nhà quảng cáo mở

Hướng dẫn thực hiện OAID

Chọn không thu thập ID thiết bị

Các nhà phát triển có thể chọn không thu thập IMEI, ID Android và OAID bằng cách sử dụng các API sau: 

AppsFlyerLib.getInstance().setCollectIMEI(false);
AppsFlyerLib.getInstance().setCollectAndroidID(false);
AppsFlyerLib.getInstance().setCollectOaid(false);

Trong một số trường hợp nghiêm trọng, bạn có thể sẽ phải tắt tất cả chức năng ghi nhật ký SDK để bảo đảm tuân thủ pháp luật và quyền riêng tư. Có thể thực hiện việc này bằng API stop. Khi API này được gọi, SDK sẽ ngừng hoạt động và không còn giao tiếp với các máy chủ AppsFlyer.

AppsFlyerLib.getInstance().stop(true, getApplicationContext());

AppsFlyerLib.getInstance().stop(true, applicationContext);

Có một số trường hợp khác nhau để người dùng lựa chọn không tham gia. Chúng tôi khuyên bạn nên thực hiện theo những hướng dẫn chính xác cho từng trường hợp liên quan tới ứng dụng của bạn.

SDK có thể được kích hoạt lại bằng cách gọi:

AppsFlyerLib.getInstance().stop(false, getApplicationContext());
AppsFlyerLib.getInstance().start(getApplicationContext(), <AF_DEV_KEY>);

AppsFlyerLib.getInstance().stop(false, applicationContext);
AppsFlyerLib.getInstance().start(applicationContext, <AF_DEV_KEY>);

Không gọi start nếu stop được đặt thành true. Bạn có thể kiểm tra trạng thái hiện tại của SDK bằng cách gọi:

AppsFlyerLib.getInstance().isStopped() // returns true if SDK is stopped, false otherwise

AppsFlyerLib.getInstance().isStopped // returns true if SDK is stopped, false otherwise

Sử dụng API này trong quá trình Khởi tạo SDK để ẩn danh hoàn toàn các cài đặt, sự kiện và phiên của người dùng:

public void anonymizeUser(boolean isDisabled);

Ví dụ cách dùng:

AppsFlyerLib.getInstance().anonymizeUser(true);

Chức năng ghi nhật ký có thể được khởi động lại bằng cách gọi anonymizeUser đặt thành false.

Trong một số trường hợp, nhà quảng cáo có thể muốn ngừng chia sẻ dữ liệu cấp người dùng với các mạng/đối tác quảng cáo cho những người dùng cụ thể. Lý do cho điều này bao gồm: 

• Các chính sách bảo mật như CCPA hoặc GDPR
• Cơ chế chọn lựa không tham gia của người dùng
• Cạnh tranh với một số đối tác (mạng quảng cáo, bên thứ 3)

AppsFlyer cung cấp hai phương thức API để ngừng chia sẻ dữ liệu với một số hoặc tất cả các đối tác:

• setSharingFilter: Được các nhà quảng cáo sử dụng để đặt một số (một hoặc nhiều) mạng/đối tác tích hợp đểloại trừ không được lấy dữ liệu.
• setSharingFilterForAllPartners: Được các nhà quảng cáo sử dụng để loại trừ tất cả các mạng/đối tác tích hợp không được lấy dữ liệu.

Các phương thức lọc này được hỗ trợ từ SDK V5.4.1.

Phương thức lọc phải được gọi mỗi khi SDK được khởi tạo và ảnh hưởng đến toàn phiên. Nếu cần thời gian để xác định xem bạn có cần đặt bộ lọc chia sẻ hay không, thì hãy trì hoãn quá trình khởi tạo SDK. 

Khi phương thức này được kích hoạt trước lệnh gọi start đầu tiên:

• Người dùng từ SRN được phân bổ là Tự nhiên và dữ liệu của họ không được chia sẻ với các đối tác tích hợp.
• Người dùng từ mạng quảng cáo lượt nhấp (không phải SRN) được phân bổ chính xác trên AppsFlyer, nhưng không được chia sẻ với mạng quảng cáo thông qua postback, API, báo cáo dữ liệu thô hoặc bằng bất kỳ phương thức nào khác.

Hiện tại, không thể lọc dữ liệu gỡ cài đặt bằng các phương thức này. Tuy nhiên, bạn có thể ngừng gửi sự kiện Gỡ cài đặt cho đối tác bằng cách sử dụng trang thiết lập trong AppsFlyer.