Ghi chú phát hành AppsFlyer SDK cho Android

Sơ lược: Hãy xem ghi chú phát hành SDK để biết tổng quan nhanh về những thay đổi mới nhất đối với SDK Android. Các nhà phát triển đang tìm kiếm thông tin chi tiết toàn diện hơn nên xem lại Ghi chú phát hành Android trên Dev Hub.

SDK Android V6 

Hướng dẫn tích hợp SDK Android dành cho nhà phát triển

Phiên bản Ngày phát hành Lưu ý
6.14.2 2024-06-10
  • Đã khắc phục sự cố khi tìm nạp Meta Install Referencerer trên các ứng dụng được xây dựng bằng Unity.
6.14.1 2024-05-29 Bảo trì SDK
6.14.0 2024-04-18
  • Đã thêm hỗ trợ cho luồng Xác thực mua hàng được cập nhật. Tính năng này hiện đang ở giai đoạn thử nghiệm kín. Tìm hiểu thêm.
  • Đã cập nhật tích hợp Người giới thiệu Huawei. Tìm hiểu thêm.
6.13.1 2024-04-03 Bảo trì SDK
6.13.0 2024-02-08
  • Đã thêm hỗ trợ cho Chính sách về sự đồng ý ở Liên minh Châu Âu (DMA) mới của Google
6.12.6 2024-01-29

Bảo trì SDK

6.12.5 2023-12-18
  • Đã thêm original_link tham số cho lệnh gọi lại liên kết sâu trong quy trình phân giải ESP.
6.12.4 25-10-2023
  • Dexguard đã cập nhật lên phiên bản 9.4.16 để cải thiện tính ổn định của SDK.

6.12.3

Ngày 31 tháng 08 năm 2023 Bảo trì SDK

6.12.2

02-08-2023
  • Đã sửa lỗi có thể khiến ứng dụng bị sự cố trên một số thiết bị chạy Android 8.1.0 và Android 11.

6.12.1

29-06-2023
  • Đã khắc phục sự cố khiến quá trình khởi chạy của Cửa hàng Play bị trì hoãn trong quảng cáo chéo.
  • Đã khắc phục lỗi khiến ứng dụng bị văng trên một số thiết bị.

6.12.0

Ngày 28 tháng 06 năm 2023
  • Ngưng hỗ trợ - vui lòng sử dụng phiên bản 6.12.1.

6.11.2

29-06-2023
  • Đã khắc phục lỗi khiến ứng dụng bị văng trên một số thiết bị.

6.11.1

6-6-2023
  • Ngưng hỗ trợ - vui lòng sử dụng phiên bản 6.12.1.
  • Đã khắc phục lỗi khiến ứng dụng đôi lúc bị văng sau khi khởi chạy SDK.

6.11.0

16-5-2022
  • Đã khắc phục sự cố đôi lúc khiến ứng dụng bị treo trên một số thiết bị khi SDK cố gắng lấy Liên kết giới thiệu Google Play

6.10.3

Ngày 25 tháng 04 năm 2023 Bảo trì SDK

6.10.1

1-3-2023
  • Đã khắc phục sự cố đôi lúc khiến các ứng dụng trên thiết bị Samsung bị đóng khi khởi chạy SDK. Sự cố này ảnh hưởng đến các ứng dụng cài SDK V6.6.0 trở lên.

6.10.0

13-02-2023
  • Miền AppsFlyer mới cho giao tiếp giữa SDK và máy chủ AppsFlyer.
  • Đã thay đổi API setHost khi các giá trị trống hoặc null được gửi đi. Tìm hiểu thêm

6.9.4

06-12-2022
  • Đã khắc phục sự cố kích hoạt một lệnh gọi đến trình nghe chuyển đổi trong quá trình gửi một sự kiện doanh thu quảng cáo từ trình kết nối SDK doanh thu quảng cáo.
  • Đã khắc phục sự cố đôi khi ứng dụng bị đóng băng khi một sự kiện doanh thu quảng cáo được gửi từ trình kết nối SDK doanh thu quảng cáo.

6.9.3

Ngày 28 tháng 11 năm 2022
  • Đã cập nhật cấu trúc yêu cầu nội bộ để Nhận dữ liệu chuyển đổi (GCD). Lưu ý: Lưu ý: Dữ liệu phản hồi vẫn giữ nguyên.
  • Đã khắc phục sự cố xảy ra khi SDK kích hoạt một yêu cầu GCD trong lúc ứng dụng có ConversionListener được đặt thành null.

6.9.2

02-10-2022
  • Đã khắc phục sự cố liên quan đến yêu cầu xác thực mua sử dụng API validateAndLogInAppPurchase bị chậm.

6.9.1

19-09-2022 Bảo trì SDK

6.9.0

12-09-2022
  • Đã thêm hỗ trợ Liên kết giới thiệu trên Xiaomi GetApps Store.
  • Đã cập nhật API nội bộ cho báo cáo doanh thu quảng cáo. Kể từ phiên bản này, chỉ có trình kết nối SDK doanh thu quảng cáo chung được hỗ trợ.

6.8.2

29-08-2022
  • Đã khắc phục sự cố nghiêm trọng với cơ chế bộ nhớ đệm của SDK được đưa vào trong V6.7.0, khiến các sự kiện được lưu trong bộ nhớ đệm bị gửi nhiều lần.

6.8.1
Ngưng hỗ trợ

24-08-2022
  • Ngưng hỗ trợ Vui lòng sử dụng V6.8.2.

6.8.0
Ngưng hỗ trợ

18-07-2022
  • Ngưng hỗ trợ Vui lòng sử dụng V6.8.2.
  • Di chuyển enableLocationCollection API từ SDK. Ứng dụng vẫn có thể báo cáo dữ liệu vị trí của người dùng bằng cách chuyển trực tiếp tới SDK thông qua API logLocation.
  • Đã thêm com.google.android.gms.permission.AD_ID quyền của SDK AndroidManifest.xml. Đọc thêm thông tin ở đây.
  • Đã khắc phục sự cố liên quan đến tối ưu hóa và giấu mã bằng R8.

6.7.0
Ngưng hỗ trợ

Ngày 19 tháng 06 năm 2022

6.6.1

16-05-2022 Bảo trì SDK

6.6.0

Ngày 01 tháng 05 năm 2022
  • Đã thêm nhiều thông số hơn vào lệnh gọi lại onDeepLinking của UDL cho luồng Liên kết sâu trực tiếp (người dùng hiện có). Để biết thêm thông tin.

6.5.4

Ngày 23 tháng 03 năm 2022 Bảo trì SDK

6.5.3

09-03-2022
  • Vá lỗi: Sửa lỗi: Đã khắc phục sự cố bằng cách tạo liên kết mời người dùng chứa các ký tự không phải tiếng Anh.

6.5.2

26-01-2022
  • Đã khắc phục sự cố khi phân giải URL cho liên kết sâu bị trì hoãn trong UDL.
  • Đã cập nhật lên DexGuard 9.2
  • Tái cấu trúc và thay đổi nội bộ.

6.5.1

29-12-2021

6.5.0

07-12-2021
  • Tái cấu trúc và thay đổi nội bộ.

6.4.3

14-11-2021
  • Đã sửa lỗi được giới thiệu trong V6.4.2vớiLinkGeneratorgây ra việc tạo liên kết thiếu tham số URL.

6.4.2

Ngày 24 tháng 10 năm 2021

Những lỗi sau đây đã được giải quyết:

  • Thông số pidpidpid bị thêm hai lần vào URL tùy chỉnh do LinkGeneratorLinkGeneratorLinkGenerator tạo.
  • Thêm / đã được thêm vào af_dp giá trị khi sử dụng LinkGenerator để tạo các lược đồ URI tùy chỉnh.
  • Nếu ứng dụng kích hoạt thu thập chỉ IMEI hoặc AndroidID, cả 2 loại mã này đều được thu thập.

6.4.1

17-10-2021

Đã giải quyết lỗi biên dịch khi sử dụng phiên bản Gradle thấp hơn V3.5.4.

6.4.0

12-09-2021

API mới: setSharingFilterForPartners cho phép bạn định cấu hình những đối tác mà SDK sẽ loại trừ khỏi việc chia sẻ dữ liệu.

Kể từ phiên bản này, setSharingFiltersetSharingFilterForAllPartners không được dùng nữa.

6.3.2

Khấu hao: 31/08/2024

06--06-2021

API mới: setDisableAdvertisingIdentifiers

6.3.1

Khấu hao: 31/08/2024

Ngày 26 tháng 05 năm 2021
  • API mới: performOnDeepLinking
  • Đã thêm khả năng kích hoạt API mời người dùng trước khi gọi lệnh start/sau khi gọi lệnh startstopstart
  • Vá lỗi: Đã khắc phục sự cố trong đó cuộc gọi đến waitForCustomerUserId đã không được phát hành ngay cả sau khi gọi setCustomerUserId

6.3.0

Khấu hao: 31/08/2024

29-04-2021
  • Vá lỗi: Việc gọi sai onConversionDataFail khi yêu cầu gửi sự kiện trong ứng dụng không thành công
  • Sửa lỗi: thu thập phép đo của cảm biến chuyển động (để phát hiện gian lận)
  • Vá lỗi: Sửa lỗi: Sửa lỗi liên quan đến giấu mã đối với UDL
  • Cập nhật kỹ thuật đối với API OneLink
6.2.3
Khấu hao: 31/08/2024
04-03-2021 Bảo trì SDK
6.2.0
Khấu hao: 31/08/2024
Ngày 07 tháng 02 năm 2021
6.1.4
Khấu hao: 31/08/2024
Ngày 12 tháng 01 năm 2021
  • Đã thêm hỗ trợ DexGuard V9
6.1.3
Khấu hao: 31/08/2024
Ngày 24 tháng 12 năm 2020
6.1.1
Khấu hao: 31/08/2024
Ngày 03 tháng 12 năm 2020
  • Đã thêm hỗ trợ liên kết giới thiệu trên Samsung Galaxy Store
  • Sửa lỗi nhỏ và cải thiện hiệu suất.
6.1.0
Khấu hao: 31/08/2024
Ngày 09 tháng 11 năm 2020
  • Đã thêm hỗ trợ cho API liên kết sâu hợp nhất
6.0.1
Khấu hao: 31/08/2024
Ngày 28 tháng 10 năm 2020

Bảo trì SDK

6.0.0
Khấu hao: 31/08/2024
14-10-2020
  • Các thay đổi lớn đối với chức năng SDK và API, bao gồm ngừng hỗ trợ và thay đổi tên phương thức. Tìm hiểu thêm

Ghi chú phát hành Android V6.0.0

Các phương thức bị xóa/ngừng hỗ trợ hoặc đổi tên

Các phương thức bị loại bỏ/ngừng hỗ trợ

Các phương thức sau đã bị loại bỏ khỏi SDK:

  • sendDeepLinkData

  • trackAppLaunch

  • setPluginDeepLinkData

  • setConsumeAFDeepLinks

  • setHostName

Các phương thức đã đổi tên

Tên API (trước V6) Tên API hiện tại (V6 trở lên)

stopTracking

stop

setCustomerIdAndTrack

setCustomerIdAndLogSession

startTracking

start

trackLocation

logLocation

reportTrackSession

logSession

trackEvent

logEvent

setDeviceTrackingDisabled

anonymizeUser

validateAndTrackInAppPurchase

validateAndLogInAppPurchase

isStopTracking

isStopped

trackAndOpenStore

logAndOpenStore

trackCrossPromoteImpression

logCrossPromoteImpression

trackInvite

logInvite

Đã đổi tên giao diện

Tên giao diện (trước V6) Tên giao diện hiện tại (V6 trở lên)

AppsFlyerTrackingRequestListener

AppsFlyerRequestListener

Các phiên bản ngừng hỗ trợ

Ghi chú phát hành SDK Android V5

Phiên bản Ngày phát hành Chỉ bảo trì Lưu ý

5.4.6

Ngày 09 tháng 11 năm 2020  
  • Đã thêm hỗ trợ liên kết giới thiệu trên Huawei AppGallery.

5.4.4

01-10-2020  
  • Đã thêm hỗ trợ cho SDK để xử lý nhiều chuyển hướng từ ESP
  • Sửa lỗi và bảo trì

5.4.3

Ngày 30 tháng 07 năm 2020  
  • Khả năng ghi nhật ký và gỡ lỗi mở rộng
  • Sửa lỗi và bảo trì
  • Hỗ trợ người giới thiệu cài đặt V2 từ Google

5.4.1

Ngày 30 tháng 06 năm 2020  
  • Cho phép nhà quảng cáo kiểm soát hoạt động chia sẻ dữ liệu với các đối tác/mạng tích hợp. Tìm hiểu thêm
  • Sửa lỗi và bảo trì

5.4.0

Ngày 03 tháng 06 năm 2020  
  • Hỗ trợ đầy đủ cho quá trình tự động thu thập OAID
  • Hỗ trợ nhiều người giới thiệu: SDK có thể thu thập những người giới thiệu Huawei và Google
  • Cải thiện hiệu suất SDK
  • Sửa lỗi và bảo trì

5.3.0

2020-04-27   
  • Truy cập dữ liệu chuyển đổi liên kết sâu trực tiếp mới nhất bất kỳ lúc nào, thông qua phương thức onAppOpenAttribution
  • Thông số bổ sung khả dụng cho các lượt hiển thị quảng cáo chéo
  • Sửa lỗi: đã khắc phục sự cố bằng các tên tệp tin a. và b. trong Windows
  • Phương thức sendDeepLinkData lấy dữ liệu phân bổ ngay cả khi người dùng được liên kết sâu vào một hoạt động cụ thể đã ngưng hỗ trợ để thay thế bằng phương thức startTracking()
5.2.0 2020-03-10   
  • Cho phép khởi tạo SDK trong mọi hoạt động
  • Khả năng bảo mật, ghi nhật ký và gỡ lỗi mở rộng
  • Sửa lỗi và bảo trì
5.1.2 19-02-2020

 

5.1.1 2020-01-23     
5.1.0 2020-01-06      
  • Nhắm mục tiêu đến Android 9 (API cấp 28) theo yêu cầu nhắm mục tiêu cấp API của Google
  • Các cải tiến để bảo vệ chống gian lận - dành cho khách hàng Protect360
  • Mô-đun tùy chọn để thu thập OAID (phù hợp với mạng nội địa Trung Quốc) - Xiaomi và Huawei (xem https://github.com/AppsFlyerSDK/appsflyer-oaid).
  • Cải thiện độ ổn định khi sử dụng setOneLinkCustomDomain cho ESP
5.0.2 Ngày 23 tháng 12 năm 2019     
5.0.1 2019-12-12     
5.0.0 12-11-2019
  • Sửa lỗi và bảo trì
  • Các thay đổi lớn đối với chức năng SDK và API, bao gồm ngừng hỗ trợ và thay đổi tên phương thức. Tìm hiểu thêm

Ghi chú phát hành Android V5.0.0

Cải thiện thời gian phản hồi SDK

Bắt đầu từ SDK V5.0.0, thời gian phản hồi GCD cho các lượt cài đặt tự nhiên đã được cải thiện.

Các phương thức đã bị xóa hoặc đổi tên

Thay đổi tên phương thức

Tên phương thức chuyển đổi dữ liệu hiện đã trùng với cả Android và iOS. Điều này ảnh hưởng thức xử lý:

  • dữ liệu chuyển đổi khi cài đặt
  • lỗi nếu không có dữ liệu
Tên Android trước bản SDK V5   Tên iOS trước bản SDK V5 Tên tiêu chuẩn hóa
onInstallConversionDataLoaded onConversionDataReceived onConversionDataSuccess
onInstallConversionFailure onConversionDataRequestFailure onConversionDataFail

Phương thức bị loại bỏ

Các phương pháp sau đã ngừng hỗ trợ trong các phiên bản SDK trước. Chúng hiện đã bị xóa khỏi SDK.

Android

  • setGCMProjectID (String projectNumber)
  • setGCMProjectNumber (String projectNumber)
  • setGCMProjectNumber (Context context, String projectNumber)
  • enableUninstallTracking (String senderId)
  • setAppUserId (String id)
  • setUserEmail (String email)
  • setCollectFingerPrint (boolean isCollect)  
  • getAttributionId (ContentResolver contentResolver)
  • Lớp FirebaseInstanceIdListener (phiên bản FirebaseInstanceIdService)

 iOS

  • loadConversionDataWithDelegate: (id<AppsFlyerTrackerDelegate>)delegate
  • setHost:(NSString *)host 

Thay đổi để nhận định dạng dữ liệu chuyển đổi

Trong phiên bản này, đối với mỗi lượt cài đặt hoặc mở ứng dụng, SDK trả về một đối tượng bản đồ có chứa dữ liệu chuyển đổi (GCD), chẳng hạn như nguồn truyền thông và tên chiến dịch.  Trong các phiên bản SDK trước, GCD chỉ trả về các thông số chứa một giá trị

Bắt đầu từ phiên bản này, tất cả thông số được trả về, kể cả những thông số không có giá trị. Các thông số không có giá trị sẽ được ghi là null.  

 Ví dụ

Lượt cài đặt sau khi nhấp vào URL sau:

https://app.appsflyer.com/com.sample.app?pid=super_media_source&c=awesome_campaign
  &campaign_id=1234&af_sub1=promo
  

Các phản hồi như sau:

Phản hồi GCD trước SDK V5 Phản hồi GCD bắt đầu từ SDK V5

   {
      "install_time": "2019-11-11 15:00:59.828",
      "media_source": "super_media_source",
      "orig_cost": "0.0",
      "advertising_id": "215d8172-c61e-4d0c-9eb2-aa4d0971ed8c",
      "af_status": "Non-organic",
      "is_first_launch": "true",
      "af_sub1": "promo",
      "af_click_lookback": "7d",
      "cost_cents_USD": "0",
      "iscache": "true",
      "click_time": "2019-11-11 15:00:35.102",
      "campaign": "awesome_campaign",
      "campaign_id": "1234",
  }
      

GCD trả về cùng một cấu trúc bất kể loại dữ liệu. Nếu một tham số trống, tham số đó sẽ được đưa vào GCD với giá trị null. Điều này giúp các nhà phát triển xử lý GCD dễ dàng hơn mà không cần phải điều chỉnh logic xử lý GCD, bất kể có bao gồm các thông số nhất định hay không. Để tìm hiểu thêm về dữ liệu chuyển đổi trong các tình huống khác nhau, hãy xem tại đây.

Ghi chú phát hành Android V4.0.0

Phiên bản Ngày phát hành Lưu ý
4.11.0 22-10-2019
  • Cải thiện tính năng ghi nhật ký để gỡ lỗi tốt hơn cho:
    • ESP
    • Phân giải Liên kết gắn thương hiệu
    • onInstallConversionData và onAppOpenAttribution.
  • Sửa lỗi và bảo trì
4.10.3 15-09-2019
  • Sửa lỗi và bảo trì
  • Hỗ trợ Mã định danh Nhà quảng cáo Mở (OAID)  
4.10.2
4.10.1 01-07-2019 Sửa lỗi và bảo trì
4.10.0 14-05-2019
  • Cải tiến SDK dành cho nhà phát triển sử dụng ProGuard.
  • Sửa lỗi và bảo trì
4.9.0 17-03-2019
  • setResolveDeepLinkURLs API để phân giải các OneLink được bọc bằng một Liên kết chung khác
  • Sửa lỗi ghi nhận thông báo đẩy khi bản ghi thông báo đẩy bị loại bỏ của tải trọng trước chứa cùng một pid và vẫn tồn tại trong bộ nhớ.
  • Sửa lỗi đánh máy từ af_county thành af_country
  • Sửa lỗi và bảo trì
4.8.20 13-02-2019
  • Cải thiện khả năng của gói miễn cước cho các nhà cung cấp dịch vụ di động
  • Sửa lỗi và bảo trì
4.8.19 26-12-2018
  • Đã khắc phục sự cố trong đó phương thức waitForCustomerUserId() nghỉ giải lao generateLink
  • Sửa lỗi và bảo trì
4.8.18 11-11-2018
  • Đã khắc phục sự cố liên kết sâu từ các hoạt động trampoline (thao tác nhấn)
  • Cải thiện độ chính xác của thu hút lại khi di chuyển giữa nền sau và nền trước
  • Sửa lỗi và bảo trì
4.8.17 02-11-2018 Khắc phục sự cố liên quan đến các xung đột trong ProGuard. Các xung đột này có thể dẫn đến mất dữ liệu khởi chạy ứng dụng trong một số trường hợp. Sự cố này chỉ ảnh hưởng đến phiên bản SDK 4.8.16
4.8.16 31-10-2018 Sửa lỗi và bảo trì
4.8.15 27-08-2018
  • Sự kiện SDK bổ sung: Đăng ký, Bắt đầu dùng thử, Nhấp vào quảng cáo, Xem quảng cáo
  • Sửa lỗi và bảo trì
4.8.14 31-07-2018
  • Đã thêm API setOutOfStore và getOutOfStore để tự động đặt giá trị AF_STORE
  • Thêm onTrackingRequestFailureonTrackingRequestSuccess API để nhận xác nhận rằng AppsFlyer đã nhận thành công máy chủ yêu cầu theo dõi
4.8.13 20-06-2018
  • Đã sửa lỗi trong một trường hợp hiếm gặp khi IMEI bị thiếu rõ ràng trong quá trình được chuyển qua API setImeiData
  • Sửa lỗi và bảo trì
4.8.12 27-05-2018
  • Đã sửa lỗi ứng dụng bị treo khi chạy thử JUnit sử dụng Robolectric
  • Sửa lỗi và bảo trì
4.8.11 02-05-2018 Sửa lỗi và bảo trì
4.8.10 26-04-2018
  • Thêm setPreinstallAttribution API
  • Sửa lỗi và bảo trì
4.8.9 02-04-2018
  • Chỉ thu thập IMEI nếu GooglePlayServices không tồn tại trên thiết bị và không thể truy xuất GAID trên thiết bị đó
  • Sửa lỗi và bảo trì
4.8.8 11-03-2018
  • Đã thêm API để trì hoãn quá trình khởi tạo SDK cho đến khi customerUserID được cung cấp
  • Sửa lỗi và bảo trì.
4.8.7 25-01-2018
  • isStopTrackingisStopTrackingisStopTracking API để tắt tất cả các hoạt động SDK
  • af_content tham số sự kiện
4.8.5 29-11-2017
  • Hỗ trợ API của người giới thiệu mới từ Google
  • Phương thức init mới để nhận ngữ cảnh
4.8.4 14-11-2017
  • Đã gắn cờ vào getConversionData is_first_launchis_first_launchis_first_launch để cho biết đây là lần khởi chạy đầu tiên của ứng dụng. Cờ này cho phép nhà phát triển xác định lần khởi chạy đầu tiên của ứng dụng một cách dễ dàng trong phản hồi gọi lại getConversionData được trả về trong mỗi lần khởi chạy. Các giá trị của is_first_launch có thể bao gồm "true" hoặc "false"
  • Sửa lỗi và bảo trì
4.8.3 27-09-2017 Đã thêm hỗ trợ dữ liệu liên kết giới thiệu HTTP trên getConersionData
4.8.2 19-09-2017 Sửa lỗi sendDeepLinkData(this) cho các ứng dụng liên kết sâu tới nhiều hoạt động
4.8.1 17-09-2017 Cải thiện khả năng bảo vệ trước các sự kiện trong ứng dụng được gọi ra trước khi khởi tạo SDK
4.8.0 03-09-2017
  • API mời người dùng
  • API quảng cáo chéo
  • Tùy chỉnh thời gian giữa các phiên
  • Hỗ trợ Gói miễn cước cho các nhà cung cấp dịch vụ di động
  • Thông số sự kiện bổ sung af_projected_revenue
  • Sửa lỗi và bảo trì
  • Ra mắt phương thức init bổ sung - AppsFlyerLib.getInstance().init(AF_DEV_KEY,conversionDataListener);
4.7.4 28-06-2017 Đã cải thiện hiệu quả xử lý ScheduledExecutorSerice bị tắt nhiều lần
4.7.3 06-06-2017 Cải tiến để tích hợp mParticle
4.7.2 22-05-2017
  • Đã khắc phục sự cố rò rỉ nhỏ của bộ nhớ
  • Đã tăng độ chính xác của phép đo Lượt gỡ cài đặt
  • Đã sửa lỗi cảnh báo ProGaurd thường ảnh hưởng đến việc đo lường lượt gỡ cài đặt
  • Sửa lỗi và bảo trì
4.7.1 22-02-2017 Đã sửa lỗi cảnh báo do ProGuard kích hoạt
4.7.0 13-02-2017
  • Thông số sự kiện bổ sung
  • Hỗ trợ đo lường lượt gỡ cài đặt dựa trên Firebase
  • Sửa lỗi và bảo trì