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

Use one of the following methods to add the SDK to your app:

• [Best practice] Using Gradle
• Manually add the SDK

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 (được đề xuất)
• Thêm thủ công người giới thiệu cài đặt

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" />
   <!-- Optional : -->
   <uses-permission android:name="android.permission.READ_PHONE_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.

Quan trọng: quan trọng là phải sử dụng khóa dev chính xác khi khởi tạo SDK. Sử dụng sai khóa dev hoặc khóa dev 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 ra 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, dưới phần Cấu hình nhấp Cài đặt Ứng dụng
3. Sao chép khóa dev của bạn
   
   

   

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 android.app.Application;
   import android.util.Log;
   import com.appsflyer.AppsFlyerLib;
   import com.appsflyer.AppsFlyerConversionListener;
   import java.util.Map;

2. Trong lớp chung, hãy gán khóa dev của bạn cho một biến, tốt nhất là AF_DEV_KEY. 
   
   Quan trọng: quan trọng là phải sử dụng khóa dev chính xác khi khởi tạo SDK. Sử dụng sai khóa dev hoặc khóa dev 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 ra sự cố phân bổ và báo cáo.
   
   
   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 chung của ứng dụng, hãy gọi lệnh startTracking().
   
   Java Kotlin

   AppsFlyerLib.getInstance().startTracking(this);
   

   AppsFlyerLib.getInstance().startTracking(this)

Trong tệp AndroidManifest.xml, bên trong thẻ ứng dụng, thêm dòng sau:

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

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

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.

Để trì hoãn việc khởi tạo SDK, bạn có thể gọi startTracking 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 startTracking 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 startTracking 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 startTracking() vào bất kỳ Hoạt động nào khác mà bạn có thể liên kết sâu đến mà không có startTracking ở trong đó.

Trước khi bạn bắt đầu kiểm tra lượt cài đặt, liệt kê vào danh sách trắng thiết bị bạn đang chuẩn bị kiểm tra.

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_id> bằng tên gói ứng dụng của bạn:
     

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

   • 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, vui lòng 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().trackEvent(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().trackEvent(getApplicationContext() , AFInAppEventType.PURCHASE , eventValue)

Sự kiện mua hàng trên có doanh thu $1234.56 được liên kết với 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().trackEvent(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().trackEvent(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 nhận việc mua hàng, hãy gọi validateAndTrackInAppPurchase.

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 validateAndTrackInAppPurchase(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().validateAndTrackInAppPurchase(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().validateAndTrackInAppPurchase(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().trackEvent(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().trackEvent(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().trackEvent(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().trackEvent(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.

Liên kết sâu cho phép bạn gửi người dùng đến các hoạt động cụ thể và phục vụ họ với nội dung tùy chỉnh. Điều này đặc biệt hữu ích khi chạy các chiến dịch nhắm mục tiêu lại.

Để thiết lập liên kết sâu với OneLink, nhà tiếp thị có quyền truy cập vào bảng điều khiển AppsFlyer và nhà phát triển có quyền truy cập vào ứng dụng phải hoạt động cùng nhau.

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.

Liên kết sâu bị trì hoãn cho phép bạn liên kết sâu người dùng mới và phục vụ họ với nội dung tùy chỉnh sau khi họ cài đặt ứng dụng. Liên kết sâu này không giống như liên kết sâu thông thường nơi ứng dụng cần được cài đặt trên thiết bị của người dùng.

Để thiết lập liên kết sâu bị trì hoãn với OneLink, nhà phát triển cũng cần truy cập vào bảng điều khiển AppsFlyer.

Thiết lập cho liên kết sâu bị trì hoãn cũng giống như thiết lập dành cho liên kết sâu. Sự khác biệt duy nhất là bạn cần triển khai logic bổ sung trong ứng dụng để liên kết sâu với người dùng và phục vụ họ với nội dung tùy chỉnh sau khi họ cài đặt và khởi chạy ứng dụng.

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.

SDK cung cấp cho bạn dữ liệu chuyển đổi hoặc 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.

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 theo dõi đã được máy chủ AppsFlyer nhận thành công, hãy triển khai trình nghe AppsFlyerTrackingRequestListener.

Phương thức gọi lại onTrackingRequestSuccess() được thu hồ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 onTrackingRequestFailure(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().startTracking(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().startTracking(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)

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 reportTrackSession(Context context);

Ví dụ cách dùng:

AppsFlyerLib.getInstance().reportTrackSession(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ó ba 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. API, khi đến lượt, nhận được OneLink từ những miền nhấp chuột 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 startTracking, 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 lại sau khi đặt ID Người dùng Khách hàng.

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().setCustomerIdAndTrack("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().startTracking(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().setCustomerIdAndTrack("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().startTracking(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().setCustomerIdAndTrack("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. Gọi ra các API sau TRƯỚC KHI gọi phương thức startTracking:
   

   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ả các theo dõi 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 isStopTracking API. Khi API này được thu hồi, SDK sẽ ngừng hoạt động và không còn giao tiếp được với các máy chủ AppsFlyer.

AppsFlyerLib.getInstance().stopTracking(true, context);

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.

Trong bất kỳ sự kiện nào, SDK có thể được kích hoạt lại bằng cách gọi API tương tự, nếu kết quả là sai.

AppsFlyerLib.getInstance().startTracking(getApplicationContext(), AF_DEV_KEY);

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 setDeviceTrackingDisabled(boolean isDisabled);

Ví dụ cách dùng:

AppsFlyerLib.getInstance().setDeviceTrackingDisabled(true);

Có thể khởi động lại việc theo dõi bằng cách gọi lại deviceTrackingDisabled được thiết lập là 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 được kích hoạt trước lệnh gọi startTracking đầ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.